You can update an existing SAML connection using a metadata file or a metadata URL from your partner.

Note:

This manual update is independent from the optional and per-connection automatic update feature.

  1. Go to the Manage All > Connections screen.
  2. Click Update with Metadata under Action for the applicable SAML connection.
  3. Refer to the following steps to import or update metadata. Instructions vary depending on the medium of the metadata.
    Metadata medium Steps
    A metadata file
    1. On the Import Metadata screen, select the File option.
    2. Choose the metadata file, and then click Next.
      Note:

      If the metadata file is digitally signed but the verification certificate is provided outside of the metadata, import the metadata verification certificate on the Import Certificate screen, and then click Next.

    3. On the Metadata Summary screen, review the signature information to evaluate the authenticity of the metadata.
    4. Click Save.
    A metadata URL
    1. On the Import Metadata screen, select the URL option.
    2. Select the metadata from the Metadata URL list.
      Tip: If the metadata you want is not shown in the list, click Manage Partner Metadata URLs.
    3. Click Load Metadata.
      Note: If there is a digital signature error, click Manage Partner Metadata URLs to resolve the issue.
    4. Click Save.
  4. On the Connections screen, click Save.
Note:

If the endpoints in the metadata share the same base URL (protocol, hostname, and port), PingFederate uses this information to populate the Base URL field. Consequently, individual endpoints on other screens do not include this information; only relative paths are shown.

Example

An SP has just changed its signing certificate and published a new metadata with the new certificate. To minimize the impacts to your users, you as the IdP can update the SP connection using the metadata immediately.
  1. Access the Identity Provider > Manage All > Connections screen.
  2. Click Update with Metadata under Action for the applicable SAML connection.
  3. Follow the workflow to complete the task.