Teaminal logo Teaminal logo

Okta Setup

Step 1: Create SAML Integration

Start off by signing into your Okta admin panel.

Click “Create App Integration” from your Okta Application dashboard.

Click “Create New App”.

Select “SAML 2.0” as a Sign on method, then click “Next”.

Enter an “Teaminal” for the app name. If you’d like to add the Teaminal logo, you can grab that here. Click “Next” to continue.

On this step you’ll need to get some values from Teaminal’s organization settings page.

Copy the “Assertion Consumer URL” field from Teaminal into the “Single Sign on URL” field in Okta.

Copy the “Metadata URL” field from Teaminal into the “Audience URI (SP Entity ID)” field in Okta.

Step 2: Configure Attribute Statements

Continue scrolling to the Attribute Statements configuration.

Fill in the Attribute Statements as seen above and click “Next”.

Step 3: Submit Application Feedback

Select “I’m an Okta customer adding an internal app” from the options menu.

Complete the form with any comments and select “Finish”.

Step 4: Add Users to SAML App

In order to test out SSO authentication, you will first need to assign your Okta SAML app to Groups.

Click on the “Assignments” tab of the app and then select “Assign to Groups”.

Find the Group(s) that you would like to assign to the app and click “Assign” next to it. Click “Done” when you’re finished.

Step 5: Save Metadata URL to Teaminal

The final step for implementing SAML SSO requires sharing your identity provider’s metadata with the application.

  1. Click on the “Sign On” tab of the SAML app you just created.
  2. Click the “Identity Provider metadata” link below the View Setup Instructions button.
  3. A separate tab will open. Copy the link and paste it into the organization settings page of Teaminal.

You should now be able to log out of Teaminal and log back in with Okta. If you have any issues, get in touch.