PingDirectory

Creating a worker application

Creating a worker application creates a sync destination or source for synchronizing changes to and from PingOne.

Before you begin

Before you create a Worker application, have the following information ready:

  • The app name and description

  • Redirect URLs for authentication (required for interactive applications only)

About this task

To create and configure a Worker app in PingOne:

Steps

  1. In the PingOne admin portal, go to Connections → Applications.

  2. Click the icon.

  3. Create the application profile by entering the following:

    • Application name: A unique identifier for the application.

    • Description (optional): A brief characterization of the application.

    • Icon (optional): A graphic representation of the application. Use a file up to 1MB in JPG, JPEG, GIF, or PNG format.

    A screen capture showing the administrative console Add Application page with name, description, and icon fields shown.

  4. In the Choose Application Type section, click Worker.

    A screen capture showing the admin portal Add Application page with Worker selected from the Choose Application Type section.

  5. Click Save.

    Result:

    The app is displayed on the Applications page.

  6. Make note of the OAuth Client ID, which appears directly below the name of the app.

    This value is required when creating a PingOne sync destination or source.

  7. Click the Configuration tab, and then click the Pencil icon to edit the configuration:

    1. In the General section, make note of the Client Secret.

      This value is required when creating a PingOne sync destination or source.

      A screen capture showing the admin portal Edit Configuration page with the Client Secret section highlighted.

    2. For Grant Type, select the Client Credentials check box.

      A screen capture showing the admin portal Edit Configuration page in the Grant Type section with the Client Credentials check box highlighted.

    3. For a token endpoint authentication method, click Client Secret Post.

      A screen capture showing the admin portal Edit Configuration page in the Token Endpoint Authentication Method section with Client Secret Post selected.

    4. Click Save.

  8. Click the toggle to enable the application.

    A screen capture showing the admin portal application Profile tab with the enable toggle set to enable.

  9. In the left navigation pane, click Environment → Properties.

  10. Make note of the Environment ID.

    This value is required when creating a PingOne sync destination or source.

Next steps

Use your Worker application as a sync source or destination for PingOne: