The information required to promote PingAccess Web applications, API applications, and Web + API applications varies by type. Prepare to provide the following information:

  • Virtual hosts: Virtual hosts enable PingAccess to protect multiple application domains and hosts. A virtual host is defined by the host name and host port, and is required to promote Web, API, and Web + API applications.

    See Virtual hosts in the PingAccess guide for details.

  • Web session: Web sessions define the policy for web application session creation, lifetime, timeouts, and their scope, and are required for Web + API applications. However, they are optional in Web applications.

    See Web Sessions in the PingAccess guide for details.

  • Identity mappings: Identity mappings make user attributes available to back-end sites that use them for authentication. There are many types of identity mappings, each with different behavior and a distinct set of fields to specify the identity mapping behavior. You can add Web and API identity mappings when promoting Web, API, and Web + API applications.

    See Identity mappings in the PingAccess guide for details.

  • Access validation method: API and Web + API applications can be configured to use access token validators to locally verify signed or encrypted access tokens.

    See Token validation in the PingAccess guide for details.

  • Agents: Agents are web server plugins that are installed on the web server hosting the target application. They intercept client requests to protected applications and allow or deny the request to proceed.

    See Agents in the PingAccess guide for details.

  • Sites: Sites are the target applications, endpoints, or APIs, which PingAccess Gateway is protecting, and to which authorized client requests are forwarded.

    See Sites in the PingAccess guide for details.

  1. To promote the application to an environment, click the expandable icon associated with the application, select the Promote tab, and click Promote.
  2. Select the environment to which you want to promote the application from the Available Environments list.
    Note:

    If you have the Application Owner role, you cannot promote applications to protected environments, which have shield icons associated with them.

  3. On the Configure Promotion page, click in the Virtual Hosts field and select the virtual hosts you want to add.
    To remove a virtual host, click the X icon next to the option.
  4. Complete the remaining fields, which will vary, depending on the type of application you are promoting.
    • Web applications:
      • Web session (optional)
      • Identity mapping (optional)
      • Agent (optional)
      • Site (optional)
    • API applications:
      • Access validation method (optional)
      • Identity mapping (optional)
      • Agent (optional)
      • Site (optional)
    • Web + API applications:
      • Access validation method (required)
      • Web session (required)
      • Web identity mapping (optional)
      • API identity mapping (optional)
      • Agent (optional)
      • Site (optional)
  5. Click Next.
  6. On the Review Promotion page, review promotion information you added.
    Additional detail is available in the Summary and Application sections of the page.
  7. Click Promote and Close.
  8. To review details regarding the promotion, click the View History Details link associated with the promotion.