Thank you for choosing Hive! This is a guide to setting up an OpenID Connect (OIDC) application on PingOne by PingIdentity to provide your employees with Single Sign-On (SSO) capabilities for Hive. This is intended for employees with admin-level permissions on your company's PingOne Organization. If your company uses PingOne for Enterprise or a different PingIdentity solution, please contact us at [email protected] for onboarding assistance.

Setting Up Your PingOne Environment

To get started setting up an OIDC integration on PingOne with Hive:

1. Login to your company's PingOne organization dashboard.

2. If you do not already have an existing PingOne environment, please complete the following steps.

   1. Under PingOne's Environments home page, click the Plus icon to create a new environment.

      
      

   2. Select Build your own solution and select PingOne SSO before clicking Next.

      

   3. Under Select how you want to deploy your services, please name your environment. Feel free to configure and change other settings according to your needs. Click Finish. You should be redirected back to the Environments home page with your newly created environment listed.

      
      

3. Click the desired PingOne environment to create the Hive Application under. This will be the environment created in step 2 or an existing environment you wish to use. Then click Manage Environment.

4. If PingOne SSO has not been added as a service to your environment, please complete the following steps (This is not applicable to people who completed step 2).

   1. Click the Plus icon under the Services section.

   2. Click the Add button for PingOne SSO and click Finish to add PingOne SSO as a new service to this environment.

      

Creating the PingOne Application

After setting up your new or existing PingOne environment with PingOne SSO capabilities, follow these steps to create an OIDC integration with Hive on PingOne:

1. Click the Applications tab on the left sidebar.

   
   

2. Click the Plus icon next to Applications to create a new application. A new window should slide in from the right. Fill in an appropriate Application Name and select the application type as OIDC Web App before clicking Save.

   
   

3. Your new application should appear in the applications list.

   
   

   Select your newly created application if not already selected and click the Configuration tab. Then, click the blue pencil icon on the right.

   
   

   Feel free to configure and change settings according to your needs. All default values should work except for one required change listed here:

   1. Initiate Login URI
      Please input https://portal-customer-api.thehive.ai/sso/oidc/code.

      
      

4. Response Type
   Please make sure Code is checked (this should already be done by default).

5. Grant Type
   Please make sure Authorization Code is checked (this should already be done by default).

6. Token Endpoint Authentication Method
   Please make sure Client Secret Basic is selected (this should already be done by default).

7. Click Save.

This completes the setup needed on PingOne for integration with Hive. However, Hive requires some additional information before SSO is fully configured.

Completing Integration with Hive

The following pieces of information found under the Overview tab of your newly-created application are needed to complete integration with Hive.

The following two pieces of information are under the General section.

• Client ID
  Use the adjacent button to copy the Client ID to your clipboard.
• Client Secret
  Use the adjacent button to copy the Client Secret to your clipboard.

The last piece of information is under the Connection Details section.

• Issuer ID
  Use the adjacent button to copy the Issue ID to your clipboard.∂

Send the Client ID, Client Secret and Issuer ID to your Hive representative. Shortly afterward, SSO with Hive will be fully set up.