Skip to main content

Okta Integration

  • Updated

Contents

Note: Okta integration is a paid feature that are only included in our Enterprise package. Organizers interested in Okta integration with Growth or Premier packages should reach out to their CSM to discuss their options.

SAML App Integration

Creating a New App Integration

Okta_SALMIntegration_Step_1.gif

  1. From the Admin page, select Applications link from the left Navigation bar. Once you have been redirected, select the Create App Integration button at the top of the page.
  2. A window will appear. Select SAML 2.0 from the list of sign-in methods, then click the Next button.

General Settings

Okta_SALMIntegration_Step_2_Updated.gif

  1. Enter Goldcast Admin App (SAML 2.0) into the App Name field. This will be your base app integration and should not be accessed by users. Instructions for restricting access to this application will be reviewed in a later section of this document. 
  2. If you would like, you may also upload the Goldcast Logo to the App logo field.
  3. Select the Next button to continue.

Configure SAML

The Configure SAML settings page is where you will enter the information needed to connect your Okta account with the Goldcast platform, please review these instructions carefully to ensure a smooth integration process.

SAML Settings

Okta_SALMIntegration_Step_3.gif

  1. Enter the following URL into the Single sign on URL field:
https://goldcast-prod.auth.us-east-1.amazoncognito.com/saml2/idpresponse
  1. Next, enter the following ID into the Audience URI (SP Entity ID) field:
urn:amazon:cognito:sp:us-east-1_YAo6iviMt

Attributes Statements

Scroll to the Attributes Statements section of the page.Okta_SALMIntegration_Step_4.gif

  1. Enter the URL below into the Name field:
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress
  1. And the following string into the Value field:
user.email
  1. Once you have finished, select the Next button at the bottom of the page.

Feedback

Okta_SAMLIntegration_Step_5_Updated.gif

  1. On the Feedback page, select the I'm an Okta customer adding an internal app option then click the Finish button.

Identity Provider Metadata Hyperlink

After you have finished setting up your app, you will be redirected to its profile. This is where you will find the Identity Provider metadata URL needed to begin setting up your Single Sign On (SSO) Integration. You will need to email this URL to Goldcast Support.

Once the team has received this URL, you will be provided with the URL you will use for your SSO Integration.

Please review the instructions below for retrieving this URL.

Okta_SAMLIntegration_Step_6_Updated.gif

  1. Select the Sign On tab at the top of the page.
  2. Locate the Identity Provider metadata URL and right-click to copy it.

Instructions for setting up your SSO integration can be found in the next section of this document.

SSO App Integration

Creating a Bookmark App

Okta_BookmarkApp_Step_1_Updated.gif

  1. From the Admin page, select Applications link from the left Navigation bar. Once you have been redirected, select the Browse App Catalog button at the top of the page.
  2. In the Search field, enter Bookmark App and select it from the dropdown.

Okta_BookmarkApp_Step_2.gif

  1. Enter Goldcast Admin App into the Application label field and the URL provided to you by the Goldcast Support team into the URL field.
  2. Select the Done button to complete the setup process.

Uploading a Bookmark App Logo

Once you have completed the setup process, you will be redirected to the Profile page for your Bookmark app.

Okta_Bookmark_EditLogo.gif

  1. Select the edit icon in the logo field and upload the following Goldcast icon.

Disable SAML Application Visibility

The SAML application's primary function is to carry out processes that allow the Bookmark application to operate. Users will only be able to access the Goldcast platform through the Bookmark app.

To avoid confusion during the sign-in process, we strongly recommend removing the SAML application icon from your user's dashboards.

Please review the instructions below for disabling this icon:

Okta_SAMLIntegration_Step_2-2.gif

  1. Select the General tab at the top of the application's Profile page.
  2. Click the Edit button on the App Settings menu to begin making updates.
  3. Under the Application Visibility parameter, select the Do not display application icon to users checkbox.
  4. Click the Save button to complete this update.

Final Steps

Now that you have set up your SAML and Bookmark app, you will need to assign all necessary users to both apps.

Okta_AssignUsers.gif

Once they have been assigned, instruct your users to click on the Bookmark app from their Dashboard to log in.

Okta_BookmarkApp_Dashboard_Updated.png

 

Related articles