Skip to content

Add caution about 'active' attribute mapping for deprovisioning #30541

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Techsurfer1981 wants to merge 1 commit into
base: production
Choose a base branch
from
+12 −0
Open

Add caution about 'active' attribute mapping for deprovisioning #30541

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions src/content/docs/fundamentals/account/account-security/scim-setup/entra.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,18 @@ Once you have [gathered the required data](/fundamentals/account/account-securit
To successfully synchronize the group details into Cloudflare the `User Principal Name` (of `Identity`) and `Email` (of `Contact Information`) fields of each user must be identical. Values are case-sensitive, and the User Principal Name can only contain alphanumeric characters. Learn more about [how to create, invite, and delete users](https://learn.microsoft.com/entra/fundamentals/how-to-create-delete-users).
:::

:::caution[Required: configure the `active` attribute mapping]
The `active` attribute mapping controls whether Entra ID sends a deprovisioning signal to Cloudflare when a user goes out of provisioning scope (for example, when removed from all assigned groups). Without this mapping, the user's account membership will remain active in Cloudflare. For group-based deprovisioning to work, the `active` attribute must use the default Microsoft expression that evaluates provisioning scope:
1. Navigate to **Provisioning** > **Mappings** > **Provision Microsoft Entra ID Users**.
2. Find or add the `active` attribute mapping.
3. Set **Mapping type** to `Expression`.
4. Enter this expression exactly:
`Switch([IsSoftDeleted], , "False", "True", "True", "False")`
5. Ensure **Target attribute** is set to `active`.
6. Select **Ok**, then **Save**.
Using `accountEnabled` as the source attribute will not trigger deprovisioning when a user is removed from a group, because the user's directory account remains enabled.
:::

4. To validate which users and groups have been synchronized, navigate to **Provisioning logs** on the sidebar menu. You can also [review the Cloudflare Audit Logs](/fundamentals/account/account-security/review-audit-logs/).

:::caution[Read-only group]
Expand Down