buoyant.io

Configuring SSO with Okta

Requirements

  • A user with an Admin role in Okta Portal. If you do not have this role, please reach out to an Okta Portal Admin within your organization to configure the integration.

Installation

  1. Log into the Okta Developer Console.
  2. Expand Applications from the sidebar and select Applications.
  3. Click Create App Integration.
  4. Select SAML 2.0 and click Next.
  5. Enter the general information for the integration, then click Next.
  6. Use the following values for the configuration:
  • Single Sign-On URL: https://accounts.buoyant.io/login/callback?connection=<org>
  • Audience URI (SP Entity ID): urn:auth0:buoyant:<org>
  • Additionally, add an attribute statement with the name name and the value user.displayName.
    Okta configuration

  1. Click Next, then Finish.

  2. Once completed, you will be able to access both the Identity Provider Single Sign-On URL and the X.509 certificate.

    SSO configuration

  3. Share these values with the Buoyant Team, who will then proceed with the configuration of the Portal.

Create a Bookmark URL Tile in Your Okta Dashboard

We recommend creating a Bookmark URL tile in your Okta dashboard for your users to make the login process easier:

  1. Navigate to Applications > Applications.
  2. Click Browse App Catalog.
  3. Click Bookmark App > Add Integration.
  4. Application Name: Buoyant Cloud
  5. URL: The login URL our team provides upon integration confirmation (e.g., https://buoyant.cloud/login?connection=<org>).

Uninstall

To uninstall the application from the Okta portal, follow these steps:

  1. Log into the Okta Developer Console.
  2. Navigate to Applications > Applications.
  3. Find the Buoyant Cloud application in the list and click on it.
  4. Click on the Delete button at the top of the application details page.
  5. Confirm the deletion when prompted.

This will remove the Buoyant Cloud application and any associated configurations from your Okta environment.