> For the complete documentation index, see [llms.txt](https://typo.gitbook.io/typo-help-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://typo.gitbook.io/typo-help-docs/getting-started/single-sign-on-sso-with-microsoft-entra.md).

# Single Sign‑On (SSO) with Microsoft Entra

### 1. Prerequisites

* **Microsoft Entra administrator access** (ability to view tenant properties and export users)
* **User list** of all team members who need access to Typo

***

### 2. Send us your Tenant ID

1. Sign in to the **Microsoft Entra admin center** (<https://entra.microsoft.com>).
2. On the **Home** page, locate the **Tenant information** card.
3. Copy the **Tenant ID** value.

<figure><img src="/files/tY1m2aohdEwlYP8qmCoa" alt="" width="563"><figcaption></figcaption></figure>

4. Email the Tenant ID to **<hello@typoapp.io>** with the subject line **“Tenant ID – \<your company name>”**.

> **Why we need this**\
> The Tenant ID uniquely identifies your organisation so Typo can trust your identity provider.

***

### 3. Export the users you want to onboard

1. In the left‑hand menu, choose **Users › All users**.
2. Multi‑select the users who should have access to Typo.

<figure><img src="/files/2ZX030Si1NQxyn17PJTQ" alt="" width="563"><figcaption></figcaption></figure>

3. Click **Download users → CSV**.

<figure><img src="/files/EHLczSQoJGht4oldNV0y" alt=""><figcaption></figcaption></figure>

4. Review the file to ensure it contains the following columns:\
   `userPrincipalName`, `displayName`, `surname`, `mail`, `givenName`, `id`&#x20;
5. Email the CSV to **<hello@typoapp.io>**.

***

### 4. We configure SSO on our side

Once we receive your Tenant ID and user list, our security team will:

* Establish a secure OpenID Connect trust with your tenant
* Map your users to your Typo workspace
* Confirm set‑up via email (usually within **1 business day**)

***

### 5. Log in with Azure SSO

1. Open **<https://app.typoapp.io/login>**.
2. Choose **“Sign in with Azure”**.

<figure><img src="/files/qCcpG5PUjGkUErAzK5hS" alt="" width="275"><figcaption></figcaption></figure>

3. Complete the Microsoft login prompt.
4. You’ll be redirected back to Typo with access to your workspace.

That’s it – welcome to Typo!