Configuring Single Sign-On Authentication With Microsoft Entra ID

In this article, you will learn how to set up Single Sign-On (SSO) using the SAML protocol in Microsoft Entra ID (formerly known as Azure Active Directory / Azure AD). SSO is an authentication method that allows users access to multiple applications with a single account. This will allow you to onboard your users using SSO and let them access the Staffbase platform using the same credentials they use to access other platforms in your organization.

• You have an Entra ID tenant.
• You have one of the following permissions to configure provisioning in Entra ID:
  • Application Administrator
  • Cloud Application Administrator
  • Global Administrator

You need to create an enterprise application in Entra ID to set up SSO.

1. In Microsoft Azure, under Azure services, click Microsoft Entra ID.
   
2. Navigate to Enterprise applications.
3. Click New application.
4. Click Create your own application.
   The Create your own application dialog opens.
   
5. Provide a name for the application. For example, Staffbase SSO or something similar to help you instantly identify the application.
6. Select Integrate any other application you don't find in the gallery (Non-gallery).
7. Click Create.
   You have created an application to authenticate users using SSO.

After creating the enterprise application, you can decide on which Entra ID users need access to the Staffbase platform using SSO.

1. In the enterprise application you created, click Users and groups.
   
   
   

The Users and groups page opens.

2. Click Add user/group.

   

3. Click None Selected.
   The Users and groups dialog opens.

4. Search for the user or group you want to add and click Select.

   

5. Click Assign.
   You have assigned users or groups to the application.

Once you have created the application, you need to define the SAML protocol.
Learn how the Microsoft identity platform uses the SAML protocol.

1. In the enterprise application, navigate to Overview.
2. Under Set up single sign on, click Get Started.
   
3. Select SAML as the single sign-on method.
   

The Set up Single Sign-On with SAML page opens.

To continue the setup process, you will need to work closely with the Staffbase Support team. First, contact the team and inform them that you're setting up SSO with Entra ID. You will receive the information needed to proceed with the setup and have to provide them with the information listed below.

To continue setting up SSO with SAML, you need to:

You will receive the following to complete the SSO setup:

• Reply URL (Assertion Consumer Service URL): The Reply URL directs Entra ID where to send its SAML Response after authenticating a user.
• Identifier (Entity ID): The Identifier acts as a unique identifier for your Staffbase platform domain in Entra ID.

Provide the following information to Staffbase:

• App Federation Metadata Url

• Your Entra ID session lifetime

After receiving the information from Staffbase, you can complete the SSO configuration.

1. In the Set up Single Sign-On with SAML page, click Edit under Basic SAML Configuration.
   
2. Enter the Identifier (Entity ID) and Reply URL (Assertion Consumer Service URL) you received from Staffbase.

1. Under SAML Signing Certificate, click Edit.
   The Attributes & Claims page opens.
   

If you want to use a different value from the one already in place for your users in your Staffbase platform, you will need to update the user identifiers in your Staffbase platform first. In such a case, ensure that all future user management also includes these new identifiers.

2. Click Add new claim.
   The Manage claim dialog opens.

   

3. Provide a name and assign a Source attribute for the claim.

The values are auto-filled based on your enterprise application and Entra ID tenant.

The values are auto-filled based on your enterprise application and Entra ID tenant.

1. Under Test single sign-on, click Test.
2. Select a way to test sign in and click Test sign in. The sign in page opens for you to test.
3. Ensure the sign in functions as expected.

After testing the SSO authentication works as expected, you can add all users in Entra ID to the enterprise application.

1. In the enterprise application you created, click Properties.

2. Set Assignment required? to No.

   

3. Click Save.

You have configured and enable SSO for your Staffbase platform.

• Microsoft Entra ID Single Sign-On SAML protocol
• How the Microsoft identity platform uses the SAML protocol
• Microsoft Entra ID: Customize claims issued in the SAML token for enterprise applications
• Microsoft Entra ID: Problems signing in to SAML-based single sign-on configured apps