Plan an automatic user provisioning deployment in Microsoft Entra ID

Many organizations rely on software as a service (SaaS) applications such as ServiceNow, Zscaler, and Slack for end-user productivity. Historically IT staff has relied on manual provisioning methods such as uploading CSV files, or using custom scripts to securely manage user identities in each SaaS application. These processes are error prone, insecure, and hard to manage.

Microsoft Entra automatic user provisioning simplifies this process by securely automating the creation, maintenance, and removal of user identities in SaaS applications based on business rules. This automation allows you to effectively scale your identity management systems on both cloud-only and hybrid environments as you expand their dependency on cloud-based solutions.

See Automate user provisioning and deprovisioning to SaaS applications with Microsoft Entra ID to better understand the functionality.

In addition to provisioning into SaaS applications, Microsoft Entra automatic user provisioning also supports provisioning into many on-premises and private cloud applications. For more information, see Microsoft Entra on-premises application identity provisioning architecture.

Learn

User provisioning creates a foundation for ongoing identity governance and enhances the quality of business processes that rely on authoritative identity data.

Key benefits

The key benefits of enabling automatic user provisioning are:

• Increased productivity. You can manage user identities across SaaS applications with a single user provisioning management interface. This interface has a single set of provisioning policies.

• Manage risk. You can increase security by automating changes based on employee status or group memberships that define roles and/or access.

• Address compliance and governance. Microsoft Entra ID supports native provisioning logs for every user provisioning request. Requests are executed in both the source and target systems. Provisioning logs let you track who has access to applications from a single screen.

• Reduce cost. Automatic user provisioning reduces costs by avoiding inefficiencies and human error associated with manual provisioning. It reduces the need for custom-developed user provisioning solutions, scripts, and provisioning logs.

Licensing

Microsoft Entra ID provides self-service integration of any application using templates provided in the application gallery menu. For a full list of license requirements, see Microsoft Entra pricing page.

Application licensing

You need the appropriate licenses for the application(s) you want to automatically provision. Discuss with the application owners whether the users assigned to the application have the proper licenses for their application roles. If Microsoft Entra ID manages automatic provisioning based on roles, the roles assigned in Microsoft Entra ID must align to application licenses. Incorrect licenses owned in the application may lead to errors during the provisioning/updating of a user.

Terms

This article uses the following terms:

• CRUD operations - Actions taken on user accounts: Create, Read, Update, Delete.

• Single sign-on (SSO) - The ability for a user to sign-on once and access all SSO enabled applications. In the context of user provisioning, SSO is a result of users having a single account to access all systems that use automatic user provisioning.

• Source system - The repository of users that the Microsoft Entra ID provisions from. Microsoft Entra ID is the source system for most preintegrated provisioning connectors. However, there are some exceptions for cloud applications such as SAP, Workday, and AWS. For example, see User provisioning from Workday to AD.

• Target system - The repository of users that the Microsoft Entra ID provisions to. The Target system is typically a SaaS application such as ServiceNow, Zscaler, and Slack. The target system can also be an on-premises system such as AD.

• System for Cross-domain Identity Management (SCIM) - An open standard that allows for the automation of user provisioning. SCIM communicates user identity data between identity providers and service providers. Microsoft is an example of an identity provider. Salesforce is an example of a service provider. Service providers require user identity information and an identity provider fulfills that need. SCIM is the mechanism the identity provider and service provider use to send information back and forth.

Training resources

Solution architectures

The Microsoft Entra provisioning service provisions users to SaaS apps and other systems by connecting to user management API endpoints provided by each application vendor. These user management API endpoints allow Microsoft Entra ID to programmatically create, update, and remove users.

Automatic user provisioning for hybrid enterprises

In this example, users and or groups are created in an HR database connected to an on-premises directory. The Microsoft Entra provisioning service manages automatic user provisioning to the target SaaS applications.

Description of workflow:

1. Users/groups are created in an on-premises HR application/system, such as SAP.

2. Microsoft Entra Connect agent runs scheduled synchronizations of identities (users and groups) from the local AD to Microsoft Entra ID.

3. Microsoft Entra provisioning service begins an initial cycle against the source system and target system.

4. Microsoft Entra provisioning service queries the source system for any users and groups changed since the initial cycle, and pushes changes in incremental cycles.

Automatic user provisioning for cloud-only enterprises

In this example, user creation occurs in Microsoft Entra ID and the Microsoft Entra provisioning service manages automatic user provisioning to the target (SaaS) applications.

Description of workflow:

1. Users/groups are created in Microsoft Entra ID.

2. Microsoft Entra provisioning service begins an initial cycle against the source system and target system.

3. Microsoft Entra provisioning service queries the source system for any users and groups updated since the initial cycle, and performs any incremental cycles.

Automatic user provisioning for cloud HR applications

In this example, the users and or groups are created in a cloud HR application like such as Workday and SuccessFactors. The Microsoft Entra provisioning service and Microsoft Entra Connect provisioning agent provisions the user data from the cloud HR app tenant into AD. Once the accounts are updated in AD, it's synced with Microsoft Entra ID through Microsoft Entra Connect, and the email addresses and username attributes can be written back to the cloud HR app tenant.

1. HR team performs the transactions in the cloud HR app tenant.
2. Microsoft Entra provisioning service runs the scheduled cycles from the cloud HR app tenant and identifies changes that need to be processed for sync with AD.
3. Microsoft Entra provisioning service invokes the Microsoft Entra Connect provisioning agent with a request payload containing AD account create/update/enable/disable operations.
4. Microsoft Entra Connect provisioning agent uses a service account to manage AD account data.
5. Microsoft Entra Connect runs delta sync to pull updates in AD.
6. AD updates are synced with Microsoft Entra ID.
7. Microsoft Entra provisioning service writebacks email attribute and username from Microsoft Entra ID to the cloud HR app tenant.

Plan the deployment project

Consider your organizational needs to determine the strategy for deploying user provisioning in your environment.

Engage the right stakeholders

When technology projects fail, it's typically because of mismatched expectations on impact, outcomes, and responsibilities. To avoid these pitfalls, ensure you're engaging the right stakeholders and that stakeholder roles in the project are well understood by documenting the stakeholders and their project input and accountabilities.

Plan communications

Communication is critical to the success of any new service. Proactively communicate to your users about their experience, how the experience is changing, when to expect any change, and how to gain support if they experience issues.

Plan a pilot

We recommend that the initial configuration of automatic user provisioning is in a test environment with a small subset of users before scaling it to all users in production. See best practices for running a pilot.

Best practices for a pilot

A pilot allows you to test with a small group before deploying a capability for everyone. Ensure that as part of your testing, each use case within your organization is thoroughly tested.

In your first wave, target IT, usability, and other appropriate users who can test and provide feedback. Use this feedback to further develop the communications and instructions you send to your users, and to give insights into the types of issues your support staff may see.

Widen the rollout to larger groups of users by increasing the scope of the group(s) targeted. Increasing the scope of the group(s) is done through dynamic membership groups or by manually adding users to the targeted group(s).

Plan application connections and administration

Use the Microsoft Entra admin center to view and manage all the applications that support provisioning. See Finding your apps in the portal.

Determine the type of connector to use

The actual steps required to enable and configure automatic provisioning vary depending on the application. If the application you wish to automatically provision is listed in the Microsoft Entra SaaS app gallery, then you should select the app-specific integration tutorial to configure its preintegrated user provisioning connector.

If not, follow the steps:

1. Create a request for a preintegrated user provisioning connector. Our team works with you and the application developer to onboard your application to our platform if it supports SCIM.

2. Use the BYOA SCIM generic user provisioning support for the app. Using SCIM is a requirement for Microsoft Entra ID to provision users to the app without a preintegrated provisioning connector.

3. If the application is able to utilize the BYOA SCIM connector, then refer to BYOA SCIM integration tutorial to configure the BYOA SCIM connector for the application.

For more information, see What applications and systems can I use with Microsoft Entra automatic user provisioning?

Collect information to authorize application access

Setting up automatic user provisioning is a per-application process. For each application, you need to provide administrator credentials to connect to the target system’s user management endpoint.

The image shows one version of the required admin credentials:

While some applications require the admin username and password, others may require a bearer token.

Plan user and group provisioning

If you enable user provisioning for enterprise apps, the Microsoft Entra admin center controls its attribute values through attribute mapping.

Determine operations for each SaaS app

Each application may have unique user or group attributes that must be mapped to the attributes in your Microsoft Entra ID. Application may have only a subset of CRUD operations available.

For each application, document the following information:

• CRUD provisioning operations to be performed on the user and or Group objects for the target systems. For example, each SaaS app business owner may not want all possible operations.

• Attributes available in the source system

• Attributes available in the target system

• Mapping of attributes between systems.

Choose which users and groups to provision

Before implementing automatic user provisioning, you must determine the users and groups to be provisioned to your application.

• Use scoping filters to define attribute-based rules that determine which users are provisioned to an application.

• Next, use user and group assignments as needed for more filtering.

Define user and group attribute mapping

To implement automatic user provisioning, you need to define the user and group attributes that are needed for the application. There's a preconfigured set of attributes and attribute-mappings between Microsoft Entra user objects, and each SaaS application’s user objects. Not all SaaS apps enable group attributes.

Microsoft Entra ID supports by direct attribute-to-attribute mapping, providing constant values, or writing expressions for attribute mappings. This flexibility gives you fine control over what is populated in the targeted system's attribute. You can use Microsoft Graph API and Graph Explorer to export your user provisioning attribute mappings and schema to a JSON file and import it back into Microsoft Entra ID.

For more information, see Customizing User Provisioning Attribute-Mappings for SaaS Applications in Microsoft Entra ID.

Special considerations for user provisioning

Consider the following to reduce issues post-deployment:

• Ensure that the attributes used to map user/group objects between source and target applications are resilient. They shouldn't cause users/groups to be provisioned incorrectly if the attributes change (for example, a user moves to a different part of the company).

• Applications may have specific restrictions and/or requirements that need to be met for user provisioning to work correctly. For example, Slack truncates values for certain attributes. Refer to automatic user provisioning tutorials specific to each application.

• Confirm schema consistency between source and target systems. Common issues include attributes such as UPN or mail not matching. For example, UPN in Microsoft Entra ID set as [email protected] and in the app, it's [email protected]. For more information, see The User and group schema reference.

Plan testing and security

At each stage of your deployment ensure that you’re testing that results are as expected, and auditing the provisioning cycles.

Plan testing

First, configure automatic user provisioning for the application. Then run test cases to verify the solution meets your organization’s requirements.

Plan security

It's common for a security review to be required as part of a deployment. If you require a security review, see the many Microsoft Entra ID whitepapers that provides an overview for identity as a service.

Plan rollback

If the automatic user provisioning implementation fails to work as desired in the production environment, the following rollback steps can assist you in reverting to a previous known good state:

1. Review the provisioning logs to determine what incorrect operations occurred on the affected users and/or groups.

2. Use provisioning logs to determine the last known good state of the users and/or groups affected. Also review the source systems (Microsoft Entra ID or AD).

3. Work with the application owner to update the users and/or groups affected directly in the application using the last known good state values.

Deploy automatic user provisioning service

Choose the steps that align to your solution requirements.

Prepare for the initial cycle

When the Microsoft Entra provisioning service runs for the first time, the initial cycle against the source system and target systems creates a snapshot of all user objects for each target system.

When you enable automatic provisioning for an application, the initial cycle takes anywhere from 20 minutes to several hours. The duration depends on the size of the Microsoft Entra directory and the number of users in scope for provisioning.

The provisioning service stores the state of both systems after the initial cycle, improving performance of subsequent incremental cycles.

Configure automatic user provisioning

Use the Microsoft Entra admin center to manage automatic user account provisioning and deprovisioning for applications that support it. Follow the steps in How do I set up automatic provisioning to an application?

The Microsoft Entra user provisioning service can also be configured and managed using the Microsoft Graph API.

Manage automatic user provisioning

Now that you've deployed, you need to manage the solution.

Monitor user provisioning operation health

After a successful initial cycle, the Microsoft Entra provisioning service will run incremental updates indefinitely, at intervals specific to each application, until one of the following events occurs:

• The service is manually stopped, and a new initial cycle is triggered using the Microsoft Entra admin center, or using the appropriate Microsoft Graph API command.

• A new initial cycle triggers a change in attribute mappings or scoping filters.

• The provisioning process goes into quarantine due to a high error rate and stays in quarantine for more than four weeks then it's automatically disabled.

To review these events, and all other activities performed by the provisioning service, refer to Microsoft Entra provisioning logs.

To understand how long the provisioning cycles take and monitor the progress of the provisioning job, you can check the status of user provisioning.

Gain insights from reports

Microsoft Entra ID can provide more insights into your organization’s user provisioning usage and operational health through provisioning logs and reports. To learn more about user insights, see Check the status of user provisioning.

Admins should check the provisioning summary report to monitor the operational health of the provisioning job. All activities performed by the provisioning service are recorded in the Microsoft Entra provisioning logs. See Tutorial: Reporting on automatic user account provisioning.

We recommend that you assume ownership of and consume these reports on a cadence that meets your organization’s requirements. Microsoft Entra ID retains most audit data for 30 days.

Troubleshoot

Refer to the following links to troubleshoot any issues that may turn up during provisioning:

• Problem configuring user provisioning to a Microsoft Entra Gallery application

• Sync an attribute from your on-premises Active Directory to Microsoft Entra ID for provisioning to an application

• Problem saving administrator credentials while configuring user provisioning to a Microsoft Entra Gallery application

• No users are being provisioned to a Microsoft Entra Gallery application

• Wrong set of users are being provisioned to a Microsoft Entra Gallery application

Helpful documentation

• Writing expressions for attribute mappings

• Microsoft Entra synchronization API overview

• Skip deletion of user accounts that go out of scope

• Microsoft Entra Connect Provisioning Agent: Version release history

Resources

• Provide product feedback

• Keep up to date on what's new with Microsoft Entra ID

• Microsoft Q&A Microsoft Entra forum

Next steps

• Configure Automatic User Provisioning

• Export or import your provisioning configuration by using Microsoft Graph API

• Writing expressions for attribute mappings in Microsoft Entra ID