---
title: "SSO Configuration: Microsoft Azure Active Directory"
description: This article will walk through how to set up Casebook Single Sign On with Microsoft Azure Active Directory.
---

[Skip to content](https://gohub.casebook.net/knowledge/sso-configuration-microsoft-azure-active-directory#main-content)

[More support](https://gohub.casebook.net/knowledge/kb-tickets/new)

[![logo-raspberry (1)](https://gohub.casebook.net/hs-fs/hubfs/logo-raspberry%20(1).png?width=1286&height=255&name=logo-raspberry%20(1).png)](https://gohub.casebook.net/)

- [Knowledge Base](https://gohub.casebook.net/knowledge)
- [Video Library](https://gohub.casebook.net/video-library)
- [Still Need Help?](https://gohub.casebook.net/knowledge/kb-tickets/new)

Open main navigation

Close main navigation

- [Knowledge Base](https://gohub.casebook.net/knowledge)
- [Video Library](https://gohub.casebook.net/video-library)
- [Still Need Help?](https://gohub.casebook.net/knowledge/kb-tickets/new)
- [More support](https://gohub.casebook.net/knowledge/kb-tickets/new)

 Hi. How can we help?

- There are no suggestions because the search field is empty.

1. [Knowledge Base](https://gohub.casebook.net/knowledge)
2. [Admin](https://gohub.casebook.net/knowledge/admin)
3. [Casebook Security](https://gohub.casebook.net/knowledge/admin#casebook-security)

# SSO Configuration: Microsoft Azure Active Directory

## This article will walk through how to set up Casebook Single Sign On with Microsoft Azure Active Directory.

### Step 1: Add Casebook as an enterprise application in Azure AD

In this step, you will add Casebook as an application in Azure AD to establish a trust relationship between the applications.

#### To add a new application in Azure AD

1. Log in to the Azure Portal.
2. In the **Azure Services** section, choose **Azure Active Directory**.
3. In the left sidebar, choose **Enterprise applications**.
4. Choose **New application**.
5. On the **Browse Azure AD Gallery** page, choose **Create your own application**.
6. Under **What’s the name of your app?**, enter a name for your application, **Casebook**, and select **Integrate any other application you don’t find in the gallery (Non-gallery)**, as shown below. Then select **Create**.  
   ![Figure 2: Add an enterprise app in Azure AD](https://d2908q01vomqb2.cloudfront.net/22d200f8670dbdb3e253a90eee5098477c95c23d/2021/11/09/Amazon-Cognito-federated-authentication-2.png)

It will take a few moments for the application to be created in Azure AD. You should be redirected to the **Overview** page for the newly added application.

**Note**: Occasionally, this step can result in a **Not Found** error, even though Azure AD has successfully created a new application. If that happens, in Azure AD navigate back to **Enterprise applications** and search for your application by name.

#### To set up Single Sign-on using SAML

1. On the **Getting started** page, in the **Set up single sign on** tile, choose **Get started**, as shown below.  
    
   
   ![Figure 3: Application configuration page in Azure AD](https://d2908q01vomqb2.cloudfront.net/22d200f8670dbdb3e253a90eee5098477c95c23d/2021/11/10/Amazon-Cognito-federated-authentication-3r.png)
2. On the next screen, select **SAML**.![Number 2-2](https://gohub.casebook.net/hs-fs/hubfs/Number%202-2.png?width=655&name=Number%202-2.png)
3. In the middle pane under **Set up Single Sign-On with SAML**, in the **Basic SAML Configuration** section, select the edit icon.![Number 3-1](https://gohub.casebook.net/hs-fs/hubfs/Number%203-1.png?width=655&name=Number%203-1.png)
4. In Casebook, copy the **Identifier** **Entity ID** under Step 1.![Screen Shot 2022-09-29 at 11.57.43 AM](https://gohub.casebook.net/hs-fs/hubfs/Screen%20Shot%202022-09-29%20at%2011.57.43%20AM.png?width=688&name=Screen%20Shot%202022-09-29%20at%2011.57.43%20AM.png)
5. Back in Azure AD, in the right pane under **Basic SAML Configuration**, replace the default **Identifier ID (Entity ID)** with the **Identifier (Entity ID)** you copied previously from Casebook.
6. In Casebook, copy the **Reply URL** under Step 2.![Screen Shot 2022-09-29 at 11.57.43 AM 2](https://gohub.casebook.net/hs-fs/hubfs/Screen%20Shot%202022-09-29%20at%2011.57.43%20AM%202.png?width=688&name=Screen%20Shot%202022-09-29%20at%2011.57.43%20AM%202.png)
7. Back in Azure AD, in the **Reply URL** field, enter the **Reply URL** you copied previously from Casebook, as shown below. Select **Save**.![Amazon-Cognito-federated-authentication-4](https://gohub.casebook.net/hs-fs/hubfs/Amazon-Cognito-federated-authentication-4.png?width=655&name=Amazon-Cognito-federated-authentication-4.png)
8. Scroll down to the **SAML Signing Certificate** section, and copy the **App Federation Metadata Url** by choosing the copy into clipboard icon (highlighted with red arrow below). Keep this URL in a text editor, as you’ll need it in the next step.![Amazon-Cognito-federated-authentication-6](https://gohub.casebook.net/hs-fs/hubfs/Amazon-Cognito-federated-authentication-6.png?width=655&name=Amazon-Cognito-federated-authentication-6.png)

### Step 2: Add your Single-Sign-On Metadata URL to Casebook

1. Paste the **App Federation Metadata Url** that you previously copied into Step 3 in Casebook and select **Validate**. ![Screen Shot 2022-09-29 at 11.57.43 AM 3](https://gohub.casebook.net/hs-fs/hubfs/Screen%20Shot%202022-09-29%20at%2011.57.43%20AM%203.png?width=688&name=Screen%20Shot%202022-09-29%20at%2011.57.43%20AM%203.png)
2. Type **"email"** into **Step 4 Map Your SSO Email Field** in Casebook.
3. Select **Turn on Single Sign On**. ![Screen Shot 2022-09-29 at 11.57.43 AM 4-1](https://gohub.casebook.net/hs-fs/hubfs/Screen%20Shot%202022-09-29%20at%2011.57.43%20AM%204-1.png?width=688&name=Screen%20Shot%202022-09-29%20at%2011.57.43%20AM%204-1.png)

### Note: Assign Users to Casebook in Azure AD.

You will need to assign users to this application in Azure AD. If a user is not assigned to Casebook, they will see the following error message as they try to log-in. ![image (3)](https://gohub.casebook.net/hs-fs/hubfs/image%20(3).png?width=688&name=image%20(3).png)

 

### Optional

If you want to further restrict the Casebook app such that only a single group of users is allowed to consent, navigate to the ***Casebook, Calendar and Email Integration*** application in Azure Portal, then select **Properties.** You can toggle the **assignment required** to **Yes**. Once this is set, you can manage those users on the **Users and Groups** page.

![unnamed](https://gohub.casebook.net/hs-fs/hubfs/unnamed.png?width=667&height=405&name=unnamed.png)

 

You can turn access options on or off for your users through the **Self Service** tab. These options can indicate if a user needs permission to access the application. ![image (7)-2](https://gohub.casebook.net/hs-fs/hubfs/image%20(7)-2.png?width=688&height=392&name=image%20(7)-2.png)

 

- [Getting Started With Casebook](https://gohub.casebook.net/knowledge/getting-started-with-casebook#main-content)

    - [Casebook Overview](https://gohub.casebook.net/knowledge/getting-started-with-casebook#casebook-overview)
    - [Getting Started for New Users](https://gohub.casebook.net/knowledge/getting-started-with-casebook#getting-started-for-new-users)
    - [Services in Casebook](https://gohub.casebook.net/knowledge/getting-started-with-casebook#services-in-casebook)
    - [Notes](https://gohub.casebook.net/knowledge/getting-started-with-casebook#notes)
- [Admin](https://gohub.casebook.net/knowledge/admin#main-content)

    - [Casebook Security](https://gohub.casebook.net/knowledge/admin#casebook-security)
    - [Roles and Permissions](https://gohub.casebook.net/knowledge/admin#roles-and-permissions)
    - [User Management](https://gohub.casebook.net/knowledge/admin#user-management)
    - [Notifications](https://gohub.casebook.net/knowledge/admin#notifications)
    - [Data](https://gohub.casebook.net/knowledge/admin#data)
    - [Field Configuration](https://gohub.casebook.net/knowledge/admin#field-configuration)
    - [Dynamic Fields](https://gohub.casebook.net/knowledge/admin#dynamic-fields)
    - [Forms](https://gohub.casebook.net/knowledge/admin#forms)
    - [Implementation & Adoption](https://gohub.casebook.net/knowledge/admin#implementation-adoption)
- [People](https://gohub.casebook.net/knowledge/people)
- [Intake](https://gohub.casebook.net/knowledge/intake)
- [Engage](https://gohub.casebook.net/knowledge/engage#main-content)

    - [Text Messages](https://gohub.casebook.net/knowledge/engage#text-messages)
    - [Configuration](https://gohub.casebook.net/knowledge/engage#configuration)
    - [Notes](https://gohub.casebook.net/knowledge/engage#notes)
- [Track](https://gohub.casebook.net/knowledge/track)
- [Access](https://gohub.casebook.net/knowledge/access)
- [Workflow & Tasks](https://gohub.casebook.net/knowledge/workflow-tasks)
- [Reporting](https://gohub.casebook.net/knowledge/reporting#main-content)

    - [Overview](https://gohub.casebook.net/knowledge/reporting#overview)
    - [Datasets](https://gohub.casebook.net/knowledge/reporting#datasets)
    - [Dashboards](https://gohub.casebook.net/knowledge/reporting#dashboards)
    - [Pre-built Reports](https://gohub.casebook.net/knowledge/reporting#pre-built-reports)
    - [Custom Reports](https://gohub.casebook.net/knowledge/reporting#custom-reports)
    - [Data Visualizations](https://gohub.casebook.net/knowledge/reporting#data-visualizations)
    - [Filters](https://gohub.casebook.net/knowledge/reporting#filters)
    - [Calculated Fields](https://gohub.casebook.net/knowledge/reporting#calculated-fields)
    - [Other](https://gohub.casebook.net/knowledge/reporting#other)
- [Audit Logs](https://gohub.casebook.net/knowledge/audit-logs)
- [Integrations](https://gohub.casebook.net/knowledge/integrations#main-content)

    - [Low-code incoming integrations with Zapier](https://gohub.casebook.net/knowledge/integrations#low-code-incoming-integrations-with-zapier)
    - [Custom incoming integrations with Casebook API](https://gohub.casebook.net/knowledge/integrations#custom-incoming-integrations-with-casebook-api)
    - [Custom outgoing integrations with Webhooks](https://gohub.casebook.net/knowledge/integrations#custom-outgoing-integrations-with-webhooks)
- [Program Area Specific](https://gohub.casebook.net/knowledge/program-area-specific#main-content)

    - [VOCA Reporting](https://gohub.casebook.net/knowledge/program-area-specific#voca-reporting)
- [Customer Support](https://gohub.casebook.net/knowledge/customer-support#main-content)

    - [Getting Unstuck](https://gohub.casebook.net/knowledge/customer-support#getting-unstuck)
    - [Account Management](https://gohub.casebook.net/knowledge/customer-support#account-management)
- [Product Release Notes](https://gohub.casebook.net/knowledge/product-release-notes#main-content)

    - [2026](https://gohub.casebook.net/knowledge/product-release-notes#2026)
    - [2025](https://gohub.casebook.net/knowledge/product-release-notes#2025)
    - [2024](https://gohub.casebook.net/knowledge/product-release-notes#2024)
    - [2023](https://gohub.casebook.net/knowledge/product-release-notes#2023)
    - [2022](https://gohub.casebook.net/knowledge/product-release-notes#2022)
    - [2021](https://gohub.casebook.net/knowledge/product-release-notes#2021)
    - [2020](https://gohub.casebook.net/knowledge/product-release-notes#2020)
- [Frequently Asked Questions](https://gohub.casebook.net/knowledge/frequently-asked-questions#main-content)

    - [Global](https://gohub.casebook.net/knowledge/frequently-asked-questions#global)
    - [Casebook Calendar](https://gohub.casebook.net/knowledge/frequently-asked-questions#casebook-calendar)
    - [Casebook Services](https://gohub.casebook.net/knowledge/frequently-asked-questions#casebook-services)
    - [Casebook Forms](https://gohub.casebook.net/knowledge/frequently-asked-questions#casebook-forms)
    - [Casebook Notes](https://gohub.casebook.net/knowledge/frequently-asked-questions#casebook-notes)
    - [cb Admin](https://gohub.casebook.net/knowledge/frequently-asked-questions#cb-admin)
    - [cb Track](https://gohub.casebook.net/knowledge/frequently-asked-questions#cb-track)
    - [cb Reporting](https://gohub.casebook.net/knowledge/frequently-asked-questions#cb-reporting)
    - [cb Access](https://gohub.casebook.net/knowledge/frequently-asked-questions#cb-access)
    - [Program Specific](https://gohub.casebook.net/knowledge/frequently-asked-questions#program-specific)

[![logo-raspberry-1-1](https://gohub.casebook.net/hs-fs/hubfs/logo-raspberry-1-1.png?width=32&height=30&name=logo-raspberry-1-1.png "logo-raspberry-1-1")](https://www.casebook.net/)

© 2025 Casebook. All rights reserved.

Casebook Knowledge Base [Video Library](https://gohub.casebook.net/video-library) [Still Need Help?](https://gohub.casebook.net/knowledge/kb-tickets/new)