Thank you for choosing Hive! This is a guide to setting up a Security Assertion Markup Language 2.0 (SAML 2.0) application on Okta 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 Okta organization tasked with managing employees' access to Hive.

Creating the Okta Application

To get started setting up a SAML integration on Okta with Hive:

1. Login to your company's Okta Admin Console.

2. Navigate to the Applications tab on the left sidebar.

   
   

3. Click on Create App Integration.

4. A pop-up window should appear. For Sign-in method, select SAML 2.0 and click Next.

   
   

5. A three-part setup screen should appear. Nothing is required by Hive under General Settings. Feel free to name your application whatever you like. This will be what your employees will see on their application dashboards. When everything has been properly configured, click Next.

6. A new screen called Configure SAML should load, allowing you to configure multiple attributes of the new application. Feel free to configure and change settings according to your needs. All default values should work except for a few required attribute changes listed here:

   1. Single sign-on URL

      1. Please input https://portal-customer-api.thehive.ai/sso/saml/acs.
      2. Please make sure the checkbox next to Use this for Recipient URL and Destination URL is checked.

   2. Audience URI (SP Entity ID)
      Please input hive.

   3. Name ID format
      Please leave the dropdown value as Unspecified (this should already be done by default).

      
      

7. Click Next. A final Feedback screen should appear. Click Finish. The application should now be created.

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

Completing Integration with Hive

The Metadata URL is the last piece of information needed by Hive to complete SSO integration. Here are the steps to find this:

1. After creating your application above, Okta should automatically direct you to the application's settings page. If you are not redirected, navigate to this page by clicking the Applications tab on the left sidebar and then clicking on your newly-created application.

2. Navigate to the Sign On tab of your application.

3. Under Settings and SAML 2.0, a Metadata URL should be displayed alongside a button you can use to copy the value to your clipboard.

   
   

Send the Metadata URL to your Hive representative. Shortly afterward, SSO with Hive will be fully set up.