đź“‹ Microsoft Entra Documentation Changes

Daily summary for changes since September 21st 2025, 8:04 PM PDT

Report generated on September 22nd 2025, 8:04 PM PDT

📊 Summary

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

📝 Modified Documentation Files

Modified by Ortagus Winfrey on Sep 22, 2025 1:24 PM
đź“– View on learn.microsoft.com
+10 / -10 lines changed
Commit: Acrolinx sweep
Changes:
Before
After
|---------|---------|
|category | A read-only string that identifies the category or categories of the task. Automatically determined when the taskDefinitionID is chosen. |
|taskDefinitionId | A string referencing a taskDefinition that determines which task to run. |
|isEnabled | A boolean value that denotes whether the task is set to run or not. If set to “true" then the task runs. Defaults to true. |
|displayName | A unique string that identifies the task. |
|description | A string that describes the purpose of the task for administrative use. (Optional) |
|executionSequence | A read-only integer that states in what order the task runs in a workflow. |
Microsoft Entra allows you to use a [Temporary Access Pass (TAP)](..//identity/authentication/howto-authentication-temporary-access-pass.md) to set up password-less credentials for users. You can also use [Microsoft Entra self-service password reset](../identity/authentication/concept-sspr-howitworks.md) to set a regular password. With this task, Lifecycle workflows allow you to automatically generate a Temporary Access Pass (TAP), and have it sent to the new user's manager. You're also able to customize the email that is sent to the user's manager.
 
> [!NOTE]
> The user's employee hire date is used as the start time for the Temporary Access Pass. Please make sure that the TAP lifetime task setting and the [time portion of your user's hire date](how-to-lifecycle-workflow-sync-attributes.md#importance-of-time) are set appropriately so that the TAP is still valid when the user starts their first day. If the hire date at the time of workflow execution is already in the past, the current time is used as the start time.
 
With this task in the Microsoft Entra admin center, you're able to give the task a name and description. You must also set:
 
|displayName | GenerateTAPAndSendEmail (Customizable by user) |
|description | Generate Temporary Access Pass and send via email to user's manager (Customizable by user) |
|taskDefinitionId | 1b555e50-7f65-41d5-b514-5894a026d10d |
|arguments | Argument contains the name parameter "tapLifetimeInMinutes", which is the lifetime of the temporaryAccessPass in minutes starting at startDateTime. Minimum 10, Maximum 43200 (equivalent to 30 days). The argument also contains the tapIsUsableOnce parameter, which determines whether the passcode is limited to a one time use. If true, the pass can be used once; if false, the pass can be used multiple times within the temporaryAccessPass lifetime. Additionally, the optional common email task parameters can be specified; if they aren't included, the default behavior takes effect. |
 
Example of usage within the workflow:
|---------|---------|
|category | A read-only string that identifies the category or categories of the task. Automatically determined when the taskDefinitionID is chosen. |
|taskDefinitionId | A string referencing a taskDefinition that determines which task to run. |
|isEnabled | A boolean value that denotes whether the task is set to run or not. If set to “*true"* then the task runs. Defaults to true. |
|displayName | A unique string that identifies the task. |
|description | A string that describes the purpose of the task for administrative use. (Optional) |
|executionSequence | A read-only integer that states in what order the task runs in a workflow. |
Microsoft Entra allows you to use a [Temporary Access Pass (TAP)](..//identity/authentication/howto-authentication-temporary-access-pass.md) to set up password-less credentials for users. You can also use [Microsoft Entra self-service password reset](../identity/authentication/concept-sspr-howitworks.md) to set a regular password. With this task, Lifecycle workflows allow you to automatically generate a Temporary Access Pass (TAP), and have it sent to the new user's manager. You're also able to customize the email that is sent to the user's manager.
 
> [!NOTE]
> The user's employee hire date is used as the start time for the Temporary Access Pass. Make sure that the TAP lifetime task setting and the [time portion of your user's hire date](how-to-lifecycle-workflow-sync-attributes.md#importance-of-time) are set appropriately so that the TAP is still valid when the user starts their first day. If the hire date at the time of workflow execution is already in the past, the current time is used as the start time.
 
With this task in the Microsoft Entra admin center, you're able to give the task a name and description. You must also set:
 
|displayName | GenerateTAPAndSendEmail (Customizable by user) |
|description | Generate Temporary Access Pass and send via email to user's manager (Customizable by user) |
|taskDefinitionId | 1b555e50-7f65-41d5-b514-5894a026d10d |
|arguments | Argument contains the name parameter "tapLifetimeInMinutes," which is the lifetime of the temporaryAccessPass in minutes starting at startDateTime. Minimum 10, Maximum 43200 (equivalent to 30 days). The argument also contains the tapIsUsableOnce parameter, which determines whether the passcode is limited to a one time use. If true, the pass can be used once; if false, the pass can be used multiple times within the temporaryAccessPass lifetime. Additionally, the optional common email task parameters can be specified; if they aren't included, the default behavior takes effect. |
 
Example of usage within the workflow:
+7 / -9 lines changed
Commit: removed last step and screenshot
Changes:
Before
After
---
title: Include file
description: Include file
author: billmath
ms.service: entra-id
ms.topic: include
ms.date: 09/18/2025
ms.author: billmath
ms.custom: include file, sfi-image-nochange
---
 
 
:::image type="content" source="media/entra-cloud-sync-how-to-install/finish.png" alt-text="Screenshot that shows the finish screen." lightbox="media/entra-cloud-sync-how-to-install/finish.png":::
 
1. After the operation finishes, you see a notification that your agent configuration was successfully verified. Select **Exit**.
 
:::image type="content" source="media/entra-cloud-sync-how-to-install/exit.png" alt-text="Screenshot that shows how to exit the installation." lightbox="media/entra-cloud-sync-how-to-install/exit.png":::
 
1. If you still get the initial screen, select **Close**.
---
title: Include file
description: Include file
author: omondiatieno
manager: mwongerapk
ms.service: entra-id
ms.topic: how-to
ms.date: 09/22/2025
ms.subservice: hybrid-cloud-sync
ms.author: jomondi
ms.custom: include file, sfi-image-nochange
---
 
 
:::image type="content" source="media/entra-cloud-sync-how-to-install/finish.png" alt-text="Screenshot that shows the finish screen." lightbox="media/entra-cloud-sync-how-to-install/finish.png":::
 
1. After the operation finishes, you see a notification that your agent configuration was successfully verified. Select **Exit**. If you still get the initial screen, select **Close**.
 
 
Modified by Ortagus Winfrey on Sep 22, 2025 2:58 PM
đź“– View on learn.microsoft.com
+5 / -5 lines changed
Commit: Acrolinx fixes
Changes:
Before
After
- Message body
- Email language
 
When you're customizing the subject or message body, we recommend that you also enable the custom sender domain and organizational branding. Otherwise, your email will contain an additional security disclaimer.
 
For more information on these customizable parameters, see [Common email task parameters](lifecycle-workflow-tasks.md#common-email-task-parameters).
 
 
1. Enter a custom subject, a message body, and the email language translation option that will be used to translate the message body of the email.
 
If you stay with the default templates and don't customize the subject and body of the email, the text will be automatically translated into the recipient's preferred language. If you select an email language, the determination based on the recipient's preferred language will be overridden. If you specify a custom subject or body, it won't be translated.
 
:::image type="content" source="media/customize-workflow-email/customize-workflow-email-example.png" alt-text="Screenshot of an example of a customized email from a workflow.":::
 
Emails sent by workflows can have their text customized to personalize, or stress specific points within, them. Workflow text can currently be customized in the following ways:
 
- **Bold**: Text within emails can be bolded by placing the desired text within `<b></b>` brackets.
- **Italics**:Text within emails can be italicized by placing the desired text within `<i></i>` brackets.
- **Underlined**:Text within emails can be italicized by placing the desired text within `<u></u>` brackets.
- **Links**: Hyperlinks can be added to text by placing the desired link within `<a href=> </a>` brackets.
- Message body
- Email language
 
When you're customizing the subject or message body, we recommend that you also enable the custom sender domain and organizational branding. Otherwise, your email contains an additional security disclaimer.
 
For more information on these customizable parameters, see [Common email task parameters](lifecycle-workflow-tasks.md#common-email-task-parameters).
 
 
1. Enter a custom subject, a message body, and the email language translation option that will be used to translate the message body of the email.
 
If you stay with the default templates and don't customize the subject and body of the email, the text is automatically translated into the recipient's preferred language. If you select an email language, the determination based on the recipient's preferred language is overridden. If you specify a custom subject or body, it won't be translated.
 
:::image type="content" source="media/customize-workflow-email/customize-workflow-email-example.png" alt-text="Screenshot of an example of a customized email from a workflow.":::
 
Emails sent by workflows can have their text customized to personalize, or stress specific points within, them. Workflow text can currently be customized in the following ways:
 
- **Bold**: Text within emails can be bolded by placing the desired text within `<b></b>` brackets.
- **Italics**: Text within emails can be italicized by placing the desired text within `<i></i>` brackets.
- **Underlined**: Text within emails can be italicized by placing the desired text within `<u></u>` brackets.
- **Links**: Hyperlinks can be added to text by placing the desired link within `<a href=> </a>` brackets.
Modified by Chris Werner on Sep 22, 2025 9:48 AM
đź“– View on learn.microsoft.com
+4 / -4 lines changed
Commit: Refine prompts for network traffic log investigation
Changes:
Before
After
 
- *Show the top 5 users with the highest data consumption in the last day.*
- *Show all blocked traffic for user {user principal name} in the last 24 hours.*
- *List all applications with high-risk scores accessed in the last 24 hours.*
- *List all applications that user {user principal name} has accessed in the last 24 hours based on network traffic.*
- *List of the top 10 accessed applications in the last week.*
- *Show all cross-tenant traffic to tenant {Enter_Tenant_ID_Here} in the last day.*
 
## See also
 
 
- *Show the top 5 users with the highest data consumption in the last day.*
- *Show all blocked traffic for user {user principal name} in the last 24 hours.*
- *List all applications with high-risk scores accessed in the last 24 hours based on network traffic logs.*
- *List all applications names that user {user principal name} has accessed in the last 24 hours based on network traffic logs.*
- *List the top 10 accessed applications names in the last week based on network traffic logs.*
- *Show all cross-tenant traffic to tenant {Enter_Tenant_ID_Here} in the last day based on network.*
 
## See also
 
Modified by Chris Werner on Sep 22, 2025 9:44 AM
đź“– View on learn.microsoft.com
+2 / -2 lines changed
Commit: Update access token version setting in documentation
Changes:
Before
After
eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6Imk2bEdrM0ZaenhSY1ViMkMzbkVRN3N5SEpsWSJ9.eyJhdWQiOiI2ZTc0MTcyYi1iZTU2LTQ4NDMtOWZmNC1lNjZhMzliYjEyZTMiLCJpc3MiOiJodHRwczovL2xvZ2luLm1pY3Jvc29mdG9ubGluZS5jb20vNzJmOTg4YmYtODZmMS00MWFmLTkxYWItMmQ3Y2QwMTFkYjQ3L3YyLjAiLCJpYXQiOjE1MzcyMzEwNDgsIm5iZiI6MTUzNzIzMTA0OCwiZXhwIjoxNTM3MjM0OTQ4LCJhaW8iOiJBWFFBaS84SUFBQUF0QWFaTG8zQ2hNaWY2S09udHRSQjdlQnE0L0RjY1F6amNKR3hQWXkvQzNqRGFOR3hYZDZ3TklJVkdSZ2hOUm53SjFsT2NBbk5aY2p2a295ckZ4Q3R0djMzMTQwUmlvT0ZKNGJDQ0dWdW9DYWcxdU9UVDIyMjIyZ0h3TFBZUS91Zjc5UVgrMEtJaWpkcm1wNjlSY3R6bVE9PSIsImF6cCI6IjZlNzQxNzJiLWJlNTYtNDg0My05ZmY0LWU2NmEzOWJiMTJlMyIsImF6cGFjciI6IjAiLCJuYW1lIjoiQWJlIExpbmNvbG4iLCJvaWQiOiI2OTAyMjJiZS1mZjFhLTRkNTYtYWJkMS03ZTRmN2QzOGU0NzQiLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiJhYmVsaUBtaWNyb3NvZnQuY29tIiwicmgiOiJJIiwic2NwIjoiYWNjZXNzX2FzX3VzZXIiLCJzdWIiOiJIS1pwZmFIeVdhZGVPb3VZbGl0anJJLUtmZlRtMjIyWDVyclYzeERxZktRIiwidGlkIjoiNzJmOTg4YmYtODZmMS00MWFmLTkxYWItMmQ3Y2QwMTFkYjQ3IiwidXRpIjoiZnFpQnFYTFBqMGVRYTgyUy1JWUZBQSIsInZlciI6IjIuMCJ9.pj4N-w_3Us9DrBLfpCt
```
 
Set the version for applications by providing the appropriate value to the `accessTokenAcceptedVersion` setting in the [app manifest](reference-app-manifest.md#manifest-reference). The values of `null` and `1` result in v1.0 tokens, and the value of `2` results in v2.0 tokens.
 
## Token ownership
 
An access token request involves two parties: the client, who requests the token, and the resource (Web API) that accepts the token. The resource that the token is intended for (its *audience*) is defined in the `aud` claim in a token. Clients use the token but shouldn't understand or attempt to parse it. Resources accept the token.
 
The Microsoft identity platform supports issuing any token version from any version endpoint. For example, when the value of `accessTokenAcceptedVersion` is `2`, a client calling the v1.0 endpoint to get a token for that resource receives a v2.0 access token.
 
Resources always own their tokens using the `aud` claim and are the only applications that can change their token details.
 
eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6Imk2bEdrM0ZaenhSY1ViMkMzbkVRN3N5SEpsWSJ9.eyJhdWQiOiI2ZTc0MTcyYi1iZTU2LTQ4NDMtOWZmNC1lNjZhMzliYjEyZTMiLCJpc3MiOiJodHRwczovL2xvZ2luLm1pY3Jvc29mdG9ubGluZS5jb20vNzJmOTg4YmYtODZmMS00MWFmLTkxYWItMmQ3Y2QwMTFkYjQ3L3YyLjAiLCJpYXQiOjE1MzcyMzEwNDgsIm5iZiI6MTUzNzIzMTA0OCwiZXhwIjoxNTM3MjM0OTQ4LCJhaW8iOiJBWFFBaS84SUFBQUF0QWFaTG8zQ2hNaWY2S09udHRSQjdlQnE0L0RjY1F6amNKR3hQWXkvQzNqRGFOR3hYZDZ3TklJVkdSZ2hOUm53SjFsT2NBbk5aY2p2a295ckZ4Q3R0djMzMTQwUmlvT0ZKNGJDQ0dWdW9DYWcxdU9UVDIyMjIyZ0h3TFBZUS91Zjc5UVgrMEtJaWpkcm1wNjlSY3R6bVE9PSIsImF6cCI6IjZlNzQxNzJiLWJlNTYtNDg0My05ZmY0LWU2NmEzOWJiMTJlMyIsImF6cGFjciI6IjAiLCJuYW1lIjoiQWJlIExpbmNvbG4iLCJvaWQiOiI2OTAyMjJiZS1mZjFhLTRkNTYtYWJkMS03ZTRmN2QzOGU0NzQiLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiJhYmVsaUBtaWNyb3NvZnQuY29tIiwicmgiOiJJIiwic2NwIjoiYWNjZXNzX2FzX3VzZXIiLCJzdWIiOiJIS1pwZmFIeVdhZGVPb3VZbGl0anJJLUtmZlRtMjIyWDVyclYzeERxZktRIiwidGlkIjoiNzJmOTg4YmYtODZmMS00MWFmLTkxYWItMmQ3Y2QwMTFkYjQ3IiwidXRpIjoiZnFpQnFYTFBqMGVRYTgyUy1JWUZBQSIsInZlciI6IjIuMCJ9.pj4N-w_3Us9DrBLfpCt
```
 
Set the version for applications by providing the appropriate value to the `requestedAccessTokenVersion` setting in the [app manifest](reference-app-manifest.md#manifest-reference). The values of `null` and `1` result in v1.0 tokens, and the value of `2` results in v2.0 tokens.
 
## Token ownership
 
An access token request involves two parties: the client, who requests the token, and the resource (Web API) that accepts the token. The resource that the token is intended for (its *audience*) is defined in the `aud` claim in a token. Clients use the token but shouldn't understand or attempt to parse it. Resources accept the token.
 
The Microsoft identity platform supports issuing any token version from any version endpoint. For example, when the value of `requestedAccessTokenVersion` is `2`, a client calling the v1.0 endpoint to get a token for that resource receives a v2.0 access token.
 
Resources always own their tokens using the `aud` claim and are the only applications that can change their token details.
 
Modified by Barclay Neira on Sep 22, 2025 9:26 PM
đź“– View on learn.microsoft.com
+3 / -0 lines changed
Commit: Enhance direct reports rule documentation
Changes:
Before
After
 
You can create a group that contains all direct reports of a manager. When the manager's direct reports change in the future, the group's membership is adjusted automatically.
 
You construct the direct reports rule by using the following syntax:
 
```
 
 
 
 
You can create a group that contains all direct reports of a manager. When the manager's direct reports change in the future, the group's membership is adjusted automatically.
 
>[!NOTE]
> The manager is also added to a direct reports dynamic group.
 
You construct the direct reports rule by using the following syntax:
 
```
+1 / -1 lines changed
Commit: fixing capitalization
Changes:
Before
After
 
For hybrid-joined devices, users must first authenticate with another method such as a password, smartcard or FIDO2 key, before using TAP to set up Windows Hello for Business.
> [!NOTE]
> For federated domains, the **FederatedIdpMfaBehavior** changes the behavior when MFA is required. If set to **enforceMfaByFederatedIdp** the user is redirected to the federated IDP and does not get the chance to use the TAP. However, if set to **acceptIfMfaDoneByFederatedIdp** then the user will see a TAP prompt in Entra ID during MFA for windows hello for business provisioning.
 
:::image type="content" border="true" source="./media/how-to-authentication-temporary-access-pass/windows-10-tap.png" alt-text="Screenshot of how to enter Temporary Access Pass when setting up Windows.":::
 
 
For hybrid-joined devices, users must first authenticate with another method such as a password, smartcard or FIDO2 key, before using TAP to set up Windows Hello for Business.
> [!NOTE]
> For federated domains, the **FederatedIdpMfaBehavior** changes the behavior when MFA is required. If set to **enforceMfaByFederatedIdp** the user is redirected to the federated IDP and does not get the chance to use the TAP. However, if set to **acceptIfMfaDoneByFederatedIdp** then the user will see a TAP prompt in Entra ID during MFA for Windows Hello for Business provisioning.
 
:::image type="content" border="true" source="./media/how-to-authentication-temporary-access-pass/windows-10-tap.png" alt-text="Screenshot of how to enter Temporary Access Pass when setting up Windows.":::
 
+1 / -1 lines changed
Commit: DNS
Changes:
Before
After
 
1. User requests a DNS query for `app.contoso.com`. If not cached locally, the DNS query is sent to the DNS proxy at the GSA edge.
1. DNS proxy either responds from its cache or forwards the query to the Connector Group defined in Quick Access.
1.The connector server sends the DNS query to the DNS servers configured at operating system level.
1. DNS proxy responds back to the client with the internal IP. The client stores the internal IP address and returns a synthetic IP to the application.
 
 
 
1. User requests a DNS query for `app.contoso.com`. If not cached locally, the DNS query is sent to the DNS proxy at the GSA edge.
1. DNS proxy either responds from its cache or forwards the query to the Connector Group defined in Quick Access.
1. The connector server sends the DNS query to the DNS servers configured at operating system level.
1. DNS proxy responds back to the client with the internal IP. The client stores the internal IP address and returns a synthetic IP to the application.
 
 
+1 / -1 lines changed
Commit: Remove preview tag
Changes:
Before
After
- Policy details are provided as both a list of all the details that are changing and a JSON view of the entire policy, with the changes highlighted.
- For policy changes that affect users or applications, you can download a JSON file of the users and applications affected by the policy change.
 
### Deep analysis (Preview)
 
Deep analysis performs an in-depth review of Conditional Access policies for scenarios such as blocking legacy authentication, blocking device control flow, and policies that require device or MFA controls. It evaluates the targeted users, groups, and roles to identify coverage gaps, overlapping or redundant policies, and consolidation opportunities. It also analyzes exclusions—flagging policies that exclude a large portion of users and recommending explicit exclusion of break‑glass accounts to reduce the risk of accidental lockout.
 
- Policy details are provided as both a list of all the details that are changing and a JSON view of the entire policy, with the changes highlighted.
- For policy changes that affect users or applications, you can download a JSON file of the users and applications affected by the policy change.
 
### Deep analysis
 
Deep analysis performs an in-depth review of Conditional Access policies for scenarios such as blocking legacy authentication, blocking device control flow, and policies that require device or MFA controls. It evaluates the targeted users, groups, and roles to identify coverage gaps, overlapping or redundant policies, and consolidation opportunities. It also analyzes exclusions—flagging policies that exclude a large portion of users and recommending explicit exclusion of break‑glass accounts to reduce the risk of accidental lockout.
 
Modified by Ortagus Winfrey on Sep 22, 2025 1:02 PM
đź“– View on learn.microsoft.com
+1 / -1 lines changed
Commit: alt description typo fix
Changes:
Before
After
The **Pre-Offboard inactive users** template is designed to configure tasks that must be completed before offboarding inactive users.
 
 
:::image type="content" source="media/lifecycle-workflow-templates/begin-off-board-inactive-users-template.png" alt-text="Screenshot of the pre-offboard inaxctive users template.":::
 
The default specific parameters for the **Pre-Offboard inactive users** template are as follows:
 
The **Pre-Offboard inactive users** template is designed to configure tasks that must be completed before offboarding inactive users.
 
 
:::image type="content" source="media/lifecycle-workflow-templates/begin-off-board-inactive-users-template.png" alt-text="Screenshot of the pre-offboard inactive users template.":::
 
The default specific parameters for the **Pre-Offboard inactive users** template are as follows:
 
Modified by Ortagus Winfrey on Sep 22, 2025 1:02 PM
đź“– View on learn.microsoft.com
+1 / -1 lines changed
Commit: Updated bullet point
Changes:
Before
After
## Next step
 
- [Manage workflow versions](manage-workflow-tasks.md)
> [Manage workflow properties](manage-workflow-properties.md)
 
## Next step
 
- [Manage workflow versions](manage-workflow-tasks.md)
- [Manage workflow properties](manage-workflow-properties.md)