SAML SSO with Microsoft Entra ID (Azure AD)

Here's a guide to get started with SAML SSO with Microsoft Entra ID for your Soulanma workspace, but for the easiest setup experience, use the pre-built Soulanma integration in the Entra ID.

If you prefer to set things up manually, here are a few things to keep in mind:

Note: SAML SSO is only available on our Business and Enterprise plans. You must be an admin to enable SAML SSO

Soulanma also supports SCIM Provisioning with Microsoft Entra ID.

  • The “Reply URL” value can be found in your Soulanma Workspace settings under “ACS URL”
  • The “User Attributes & Claims” must be without namespace, and the capitalization is important

Example of a complete, working SAML setup:

Listing of all claims/attributes:

Example of how to remove the Namespace URI for a claim:

After SAML SSO is configured, you can go back to your Soulanma Workspace settings and adjust two more things:

  • Default user role: Soulanma supports JIT (Just-in-time) account provisioning. That means that Soulanma will create an account for a user authenticating via SAML if necessary. New users will be created with the role and permissions you choose:
    • Editors - paid role with full ability to create and edit content
    • Viewers - free role with read and comment-only limited permissions
  • Require SAML for login: You can enable this optional setting if you want to prevent users from accessing your workspace with other means of authentication, such as a password or via Google SSO.

There are some attributes that are the same for all identity providers:

Soulanma uses the e-mail address of the SAML user to identify them on Soulanma. This will come up with configuration options like Name ID Format or Name ID. When in doubt, try to choose the option that will return the user's e-mail.

Important: If you have updated your workspace key, the login URL will change to match. The ACS URL will not.

If you've configured your SAML login to use the login URL, you must update it for SAML to work.

Written by:

  • Darta

    Darta