# Microsoft Single Sign-On Configuration

Like with Google, many people around the world and businesses have or use Microsoft. To setup Microsoft single sign-on on Docvora the below steps can be followed.



Setting up SSO requires Administrator permissions on Docvora and an Enterprise or custom plan.

This guide is aimed at users without Microsoft experience of a proper Microsoft developer account. However, the steps remain mostly the same for the setup of the OAuth section.



Creating a Microsoft Developer Entra ID





Go to: https://entra.microsoft.com



If you’re prompted to sign in, sign in with your outlook.com or business account.



You’ll may see a message like “You don’t have access to this resource.”
That’s fine — you just need to create a tenant. Follow the sub-steps tp create a tenant or skip to step four.





Visit this direct link to the tenant creation page: https://entra.microsoft.com/#view/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/~/CreateTenant



Choose:
Azure Active Directory type
Organization name: (whatever you want)
Initial domain: e.g. docvoratenant.onmicrosoft.com
Country/region: pick your country



Wait 30–60 seconds for it to create.



Once done, click your profile picture (top-right) → Switch tenant → select your new tenant.



Now you’ll have full access to:
App registrations
Certificates & secrets
Enterprise applications



Navigate to the App registrations page.



Select register an application.



Fill out the name, type, and callback URI.



After creating:





Copy Application (client) ID



Copy Directory (tenant) ID



Go to Certificates & secrets → New client secret → copy the value immediately.



Configuring Docvora





Enter the Docvora staff panel on your instance and navigate to the below menu.

Staff Panel > Docvora Settings > Login Methods > Discord



Enable the SSO method with the checkbox.



Enter the earlier saved client ID and secret.





Click save.



Your docvora instance will internally restart services to enable the login method. This may take up to a minute to reflect on the login page.



Setting a Required Microsoft Tenant





Navigate to the Entra home page - https://entra.microsoft.com.



Copy the tenant ID.



Paste it into Docvora's Microsoft SSO settings.



Click save.



Your docvora instance will internally restart services to enable the login method. This may take up to a minute to reflect on the login page.

Like with Google, many people around the world and businesses have or use Microsoft. To setup Microsoft single sign-on on Docvora the below steps can be followed.

> **Info:** Setting up SSO requires Administrator permissions on Docvora and an Enterprise or custom plan.

This guide is aimed at users without Microsoft experience of a proper Microsoft developer account. However, the steps remain mostly the same for the setup of the OAuth section.

---

## Creating a Microsoft Developer Entra ID

1. Go to: [https://entra.microsoft.com](https://entra.microsoft.com/)
2. If you’re prompted to sign in, sign in with your `outlook.com` or business account.
3. You’ll may see a message like _“You don’t have access to this resource.”_  
   That’s fine — you just need to create a tenant. Follow the sub-steps tp create a tenant or skip to step four.
   1. Visit this **direct link to the tenant creation page**: [https://entra.microsoft.com/#view/Microsoft\_AAD\_IAM/ActiveDirectoryMenuBlade/~/CreateTenant](https://entra.microsoft.com/#view/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/~/CreateTenant)
   2. Choose:  
      Azure Active Directory type  
      Organization name: (whatever you want)  
      Initial domain: e.g. `docvoratenant.onmicrosoft.com`  
      Country/region: pick your country
   3. Wait 30–60 seconds for it to create.
   4. Once done, click your profile picture (top-right) → Switch tenant → select your new tenant.
   5. Now you’ll have full access to:  
      App registrations  
      Certificates & secrets  
      Enterprise applications
4. Navigate to the App registrations page.
5. Select register an application.
6. Fill out the name, type, and callback URI.
7. After creating:
   - Copy **Application (client) ID**
   - Copy **Directory (tenant) ID**
8. Go to **Certificates & secrets → New client secret** → copy the `value` immediately.

---

## Configuring Docvora

1. Enter the Docvora staff panel on your instance and navigate to the below menu.  
     
   Staff Panel > Docvora Settings > Login Methods > Discord
2. Enable the SSO method with the checkbox.
3. Enter the earlier saved client ID and secret.![A boring example image](https://weblutions.com/i/UmJL5T.png "An example")
4. Click save.
5. Your docvora instance will internally restart services to enable the login method. This may take up to a minute to reflect on the login page.

---

### Setting a Required Microsoft Tenant

1. Navigate to the Entra home page - [https://entra.microsoft.com.](https://entra.microsoft.com/)
2. Copy the tenant ID.
3. Paste it into Docvora's Microsoft SSO settings.
4. Click save.
5. Your docvora instance will internally restart services to enable the login method. This may take up to a minute to reflect on the login page.