Skip navigation
Documentation

PingFederate

Last Updated: October 22nd, 2020

Contents

Ping Identity has partnered with Duo Security to provide two-factor authentication for PingFederate® logins, complete with self-service enrollment and Duo Prompt.

PingFederate® is a full-featured federation server that provides identity management, web single sign-on, and API security for customers, partners, and employees. Users can securely access the applications they require with a single identity using any device. PingFederate® supports all of the current identity standards including SAML, WS-Federation, WS-Trust, OAuth, and OpenID Connect.

Duo's two-factor authentication is now available for PingFederate SSO user logins.

Connectivity Requirements

This application communicates with Duo's service on TCP port 443. Firewall configurations that restrict outbound access to Duo's service with rules using destination IP addresses or IP address ranges aren't recommended, since these may change over time to maintain our service's high availability. If your organization requires IP-based rules, please review this Duo KB article.

First Steps

  1. Sign up for a Duo account.
  2. Log in to the Duo Admin Panel and navigate to Applications.
  3. Click Protect an Application and locate PingFederate in the applications list. Click Protect this Application to get your integration key, secret key, and API hostname. (See Getting Started for help.)

Treat your secret key like a password

The security of your Duo application is tied to the security of your secret key (skey). Secure it as you would any sensitive credential. Don't share it with unauthorized individuals or email it to anyone under any circumstances!

Duo Universal Prompt

Duo's next-generation authentication experience, the Universal Prompt, is coming to web-based applications that display the current Duo Prompt in browsers.

Migration to Universal Prompt for your Ping Federate application is a two-step process:

  • Update the Ping Federate application to support the Universal Prompt.
  • Enable the Universal Prompt experience for users of that Ping Federate application (when the Universal Prompt becomes available)

Ping Federate needs an update to support the Universal Prompt when it's ready, but the update isn't available yet. The "Universal Prompt" section reflects this status as "Waiting on App Provider". Please contact Ping to request Duo Universal Prompt support for Ping Federate.

After Ping makes the necessary changes available you may need to install an application update on your server, or log in to Ping Federate as an admin to enable Duo Universal Prompt support.

Universal Prompt Info - Update Not Yet Available

You'll later return to the settings on this page to activate the Universal Prompt for your Ping Federate users once we've released it.

Click the See Update Progress link to view the Universal Prompt Update Progress report. This report shows the update availability and migration progress for all your Duo applications in-scope for Universal Prompt support.

Read the Universal Prompt Update Guide for more information about the update process to support the new prompt, and watch the Duo Blog for future updates about the Duo Universal Prompt.

Configure Duo in PingFederate

  1. Download the Duo Security Integration Kit from PingFederate Server Integration Kits Downloads (Ping account login required).

  2. Refer to Ping Identity's Duo Security Integration Kit Product Documentation for installation and configuration instructions. Follow the directions to deploy Duo in your PingFederate environment.

Updating the Duo Integration Kit

To update your installed Duo integration kit to a newer version you'll need to:

  1. Download the most recent version of the Duo integration kit from PingFederate Server Integration Kits Downloads (Ping account login required).

  2. Extract the contents of the downloaded ZIP file and copy those files to your Ping server(s), replacing the existing Duo kit files.

  3. Restart PingFederate services.

See the Upgrade from a previous installation section in Ping's documentation for complete instructions. You'll need to update each server in your PingFederate cluster separately.

Troubleshooting

Need some help? Take a look at our PingFederate Knowledge Base articles or Community discussions. For further assistance, contact Support.