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.
- Create a new security group in Azure AD named Password Boss Users
Create a new application registration
- Go to https://portal.azure.com
- From the left menu click All services
- Click Azure Active Directory
- Click App registrations
- Click New registration
- Name your application Password Boss AD Connector
- In the Supported Accounts Type section select Accounts in this organizational directory only
- Click the Register button to create the application.
Configure API Permissions
- 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.
- Click View API Permissions
- Click Add a permission
- Select Microsoft Graph
- Select Application permission
- You will need to set the following two permissions
Group -> Group.Read.AllUser -> User.Read.All
- Click Add permission at the bottom
- Click Grant admin consent for [Business Name]
- Click Yes
Create Client Secret Key
- Select the application you created.
- Click Certificates & secrets and then click New client secret
- Name the key Password Boss Secret and set the expiration to Never
- Click Add
- 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.
Copy application ID and Tenant ID
- 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.
Enter Redirect URI’s
- From the Overview screen on the App registration click Add a Redirect URI
- Add the following two URI’s and then click Save https://partner.passwordboss.com/azure/callback https://portal.passwordboss.com/business/connectors/azure/callback
The remaining configuration happens in the Password Boss Portal
Install the Azure Active Directory Connector
- Open the Password Boss Portal
- In the Partner Portal, the connector is located on the Connectors tab for each Company.
- In the User portal, the connector is located on the Integrations tab.
- Click on the Integrations tab
- Click Install in the Microsoft Azure Active Directory Connector
- Save the Authentication token for future use and click Next
- Enter the Client ID, Client Secret, and Tenant and click Verify Connection
- You will be redirected to Microsoft in your browser to authorize the connection. Click to provide consent and click Accept.
- After successful verification at Microsoft you will see Connection Verified.
- Click Next to continue
- 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.
- 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.
- Click Next
- Review the sync rules. In most cases, the default setting will be the best choice.
- Click Save Changes
- When you return to the connector list in the portal you will see the connector with a status of Waiting for connection.
- Normally this status will transition to Connected with a couple of minutes.
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.