---
title: Modifying connections to PingOne
description: 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
component: pingfederate
version: 13.1
page_id: pingfederate:administrators_reference_guide:help_p1connections_p1connectionedit
canonical_url: https://docs.pingidentity.com/pingfederate/13.1/administrators_reference_guide/help_p1connections_p1connectionedit.html
llms_txt: https://docs.pingidentity.com/pingfederate/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
revdate: July 5, 2022
section_ids:
  editing-connection-names-and-descriptions: Editing connection names and descriptions
  about-this-task: About this task
  steps: Steps
  disabling-and-enabling-connections: Disabling and enabling connections
  steps-2: Steps
  replacing-connection-credentials: Replacing connection credentials
  about-this-task-2: About this task
  steps-3: Steps
  resultpingone-generates-a-new-credential-adds-it-to-the-tab-and-opens-a-dialog-box: Result:PingOne generates a new credential, adds it to the tab, and opens a dialog box.
  next-steps: Next steps
  modifying-which-environments-connections-can-access: Modifying which environments connections can access
---

# 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 **[icon: plus, set=fa]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. Learn more in [Add roles and responsibilities](https://docs.pingidentity.com/pingone/integrations/p1_edit_connection.html#add_roles) in the PingOne documentation.