PingFederate Server

Modifying connections to PingOne

Administrators can modify a connection between PingFederate and PingOne by, for example, adding a PingOne environment to it, replacing its credential, changing its description, or disabling it

If you have multiple connections to PingOne, to avoid confusion, you can identify a connection by its connection ID in both PingFederate and PingOne. The connection ID never changes, whereas its name can be changed.

Editing connection names and descriptions

You can change the names and descriptions of connections between PingFederate and PingOne.

About this task

The following procedure describes how to change the name and description of the connection in PingFederate. You can also change them in PingOne.

Changing the name and description in PingFederate does not change them in PingOne, and vice versa. You cannot change a connection’s ID.

Steps

  1. In PingFederate, go to System → External Systems → PingOne Connections.

  2. On the PingOne Connections window, open the connection’s card by clicking its expand icon.

  3. Click the pencil icon.

  4. Change the Connection Name, Connection Description, or both.

  5. Click Save.

Disabling and enabling connections

You can disable a connection between PingFederate and PingOne in either of those applications; however, to enable a connection, it must be enabled in both applications.

Steps

  1. To disable or enable a connection in PingFederate:

    1. Go to System → External Systems → PingOne Connections.

    2. On the connection’s card, click the toggle switch to change the connection’s state.

  2. To disable or enable a connection in PingOne:

    1. Go to Connections → Product Platform → PingFederate.

    2. On the connection’s card, click the toggle switch to change the connection’s state.

Replacing connection credentials

You can replace or revoke the credential of a connection between PingFederate and PingOne.

About this task

The following procedure describes how to replace a connection’s credential, which requires administrative access to both applications.

Steps

  1. In PingOne:

    1. Go to Connections → Product Platform → PingFederate.

    2. On the PingFederate Connections window, open the connection’s card and go to the Configuration tab.

    3. Click the pencil icon.

    4. Click Add.

      Result:PingOne generates a new credential, adds it to the tab, and opens a dialog box.

    5. In the dialog box, click the credential to save it to the clipboard.

    6. Close the dialog box.

    7. If you will not perform step 2 now, paste and save the credential in a text file because this is the only time you can view and copy the credential.

  2. In PingFederate:

    1. Go to System → External Systems → PingOne Connections.

    2. On the PingOne Connections window, open the connection’s card.

    3. Click the pencil icon.

    4. Paste the new credential that you created in step 1 in the Credential field.

    5. Click Save.

Next steps

After you replace a connection’s credential, you can go to PingOne and revoke the old credential.

Modifying which environments connections can access

PingOne administrators can specify which environments in PingOne a connection can access.

In PingOne, environments are assigned to roles and roles are assigned to connections. When a connection is created, PingOne assigns it default roles and environments. A connection can access all the environments assigned to its roles. For more information, see Edit a connection: Add roles and responsibilities in the documentation for PingOne.