Configure Okta SAML SSO in Insomnia

Before you can configure the SSO connection in Okta, you must start configuring the SSO settings in Insomnia so you have access to the single-sign on URL and audience URI for the Okta settings.

1. In your Insomnia account settings, click your account at the top right and select Enterprise Controls from the dropdown.
2. Click SSO in the sidebar and then click Create Connection.
3. In the SSO settings, enter your company’s domain.

Keep this window open while you configure the settings in Okta.

Now that you have the single-sign on URL and audience URI from Insomnia, you can create a new app integration in Okta.

1. Create a new app integration in Okta.
2. For the Sign-in method, select SAML 2.0.
3. Configure the general settings as needed.

4. Configure the following app SAML settings:

   Okta setting	Value
   Single sign-on URL	Copy this from the SSO settings in Insomnia.
   Audience URI (SP Entity ID)	Copy this from the SSO settings in Insomnia.
   Name ID format	EmailAddress
   Application username	Email
   Update application username on	Create and update

5. In the Attribute Statements, add the following attribute:

   Name	Name format	Value
   email	Unspecified	user.email

6. Save the new application.
7. In the application Sign On page, find and copy the Sign on URL. This will be used for the sign on URL in Insomnia.
8. Create a signing certificate for your app and copy the certificate. This will be used in the Insomnia SSO settings.

Now that Okta SSO is configured and you have the sign on URL and certificate from Okta, you can finish configuring the SSO settings in Insomnia.

1. In the Insomnia SSO settings, enter the sign on URL and signing certificate from Okta.
2. To verify the connection, click Create connection. If the connection is successful, you will get a message that says “Your SAML connection has been successfully updated.”

You can add users or groups to the application in Okta. They won’t be allowed to log in with SSO yet though.

In Okta, assign users or groups to the app integration.

Now that users or groups are assigned to the app in Okta, you can start inviting users to Insomnia. Once they accept the invite, they can log in to Insomnia with SSO.

1. In your Insomnia account settings, click your account at the top right and select Your organizations.
2. Click the organization you configured SSO for.
3. Enter the emails of the users you added to the Okta app and click Invite.