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.
Syncing groups from Azure Active Directory to Password Boss
Groups can also be sync'd to Password Boss. Details are in the Synchronizing Groups article.
Using sync Rules to customize Sync
sync rules are used to determine the actions taken in Password Boss when changes are made in Active Directory. Details of the sync rule are in the Sync Rules article.
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.
- 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.
- After saving the new AD connector you should be on the Overview page for the new connector. Note: Microsoft is frequently changing these pages and flow, 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.All
User -> User.Read.All
Click Add permission at the bottom
Click Grant admin consent for [Org Name]
- Click Yes
- 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.
- 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.
- From the Overview screen on the App registration click Add a Redirect URI
- Add the following two URI’s and then click Save
The remaining configuration happens in the Password Boss Portal
- 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 Install
- 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.
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.
Updated almost 2 years ago