How-to: Export provisioning configuration and roll back to a known good state

In this article, you learn how to:

• Export and import your provisioning configuration from the Microsoft Entra admin center

Export and import your provisioning configuration from the Microsoft Entra admin center

Export your provisioning configuration

To export your configuration:

1. Sign in to the Microsoft Entra admin center as at least an Application Administrator.
2. Browse to Entra ID > Enterprise apps and choose your application.
3. In the left navigation pane, select provisioning. From the provisioning configuration page, select attribute mappings, then show advanced options, and finally review your schema. The schema editor opens.
4. Select download in the command bar at the top of the page to download your schema.

Disaster recovery - roll back to a known good state

Exporting and saving your configuration allows you to roll back to a previous version of your configuration. We recommend exporting your provisioning configuration and saving it for later use anytime you make a change to your attribute mappings or scoping filters. Open the JSON file that you downloaded, copy the entire contents. Next, replace the entire contents of the JSON payload in the schema editor, and then save. If there's an active provisioning cycle, it completes and the next cycle uses the updated schema. The next cycle is also an initial cycle, which reevaluates every user and group based on the new configuration.

Some things to consider when rolling back to a previous configuration:

• Users are evaluated again to determine if they should be in scope. If the scoping filters have changed, a user isn't in scope anymore because they're disabled. While the behavior is the desired in most cases, there are times where you may want to prevent it.
• Changing your provisioning configuration restarts the service and triggers an initial cycle.