Integrate with Okta

Okta doesn't provide automatic setup of SAML applications by uploading the Service Provider Meta Data. This small tutorial will guide you through the necessary steps to get Instana integrated with Okta as a SAML app.


  • You will require administrator privileges in Okta.
  • Please open the SAML configuration page in Instana as you will be copy pasting some values between there and Okta.


Creating the SAML app in Okta

  1. From the drop down on top, select the application perspective in Okta.

Okta SAML Application

  1. Click Add Application.

Okta add SAML Application

  1. To open the wizard, click Create Application.

Okta create SAML Application

  1. We are going to create a SAML 2.0 application so that's what we are going to select from the dropdown.

Okta Wizard page 1

  1. Name the application. Instana in our case.

Okta Wizard page 2

  1. Copy the ACS URL from the Instana-SAML setup page and put it in Single sign on URL
  2. Change Name ID Format to EmailAddress
  3. Change Application username to Email

Okta Wizard page 3

That's it. The final page gives us an overview of the SAML application we just created.

In this page we can now download the Identity Provider metadata.

Store it locally, switch to the Instana-SAML setup page and upload the file, thereby activating the SAML integration.

Okta Wizard page 4

Adding Users to Instana

With SAML enabled this is now the only way for your users to access Instana.

To actually enable users they have to get the SAML app assigned to them.

So open the application overview in Okta and select to assign a users from the dropdown.

NOTE: Make sure that every user has an associated eMail-address.

Each new user will receive the default role when first logging in.

Okta add user