If you want to configure and manage an Azure app on your own, you’ll need to create a custom app in the Azure portal. Follow the steps below to create your custom app:

In this article:

• Creating a Custom App in Azure
• Retrieving the Client Credentials for Microsoft Connections
• Adding the Redirect URI to a Custom Microsoft 365 Connection

Prerequisite

• You are an Azure Global Admin

Creating a Custom App in Azure

1. In your Azure Portal, navigate to Microsoft Entra ID > App registrations.
2. Click + New registration.
   
   
3. Provide a name for the app.
4. Select Accounts in any organizational directory (Any Azure AD directory - Multitenant) for the account type.
5. Click Register.
   The app is created and the details are displayed.

Retrieving the Client Credentials for Microsoft Connections

You need both the Client ID and Client Secret for your custom Microsoft app to successfully configure a custom Microsoft connection in the Staffbase platform.

Retrieving the Azure App Client ID for Your Custom Microsoft App

1. In your Azure Portal, navigate to Microsoft Entra ID > App registrations.
2. Choose the app you have created for your Microsoft Connection.
3. Copy the Application(client) ID to your clipboard.
   
   
4. Paste the Client ID to the Azure App Client ID field of the Microsoft Connection dialog in the Staffbase Studio.

Creating the Azure App Client Secret

1. In your Azure Portal, navigate to Microsoft Entra ID > App registrations.
2. Choose the app you have created for your Microsoft Connection.
3. Click Add a certificate or secret for Client credentials.
   
   
   
   The Certificates & secrets page opens.
4. Click + New client secret.
   
   
5. Provide a description and expiration date.
   
   
   
   
   The Microsoft Connection has to be renewed in Azure after the expiration of the client secret.
6. Click Add.
7. Copy the value to the clipboard.
   
   
8. Paste the secret ID into the field Azure App Client Secret in the Microsoft Connection dialog in the Staffbase Studio.

Adding the Staffbase Redirect URI to Microsoft Azure App

Your employee app or intranet needs to be connected to the custom Azure app you created. You need to add the Staffbase redirect URI to the custom Azure app.

Prerequisites

• You have created a custom Azure app.
• You have configured the Microsoft connection in the Studio using the custom Azure app.
• You know where your Staffbase platform is hosted. Read this article to learn more.

1. In the Microsoft Entra ID (formerly Microsoft Azure Active Directory), navigate to App registrations.
2. In your registered app, click Add a Redirect URI.
3. Click Add a platform.
4. Choose Web.
   The dialog to configure web application URIs opens
5. Paste the appropriate Redirect URI to the Redirect URIs field based on your setup.
   
   
   • Default Azure App:
     Based on your hosting architecture: If your Staffbase platform is using the
     • US hosting infrastructure:
       https://backend-us1.staffbase.com/api/integrations/auth/ms365/callback 
     • German hosting infrastructure:
       https://backend-de1.staffbase.com/api/integrations/auth/ms365/callback
   • Custom Azure App: 
     https://{your_app_domain}/api/integrations/auth/ms365/callback
6. Click Configure.
7. Click Save.
   This confirms the configured redirect URI.

You have added the Redirect URI to your custom Azure App. Now your users can sign in to Microsoft 365 from your Staffbase platform.