Managing applications

PingCentral
bundle
pingcentral-19
ft:publication_title
PingCentral
Product_Version_ce
PingCentral 1.9
category
Administrator
Audience
Developer
Product
pc-19
pingcentral
ContentType_ce
Page created: 8 Oct 2021 |
Page updated: 21 Apr 2022
| 1 min read

1.9 Product PingCentral Developer Audience Administrator

All PingCentral applications and applications in verified PingAccess and PingFederate environments display on the Applications page, where you can filter the list of applications, add new applications, update existing applications, and delete them from PingCentral when they are no longer needed.

Filtering applications

Page created: 8 Oct 2021 |
Page updated: 21 Apr 2022
| 1 min read

1.9 Product PingCentral Developer Audience Administrator

Use the filters at the top of the page to filter your list of applications, or use the search feature to locate specific applications.

  1. Select your filters. You can filter by:
    • Environment
    • Template
    • Application owner, or groups of application owners
    • Integration type (OAuth and OIDC or SAML)
    • Managed (applications created from or promoted to PingCentral environments), and Unmanaged (applications that reside in verified PingAccess or PingFederate environments.)
      A screen capture of the Applications page that displays the filters available to filter the application list.
  2. Click the filters to remove them.
  3. If you know the name of an application, further refine your search by entering the first few letters of application's name.

Adding applications

Page created: 8 Oct 2021 |
Page updated: 21 Apr 2022
| 1 min read

1.9 Product PingCentral Developer Audience Administrator

There are a variety of ways you can add applications to PingCentral. You can apply templates to them, you can create templates from them, or you can add them directly to PingCentral.

  1. To apply an OAuth, OIDC, SAML, or PingAccess template to an application:
    1. Click Add Application.
    2. On the Select Template page, select the appropriate template and follow the wizard prompts.

      See Selecting a template in the PingCentral for Application Owners guide for additional information.

  2. To create a template from an unmanaged application:
    1. Select the expandable icon associated with the application.
    2. Click Add as Template and follow the wizard prompts.

      The template displays in the list of available templates.

  3. To add a PingFederate or PingAccess application directly to PingCentral:
    1. Use the search and filtering features to locate applications.

      For more information, see Filtering applications

    2. Select the expandable icon associated with the application.
    3. Click Add to PingCentral as shown in the following example, name the application, assign owners, and save it.
      This example shows a selected PingFederate application that displays the Add to PingCentral button.

Updating applications

Page created: 8 Oct 2021 |
Page updated: 21 Apr 2022
| 3 min read

1.9 Product PingCentral Developer Audience Administrator

To keep your applications secure, rotate certificates and client secrets on a regular basis and apply updated security configurations to applications built from templates if new configuration templates become available.

You don't need to recreate your applications in PingCentral to apply new templates. Replace the templates associated with your applications and promote them again.

  1. On the Applications page, click the Expand icon associated with the application you want to update and then click the Pencil icon.

    All of the editable information is on one page.

  2. To update the name, description, and owners, change the information in the Name, Description, and Owners fields. Click Save.
  3. To change the template used to create the application, click Change Template and select a new template from the Select Template page. Click Save and Close.
    Note:

    You cannot apply a SAML template to an OAuth or OpenID Connect (OIDC) application nor apply an OAuth or OIDC template to a SAML application.

  4. Optional: To update OAuth or OIDC application information:
    1. In the Client section, change the scopes associated with OAuth or OIDC applications. Select or clear the appropriate check boxes and click Save.
      Note:

      You cannot edit scopes for applications created in PingCentral 1.2.0. However, you can update the template associated with an application to a template created in a later version, which allows you to update scope information.

    2. In the Promote section, change the information in the Redirect URI fields for the appropriate environments and click Save.
    3. To change client secrets, return to the Applications page, promote the application again, and generate a new secret.
  5. Optional: To update SAML application information:
    1. In the Attribute Mappings section, add or remove attributes and expressions, or update attribute and expression values, and click Save.
    2. In the Promotions section, upload a new .xml file that contains service provider metadata, such as the Entity ID, ACS URL, certificates, and attribute information, from another SAML application. Click Choose File or Or Use URL to provide the metadata file.
      Note:

      If metadata is used, the attribute mapping section might also need to be updated to include new attributes from the metadata file.

    3. Change the information in the Entity ID or ACS URL fields and click Save.
    4. To change the signing certificate, select the appropriate certificate in the Signing Certificate list and click Save.
    5. To change the service provider (SP) certificate, click SP Certificate to upload a new certificate, or click Remove to remove it. Click Save.
  6. Optional: To update PingAccess application information:
    1. On the Properties tab, in the Promote section, update the Virtual Hosts, Access Validation, Identity Mapping, and Site or Agent names, as appropriate. Click Save.
    2. On the Resources tab, update information regarding each resource and click Save.
    3. On the Policy tab, click the Pencil icon associated with the policy you want to update. Make changes and click Save.

Deleting applications

Page created: 8 Oct 2021 |
Page updated: 21 Apr 2022
| 1 min read

1.9 Product PingCentral Developer Audience Administrator

You can delete applications within PingCentral, but they will still exist in PingFederate or PingAccess. You need to delete them directly from PingFederate or PingAccess.

Applications owners can also delete applications within PingCentral but might not be able to access PingFederate or PingAccess, so you might receive requests to delete applications from PingFederate or PingAccess for them.

  1. To delete an application from PingCentral, click the associated Delete icon.
    A message displays asking you if you want to delete the application.
  2. Click Delete.