# 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="https://813988662-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeCZyG1kSmV84geZ9Ws6s%2Fuploads%2FUpAfG0XRnBcwAww5ZoME%2FScreenshot%202025-06-18%20at%203.59.12%E2%80%AFPM.png?alt=media&#x26;token=9bd13bd8-9c74-49a3-9cd7-f634be5d9eb9" 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="https://813988662-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeCZyG1kSmV84geZ9Ws6s%2Fuploads%2FaUaZAot50P5oHE9XJwqW%2FScreenshot%202025-06-18%20at%203.58.29%E2%80%AFPM.png?alt=media&#x26;token=6256a453-aa6f-4359-b4ce-0ce05dab7f15" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="https://813988662-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeCZyG1kSmV84geZ9Ws6s%2Fuploads%2FxYOxd8RJqWKYl93cAV1h%2FScreenshot%202025-06-18%20at%204.46.25%E2%80%AFPM.png?alt=media&#x26;token=d7132ed7-e1e2-4d52-8758-9e6b76e8580a" 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="https://813988662-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeCZyG1kSmV84geZ9Ws6s%2Fuploads%2Fof1CFLUWofxdAvdVcjse%2FScreenshot%202025-06-18%20at%204.48.22%E2%80%AFPM.png?alt=media&#x26;token=e71ba43e-a407-4291-bc30-6390b0d602b1" 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!