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.

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

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

   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.

   

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.

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.