Integrating Insomnia Enterprise with Microsoft Azure/Entra ID SAML 2.0

This guide provides instructions for setting up Single Sign-On (SSO) for Insomnia Enterprise using Azure’s Microsoft Entra SAML integration, ensuring secure and efficient user authentication.

Configuring Insomnia Enterprise

  • Access Enterprise Controls: In Insomnia, navigate to “Enterprise Controls.”
  • Create SSO Connection: Click to create a new SSO Connection.
  • SSO Configuration: Set up your company domain in Insomnia and keep the page open to transfer details between Insomnia and Azure.

Setting up Azure Integration

  1. Access Azure Portal: Open a separate page and go to your Azure Portal.
  2. Navigate to Enterprise Applications: Go to Microsoft Entra ID > Enterprise Applications.

  3. Add New Application: In the Microsoft Entra Gallery, select “Microsoft Entra SAML Toolkit.”

    microsoft entra gallery

  4. Configure Application: Rename the toolkit (e.g., “Insomnia”) and press “Create.”

    microsoft entra toolkit

  5. Edit Single-Sign-On Properties: Access the Single-Sign-On properties for further configuration.

    microsoft entra saml start

Configuring SAML Settings

  1. Basic SAML Configuration: Copy the “Audience Restriction” field from Insomnia into a new Azure’s Identifier field.

    microsoft entra saml identity id

  2. Setting Reply and Sign-On URLs: Copy the SSO URL from Insomnia into both the Reply URL and the Sign-On URL in Azure. Note: the copied SSO URL is the same for both fields on Azure.

    insomnia copy microsoft entra saml into org config

    microsoft entra saml add sign on url

    microsoft entra saml reply url

  3. Attributes and Claims: Create an email attribute in Azure that points to user.mail.

    microsoft entra saml add email attribute

  4. Login URL Transfer: Copy the Login URL from Azure into Insomnia.

    microsoft entra saml copy login url.jpg

  5. Import Signing Certificate: Transfer the base64 version of the Signing certificate from Azure to Insomnia.

    microsoft entra saml signing certificate

Finalizing User Setup

  1. Assign Users in Azure/Entra: Assign users to the Enterprise application in Azure.

    microsoft entra assign users

  2. Invite Users in Insomnia: Invite the same users to your organization in Insomnia.

    insomnia enterprise sso invite user

Completion

Once these steps are completed, users receiving invites and signing up/logging in via Azure SSO will securely access Insomnia Enterprise.

microsoft insomnia login example

This process ensures a streamlined integration between Insomnia Enterprise and Azure Microsoft Entra SAML for effective SSO implementation.

© Kong Inc. 2021