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 should not 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 Developer Tools page on the Ping Identity website.

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

    3. Extract the contents from the .zip file.

  2. Install the OAuth Playground:

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

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

  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.