PingFederate Server

Accessing IdP connections

In the IdP Connections window, you can create or import a connection, or edit a recently modified connection by clicking on its connection name.

About this task

The IdP Connections window displays 20 connections at a time. As needed, use the pagination controls to navigate through the rest of your connections. You can also search connections by their names or connection IDs.

A connection is included in the search results so long as its name or ID is a partial, case-insensitive match to a search term.

You can sort by connection name, partner connection ID, default virtual server ID, creation date, or last modified timestamps; narrow by protocol and status; and perform various connection-related tasks.

Steps

  1. Go to the Authentication → Integration → IdP Connections.

    Choice Action

    Edit a connection

    Select the connection by its name. For the setting you want to change, select the corresponding tab and follow the configuration wizard to complete the task.

    Create a connection

    Click Create Connection, then follow the configuration wizard to create a new connection to your identity provider (IdP) partner.

    Copy a connection

    Click Select action → Copy, then follow the configuration wizard to create a new connection based on an existing (source) connection.

    This is most useful if the new connection and the source connection share many common setting values.

    Export a connection

    Click Select Action → Export Connection, then save the XML file as prompted.

    This is useful in situations where you want to make a backup of a connection prior to making changes to it.

    Import a connection

    Click Import Connection, then follow the on-screen instructions to complete the task.

    If the connection already exists, you have the option to overwrite the existing connection.

    Prior to the import, you can modify the XML file to suit your needs. The XML file can also be imported to another PingFederate environment acting in the same federation role (SP) at your site. The source and the target must run the same version of PingFederate.

    Export metadata for any SAML browser single sign-on (SSO) connection

    Click Select Action → Export Metadata, then follow the on-window instructions to complete the task.

    Update a SAML browser SSO connection

    Click Select Action → Update with Metadata, then follow the on-screen instructions to complete the task.

    You can update a connection via a metadata XML file or a metadata URL.

    The update operation might require additional configuration. Review the connection after the update operation.

    Toggle the status of a connection

    Slide the toggle switch to enable or disable a connection.

    Remove a connection

    Click Select Action → Delete.

    Override the verbosity of runtime transaction logging for all IdP connections

    Click Show Advanced Fields and the select the desired override option.

    Off

    Select this option and let the per-connection Logging Mode configuration determine the amount of information PingFederate records in the runtime transaction log.

    This is the default selection.

    On

    Select this option, followed by one of the four logging modes, to set the verbosity of runtime transaction logging for all IdP connections. This is most useful when troubleshooting an issue that affects multiple connections.

    Turn off automatic multi-connection error checking

    Click Show Advanced Fields and the select the Disable Automatic Connection Validation check box.

    This check box is not selected by default.

    Once selected or cleared, the state of this setting is reflected on Applications → Integration → SP Connections as well.

    For more information about this advanced setting and its impact, see Configuring automatic connection validation.

    Keep your changes

    Click Save.

    Discard your changes

    Click Cancel.