Microsoft Secure Sign-In

Microsoft Secure Sign-In

Overview

Microsoft Secure Sign-In lets your employees log in to RepairDesk with their Microsoft work accounts through Microsoft Entra ID (formerly Azure Active Directory).

You connect your Microsoft account in one click. There is no need to register an app in the Azure Portal or copy IDs and secrets. Once connected, you import the employees who should have access and give each one a RepairDesk role.

RepairDesk also keeps your employee list in step with Entra ID. When you disable someone in Entra ID, RepairDesk deactivates them and signs them out. When you re-enable them, their RepairDesk access comes back.

With this, you can reduce password management, off board staff in one place, and keep sign-in under your company's Microsoft security policies.

Requirements

Before you begin, make sure you have:

  • The business owner's RepairDesk login. Only the business owner can connect, disconnect, or change this integration.

  • A Microsoft work or school account in your organization. Personal Microsoft accounts (such as Outlook.com or Hotmail) are not supported.

  • Access to a Microsoft Entra ID admin, if you are not one yourself. An admin must approve RepairDesk once for your organization.

Where to find Microsoft Secure Sign-In

  1. Log in to your RepairDesk account as the business owner.

  2. From the main menu, navigate to Settings > Integrations.

  3. Click on Microsoft Entra ID.

  4. You will arrive at the integration page, where you can connect your Microsoft account, import users, and check the connection status.  

How to set up Microsoft Secure Sign-In

Connect your Microsoft account, import your employees, and choose how they log in.

1. Connect with Microsoft

  1. On the integration page, click Connect with Microsoft.

  • If the Use your own Azure app switch is on, turn it off first. The Connect button is unavailable while it is on.

  1. Sign in with your Microsoft work account.

  2. The connection completes and you return to RepairDesk with your Microsoft users listed.

2. Import Users

Only imported users with a role can sign in with Microsoft.
  1. Navigate to the Azure Users tab.

  • You will see your Microsoft users with their RD Status - "Exists in RD"

  1. Select the users you want to give access to by clicking the Import User button

  2. Choose a RepairDesk role for them (e.g., Manager, Technician, Cashier).

3. Choose whether to require Microsoft sign-in

Once the integration is connected, you can make Microsoft the only way your employees log in to the web app.
  1. Turn on Disable Default Login.

  2. Click Save.


How employees sign in

  1. Go to your RepairDesk login page.

  2. Click Sign in with Microsoft.

  3. Sign in with your Microsoft work account.

  4. You are taken back to RepairDesk and logged in.

RepairDesk matches the Microsoft account to an employee by email address. If you are asked for a RepairDesk 2FA code after signing in, enter it as usual. This can happen when you log in from a new country or network.

Advanced: Use your own Azure app

Step 1: Enable Microsoft Secure Sign-In integration

  1. Go to Settings > Integrations > Productivity >Microsoft SSO


  2. From the top-right, click Enable to start using the integration


  1. You'll automatically be redirected to the Setup tab

  2. Microsoft SSO is now enabled.


Step 2: Register RepairDesk as an Application in Azure Portal

  1. Go to Azure Portal and sign in:
    https://portal.azure.com

  2. From Azure Services navigate to Microsoft Entra ID page



  3. Click on Add > App registration


  4. On the Register an application page, enter an application name. 
    Select a Supported account, e-g  Accounts in any organizational directory (Any Microsoft Entra ID tenant - Multitenant)


  5. Click Register

Your application is now created.


Step 3: Add the Redirect URL

  1. Inside the application page, click Manage > Authentication in the left menu.


  2. Under “Redirect URL configuration” tab, click Add Redirect URL → Web


  3. Copy the Callback URL from your integration page under the Setup tab. 


  1. Paste the copied URL in the Azure portal and click Configure


  2. Your platform should now be shown in the list, 



Step 4: Configure Required API Permissions

  1. Go to API permissions in the left menu


  2. Click Add a permission → Microsoft Graph


  3. Add the following:

    1. Application Permissions: User.Read.All


    2. Delegated Permissions: User.Read.All


After adding the permissions, click Grant admin consent


Step 5: Generate Application Credentials

  1. Go to Certificates & secrets page from the left panel



  2. Click New client secret


  3. Enter a description and choose an expiration option and click Add. 
    Note: Copy the Client Secret Value immediately — you will not be able to see it again.


  1. Next, go to Overview and copy the following:

    1. Application (client) ID → Client ID

    2. Directory (tenant) ID → Tenant ID

You will enter these in RepairDesk shortly.


Step 5: Connect Microsoft Secure Sign-In inside RepairDesk

  1. Go to the integration page enabled earlier, 

  2. Enter the following values from Azure:

    1. Client ID

    2. Tenant ID

    3. Client Secret

  1. Save the configuration


  2. Microsoft SSO is now connected


Step 6: Import Users from Azure Active Directory

  1. Navigate to Azure Users tab, you'll see a list of azure users here with their Azure Status



  2. Select users you want to sync into RepairDesk, and click Import Selected Users

  3. Once imported, the Exists in RD column will be marked as Yes



Step 7: Assign Roles to Imported Users (Mandatory)

After importing users:

  1. Go to Settings > Employees > Manage Employees

  2. Open each imported user

  3. Assign a Role (e.g., Admin, Manager, Cashier)


User Login Experience

Once setup is complete:

  1. Users go to the RepairDesk login screen

  2. Click Sign in with Microsoft

  3. They are redirected to Microsoft to authenticate

  4. Successful login redirects them back into RepairDesk


Troubleshooting & FAQs

1. A user cannot log in after SSO is configured

  • Ensure the user was imported first from Azure AD

  • Ensure the user has a role assigned inside RepairDesk

  • Ensure their Azure account is active

2. Getting a “Permission denied” error

Check if both Microsoft Graph permissions exist:

  • User.Read.All (Application)

  • User.Read.All (Delegated)
    Make sure Admin Consent was granted.

3. Login loop or redirect issues

Verify the Redirect URI is added exactly as provided — no slashes, typos, or trailing spaces.

4. Client Secret expired

Azure client secrets expire based on the duration selected.
Simply generate a new secret and update it inside RepairDesk.

5. Can I remove users from RepairDesk by removing them in Azure?

No. Removing a user in Azure won’t automatically remove them from RepairDesk.
You can manually disable or delete them from Settings > Manage Employees.


Need Help?

If you need assistance setting up Microsoft SSO, contact our support team via live chat or email. We’re here to help ensure everything is configured correctly.