Azure Active Directory Connector for Password Boss

The Password Boss Azure AD connector allows you to create and update user account in Password Boss directly from Azure AD.

This connector does not synchronize the user's AD password to Password Boss.

Create a group in Azure AD to synchronize to Password Boss

  • The Azure Active Directory connector work by monitoring group in Active Directory.
  • When users are added to the group the user accounts are created in Password Boss.
  • When users are removed from the groups, disabled or deleted the user accounts in Password Boss are disabled, although this is a setting you can change in the Sync Rules tab of the connector in the Password boss Portal.
  1. Create a new security group in Azure AD named Password Boss Usersmceclip25.png

Create a new application registration

  1. Go to
  2. From the left menu click All services
  3. Click Azure Active Directory mceclip34.png
  4. Click App registrations
  5. Click New registration mceclip35.png
  6. Name your application Password Boss AD Connector
  7. In the Supported Accounts Type section select Accounts in this organizational directory only
  8. Click the Register button to create the application. mceclip36.png

Configure API Permissions

    1. After saving the new AD connector you should be on the Overview page for the new connector. Note: Microsoft has changed this page occasionally, so you may need to navigate manually to the Overview page as shown in the screenshot below.
    2. Click View API Permissions mceclip37.png
    3. Click Add a permission mceclip38.png
    4. Select Microsoft Graph mceclip39.png
    5. Select Application permission mceclip40.png
    6. You will need to set the following two permissions
      Group -> Group.Read.All mceclip32.png User -> User.Read.All mceclip41.png
  1. Click Add permission at the bottom
  2. Click Grant admin consent for [Business Name] mceclip30.png
  3. Click Yes

Create Client Secret Key

  1. Select the application you created.
  2. Click Certificates & secrets and then click New client secret mceclip29.png
  3. Name the key Password Boss Secret and set the expiration to Never mceclip28.png
  4. Click Add
  5. Copy your secret key now – it is not shown again. We recommend placing the secret key in a digital Note in Password Boss. You will need the key to finish the configuration on the Password Boss Portal. mceclip14.png

Copy application ID and Tenant ID

  1. From the Overview tab of the App registration you just created copy the Application (client) ID and the Directory (tenant) ID. You will need these values to finish the setup on the Password Boss Portal. mceclip15.png

Enter Redirect URI’s

  1. From the Overview screen on the App registration click Add a Redirect URI mceclip16.png
  2. Add the following two URI’s and then click Save mceclip27.png

The remaining configuration happens in the Password Boss Portal

Install the Azure Active Directory Connector

  1. Open the Password Boss Portal
    1. In the Partner Portal, the connector is located on the Connectors tab for each Company.
    2. In the User portal, the connector is located on the Integrations tab.
  2. Click on the Integrations tab
  3. Click Install in the Microsoft Azure Active Directory Connector mceclip19.png
  4. Save the Authentication token for future use and click Next mceclip20.png
  5. Enter the Client ID, Client Secret, and Tenant and click Verify Connection mceclip21.png
  6. You will be redirected to Microsoft in your browser to authorize the connection. Click to provide consent and click Accept.


  7. After successful verification at Microsoft you will see Connection Verified. mceclip47.png
  8. Click Next to continue
  9. On the Users & Groups tab click the green button to select the Password Boss Users group that you created in the first section of this guide. The group selected here is the group that will be synchronized to Password Boss. Notes: As a best practice use a dedicated group only used for managing users in Password Boss. Only one group can be selected for synchronization to Password Boss. mceclip42.png
  10. Optional - Select Azure groups to sync to Password Boss. Any groups select will be synchronized to Password Boss as long as the groups contain users who are included in the sync group you specified above. Empty groups will not be synchronized.
  11. Click Next
  12. Review the sync rules. In most cases, the default setting will be the best choice.
  13. Click Save Changes mceclip43.png
  14. When you return to the connector list in the portal you will see the connector with a status of Waiting for connection. mceclip46.png
  15. Normally this status will transition to Connected with a couple of minutes. mceclip45.png

    Users whose accounts were synchronized from Azure AD will show Azure AD in the Managed By column of the Users tab of the portal.

Troubleshooting Synchronization

Synchronization runs every minute with Microsoft. If you have made changes in Azure AD that are not being updated in Password Boss follow these troubleshooting steps.

In the Password Boss Portal, what status is shown for the AZ AD connector?

  • Connected means the last connection to Microsoft was successful
  • Unauthorized means you need to reauthorize the Azure AD connector. Edit the connector from the Azure Auth tab click Verify Connection

Check your Password boss Users group in Azure Ad to confirm the correct users are in the group.

If synchronization seems stuck you can perform a manual synchronization. Select the checkbox next to the connector and from the Actions menu select Synchronize Now.





Was this article helpful?