PingFederate Server

OAuth Playground

Developers can install and use the PingFederate OAuth Playground to experiment with OAuth and OpenID Connect.

Before you begin

Before you can install the OAuth Playground, install the instance of PingFederate in which you will install the OAuth Playground.

You shouldn’t install OAuth Playground in PingFederate production environments.

About this task

Acting as both a client and a resource server, the OAuth Playground simulates authorization requests, responses, and token validation. These features can help you integrate OAuth and OpenID Connect protocols into your applications.

To install the OAuth Playground, perform the following procedure. For more information, including the credentials needed for some OAuth grants, see the ReadMeFirst file in the OAuth Playground .zip file.

Steps

  1. Get the OAuth Playground files:

    1. In a browser, go to the PingFederate Downloads page on the Ping Identity website.

    2. Click the Add-ons tab and scroll down to the Developer Tools section.

    3. Click the OAuth Playground link. If requested, log in to your Ping Identity account. Your browser downloads the OAuth Playground .zip file.

    4. Extract the contents from the .zip file.

  2. Install the OAuth Playground:

    1. Copy the contents of the /dist/deploy directory into /pingfederate/server/default/deploy in your PingFederate directory.

    2. Merge the contents of the /dist/conf directory into /pingfederate/server/default/conf in your PingFederate directory.

  3. Configure the OAuth Playground:

    1. Open the OAuth Playground by going to https://<pf_host>:9031/oauthplayground in a browser.

    2. Click the Setup button. The Setup wizard appears.

    3. Follow the wizard’s instructions.

      The Setup button appears only the first time that you configure the OAuth Playground. To reconfigure the OAuth Playground, click Settings on the taskbar. On the Settings window, click the Set Up Again button. Follow the wizard’s instructions.