> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oloid-demo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrating Oloid tenant to your PingOne (OIDC) instance

> This document provides step-by-step instructions on how Oloid's WebKey application integrates with PingOne as an external OpenID Connect (OIDC) Identity...

**Introduction**

This document provides step-by-step instructions on how Oloid's WebKey application integrates with PingOne as an external OpenID Connect (OIDC) Identity Provider (IdP).

1. Sign in to the Ping Identity Administrator Console with your PingOne account credentials

2. Select **Create Environment**, then select **Create a Customer Solution**.

   ![Integrating Oloid tenant to your... - screenshot 1](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/image-26f01078.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=bf563e58a08046e81e136df7a4c9c861)

   ![Integrating Oloid tenant to your... - screenshot 2](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/image-7cf8bf37.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=3600d6e387866d970973bfeb20f32337)

3. Go to the newly created environment and select **Manage Environment**.

   ![Integrating Oloid tenant to your... - screenshot 3](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/4c4ba1e5-eb54-450f-9107-ed1724bdca3f-af92483c.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=15b7f52c965a1fab7bc03b9465b0fdff)

4. On the left menu panel, select **Integrations > External IdPs**.

   ![Integrating Oloid tenant to your... - screenshot 4](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/8a5158f9-2f6b-461d-9fff-7da75f002bd4-0c2c21af.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=4cc173c0e5ebe4e1fdb8d4ff3875f1e7)

   The Identity Providers page is displayed.

5. Select **+Add Provider**.

   ![Integrating Oloid tenant to your... - screenshot 5](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/52b58014-749a-4425-91ec-12c322fc2b6f-6a60eaeb.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=2e81cd6ead1835e400514b4bde4286c9)

6. Select **OpenID Connect** under Custom.

   ![Integrating Oloid tenant to your... - screenshot 6](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/2c519bd8-55a7-4735-b222-68e4dbff12d6-03da13d3.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=fc2447acdc4171cb9475b06c386cf557)

7. Do the following:
   1. Enter a unique name for the Identity Provider profile in the **NAME** field.
   2. Enter a description to help identify the purpose of this profile in the **DESCRIPTION** field.
   3. Click **Continue**.

      ![Integrating Oloid tenant to your... - screenshot 7](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/cc7c2e23-912f-45b2-99d9-f13dfa8a1cdf-19f7dffd.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=add77502ebf7d4029741a2e3970628cb)

      The Configure OpenID Connect Connection section is displayed.
   4. Enter **ClientID** and **Client Secret** provided by Oloid Admin.

      ![Integrating Oloid tenant to your... - screenshot 8](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/d00bdbdc-da34-41a0-9824-a22ab164194f-a0fffb89.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=e87532ce3a6b03fb4ae7836c458029d1)
   5. Enter **OpenID Configuration Endpoint** from Oloid Tenant Admin Portal in the **Discovery Document URI** field.

      > [!NOTE]
      >
      > **Note:** To find the **OpenID Configuration Endpoint** in the Oloid Tenant Admin Portal, go to **Auth Policies** > **Identity Provider** > select **IDP Profile** > **Meta Data** tab > **OpenID Configuration Endpoint**.

      ![Integrating Oloid tenant to your... - screenshot 9](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/d5512f46-f368-4ee2-8b66-18d5bc27be0d-ea4a75c0.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=4268960735bb942c8ff1781de122763a)

      ![Integrating Oloid tenant to your... - screenshot 10](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/b087c1e3-2a4c-46f9-8555-f40ca827477f-db57caab.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=03a5a530a34aec3e73d1daee45b3daff)
   6. Next, select **Use Discovery Document**.
      This auto-fills the remaining endpoints.

      ![Integrating Oloid tenant to your... - screenshot 11](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/1ce1f7c5-036b-4648-baf9-00d6c5f29e78-ce8956b7.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=68c26c620af2a11d3a3bff865f3dff7f)
   7. Select **Client Secret Basic** as **TOKEN ENDPOINT AUTHENTICATION METHOD**.

      ![Integrating Oloid tenant to your... - screenshot 12](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/image-df809ed5.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=45716fdd6c0cdd5bba96d32ca8ca5723)
   8. Click **Save and Continue**.

      ![Integrating Oloid tenant to your... - screenshot 13](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/78eb6cd7-12b8-40c3-a3ec-f01aa26d9427-e4afe936.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=0c89117bcd5774fa60d8775ea152858d)

      The Map Attributes section is displayed.
   9. Click **+ADD ATTRIBUTE**.

      ![Integrating Oloid tenant to your... - screenshot 14](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/b92c083a-e7cb-4259-923b-6c974e61a68c-9208e91d.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=2c8046a06dfd95b17e8c56cafca95b32)
   10. Select **Email Address** from **PINGONE USER PROFILE ATTRIBUTE** dropdown list.

       ![Integrating Oloid tenant to your... - screenshot 15](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/image-6ca072d4.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=32711913dc32aeddbfe69980ff8cbde1)
   11. Set **providerAttributes.Email** in **OIDC ATTRIBUTE** field.

       ![Integrating Oloid tenant to your... - screenshot 16](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/91efed97-dde6-4198-bcd0-0397c8fff6cf-99d0cee4.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=c071ed7472d5b006d1862f0e969c151c)
   12. Select **Empty Only** from **UPDATE CONDITION** dropdown list.

       ![Integrating Oloid tenant to your... - screenshot 17](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/f929c124-b7ac-41d5-84f5-407a2a29d180-81f1dc1b.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=642a8b5761d2294ee6764edf85d09d26)
   13. Select **Save and Finish**.

       ![Integrating Oloid tenant to your... - screenshot 18](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/78748a6d-cbf4-4674-9695-82cd3aa5ca27-791b5992.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=ed42b161a953a60b5f968881eb4d288f)

8. Enable the newly created IDP from the External IdPs list.

   ![Integrating Oloid tenant to your... - screenshot 19](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/eb0dda5a-3a0a-4c28-bf31-4664794d4651-95977573.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=401c862c5e3d7b7c36e407ec04288546)

9. Go to the **Connection** tab, copy the **CALLBACK URL,** and paste it in the Oloid Tenant Admin Portal in **Callback URL** field.

   > [!NOTE]
   >
   > **Note:** To find the **Callback URL** field in the Oloid Tenant Admin Portal, go to **Auth Policies** > **Identity Provider** > select **IDP Profile** > **IDP Settings** tab > **Callback URL**.

   ![Integrating Oloid tenant to your... - screenshot 20](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/94647849-25ad-4e3f-aabe-cafce7f496e2-b83cffe4.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=bcca9cf55f8fb99797c8304bcbe1774f)

   ![Integrating Oloid tenant to your... - screenshot 21](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/53056d81-a7a1-42de-a90b-d8c264c7c9c1-cc0dc7f4.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=b4bdff8a5cff3ca36802c08027672011)

10. Update the Authentication Policies to use the new IDP.
    1. On the left navigation menu panel, go to **Authentication** > **Policies** > **Authentication**.

       ![Integrating Oloid tenant to your... - screenshot 22](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/c1268022-6ae3-4245-91cf-95c43d9d0850-546274cb.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=4fb4c19f38180b6b497d43c0bf655b05)

       The Authentication Policies page is displayed.
    2. Select **+Add Policy** to create a new authentication policy.

       ![Integrating Oloid tenant to your... - screenshot 23](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/951713c7-dc1e-4174-b9b7-60f37f10b044-1138da61.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=b76d963ce4dd07937e2421bd8d4b6f97)

       The Policy page is displayed.
    3. Enter policy name in the **POLICY NAME** field.
    4. Under **STEP TYPE,** select **External Identity Provider** from dropdown.

       ![Integrating Oloid tenant to your... - screenshot 24](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/192e0ce1-ed0d-49b3-8f0c-562a2a58bf5d-e6348b93.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=5965f56a0859b036b6679213a9baa40a)

       The EXTERNAL IDENTITY PROVIDER section is displayed.
    5. Select the created external identity provider from the **EXTERNAL IDENTITY PROVIDER** section.

       ![Integrating Oloid tenant to your... - screenshot 25](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/fc5804b1-db13-4cca-960a-9b5c4546771f-e34e56ea.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=d61bd84185dc3a399416d4f7b71fbcce)
    6. Click **Save**.
       The policy is created successfully.

       ![Integrating Oloid tenant to your... - screenshot 26](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/b695622e-abf8-4795-a37b-132479053dde-b159c81a.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=94cfc1882667268d1fbf28816bc7a105)

11. Next, go to the left menu navigation panel and select **Applications** > **Applications**.

    ![Integrating Oloid tenant to your... - screenshot 27](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/3cb60681-58fd-4d90-bee1-7b0cdf967c8a-faccdce6.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=ed392f68a0b84bbb03e5710860ba9d59)

12. On the Application page, select **PingOne Application Portal** > copy the **Home Page URL**.

    ![Integrating Oloid tenant to your... - screenshot 28](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/ce330d19-03eb-4f79-995a-fa2d92d5420d-b6441a86.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=04ef4a285a9cd6f7ab6ac949420c22aa)

    ![Integrating Oloid tenant to your... - screenshot 29](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/e5a6b37c-ef6c-4022-aed7-bd5bdae122ec-a3176b70.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=187a8292a4ab7e358b1d3ca37d5ad512)

13. Select **Applications** from the left menu, and click the Add ![Integrating Oloid tenant to your... - screenshot 30](https://downloads.intercomcdn.com/i/o/e4gi378c/1510083718/732161c5a054e654bfbc35893bc1/image.png?expires=1790488800\&signature=a197e70bdbadf78bd1c8931185a4826527ac831f25aafe7f24caf5c3ef861637\&req=dSUmFsl2noZeUfMW3nq%2BgQY%2Fqnx1Drz9Mo13H3%2BmVDn5srpUKnQC6r5SJyA5%0AGoEvJHrlAke4rmF2KHJUX%2BB88Rs%3D%0A) icon to add a new application.

    ![Integrating Oloid tenant to your... - screenshot 31](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/b2d9b9f4-6aa8-4ec5-b9f4-0223da7ca33f-ce5788fe.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=20d146731e0ab965f101b955ef3d72b8)

    The add application page is displayed.

14. Do the following:
    1. Enter **Application Name**, then select **OIDC Web App** from Application Type.
    2. Click **Save**.

       ![Integrating Oloid tenant to your... - screenshot 32](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/0780ec6b-1661-43e2-b7d0-03d2a50dbcac-ec848f0b.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=08e6ef535c09fef05590507e6eedaff3)

       The application is created successfully.

15. Select the newly created application from the application list to edit.

    ![Integrating Oloid tenant to your... - screenshot 33](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/503dd0fb-516c-4d7c-9bfd-9f851c8759aa-8207b61b.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=631ad8067ddb65182cdd6efa1b74a4c4)

16. On the application **Profile** page, enable the app using the toggle button next to the application name.

    ![Integrating Oloid tenant to your... - screenshot 34](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/c44a54c7-6faf-4dac-9f00-3f4dd3063692-2d2a2173.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=3a7de8ddb3b7f66fea4ee00b2222bee3)

17. Paste the copied URL in the **Configuration tab** > **Redirect URL** field of the created application.

    > [!NOTE]
    >
    > **Note:** Create an application.

    ![Integrating Oloid tenant to your... - screenshot 35](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/bac122bd-a57e-4e92-b4ac-cd17ed9d5441-9170432f.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=b2646eddc9125ae6e9735679b27df6a8)

18. In the Oloid Tenant Admin Portal, go to **IDP Settings > Redirect URL** and paste the same Home Page URL in the **Redirect URL** field.

    ![Integrating Oloid tenant to your... - screenshot 36](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/5a1c03ed-272e-48c1-aba5-a96afd467b84-da4d3673.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=1da68ebf7a39bbb983ad17431ae1d0fa)

    > [!NOTE]
    >
    > **Note:** Ensure that the Redirect URL in both PingOne and the Oloid Tenant Admin Portal match exactly to enable successful authentication.

19. Select the created application.
    The application details page is displayed.

20. Go to **Resources** > edit **ALLOWED SCOPES**.

    ![Integrating Oloid tenant to your... - screenshot 37](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/cdcab448-838f-4d5a-b1d7-8077d1a27222-72b98d0d.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=015b690be1eb62baf00e4a88ae3e9d9a)

21. Select **email**, and then click **Save**.

    ![Integrating Oloid tenant to your... - screenshot 38](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/a1a8ce03-d189-4174-8087-e692fbfde3c4-e05eb30e.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=a8bf035539bace94d855f2d0ce4216fc)

22. Then, go to **Access and edit > add groups >** click **Save**.

23. Under **Policies** tab, click **+Add Policies**.

    ![Integrating Oloid tenant to your... - screenshot 39](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/60ef20fa-f3b3-48e5-8f55-e2355ad8e785-38b2b8e8.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=f087370fb655dbebd7ff6d15047d0124)

24. Select the created policy, then click **Save**.

    ![Integrating Oloid tenant to your... - screenshot 40](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/2ff6e6f5-67fc-4358-8ba8-167a876c5634-18530d39.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=0fcc022d1f0ee87582efa9b04b68ae45)

25. Under Access tab, click the edit![Integrating Oloid tenant to your... - screenshot 41](https://downloads.intercomcdn.com/i/o/e4gi378c/1493225132/22fe22458e3cf6adb8a4d3a38d11/image.png?expires=1790488800\&signature=574697ee6a01452dd015b4eee1aa85b17b016ba5ac1ee375270521848eaec9e7\&req=dSQuFct8mIBcW%2FMW3nq%2BgQpFExX7qbVUNf5N%2Fmrjs1uE0RBbhuWBn9Sp9HlX%0A9dUhYNyLeXZ3aTsHTUszRA4dgWE%3D%0A)icon.

    ![Integrating Oloid tenant to your... - screenshot 42](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/image-b8c50b27.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=d6a2d3520df371f34f01842e8c1181a1)

26. Select the created group, then click **Save**.

    > [!NOTE]
    >
    > **Note:** To create a group, go to **Directory** > **Groups**.

    ![Integrating Oloid tenant to your... - screenshot 43](https://mintcdn.com/oloid-999c42b2/VK0zXmuQ74fwF_wL/images/intercom/10796370/8f3d27e5-b6d9-483b-a7f5-150fdbd10719-a874a9a0.png?fit=max\&auto=format\&n=VK0zXmuQ74fwF_wL\&q=85\&s=18f291f0f86a79e030d3b5667bc1e5cc)

**Related Document**

[How to configure OIDC - PingOne IDP Profile](https://oloid.help/en/articles/10826464-how-to-configure-oidc-pingone-idp-profile)