---
title: Setting up ZEN Master Azure SSO
slug: zen-master/setting-up-zen-master-azure-sso
createdAt: 2024-12-10T16:20:01.815Z
---

This section includes instructions on how to register ZEN Master as an SSO app on Azure and configure the connection between ZEN Master and Azure. To complete this process, you need to login as an Admin on both the Azure side and the ZEN  Master side. It is, therefore, recommended to have both open in parallel.

:::hint{type="info"}
Note: if you have already registered ZEN Master as an app in Azure, you can skip this.
:::



**To setup ZEN Master Azure SSO:**

::::WorkflowBlock
:::WorkflowBlockItem
In **Azure**, go to **Identity > Azure Active Directory > App Registrations**.
:::

:::WorkflowBlockItem
Click **New Registrations**.

::Image[]{src="https://api.archbee.com/api/optimize/mzxtTQEvCNIdUNgF2kuwJ/3bPTuMFssIdKUedXkp0lR_image.png" size="90" width="812" height="250" position="center" showCaption="false"}
:::

:::WorkflowBlockItem
In the **Name** field, enter a name for the SSO app. This name will be displayed to the users when they use Azure as an SSO portal. For example, "ZEN Master SSO".
:::

:::WorkflowBlockItem
Under **Supported account types**, specify who can access the ZEN Master SSO app. In this case, it is recommended to select the **Account in this organizational directory** option.
:::

:::WorkflowBlockItem
In **ZEN Master**, go to **Account Management > Single Sign-On**.
:::

:::WorkflowBlockItem
Click **+Add**.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/mzxtTQEvCNIdUNgF2kuwJ/h5rVHNL48V-bU2Vi_KaxO_image.png" size="90" width="1705" height="236" position="center" showCaption="false"}
:::

:::WorkflowBlockItem
In the **Name** field, enter a name for this SSO connection. This is the name that will be displayed on the Azure button in the ZEN Master **Sign In** portal. 
:::

:::WorkflowBlockItem
At the bottom of the screen, copy the **Callback URL**.

::Image[]{src="https://api.archbee.com/api/optimize/amUtKWPrNQCS-26DKyGuI-8E30jzHUpYQM8sWws7peu-20250228-161932.png" size="80" width="1448" height="1410" position="center" alt="Create Single Sign-on screen" showCaption="false"}
:::

:::WorkflowBlockItem
Back in **Azure**, paste the copied **Callback URL** into the **Redirect URI** field.

::Image[]{src="https://api.archbee.com/api/optimize/mzxtTQEvCNIdUNgF2kuwJ/1jbX1iew8EB4pWC6AQ2oq_image.png" size="90" width="853" height="458" position="center" showCaption="false"}
:::

:::WorkflowBlockItem
Click **Register**.&#x20;

The following screen is displayed with the connection strings.

::Image[]{src="https://api.archbee.com/api/optimize/mzxtTQEvCNIdUNgF2kuwJ/lQ9vGzX7T6EOvZe0KeIH8_image.png" size="90" width="1325" height="652" position="center" showCaption="false"}
:::

:::WorkflowBlockItem
Copy the **Application (client) ID** from **Azure** and paste it to the **Client ID** field in **ZEN Master**.
:::

:::WorkflowBlockItem
In **Azure** click **Endpoints&#x20;**&#x61;t the top.

::Image[]{src="https://api.archbee.com/api/optimize/mzxtTQEvCNIdUNgF2kuwJ/5vsX2r0i0mAbDWm3sfj0p_image.png" size="90" width="1162" height="258" position="center" showCaption="false"}
:::

:::WorkflowBlockItem
In **Azure**, go to **Certificates & secrets**.
:::

:::WorkflowBlockItem
Under **Client Secrets**, click **New Client Secret**.

::Image[]{src="https://api.archbee.com/api/optimize/mzxtTQEvCNIdUNgF2kuwJ/nEX4a5kwsjlk2CcdIBvD6_image.png" size="90" width="1017" height="628" position="center" showCaption="false"}


:::

:::WorkflowBlockItem
In the **Description** field, enter any name for the client secret. For example, "ZEN Master".&#x20;
:::

:::WorkflowBlockItem
Under **Expires**, select the desired expiration time.&#x20;
:::

:::WorkflowBlockItem
Click **Add**.&#x20;
:::

:::WorkflowBlockItem
Copy the secret by clicking the **Copy** button.

![](https://api.archbee.com/api/optimize/mzxtTQEvCNIdUNgF2kuwJ/BoxjU4ZStILnGIG9TGu1W_image.png)
:::

:::WorkflowBlockItem
In **ZEN Master**, paste the copied secret into the **Client Secret** field.
:::

:::WorkflowBlockItem
If you plan to manually register Azure AD users to ZEN Master (see [Pre-registering Users in ZEN Master for Azure](https://docs.zixi.com/zen-master/pre-registering-users-in-zen-master-for-azure)) before granting access, select the **Allow pre-registered users only** checkbox. The registration is simple and only involves entering the user's email.
:::

:::WorkflowBlockItem
If you want group information about a user to be sent to ZEN Master when the user logs in, select the **Request groups in single sign-on** checkbox. See [Setting up Groups and Roles](https://docs.zixi.com/zen-master/setting-up-groups-and-roles).
:::

:::WorkflowBlockItem
If you want to sync group information about a user to be sent to ZEN Master when the user logs in, select the **Sync single sign-on groups** checkbox. See [Setting up Groups and Roles](https://docs.zixi.com/zen-master/setting-up-groups-and-roles).
:::

:::WorkflowBlockItem
If you want to sync single sign-on roles r when the user logs in, select the **Sync single sign-on roles** checkbox. See [Setting up Groups and Roles](https://docs.zixi.com/zen-master/setting-up-groups-and-roles).
:::

:::WorkflowBlockItem
In **ZEN Master**, click **Save**.&#x20;

The newly created Azure SSO is added to the list of SSO profiles. The users defined in the Azure AD will be able to connect to ZEN Master by selecting the newly created SSO option under **Sign In With**. During the first connection you will be required to provide permission to connect through Azure to ZEN Master. As an administrator, you can select **Consent on behalf of your organization** option, which will not require additional consent by the other users.

::Image[]{src="https://api.archbee.com/api/optimize/mzxtTQEvCNIdUNgF2kuwJ/KKDDc_xCnY0KxMv3urg8H_image.png" size="60" width="360" height="277" position="center" showCaption="false"}

However, if you have selected the **Allow pre-registered users only&#x20;**&#x6F;ption you will need to manually pre-register the users by following the instructions in [Pre-registering Users in ZEN Master for Azure](https://docs.zixi.com/zen-master/pre-registering-users-in-zen-master-for-azure).
:::
::::



