πŸ“‹ Microsoft Entra Documentation Changes

Daily summary for changes since October 5th 2025, 8:03 PM PDT

Report generated on October 6th 2025, 8:03 PM PDT

πŸ“Š Summary

40
Total Commits
0
New Files
14
Modified Files
0
Deleted Files
11
Contributors

πŸ“ Modified Documentation Files

Modified by John Flores on Oct 6, 2025 3:30 PM
πŸ“– View on learn.microsoft.com
+74 / -46 lines changed
Commit: [Conditional Access] Soft delete and restore
Changes:
Before
After
---
title: Recover from deletions in Microsoft Entra ID
description: Learn how to recover from unintended deletions.
author: janicericketts
manager: martinco
ms.service: entra
ms.subservice: architecture
ms.topic: article
ms.date: 11/14/2022
ms.author: jricketts
ms.reviewer: jricketts
ms.custom: sfi-image-nochange
---
 
# Recover from deletions
 
This article addresses recovering from soft and hard deletions in your Microsoft Entra tenant. If you haven't already done so, read [Recoverability best practices](recoverability-overview.md) for foundational knowledge.
 
## Monitor for deletions
 
---
title: Recover from deletions in Microsoft Entra ID
description: Understand the difference between soft and hard deletions and how to recover or recreate objects in Microsoft Entra ID.
author: janicericketts
manager: martinco
ms.service: entra
ms.subservice: architecture
ms.topic: article
ms.date: 10/06/2025
ms.author: jricketts
ms.reviewer: jricketts
ms.custom: sfi-image-nochange
---
# Recover from deletions
 
Managing deletions in Microsoft Entra ID is a critical aspect of maintaining the integrity and availability of your organization's identity infrastructure. This article provides a comprehensive guide to understand the differences between soft and hard deletions, monitor for deletions, and recover or recreate objects in your Microsoft Entra tenant. Whether you're dealing with accidental deletions or preparing recovery strategies, this guide equips you with the knowledge and tools to minimize disruption and ensure continuity. For foundational insights, start with [Recoverability best practices](recoverability-overview.md).
 
## Monitor for deletions
 
The [Microsoft Entra audit log](~/identity/monitoring-health/concept-audit-logs.md) contains information on all delete operations performed in your tenant. Export these logs to a security information and event management tool, such as [Microsoft Sentinel](/azure/sentinel/overview).
+83 / -3 lines changed
Commit: Adding SCIM Validations
Changes:
Before
After
ms.service: entra-id
ms.subservice: app-provisioning
ms.topic: tutorial
ms.date: 09/12/2025
ms.custom: template-tutorial, sfi-image-nochange
ms.reviewer: arvinh
ai-usage: ai-assisted
 
:::image type="content" source="./media/scim-validator-tutorial/scim-validator-results.png" alt-text="Screenshot of SCIM Validator results page." lightbox="./media/scim-validator-tutorial/scim-validator-results.png":::
 
1. Check validations performed by the SCIM Validator
1. [Validations performed by SCIM Validator - create user](./use-scim-to-build-users-and-groups-endpoints.md#validations-performed-by-scim-validator-create-user)
 
## Using Expressions on SCIM Validator
The SCIM Validator supports using expressions to generate desired values for attributes.
 
 
 
 
 
ms.service: entra-id
ms.subservice: app-provisioning
ms.topic: tutorial
ms.date: 10/06/2025
ms.custom: template-tutorial, sfi-image-nochange
ms.reviewer: arvinh
ai-usage: ai-assisted
 
:::image type="content" source="./media/scim-validator-tutorial/scim-validator-results.png" alt-text="Screenshot of SCIM Validator results page." lightbox="./media/scim-validator-tutorial/scim-validator-results.png":::
 
### Note validations performed by SCIM Validator
 
**Create New User**
- POST /Users – Creates a new user with a complete JSON payload.
- Endpoint returns HTTP 201
- POST response contains created user ID
- GET /Users?filter={joiningProperty} eq "value" – Verifies creation by filtering on the joining property.
- GET returns created user
- Returned values from GET match the passed values from the POST request (varies based on endpoint)
- DELETE /Users - Cleans Up Test User.
+12 / -43 lines changed
Commit: Edits
Changes:
Before
After
 
- **LDAP Authentication/Queries** – Applications can have LDAP server settings pointing to AD and perform binds or lookups, custom-developed or third-party products prompting users for AD credentials.
 
- **Federation/Modern Authentication** – Some applications are already federated via AD FS, or support modern protocols such as SAML or OAuth. These can generally be reconfigured to use Microsoft Entra ID with minimal effort.
 
- **Other Legacy Methods** – Includes cases where apps use RADIUS against AD or local accounts. Though not the primary focus, these should be documented for completeness.
 
### Step 3. Assess modernization feasibility
 
 
### Step 7. Handling LDAP-based applications (Directory-Bound Apps)
 
**LDAP-bound applications** or services directly query Active Directory Domain Services (AD DS) via LDAP, most often for authentication using a simple bind with username and password, or for directory reads. Common examples include older enterprise applications, network appliances, or custom-developed apps that rely on LDAP binds to validate credentials. These applications typically require an LDAP server, and can't easily transition to modern authentication protocols.
 
#### Recommended Solution: Microsoft Entra Domain Services
 
The recommended solution for supporting LDAP-bound apps in the cloud is Microsoft Entra Domain Services. Hosted on Azure, Microsoft Entra Domain Services provides LDAP, Kerberos, and NTLM endpoints, syncing user accounts, and credentials from your Microsoft Entra ID tenant. This allows legacy applications to use cloud-hosted AD for authentication without switching
to modern protocols. The managed domain mainly supports read and authentication for LDAP clients.
 
### Step 8. Handling Kerberos-Based Applications (Windows Integrated Auth)
 
- **LDAP Authentication/Queries** – Applications can have LDAP server settings pointing to AD and perform binds or lookups, custom-developed or third-party products prompting users for AD credentials.
 
- **Federation/Modern Authentication** – Some applications are already federated via [AD FS](/windows-server/identity/ad-fs/ad-fs-overview), or support modern protocols such as SAML or OAuth. These can generally be reconfigured to use Microsoft Entra ID with minimal effort.
 
- **Other Legacy Methods** – Includes cases where apps use RADIUS against AD or local accounts. Though not the primary focus, these should be documented for completeness. For more information, see: [RADIUS authentication with Microsoft Entra ID](../../architecture/auth-radius.md).
 
### Step 3. Assess modernization feasibility
 
 
### Step 7. Handling LDAP-based applications (Directory-Bound Apps)
 
**LDAP-bound applications** or services directly query Active Directory Domain Services (AD DS) via LDAP, most often for authentication using a simple bind with username and password, or for directory reads. Common examples include older enterprise applications, network appliances, or custom-developed apps that rely on LDAP binds to validate credentials. These applications typically require an LDAP server, and can't easily transition to modern authentication protocols. For more information, see: [LDAP authentication with Microsoft Entra ID](../../architecture/auth-ldap.md).
 
#### Recommended Solution: Microsoft Entra Domain Services
 
The recommended solution for supporting LDAP-bound apps in the cloud is Microsoft Entra Domain Services. Hosted on Azure, Microsoft Entra Domain Services provides LDAP, Kerberos, and NTLM endpoints, syncing user accounts, and credentials from your Microsoft Entra ID tenant. This allows legacy applications to use cloud-hosted AD for authentication without switching
to modern protocols. The managed domain mainly supports read and authentication for LDAP clients. For more information, see: [What is Microsoft Entra Domain Services?](../../identity/domain-services/overview.md).
 
### Step 8. Handling Kerberos-Based Applications (Windows Integrated Auth)
+41 / -0 lines changed
Commit: Add missing validations from PR9736
Changes:
Before
After
"members": []
}
```
 
#### Get Group
 
 
*HTTP/1.1 204 No Content*
 
### Update Group [Add Members]
 
##### <a name="request-11"></a>Request
 
*HTTP/1.1 204 No Content*
 
#### Update Group [Remove Members]
 
##### <a name="request-12"></a>Request
 
 
"members": []
}
```
##### Validations performed by SCIM Validator
 
**Create New Group**
 
- POST /Groups – Creates a new group with a complete JSON payload.
- Endpoint returns HTTP 201
- POST response contains created group ID
- GET /Group?filter={joiningProperty} eq "value" – Verifies creation by filtering on the joining property.
- GET returns created group
- Returned values from GET match the passed values from the POST request (varies based on endpoint)
- DELETE /Groups - Cleans Up Test User.
- Only called if hard delete is supported
 
**Create Duplicate Group**
- POST /Groups – Attempts to create a group using an identical payload (with the same unique/joining attribute) to an existing group.
- Return HTTP 201 on first create request
- Return HTTP 409 on second create request
+11 / -3 lines changed
Commit: SOA Quick fixes
Changes:
Before
After
 
Once you identify the employees for SOA conversion, follow these steps:
 
1. Create a new provisioning application in Microsoft Entra ID to provision users from your HR system directly to Microsoft Entra ID. Use scoping filters to restrict this app to only handle SOA converted users. For example: In the first phase, if you’re transferring SOA only for users in the β€œ*Finance*” department, then set the scoping filter as department EQUALS β€œ*Finance*.” Expand the scoping filter in future phases to include more users.
 
1. Update the configuration of your HR to Active Directory provisioning app to exclude the SOA transferred users from syncing to AD. Continuing with the previous example, you can exclude *β€œFinance”* department users from syncing to AD by setting the filter department to NOT EQUALS β€œ*Finance*.”
 
1. Update the configuration of your Microsoft Entra Connect Sync / Cloud Sync app to exclude the SOA transferred users from syncing to Microsoft Entra ID using a similar scoping filter.
 
The following diagram depicts the new SOA-aware provisioning configuration:
 
 
 
 
 
 
 
 
 
 
Once you identify the employees for SOA conversion, follow these steps:
 
1. Stop the β€œ*HR to on-premises Active Directory*” provisioning job.
 
1. For users eligible for SOA conversion, switch the SOA of the users from on-premises Active Directory to Entra ID.
 
1. Create a new β€œ*HR to Microsoft Entra ID*” provisioning application to provision users from your HR system to Entra ID. Use scoping filters to restrict this app to only handle SOA converted users. For example: In the first phase, if you’re converting SOA only for users in the β€œFinance” department, then set the scoping filter as department EQUALS β€œFinance”. Expand the scoping filter in future phases to include more users.
 
1. Start the new β€œ*HR to Microsoft Entra ID*” provisioning job.
 
1. Update the configuration of your β€œHR to on-premises Active Directory” provisioning app to exclude the SOA converted users from syncing to AD. Ensure that the skip out of scope deletions flag is set on the provisioning job. Continuing with the example above, you can exclude β€œFinance” department users from syncing to AD by setting the filter department NOT EQUALS β€œFinance”.
 
1. Restart the β€œ*HR to on-premises Active Directory*” provisioning job.
 
1. Update the configuration of your Entra Connect Sync / Cloud Sync app to exclude the SOA converted users from syncing to Entra ID using a similar scoping filter.
 
The following diagram depicts the new SOA-aware provisioning configuration:
 
Modified by Ortagus Winfrey on Oct 6, 2025 9:31 PM
πŸ“– View on learn.microsoft.com
+10 / -0 lines changed
Commit: User SOA added to whats new
Changes:
Before
After
 
## September 2025
 
### Public Preview - Use SMS as a verification method in password reset flows in Microsoft Entra External ID
 
**Type:** New feature
 
 
 
 
 
 
 
 
 
 
 
## September 2025
 
### Public Preview - Convert Source of Authority of synced Active Directory users to the cloud
 
**Type:** New feature
**Service category:** Group Management
**Product capability:** Microsoft Entra Connect and Microsoft Entra Cloud Sync
 
The Source of Authority (SOA) at the object level allows administrators to convert specific users synced from Active Directory (AD) to Microsoft Entra ID into cloud-editable objects, which are no longer synced from AD and act as if originally created in the cloud. This feature supports a gradual migration process, decreasing dependencies on AD while aiming to minimize user and operational impact. Both Microsoft Entra Connect Sync and Cloud Sync recognize the SOA switch for these objects. The option to switch the SOA of synced users from AD to Microsoft Entra ID is currently available in Public Preview. For more information, see: [Embrace cloud-first posture: Transfer user Source of Authority (SOA) to the cloud (Preview)](../identity/hybrid/user-source-of-authority-overview.md).
 
---
 
### Public Preview - Use SMS as a verification method in password reset flows in Microsoft Entra External ID
 
**Type:** New feature
Modified by csmulligan on Oct 6, 2025 2:15 PM
πŸ“– View on learn.microsoft.com
+3 / -3 lines changed
Commit: Minor updates.
Changes:
Before
After
 
ms.service: entra-external-id
ms.topic: how-to
ms.date: 10/21/2024
ms.custom: it-pro
ms.collection: M365-identity-device-management
 
#customer intent: As a B2B collaboration user flow administrator, I want to define custom attributes for user flows in Microsoft Entra, so that I can collect specific information during sign-up and extend the set of attributes stored on a guest account.
---
 
# Define custom attributes to self-service sign-up flows in Microsoft Entra External ID
 
[!INCLUDE [applies-to-workforce-only](./includes/applies-to-workforce-only.md)]
 
> [!TIP]
> This article applies to B2B collaboration user flows in workforce tenants. For information about external tenants, see [Collect user attributes during sign-up](customers/how-to-define-custom-attributes.md).
 
For each application, you might have different requirements for the information you want to collect during sign-up. Microsoft Entra External ID comes with a built-in set of information stored in attributes, such as Given Name, Surname, City, and Postal Code. With Microsoft Entra External ID, you can extend the set of attributes stored on a guest account when the external user signs up through a user flow.
 
 
ms.service: entra-external-id
ms.topic: how-to
ms.date: 10/06/2025
ms.custom: it-pro
ms.collection: M365-identity-device-management
 
#customer intent: As a B2B collaboration user flow administrator, I want to define custom attributes for user flows in Microsoft Entra, so that I can collect specific information during sign-up and extend the set of attributes stored on a guest account.
---
 
# Collect custom user attributes during B2B collaboration sign-up
 
[!INCLUDE [applies-to-workforce-only](./includes/applies-to-workforce-only.md)]
 
> [!TIP]
> This article applies to B2B collaboration user flows in workforce tenants. For information about external tenants, see [Collect custom user attributes during external tenant sign-up](customers/how-to-define-custom-attributes.md).
 
For each application, you might have different requirements for the information you want to collect during sign-up. Microsoft Entra External ID comes with a built-in set of information stored in attributes, such as Given Name, Surname, City, and Postal Code. With Microsoft Entra External ID, you can extend the set of attributes stored on a guest account when the external user signs up through a user flow.
 
+1 / -5 lines changed
Commit: Requested changes
Changes:
Before
After
 
:::image type="content" source="media/how-to-user-source-of-authority-configure/try-update.png" alt-text="Screenshot of an attempt to update a user to verify it's read-only.":::
1. Search the Microsoft Entra admin center for the user. Verify that all user fields are greyed out, and that source is Windows Server AD DS:
 
:::image type="content" border="true" source="media/how-to-user-source-of-authority-configure/properties.png" alt-text="Screenshot of advanced user properties.":::
 
1. Now you can update the SOA of the user to be cloud-managed. Run the following operation in Microsoft Graph Explorer for the user object you want to transfer to the cloud. For more information about this API, see [Update onPremisesSyncBehavior](/graph/api/onpremisessyncbehavior-update).
 
 
1. Confirm the change in the Audit Logs. To access Audit Logs in the Azure portal, open **Manage Microsoft Entra ID** > **Monitoring** > **Audit Logs**, or search for *audit logs*. Select **Change Source of Authority from AD to cloud** as the activity.
 
:::image type="content" border="true" source="media/how-to-user-source-of-authority-configure/audit.png" alt-text="Screenshot of change to user properties in Audit Logs.":::
 
1. Check that the user can be updated in the cloud.
 
```https
 
:::image type="content" source="media/how-to-user-source-of-authority-configure/try-update.png" alt-text="Screenshot of an attempt to update a user to verify it's read-only.":::
1. Search the Microsoft Entra admin center for the user. Verify that all user fields are greyed out, and that source is Windows Server AD DS.
 
1. Now you can update the SOA of the user to be cloud-managed. Run the following operation in Microsoft Graph Explorer for the user object you want to transfer to the cloud. For more information about this API, see [Update onPremisesSyncBehavior](/graph/api/onpremisessyncbehavior-update).
 
 
1. Confirm the change in the Audit Logs. To access Audit Logs in the Azure portal, open **Manage Microsoft Entra ID** > **Monitoring** > **Audit Logs**, or search for *audit logs*. Select **Change Source of Authority from AD to cloud** as the activity.
 
1. Check that the user can be updated in the cloud.
 
```https
 
 
 
 
+4 / -0 lines changed
Commit: [Conditional Access] Soft delete and restore
Changes:
Before
After
 
Some IP addresses can't be mapped to a specific country or region. To capture these IP locations, select the box **Include unknown countries/regions** when defining a geographic location. This option allows you to choose if these IP addresses should be included in the named location. Use this setting when the policy using the named location should apply to unknown locations.
 
## Common questions
 
### Is there Graph API support
 
 
 
 
 
Some IP addresses can't be mapped to a specific country or region. To capture these IP locations, select the box **Include unknown countries/regions** when defining a geographic location. This option allows you to choose if these IP addresses should be included in the named location. Use this setting when the policy using the named location should apply to unknown locations.
 
## Restore deleted locations
 
If a Conditional Access policy or location is deleted, it can be restored within the 30 day soft-delete period. For more information about restoring Conditional Access policies and named locations, see the article [Recover from deletions](../../architecture/recover-from-deletions.md#conditional-access-policies).
 
## Common questions
 
### Is there Graph API support
+4 / -0 lines changed
Commit: [Conditional Access] Soft delete and restore
Changes:
Before
After
 
- If a policy is disabled and no longer needed, **delete it**.
 
## Troubleshoot Conditional Access policies
 
If a user has an issue with a Conditional Access policy, collect this information to help with troubleshooting.
 
 
 
 
 
- If a policy is disabled and no longer needed, **delete it**.
 
##### Restore deleted policies
 
If a Conditional Access or location is deleted, it can be restored within the 30 day soft-delete period. For more information about restoring Conditional Access policies and named locations, see the article [Recover from deletions](../../architecture/recover-from-deletions.md#conditional-access-policies).
 
## Troubleshoot Conditional Access policies
 
If a user has an issue with a Conditional Access policy, collect this information to help with troubleshooting.
+2 / -2 lines changed
Commit: Minor updates.
Changes:
Before
After
#Customer intent: As a developer, devops, IT admin, I want to create custom attributes in my tenant and add them to my sign-up user flow so that I can collect then during sign-up.
---
 
# Collect custom user attributes during sign-up
 
[!INCLUDE [applies-to-external-only](../includes/applies-to-external-only.md)]
 
> [!TIP]
> This article applies to user flows in external tenants. For information about workforce tenants, see [Define custom attributes for user flows](../user-flow-add-custom-attributes.md).
 
If your app requires more information than the built-in user attributes provide, you can add your own attributes. We refer to these attributes as *custom user attributes*.
 
#Customer intent: As a developer, devops, IT admin, I want to create custom attributes in my tenant and add them to my sign-up user flow so that I can collect then during sign-up.
---
 
# Collect custom user attributes during external tenant sign-up
 
[!INCLUDE [applies-to-external-only](../includes/applies-to-external-only.md)]
 
> [!TIP]
> This article applies to user flows in external tenants. For information about workforce tenants, see [Collect custom user attributes during B2B collaboration sign-up](../user-flow-add-custom-attributes.md).
 
If your app requires more information than the built-in user attributes provide, you can add your own attributes. We refer to these attributes as *custom user attributes*.
 
+3 / -0 lines changed
Commit: added a note for shared device mode
Changes:
Before
After
|Edge browser with profile login | &#x2705; |
|Managed Home Screen | &#x2705; |
 
### Browsers
 
|Operating system | Chrome certificate on-device | Chrome smart card/security key | Safari certificate on-device | Safari smart card/security key | Edge certificate on-device | Edge smart card/security key |
 
 
 
|Edge browser with profile login | &#x2705; |
|Managed Home Screen | &#x2705; |
 
>[!NOTE]
>When using Microsoft Entra certificate-based authentication on Android devices in kiosk mode (common in Shared Device Mode), customers should allow list com.android.systemui as a required package to ensure they are presented with the appropriate UI to complete their authentication.
 
### Browsers
 
|Operating system | Chrome certificate on-device | Chrome smart card/security key | Safari certificate on-device | Safari smart card/security key | Edge certificate on-device | Edge smart card/security key |
Modified by Ortagus Winfrey on Oct 6, 2025 6:46 PM
πŸ“– View on learn.microsoft.com
+1 / -1 lines changed
Commit: SOA image and wording fix
Changes:
Before
After
### Password-less authentication of SOA transferred users
**Scenario**: You’ve transferred the SOA for users and now want to allow them to access both on-premises, and cloud, resources. Instead of completely removing users from on-premises, introduce Cloud Kerberos Trust password-less authentication to allow them to maintain a hybrid presence allowing them to continue to access their on-premises resources, while also allowing them to access cloud resources. Password-less authentication methods, such as [Windows Hello for Business](/windows/security/identity-protection/hello-for-business/configure) or [FIDO2 security keys](../../identity/authentication/how-to-enable-passkey-fido2.md), can be used to allow these users to access both their on-premises resources, and cloud resources such as [Azure Files](/azure/storage/files/storage-files-introduction) through [Microsoft Entra Private Access](../../global-secure-access/concept-private-access.md). Using Password-less authentication also enables Multifactor Authentication on the SOA transferred users increasing security. Password-less authentication also allows you to enable Conditional Access policies on the on-premises resources, allowing greater control and security over these resources.
:::image type="content" source="media/user-source-of-authority-overview/passwordless-authentication-source-of-authority.png" alt-text="Screenshot of the password-less authentication scenario for User SOA.":::
 
### Password-less authentication of SOA transferred users
**Scenario**: You’ve transferred the SOA for users and now want to allow them to access both on-premises, and cloud, resources. Instead of completely removing users from on-premises, introduce Cloud Kerberos Trust password-less authentication to allow them to maintain a hybrid presence allowing them to continue to access their on-premises resources, while also allowing them to access cloud resources. Password-less authentication methods, such as [Windows Hello for Business](/windows/security/identity-protection/hello-for-business/configure) or [FIDO2 security keys](../../identity/authentication/how-to-enable-passkey-fido2.md), can be used to allow these users to access both their on-premises resources, and cloud resources such as [Azure Files](/azure/storage/files/storage-files-introduction) through [Microsoft Entra Private Access](../../global-secure-access/concept-private-access.md). Using Password-less authentication also enables Multifactor Authentication on the SOA transferred users increasing security. Password-less authentication also allows you to enable Conditional Access policies on the on-premises resources, allowing greater control and security over these resources. **The user account must remain in Active Directory for this scenario to work**.
:::image type="content" source="media/user-source-of-authority-overview/passwordless-authentication-source-of-authority.png" alt-text="Screenshot of the password-less authentication scenario for User SOA.":::
 
+1 / -1 lines changed
Commit: Links added for SOA
Changes:
Before
After
 
One AD DS minimization approach is to convert the Group Source of Authority (SOA) to Microsoft Entra ID. This approach lets you directly manage those groups in the cloud. You can delete AD DS groups that you no longer need on-premises. If you need to keep a group on-premises, you can configure security group provisioning from Microsoft Entra ID to AD DS. Then you can make changes to the group in Microsoft Entra ID and have those changes reflected in the on-premises group.
 
This article describes how Group SOA can help IT administrators transition group management from AD DS to the cloud. You can also enable advanced scenarios like access governance with Microsoft Entra ID Governance.
 
## Video: Microsoft Entra Group Source of Authority
 
 
One AD DS minimization approach is to convert the Group Source of Authority (SOA) to Microsoft Entra ID. This approach lets you directly manage those groups in the cloud. You can delete AD DS groups that you no longer need on-premises. If you need to keep a group on-premises, you can configure security group provisioning from Microsoft Entra ID to AD DS. Then you can make changes to the group in Microsoft Entra ID and have those changes reflected in the on-premises group.
 
This article describes how Group SOA can help IT administrators transition group management from AD DS to the cloud. You can also enable advanced scenarios like access governance with Microsoft Entra ID Governance. For a guide on using group SOA for IT architects, see: [Cloud-First identity management: Guidance for IT architects](guidance-it-architects-source-of-authority.md)
 
## Video: Microsoft Entra Group Source of Authority