Organizations that use Azure Active Directory user provisioning (Azure AD) for user management can integrate it with their StarLeaf account. Azure AD integration is an additional option on your StarLeaf Enterprise account.

StarLeaf integration with Azure AD is still in preview status in Azure Marketplace.

On this page:

Features

  • Automatically synchronize new users from Azure AD to StarLeaf
  • Automatically synchronize user updates from Azure AD to StarLeaf
  • Automatically synchronize user deactivation from Azure AD to StarLeaf

Pre-requisites

  • StarLeaf Enterprise subscription

How to set up the integration

  1. Complete StarLeaf Portal configuration (described below).
  2. Add StarLeaf in Azure AD (described below).

StarLeaf Portal configuration for Azure AD integration

Before you can configure StarLeaf provisioning in Azure AD, you need to know the Tenant URLĀ and Secret Token.

  1. Log in to portal.starleaf.com
  2. Go to Integrations > Add integration.
  3. Select Microsoft Azure Active Directory and select Apply.
  4. You see the SCIM server URI and Access token:
  5. Make a note of the SCIM base URL and Access token. You will need these when you configure Azure AD.

Add StarLeaf in Azure AD

  1. Log in to the Azure portal https://portal.azure.com
  2. Go to Azure Active Directory > Enterprise applications – All applications > Categories.
  3. Select Add an application.
  4. Under Add from the gallery, type starleaf in the search field.
  5. Select the StarLeaf app.
  6. Select Add.
  7. Select the Provisioning tab of the StarLeaf application:
    1. Set the Provisioning Mode to Automatic.
    2. Enter the SCIM base URL and Access token from the Portal into the Tenant URLĀ and Secret Token fields respectively.
    3. Select Test Connection. This confirms that you have used the correct credentials.
    4. Select Save.
  8. Set Provisioning Status to On.
  9. Choose a Scope:
    • Sync all users and groups: Sync all users and groups in your AD automatically (not recommended).
    • Sync only assigned users and groups: Select specific users and/or groups you want to enable StarLeaf for by adding them in the Users and groups tab on the left (recommended).
  10. Ensure that the box is ticked where it says Clear current state and synchronization.
  11. Select Save. Setup is complete.

Users added in Azure AD take a minimum of 20 minutes to appear in the StarLeaf Portal. This may take longer if there are a lot of users / user groups.

If you add a user to Azure AD and this user already exists in the StarLeaf Portal with an identical email address, the user will be managed in Azure AD from that point on.

Troubleshooting

If you think your access token has been compromised, you must create a new token. In the StarLeaf Portal, go to the Azure Active Directory Integration and select Regenerate access token and select Apply. You must enter the new token in Azure AD as the Secret Token.