Insomnia logo
  • Documentation
  • Get Started for Free
    • Introduction to Insomnia
    • Install Insomnia
    • Send Your First Request
    • Import and Export Data
    • Environment Variables
    • Insomnia Accounts
    • Forgotten Passphrase
    • Organizations
    • Enable Enterprise membership
    • Configuring EE SSO
    • Integrating Insomnia Enterprise with Okta SAML 2.0
    • Integrating Insomnia Enterprise with Microsoft Azure/Entra ID SAML 2.0
    • Insomnia Whitelisting Guide for Enterprise Users
    • Insomnia Subscriptions
    • Insomnia Subscription Management
    • Scratch Pad Tutorial
    • Requests
    • Responses
    • Request Collections
    • Request Timeouts
    • Chaining Requests
    • Post CSV Data
    • SOAP Requests
    • gRPC
    • WebSocket Support
    • Get Started with Documents
    • Design Documents
    • Linting
    • GraphQL for OpenAPI
    • Migrate from Designer
    • Unit Testing
    • Stress Testing
    • Insomnia Storage Options Guide
    • Sync with Insomnia Cloud
    • Sync with Git
    • Key Security Features
    • Security Standards
    • Signup and Authentication
    • Analytics Collected
    • End to End Data Encryption
    • Authentication
    • Client Certificates
    • Generate Code Snippet
    • Cookie Management
    • Encoding
    • GraphQL Queries
    • Run in Insomnia Button
    • Key Maps
    • Proxy
    • Introduction to Plugins
    • Context Object Reference
    • Template Tags
    • Hooks and Actions
    • Custom Themes
    • FAQ
    • Application Data
    • SSL Validation
    • Password Recovery
    • Introduction to Inso CLI
    • Install Inso CLI
    • CLI Command Reference
      • inso generate config
      • inso run test
      • inso lint spec
      • inso export spec
      • inso script
      • OpenAPI Spec Reference
      • Using Custom Linting with Inso CLI
    • Configuration
    • Inso CLI on Docker
    • Continuous Integration
    • Kong Declarative Config (for decK)
    • Kong for Kubernetes
    • Insomnia Pre-request Script Overview
    • Insomnia API Mocking Overview

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.

Edit this page
Report an issue
    COMPANY
  • Insomnia
  • Blog
  • Changelog
  • Pricing
  • Careers
    PRODUCTS
  • Insomnia
  • Inso (CLI)
    RESOURCES
  • Sign In
  • Documentation
  • Support
    LEGAL
  • Privacy Policy
  • Terms & Conditions
© Kong Inc. 2021