> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sevalla.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Microsoft Entra SAML SSO
> Learn how to set up SAML SSO in Sevalla with Microsoft Entra.
[Microsoft Entra](https://entra.microsoft.com/) (formerly Azure) is an Identity Provider (IdP) that enables secure single sign-on (SSO), allowing your company's users to access multiple applications with one login.
With Security Assertion Markup Language (SAML) SSO, employees sign in once using their company credentials (typically email and password). The IdP, such as Microsoft Entra, verifies their identity and grants seamless, secure access to all connected services, without requiring separate logins for each application.
Company owners or IT administrators can link their organization’s email domain (e.g., @[mycompany.com](http://mycompany.com)) to the IdP so that anyone with a company email address is automatically recognized and can securely sign in to SAML-enabled tools.
Using Sevalla SAML SSO, you can connect Microsoft Entra to Sevalla by creating a SAML application within Microsoft Entra, verifying your company’s email domain, and adding the required Microsoft Entra details in Sevalla. This allows your team to log in with their existing company credentials, eliminating the need to create or manage separate Sevalla accounts.
When using SAML SSO with Sevalla, login must always be initiated from Sevalla. Logging in directly from your Identity Provider (IdP) is not supported.
IdPs only support one active session per browser. If you have multiple Google Workspace accounts and are logged into one, attempting to log into another through Sevalla will result in an error. To switch accounts, log out of Google Workspace or use your browser’s Incognito/Private mode.
## Enable SSO in Sevalla
When you set up SAML SSO, you can navigate away from the SSO setup at any stage to store your progress and return later.
In Sevalla, go to your **Company settings** > **Single sign-on**, and click **Enable**.
Read through the introduction, which explains how SSO will be set up, and click **Continue**.
The next page provides all the information you need to set up your SAML app within Microsoft Entra.
## Set up the app integration in Microsoft Entra
In Sevalla, the **Create SAML app** tab provides all the information you need to set up your SAML app within Microsoft Entra. The following steps explain where to add this information.
When using SAML SSO with Sevalla, all logins must be initiated directly from Sevalla. Logging in from your Identity Provider (IdP) dashboard is not supported. For this reason, you may want to hide the Sevalla app from users’ IdP dashboards to avoid confusion.
Log in to Microsoft Entra as a user with admin access, and within the Microsoft Entra admin center, click **Entra ID** > **Enterprise applications** > **New application**.
Click **Create your own application**, enter a name for your application, for example, Sevalla Dashboard, and click **Create**.
Once the application is created, click **Single sign-on** and select **SAML**.
Within **Basic SAML Configuration**, click **Edit**.
Complete the **Basic SAML Configuration** in Microsoft Entra as follows:
* **Identifier (Entity ID):** Click **Add identifier** and then copy and paste the **Entity ID** from Sevalla.
* **Reply URL (Assertion Consumer Service URL):** Click **Add reply URL** and then copy and paste the **SSO/ACS URL** from Sevalla.
* **Sign on URL:** Copy and paste the **Start URL** from Sevalla.
Leave all other fields as default and click **Save**.
## Map your Microsoft Entra attributes
Within Microsoft Entra, you must map the firstName, lastName, and email attributes from Sevalla to the correct fields within Microsoft Entra. For more information about how to do this, refer to the [Microsoft Entra documentation](https://learn.microsoft.com/en-us/entra/identity-platform/saml-claims-customization).
## Assign users to the Microsoft Entra app
In Microsoft Entra, go to **Enterprise apps**, select the application you set up for the Sevalla Dashboard, click **Users and groups**, and then click **Add user/group**.
Click **None selected**, select the users or groups you want to grant Sevalla access via SSO, and then click **Select**.
Click **Assign** and then click **Assign to People**. If you have your users set up in groups, click **Assign to Groups**. Click **Assign** on each user or group you want to assign to the Sevalla SAML SSO application and then click **Done**.
To test authentication, make sure the Sevalla user account you’re signed in with is assigned.
## Sevalla setup
In Sevalla, on **Create SAML app**, click **Continue** so that you are on the **Sevalla setup** page.
### Email domain
In the **Domain name**, enter the email domain users will use to sign in using SAML SSO, and click **Add domain**.
Only Sevalla accounts with an email address matching the verified domain can authenticate via SAML. For example, if SAML is enabled for `example.com`, only users with an `@example.com` email address will be able to sign in for that company.
Each email address can only be linked to one SAML configuration in Sevalla. This means a domain (e.g., `example.com`) can be associated with only one company at a time. Similarly, each Sevalla user can use SAML authentication for a single company only.
If the domain has already been verified in Sevalla through DNS management or as a site domain, it will automatically be verified. If it hasn’t, you’ll be prompted to add a TXT record to your DNS management service to confirm domain ownership.
Because DNS changes can take time to propagate, you can navigate away from the SSO setup to store your progress and return later.
#### Set up Sevalla SAML
In Microsoft Entra, go to **Enterprise apps**, select the application you set up for the Sevalla Dashboard, and click **Single sign-on**.
In Sevalla, within the Single sign-on **Sevalla setup** tab, complete the fields as follows:
* **SSO URL:** Copy and paste the **Login URL** from the **Set up Sevalla Dashboard** section in Microsoft Entra.
* **Entity ID:** Copy and paste the **Microsoft Entra Identifier** from the **Set up Sevalla Dashboard** section in Microsoft Entra.
* **Public certificate:** In Microsoft Entra, within **SAML Certificates**, click **Download** on **Certificate (Base64)**. Open this file in any text editor, and copy and paste the contents into Sevalla.
Certificates can expire, so you may need to update this in the future. Company Owners and Company Administrators will receive a notification three weeks prior to certificate expiration to ensure the certificate is updated in a timely manner.
Click **Continue**.
## Test the authentication in Sevalla
You cannot enable SAML SSO within Sevalla without first testing the authentication.
In Sevalla, within Single sign-on, click **Continue** until you are on the **Test and finish** tab, and click **Test authentication**.
A notification appears if the test was successful or if the test fails.
If the test fails, click **Back** and check your SAML settings within your IdP and within Sevalla.
If the test is successful and you want to enable SAML, click **Save and set SSO live**.
Your Sevalla company users will now be able to sign in with SAML SSO or by entering their username and password. Users who sign in through an IdP are not required to complete Sevalla's 2FA, as authentication is handled directly by the IdP.
If you want to force users to sign on via SAML, you can enable Mandatory SSO and add Exceptions. You can also enable JIT provisioning to allow users authorized by your IdP to access your Sevalla company without requiring an invitation.
## Change the session duration
Your Identity Provider (IdP) determines how long your SSO session remains active and when it expires. If your IdP doesn’t specify a session duration, Sevalla defaults to a 24-hour session.
When your SSO session expires, you’ll be logged out of SSO. If you’re working within a company that uses SSO, you’ll be prompted to reauthenticate. If you have access to multiple companies in Sevalla, you’ll remain logged in overall but will need to reauthenticate before accessing any company that requires SSO.
For details on adjusting session duration, refer to the [Microsoft Entra Documentation](https://learn.microsoft.com/en-us/entra/identity/conditional-access/howto-conditional-access-session-lifetime).