πŸ“‹ Microsoft Entra Documentation Changes

Changes for May 2nd 2025

Period: May 1st 2025, 12:00 AM to May 2nd 2025, 12:00 AM

πŸ“š Historical Report: This report shows documentation changes that occurred during the 24-hour period ending on May 2nd 2025.

πŸ“Š Summary

131
Total Commits
1
New Files
52
Modified Files
0
Deleted Files
31
Contributors

πŸ†• New Documentation Files

+111 lines added
Commit: Add files via upload

πŸ“ Modified Documentation Files

+20 / -20 lines changed
Commit: Updates
Changes:
Before
After
 
# Create a custom extension to externally determine the approval requirements for an entitlement management access package
 
In entitlement management, approvers for access package requests can either be directly assigned, or determined dynamically. While entitlement management natively supports dynamic approval options such as the requestor's manager, second-level manager, sponsor from a connected organization, or the requestor, these options don't cover all scenarios. With [custom extensions](entitlement-management-logic-apps-integration.md) calling out to [Azure Logic Apps](/azure/logic-apps/logic-apps-overview), you're able to determine approval requirements for access packages through an external system. With this external call, you're able to determine approval requirements based on each of the [ApprovalStage properties](/graph/api/resources/approvalstage?view=graph-rest-beta#properties). This article walks you through making a custom extension, its underlying Azure Logic App, setting its system assigned identity and role in the catalog, editing the logic app action and body so that it performs business logic, and testing to see if it runs successfully.
 
 
## License requirements
## Prerequisites
 
- At least the [Catalog owner](../id-governance/entitlement-management-delegate.md#entitlement-management-roles) role of the catalog where the custom extension will be created.
- At least the [Azure built-in role](/azure/role-based-access-control/built-in-roles) of [Logic App Contributor](/azure/role-based-access-control/built-in-roles/integration#logic-app-contributor) on the Logic App itself or on the resource group, subscription, or management group that the logic app is in.
 
## Create the custom extension and Azure Logic App
 
To create a custom extension, and its underlying Azure Logic App, you'd do the following steps:
 
1. Sign in to the [Microsoft Entra admin center](https://entra.microsoft.com) as at least an [Catalog owner](../id-governance/entitlement-management-delegate.md#entitlement-management-roles) of the catalog where the custom extension will be located.
 
1. Browse to **Identity governance** > **Entitlement management** > **Catalogs**.
 
 
# Create a custom extension to externally determine the approval requirements for an entitlement management access package
 
In entitlement management, approvers for access package requests can either be directly assigned, or determined dynamically. While entitlement management natively supports dynamic approvers such as the requestor's manager, second-level manager, or sponsor from a connected organization, these options don't cover all scenarios. With [custom extensions](entitlement-management-logic-apps-integration.md) calling out to [Azure Logic Apps](/azure/logic-apps/logic-apps-overview), you're able to determine approval requirements for access packages at the time of request through an external system. With this external call, you're able to determine approval requirements based on each of the [ApprovalStage properties](/graph/api/resources/approvalstage?view=graph-rest-beta#properties). This article walks you through making a custom extension, its underlying Azure Logic App, setting its system-assigned identity and role in the catalog, editing the logic app action to perform business logic, and testing to see if it runs successfully.
 
 
## License requirements
## Prerequisites
 
- At least the [Catalog owner](../id-governance/entitlement-management-delegate.md#entitlement-management-roles) role of the catalog where the custom extension will be created.
- At least the [Azure built-in role](/azure/role-based-access-control/built-in-roles) of [Logic App Contributor](/azure/role-based-access-control/built-in-roles/integration#logic-app-contributor) on the Logic App itself, the resource group, subscription, or management group that the logic app is in.
 
## Create the custom extension and Azure Logic App
 
To create a custom extension, and its underlying Azure Logic App, you'd do the following steps:
 
1. Sign in to the [Microsoft Entra admin center](https://entra.microsoft.com) as at least a [Catalog owner](../id-governance/entitlement-management-delegate.md#entitlement-management-roles) of the catalog where the custom extension will be located.
 
1. Browse to **Identity governance** > **Entitlement management** > **Catalogs**.
 
Modified by Barclay Neira on May 1, 2025 8:39 AM
πŸ“– View on learn.microsoft.com
+13 / -21 lines changed
Commit: freshness pass
Changes:
Before
After
manager: femila
ms.service: entra-verified-id
ms.topic: whats-new
ms.date: 12/16/2024
ms.custom: references_regions
ms.author: barclayn
 
 
## June 2024
 
- [FaceCheck](using-facecheck.md) introducing the Face Check Addon as an incremental update to the Face Check public preview. Face Check is a premium feature within Microsoft Entra Verified ID free to use during the public preview period ending on Aug 12.
 
## April 2024
 
POST https://verifiedid.did.msidentity.com/v1.0/:tenant/verifiablecredentials/issuance
```
 
The first API was for creating an issuance or presentation request. The second API was for retrieving a request and the last two APIs was for a wallet completing issuance or presentation. The API endpoints to use since preview are:
 
```http
manager: femila
ms.service: entra-verified-id
ms.topic: whats-new
ms.date: 04/30/2025
ms.custom: references_regions
ms.author: barclayn
 
 
## June 2024
 
- [FaceCheck](using-facecheck.md) introducing the Face Check Addon as an incremental update to the Face Check public preview. Face Check is a premium feature within Microsoft Entra Verified ID free to use during the public preview period ending on August 12.
 
## April 2024
 
POST https://verifiedid.did.msidentity.com/v1.0/:tenant/verifiablecredentials/issuance
```
 
The first API was for creating an issuance or presentation request. The second API was for retrieving a request and the last two APIs was for a wallet completing issuance or presentation. The API endpoints are:
 
```http
+28 / -5 lines changed
Commit: Update authenticate-application-id.md
Changes:
Before
After
 
## Bring Your Own Application (BYOA)
 
In this set up, the customer administrator manages the application that is used by Entra Connect Sync to authenticate to Entra, the application permissions and certificate credential used by the application. The administrator [registers a Microsoft Entra app and creates a service principal.](../../../identity-platform/howto-create-service-principal-portal.md)
 
The application and service principal need to be created in Entra using MSGraph with the certificate credential and the AdminWebService and SSPR (if necessary) permissions
 
## Bring Your Own Certificate (BYOC)
 
 
The following are additional requirements for the BYOA application management option
- The customer creates a certificate as instructed in BYOC Prerequisites above.
- Customer registers an application with Entra and creates service principal.
- Customer registers the certificate with the application
 
 
Replace <CertificateSHA256Hash> with the CertificateSHA256Hash
 
- Use BYOA
[Register a Microsoft Entra app and create a service principal.](../../../identity-platform/howto-create-service-principal-portal.md) . Note the application Id as it will be necessary in the next section.
 
## Bring Your Own Application (BYOA)
 
In this set up, the customer administrator manages the application that is used by Entra Connect Sync to authenticate to Entra, the application permissions and certificate credential used by the application. The administrator [registers a Microsoft Entra app and creates a service principal.](graph/tutorial-applications-basics?tabs=http#register-an-application-with-microsoft-entra-id.md). The application should be assigned the required [permissions](#microsoft-graph-permissions-for-byoa)
 
## Bring Your Own Certificate (BYOC)
 
 
The following are additional requirements for the BYOA application management option
- The customer creates a certificate as instructed in BYOC Prerequisites above.
- Customer registers an application with Entra and creates service principal. The necessary [permissions](#microsoft-graph-permissions-for-byoa) are granted via graph.
- Customer registers the certificate with the application
 
 
Replace <CertificateSHA256Hash> with the CertificateSHA256Hash
 
- Use BYOA
[Register a Microsoft Entra app and create a service principal.](graph/tutorial-applications-basics?tabs=http#register-an-application-with-microsoft-entra-id.md) . Note the application Id as it will be necessary in the next section.
 
4. Link Entra Application with Microsoft Entra Connect Sync using Administrator credentials.
+23 / -8 lines changed
Commit: peer-based insights to suggested access packages in My Access public preview
Changes:
Before
After
 
# Suggested access packages in My Access (Preview)
 
In My Access, Microsoft Entra ID Governance users can see a curated list of suggested access packages in My Access. This capability allows users to quickly view the most relevant access packages for them based off their peers' access packages and previous requests without scrolling through all their available access packages.
 
The suggested access packages list is created by finding people related to the user (manager, direct reports, organization, team members) and recommending access packages based on what the users’ peers have. The user is also suggested access packages that they previously owned.
 
## Enable users to see their suggested access packages in My Access
 
Follow these steps to enable suggested access packages in My Access.
 
1. Sign in to the [Microsoft Entra admin center](https://entra.microsoft.com) as at least an [Identity Governance Administrator](../identity/role-based-access-control/permissions-reference.md#identity-governance-administrator).
 
1. Browse to **ID Governance** > **Entitlement management** > **Settings**.
 
1. Select **Edit**.
 
1. On the edit page under Opt-in Preview Features, select **Show suggested access packages in My Access**.
:::image type="content" source="media/entitlement-management-suggested-access-packages/opt-in-features-selection.png" alt-text="Screenshot of opt-in to suggested access package feature." lightbox="media/entitlement-management-suggested-access-packages/opt-in-features-selection.png":::
1. Select **Save**.
 
# Suggested access packages in My Access (Preview)
 
In My Access, Microsoft Entra ID Governance users can see a curated list of suggested access packages in My Access. This capability allows users to quickly view the most relevant access packages for them based off their peers' access packages and previous assignments without scrolling through all their available access packages.
 
The suggested access packages list is created by finding people related to the user (manager, direct reports, organization, team members) and recommending access packages based on what the users’ peers have. The user is also suggested access packages that were previously assigned to them.
 
## Opt in for end users to see their suggested access packages in My Access
 
Follow these steps to enable suggested access packages in My Access.
 
1. Sign in to the [Microsoft Entra admin center](https://entra.microsoft.com) as at least an [Identity Governance Administrator](../identity/role-based-access-control/permissions-reference.md#identity-governance-administrator).
 
1. Browse to **ID Governance** > **Entitlement management** > **Preview Features**.
 
1. Select **Show suggested access packages in My Access**.
:::image type="content" source="media/entitlement-management-suggested-access-packages/opt-in-features-selection.png" alt-text="Screenshot of the opt in feature selection option." lightbox="media/entitlement-management-suggested-access-packages/opt-in-features-selection.png":::
1. Select **Save**.
 
1. Sign in to the My Access portal at https://myaccess.microsoft.com. Select **Access packages** to see your suggested access packages.
Modified by csmulligan on May 1, 2025 8:06 PM
πŸ“– View on learn.microsoft.com
+8 / -20 lines changed
Commit: What's new in April?
Changes:
Before
After
 
Welcome to what's new in documentation for Microsoft Entra External ID in external tenants. This article lists new docs that were added and docs that were significantly updated in the last three months.
 
## March 2025
 
### New articles
- [Add OpenID Connect as an external identity provider](how-to-custom-oidc-federation-customers.md) - Email claim is now mandatory
- [Microsoft Entra External ID frequently asked questions](faq-customers.md) - Updated billing for phone charges
- [Identity providers for external tenants](concept-authentication-methods-customers.md) - Included SAML/WS-Fed details
 
## January 2025
 
### New articles
 
- [Use Azure Front Door as a reverse proxy in production environment for a single-page app that uses native authentication (preview)](how-to-native-authentication-cors-solution-production-environment.md)
- [Set up a reverse proxy for a single-page app that calls native authentication API by using Azure Function App (preview)](how-to-native-authentication-cors-solution-test-environment.md)
- [Quickstart: Sign in users in a sample React single-page application by using native authentication (preview)](quickstart-native-authentication-single-page-app-react-sign-in.md)
- [Tutorial: Reset password in a React single-page app by using native authentication (preview)](tutorial-native-authentication-single-page-app-react-reset-password.md)
- [Tutorial: Set up CORS proxy server to manage CORS headers for native authentication (preview)](tutorial-native-authentication-single-page-app-react-set-up-local-cors.md)
- [Tutorial: Sign in users into a React single-page app by using native authentication (preview)](tutorial-native-authentication-single-page-app-react-sign-in.md)
 
Welcome to what's new in documentation for Microsoft Entra External ID in external tenants. This article lists new docs that were added and docs that were significantly updated in the last three months.
 
## April 2025
 
### Updated articles
 
- [Microsoft Entra External ID frequently asked questions](customers/faq-customers.md) - Added clarification on tenant creation
- [Create a sign-up and sign-in user flow for an external tenant app](how-to-user-flow-sign-up-sign-in-customers.md) - Added disable sign-up experience to the user flow
- [Extend authentication flows with your own business logi](concept-custom-extensions.md) - Added custom authentication extensions
 
## March 2025
 
### New articles
- [Add OpenID Connect as an external identity provider](how-to-custom-oidc-federation-customers.md) - Email claim is now mandatory
- [Microsoft Entra External ID frequently asked questions](faq-customers.md) - Updated billing for phone charges
- [Identity providers for external tenants](concept-authentication-methods-customers.md) - Included SAML/WS-Fed details
 
 
 
Modified by Barclay Neira on May 1, 2025 8:39 AM
πŸ“– View on learn.microsoft.com
+13 / -13 lines changed
Commit: freshness pass
Changes:
Before
After
manager: femila
ms.service: entra-verified-id
ms.topic: faq
ms.date: 12/13/2024
ms.author: barclayn
# Customer intent: As a developer I am looking for information on how to enable my users to control their own information
---
 
### Does Microsoft Entra Verified ID support ION as its DID method?
 
Verified ID supported the DID:ION method in preview until December 2023, after which it was discontinued.
 
### How do I move to did:web from did:ion?
 
If you want to move to `did:web` from `did:ion`, you can follow these steps via the [Admin API](admin-api.md). Changing authority requires reissuance of all credentials:
 
#### Export existing did:ion credential definitions
 
1. For the `did:ion` authority, use the [portal](https://entra.microsoft.com/#view/Microsoft_AAD_DecentralizedIdentity/CardsListBlade) to copy out all display and rules definition of the existing credentials.
1. If you have more than one authority, you have to use the Admin APIs if the `did:ion` authority isn't the default authority. On the Verified ID tenant, connect using Admin API, [list the authorities](admin-api.md#list-authorities) to get the authority ID for the `did:ion` authority. Then use the [list contracts](admin-api.md#list-contracts) API to export them and save the result to a file so you can recreate them.
manager: femila
ms.service: entra-verified-id
ms.topic: faq
ms.date: 04/30/2025
ms.author: barclayn
# Customer intent: As a developer I am looking for information on how to enable my users to control their own information
---
 
### Does Microsoft Entra Verified ID support ION as its DID method?
 
Verified ID supported the DID:ION method in preview until December 2023.
 
### How do I move to did:web from did: ion?
 
If you want to move to `did:web` from `did:ion`, you can follow these steps via the [Admin API](admin-api.md). Changing authority requires reissuance of all credentials:
 
#### Export existing did: ion credential definitions
 
1. For the `did:ion` authority, use the [portal](https://entra.microsoft.com/#view/Microsoft_AAD_DecentralizedIdentity/CardsListBlade) to copy out all display and rules definition of the existing credentials.
1. If you have more than one authority, you have to use the Admin APIs if the `did:ion` authority isn't the default authority. On the Verified ID tenant, connect using Admin API, [list the authorities](admin-api.md#list-authorities) to get the authority ID for the `did:ion` authority. Then use the [list contracts](admin-api.md#list-contracts) API to export them and save the result to a file so you can recreate them.
+20 / -6 lines changed
Commit: move assigning users to afterward
Changes:
Before
After
 
If you're using a Salesforce Sandbox environment, see the [Salesforce Sandbox integration article](./salesforce-sandbox-tutorial.md).
 
## Assigning users to Salesforce
 
Microsoft Entra ID uses a concept called "assignments" to determine which users should receive access to selected apps. In the context of automatic user account provisioning, only the users and groups that are "assigned" to an application in Microsoft Entra ID are synchronized.
 
Before configuring and enabling the provisioning service, you need to decide which users or groups in Microsoft Entra ID need access to your Salesforce app. You can assign these users to your Salesforce app by following the instructions in [Assign a user or group to an enterprise app](~/identity/enterprise-apps/assign-user-or-group-access-portal.md)
 
### Important tips for assigning users to Salesforce
 
* It's recommended that a single Microsoft Entra user is assigned to Salesforce to test the provisioning configuration. More users and/or groups may be assigned later.
 
* When assigning a user to Salesforce, you must select a valid user role. The "Default Access" role doesn't work for provisioning
 
> [!NOTE]
> This app imports profiles from Salesforce as part of the provisioning process, which you may want to select when assigning users in Microsoft Entra ID. Please note that the profiles that get imported from Salesforce appear as Roles in Microsoft Entra ID. Roles shouldn't be manually edited in Microsoft Entra ID when doing role imports. If you wish to assign users to a custom profile, then wait for profiles to be imported from Salesforce before assigning users to an application.
> [!NOTE]
> Once the users are provisioned in the Salesforce application, administrator need to configure the language specific settings for them. Please see [this](https://help.salesforce.com/articleView?id=setting_your_language.htm&type=5) article for more details on language configuration.
 
 
If you're using a Salesforce Sandbox environment, see the [Salesforce Sandbox integration article](./salesforce-sandbox-tutorial.md).
 
## Plan for assigning users to Salesforce
 
Microsoft Entra ID uses a concept called "assignments" to determine which users should receive access to selected apps. In the context of automatic user account provisioning, only the users and groups that are "assigned" to an application in Microsoft Entra ID are synchronized.
 
Before configuring and enabling the provisioning service, you need to decide which users or groups in Microsoft Entra ID need access to your Salesforce app.
 
### Important tips for assigning users to Salesforce
 
* It's recommended that a single Microsoft Entra user is assigned to Salesforce to test the provisioning configuration. More users and/or groups can assigned later, through the mechanisms described in [Assign users](#assign-users).
 
* When assigning a user to Salesforce, you must select a valid user role. The "Default Access" role doesn't work for provisioning. Note that some roles may require licensing in Salesforce.
 
> [!NOTE]
> This app imports profiles from Salesforce as part of the provisioning process, which you may want to select when assigning users in Microsoft Entra ID. Please note that the profiles that get imported from Salesforce appear as Roles in Microsoft Entra ID. Roles shouldn't be manually edited in Microsoft Entra ID when doing role imports. If you wish to assign users to a custom profile, then wait for profiles to be imported from Salesforce before assigning users to an application.
> [!NOTE]
> Once the users are provisioned in the Salesforce application, administrator need to configure the language specific settings for them. Please see [this](https://help.salesforce.com/articleView?id=setting_your_language.htm&type=5) article for more details on language configuration.
 
Modified by csmulligan on May 1, 2025 8:06 PM
πŸ“– View on learn.microsoft.com
+15 / -9 lines changed
Commit: What's new in April?
Changes:
Before
After
---
title: What's new in Microsoft Entra External ID
description: New and updated documentation for the Microsoft Entra External ID.
ms.date: 04/01/2025
ms.service: entra-external-id
ms.topic: whats-new
 
 
Welcome to what's new in documentation for Microsoft Entra External ID in workforce tenants. This article lists new docs that were added and docs that were significantly updated in the last three months. To learn what's new with the Microsoft Entra ID service, see [What's new in Microsoft Entra ID](~/fundamentals/whats-new.md).
 
## March 2025
 
### Updated articles
### Updated articles
 
- [Add federation with SAML/WS-Fed identity providers](direct-federation.md) - Editorial updates
- [Configure external collaboration settings for B2B in Microsoft Entra External ID](external-collaboration-settings-configure.md) - Global Administrator role update
 
## December 2024
 
---
title: What's new in Microsoft Entra External ID
description: New and updated documentation for the Microsoft Entra External ID.
ms.date: 05/01/2025
ms.service: entra-external-id
ms.topic: whats-new
 
 
Welcome to what's new in documentation for Microsoft Entra External ID in workforce tenants. This article lists new docs that were added and docs that were significantly updated in the last three months. To learn what's new with the Microsoft Entra ID service, see [What's new in Microsoft Entra ID](~/fundamentals/whats-new.md).
 
## April 2025
 
### New article
 
- [Migrate CrossTenantAccessPolicy JSON to the new Microsoft Graph API](migrate-to-xtap-v2-api.md)
 
### Updated articles
 
- [Tutorial - multifactor authentication for B2B](b2b-tutorial-require-mfa.md) - Editorial updates
- [Set up tenant restrictions v2](tenant-restrictions-v2.md) - Updated tenant restrictions v2 events
+15 / -5 lines changed
Commit: Fixes to boost engagement score
Changes:
Before
After
ms.subservice: enterprise-apps
 
ms.topic: tutorial
ms.date: 02/13/2025
ms.author: jomondi
ms.reviewer: jeedes
ms.collection: M365-identity-device-management
 
# Tutorial: Manage certificates for federated single sign-on
 
In this tutorial, we cover common questions and information related to certificates that Microsoft Entra ID creates to establish federated single sign-on (SSO) to your software as a service (SaaS) applications. Add applications from the Microsoft Entra application gallery or by using a non-gallery application template. Configure the application by using the federated SSO option.
 
This tutorial is relevant only to apps that are configured to use Microsoft Entra SSO through Security Assertion Markup Language (SAML).
 
In this tutorial, an administrator of the application learns how to:
 
 
## Autogenerated certificate for gallery and non-gallery applications
 
When you add a new application from the gallery and configure a SAML-based sign-on (by selecting **Single sign-on** > **SAML** from the application overview page), Microsoft Entra ID generates a self-signed certificate for the application that is valid for three years. To download the active certificate as a security certificate (**.cer**) file, return to that page (**SAML-based sign-on**) and select a download link in the **SAML Certificates** heading. You can choose between the raw (binary) certificate or the Base 64 (base 64-encoded text) certificate. For gallery applications, this section might also show a link to download the certificate as federation metadata XML (an **.xml** file), depending on the requirement of the application.
ms.subservice: enterprise-apps
 
ms.topic: tutorial
ms.date: 04/30/2025
ms.author: jomondi
ms.reviewer: jeedes
ms.collection: M365-identity-device-management
 
# Tutorial: Manage certificates for federated single sign-on
 
In this tutorial, learn how to manage federation certificates in Microsoft Entra ID by customizing expiration dates and renewing certificates for seamless SAML single sign‑on (SSO).
 
We cover common questions and information related to certificates that Microsoft Entra ID creates to establish federated single sign-on (SSO) to your software as a service (SaaS) applications. Add applications from the Microsoft Entra application gallery or by using a non-gallery application template. Configure the application by using the federated SSO option.
 
This tutorial is relevant to apps that are configured to use Microsoft Entra SSO through Security Assertion Markup Language (SAML).
 
In this tutorial, an administrator of the application learns how to:
 
 
## Autogenerated certificate for gallery and non-gallery applications
+9 / -9 lines changed
Commit: updating
Changes:
Before
After
### Breaking Change on Entra Connect Sync
 
>[!IMPORTANT]
> New Micrsoft Entra Connect Sync Versions will only be available via the Microsoft Entra Admin center
>
> Following up on our earlier [What’s New](../../../fundamentals/whats-new.md#general-availability---download-microsoft-entra-connect-sync-on-the-microsoft-entra-admin-center) communication, new versions of Microsoft Entra Connect Sync are only available on theβ€―[Microsoft Entra Connect blade](https://entra.microsoft.com/#view/Microsoft_AAD_Connect_Provisioning/AADConnectMenuBlade/%7E/GetStarted) within Microsoft Entra Admin center and will no longer be released to the [Microsoft Download Center](https://www.microsoft.com/en-us/download/details.aspx?id=47594).
 
 
 
> [!WARNING]
> The MSOnline PowerShell [retirement](https://aka.ms/msonlineretirement) will start impacting the Microsoft Entra Connect Sync wizard in April 2025. You must upgrade your Connect Sync version **by 30 April 2025** to maintain Connect Sync wizard capabilities such as schema refresh, configuration of staging mode, and user-sign in changes. The minimum supported versions are [2.4.18.0](reference-connect-version-history.md#24180) for commercial cloud and [2.4.21.0](reference-connect-version-history.md#24210) for non-commercial clouds, or any newer version. No action is required if your Microsoft Entra Connect Sync server is within the recommended version range. [Learn More](harden-update-ad-fs-pingfederate.md)
 
## Looking for the latest versions?
 
 
### Release status
 
04/30/2025: Released for download via the Microsoft Entra Admin center.
 
### Added Features
### Breaking Change on Entra Connect Sync
 
>[!IMPORTANT]
> New Micrsoft Entra Connect Sync Versions are only available via the Microsoft Entra admin center
>
> Following up on our earlier [What’s New](../../../fundamentals/whats-new.md#general-availability---download-microsoft-entra-connect-sync-on-the-microsoft-entra-admin-center) communication, new versions of Microsoft Entra Connect Sync are only available on theβ€―[Microsoft Entra Connect blade](https://entra.microsoft.com/#view/Microsoft_AAD_Connect_Provisioning/AADConnectMenuBlade/%7E/GetStarted) within Microsoft Entra admin center and are no longer be released to the [Microsoft Download Center](https://www.microsoft.com/en-us/download/details.aspx?id=47594).
 
 
 
> [!WARNING]
> The MSOnline PowerShell [retirement](https://aka.ms/msonlineretirement) will impact the Microsoft Entra Connect Sync wizard in April 2025. You must upgrade your Connect Sync version **by 30 April 2025** to maintain Connect Sync wizard capabilities such as schema refresh, configuration of staging mode, and user-sign in changes. The minimum supported versions are [2.4.18.0](reference-connect-version-history.md#24180) for commercial cloud and [2.4.21.0](reference-connect-version-history.md#24210) for non-commercial clouds, or any newer version. No action is required if your Microsoft Entra Connect Sync server is within the recommended version range. [Learn More](harden-update-ad-fs-pingfederate.md)
 
## Looking for the latest versions?
 
 
### Release status
 
04/30/2025: Released for download via the Microsoft Entra admin center.
 
### Added Features
Modified by Michele Martin on May 1, 2025 5:17 AM
πŸ“– View on learn.microsoft.com
+1 / -16 lines changed
Commit: reverse changes to include file
Changes:
Before
After
 
The required licenses vary based on the monitoring and health capability.
 
| Log / Report | Roles | Licenses |
|--|--|--|
| Audit logs | [Reports Reader](../identity/role-based-access-control/permissions-reference.md#reports-reader)<br>[Security Reader](../identity/role-based-access-control/permissions-reference.md#security-reader)<br>[Security Administrator](../identity/role-based-access-control/permissions-reference.md#security-administrator) | All editions of Microsoft Entra ID |
| Sign-in logs | [Reports Reader](../identity/role-based-access-control/permissions-reference.md#reports-reader)<br>[Security Reader](../identity/role-based-access-control/permissions-reference.md#security-reader)<br>[Security Administrator](../identity/role-based-access-control/permissions-reference.md#security-administrator) | All editions of Microsoft Entra ID |
| Sign-up logs (preview) | [Reports Reader](../identity/role-based-access-control/permissions-reference.md#reports-reader)<br>[Security Reader](../identity/role-based-access-control/permissions-reference.md#security-reader)<br>[Security Administrator](../identity/role-based-access-control/permissions-reference.md#security-administrator)<br>[Global Reader](../identity/role-based-access-control/permissions-reference.md#global-reader)<br> | Microsoft Entra External ID |
| Provisioning logs | [Reports Reader](../identity/role-based-access-control/permissions-reference.md#reports-reader)<br>[Security Reader](../identity/role-based-access-control/permissions-reference.md#security-reader)<br>[Application Administrator](../identity/role-based-access-control/permissions-reference.md#application-administrator)<br>[Cloud App Administrator](../identity/role-based-access-control/permissions-reference.md#cloud-application-administrator) | Microsoft Entra ID P1 or P2 |
| Custom security attribute audit logs* | [Attribute Log Administrator](../identity/role-based-access-control/permissions-reference.md#attribute-log-administrator)<br>[Attribute Log Reader](../identity/role-based-access-control/permissions-reference.md#attribute-log-reader) | All editions of Microsoft Entra ID |
| Health | [Reports Reader](../identity/role-based-access-control/permissions-reference.md#reports-reader)<br>[Security Reader](../identity/role-based-access-control/permissions-reference.md#security-reader)<br>[Helpdesk Administrator](../identity/role-based-access-control/permissions-reference.md#helpdesk-administrator) | Microsoft Entra ID P1 or P2 |
| Microsoft Entra ID Protection** | [Security Administrator](../identity/role-based-access-control/permissions-reference.md#security-administrator)<br>[Security Operator](../identity/role-based-access-control/permissions-reference.md#security-operator)<br>[Security Reader](../identity/role-based-access-control/permissions-reference.md#security-reader)<br>[Global Reader](../identity/role-based-access-control/permissions-reference.md#global-reader)<br> | Microsoft Entra ID Free<br>Microsoft 365 Apps<br>Microsoft Entra ID P1 or P2 |
| Microsoft Graph activity logs | [Security Administrator](../identity/role-based-access-control/permissions-reference.md#security-administrator)<br>Permissions to access data in the corresponding log destination | Microsoft Entra ID P1 or P2 |
| Usage and insights | [Reports Reader](../identity/role-based-access-control/permissions-reference.md#reports-reader)<br>[Security Reader](../identity/role-based-access-control/permissions-reference.md#security-reader)<br>[Security Administrator](../identity/role-based-access-control/permissions-reference.md#security-administrator) | Microsoft Entra ID P1 or P2 |
 
*Viewing the custom security attributes in the audit logs or creating diagnostic settings for custom security attributes requires one of the Attribute Log roles. You also need the appropriate role to view the standard audit logs.
 
**The level of access and capabilities for Microsoft Entra ID Protection varies with the role and license. For more information, see the [license requirements for ID Protection](~/id-protection/overview-identity-protection.md#license-requirements).
| Capability | Microsoft Entra ID Free | Microsoft Entra ID P1 or P2 / Microsoft Entra Suite |
| --- | --- | --- |
 
The required licenses vary based on the monitoring and health capability.
 
| Capability | Microsoft Entra ID Free | Microsoft Entra ID P1 or P2 / Microsoft Entra Suite |
| --- | --- | --- |
| Audit logs | Yes | Yes |
| Custom security attributes | Yes | Yes |
| Health | No | Yes |
| Microsoft Graph activity logs | No | Yes |
| Usage and insights | No | Yes |
 
 
 
 
 
 
 
 
 
 
+7 / -7 lines changed
Commit: Update how-to-manage-ssh-server-administration.md
Changes:
Before
After
# Management for SSH-based server administration
It's widely recognized by the IT industry that IT administrators use Secure Shell (SSH) as a critical service to enable security while managing configuration, deployment, and maintenance of servers and applications in an organization's infrastructure. SSH is a secure way to access and manage devices over an unsecured network. SSH encryption protocols, ensure the integrity and confidentiality of administrative tasks and remote system interactions, which are pivotal to maintain operational efficiency and reduce potential security risks.
In this guide learn to configure and establish an SSH connection using Microsoft Entra Private Access for enhanced security. Organizations use Private Access to modernize user access to private apps and resources.
You can [learn more about Private Access](concept-private-access.md).
* **Licensing** - Learn about licensing and the products that make up [Microsoft Global Secure Access](overview-what-is-global-secure-access.md)
* Learn more about [Microsoft Entra plans and pricing](https://aka.ms/azureadlicense)
* **A remote server with SSH** enabled
* **GSA private connector** with network connectivity to the resource
* Learn how to [configure connectors](how-to-configure-connectors.md)
* **A device with the GSA client** on Microsoft Entra joined, or Microsoft Entra hybrid joined
* **Private Access profile** enabled
## Global Secure Access client review and testing
In this section find links to guidance to install and configure the Microsoft Global Secure Access [client](concept-clients.md) on user devices.
# Management for SSH-based server administration
It's widely recognized by the IT industry that IT administrators use Secure Shell (SSH) as a critical service. Admins enable security while managing configuration, deployment, and maintenance of servers and applications in an organization's infrastructure. SSH is a secure way to access and manage devices over an unsecured network. SSH encryption protocols, ensure the integrity and confidentiality of administrative tasks and remote system interactions, pivotal for operational efficiency and risk reduction.
In this guide, learn to configure and establish an SSH connection using Microsoft Entra Private Access for enhanced security. Organizations use Private Access to modernize user access to private apps and resources.
You can [learn more about Private Access](concept-private-access.md).
* **Licensing** - Learn about licensing and the products that make up [Microsoft Global Secure Access](overview-what-is-global-secure-access.md)
* Learn more about [Microsoft Entra plans and pricing](https://aka.ms/azureadlicense)
* **A remote server with SSH** enabled
* **Microsoft Global Secure Access (GSA) private connector** with network connectivity to the resource
* Learn how to [configure connectors](how-to-configure-connectors.md)
* **A device with the GSA client** on Microsoft Entra joined, or Microsoft Entra hybrid joined
* **Private Access profile** enabled
## Global Secure Access client review and testing
In this section, find links to guidance to install and configure the Microsoft Global Secure Access [client](concept-clients.md) on user devices.
Modified by John Flores on May 1, 2025 12:06 AM
πŸ“– View on learn.microsoft.com
+11 / -2 lines changed
Commit: [Conditional Access] Agent settings update
Changes:
Before
After
 
- During the preview, avoid using an account to set up the agent that requires role activation with Privileged Identity Management. Using an account that doesn't have standing permissions might cause authentication failures for the agent.
- Once agents are started, they can't be stopped or paused. It might take a few minutes to run.
- The agent is configured to run every 24 hours based on when it's initially configured. Toggling the trigger to off under the settings page of the agent and back on at a specific time reconfigures the agent to run at that time.
- For policy consolidation, each agent run only looks at four similar policy pairs
- The agent currently runs as the user who enables it.
- In preview, you should only run the agent from the Microsoft Entra admin center.
 
:::image type="content" source="media/agent-optimization/conditional-access-optimization-agent-overview.png" alt-text="Screenshot showing the Conditional Access Optimization Agent enabled in an organization." lightbox="media/agent-optimization/conditional-access-optimization-agent-overview.png":::
 
1. Selecting a suggestion provides you with more detail to back up the suggestion, along with the ability to review the changes in the policy viewer or in JSON format.
1. Newly created policies are created in report-only mode. As a best practice organizations should exclude their break-glass accounts from policy to avoid being locked out due to misconfiguration.
 
> [!TIP]
 
Use the **Give Microsoft feedback** button at the top of the agent window to provide feedback to Microsoft about the agent.
 
## Remove agent
 
If you no longer wish to use the Conditional Access optimization agent, you can remove it using the **Remove agent** button at the top of the agent window.
 
- During the preview, avoid using an account to set up the agent that requires role activation with Privileged Identity Management. Using an account that doesn't have standing permissions might cause authentication failures for the agent.
- Once agents are started, they can't be stopped or paused. It might take a few minutes to run.
- For policy consolidation, each agent run only looks at four similar policy pairs
- The agent currently runs as the user who enables it.
- In preview, you should only run the agent from the Microsoft Entra admin center.
 
:::image type="content" source="media/agent-optimization/conditional-access-optimization-agent-overview.png" alt-text="Screenshot showing the Conditional Access Optimization Agent enabled in an organization." lightbox="media/agent-optimization/conditional-access-optimization-agent-overview.png":::
 
1. Selecting a suggestion allows you to see the proposed change, make edits, see [potential policy impact](concept-conditional-access-report-only.md#reviewing-results).
1. Newly created policies are created in report-only mode. As a best practice organizations should exclude their break-glass accounts from policy to avoid being locked out due to misconfiguration.
 
> [!TIP]
 
Use the **Give Microsoft feedback** button at the top of the agent window to provide feedback to Microsoft about the agent.
 
## Settings
 
The agent is configured to run every 24 hours based on when it's initially configured. Toggling **Trigger** to off under the settings page of the agent and back on at a specific time reconfigures the agent to run at that time.
 
Modified by Regan Downer on May 1, 2025 11:30 PM
πŸ“– View on learn.microsoft.com
+6 / -6 lines changed
Commit: Acrolinx
Changes:
Before
After
| AADSTS50102 | Unable to load CustomClaimsTransformer '{type}' was specified for principal '{principalId}'. |
| AADSTS50103 | There was an error transforming the claims for the token: {errorMessage} |
| AADSTS50105 | EntitlementGrantsNotFound - The signed in user isn't assigned to a role for the signed in app. Assign the user to the app. To learn more, see the troubleshooting article for error [AADSTS50105](/troubleshoot/azure/active-directory/error-code-aadsts50105-user-not-assigned-role). |
| AADSTS50107 |The requested federation realm object '{name}' does not exist. Application error - the login request was malformed and could not be matched with an existing authentication endpoint or instance. |
| AADSTS50108 | Claims transformation configuration could not be retrieved. |
| AADSTS50109 | Claim transformation is unknown from configuration. |
| AADSTS50111 | Unknown claim transformation was asked to be applied. |
| AADSTS50138 | Invalid encryption key environment. |
| AADSTS50139 | SessionMissingMsaOAuth2RefreshToken - The session is invalid due to a missing external refresh token. |
| AADSTS50140 | KmsiInterrupt - This error occurred due to "Keep me signed in" interrupt when the user was signing-in. This is an expected part of the sign in flow, where a user is asked if they want to remain signed into their current browser to make further logins easier. For more information, see [The new Microsoft Entra sign-in and β€œKeep me signed in” experiences rolling out now!](https://techcommunity.microsoft.com/t5/azure-active-directory-identity/the-new-azure-ad-sign-in-and-keep-me-signed-in-experiences/m-p/128267). You can [open a support ticket](~/fundamentals/how-to-get-support.md) with Correlation ID, Request ID, and Error code to get more details.|
| AADSTS50141 | Protected key is not intended for the authenticated user. |
| AADSTS50142 | Password change is required due to a conditional access policy. |
| AADSTS50143 | Session mismatch - Session is invalid because user tenant doesn't match the domain hint due to different resource.Β [Open a support ticket](~/fundamentals/how-to-get-support.md) with Correlation ID, Request ID, and Error code to get more details. |
| AADSTS50144 | InvalidPasswordExpiredOnPremPassword - User's Active Directory password has expired. Generate a new password for the user or have the user use the self-service reset tool to reset their password. |
| AADSTS50147 | Invalid size of the code challenge parameter. Contact the application owner to correct their use of the PKCE parameters. |
| AADSTS50148 | The code_verifier does not match the code_challenge supplied in the authorization request for PKCE. Contact the application owner to correct their use of the PKCE parameters. |
| AADSTS50146 | MissingCustomSigningKey - This app is required to be configured with an app-specific signing key. It's either not configured with one, or the key has expired or isn't yet valid. Please contact the owner of the application. |
| AADSTS501461 | AcceptMappedClaims is only supported for a token audience matching the application GUID or an audience within the tenant's verified domains. Either change the resource identifier, or use an application-specific signing key. |
| AADSTS50147 | MissingCodeChallenge - The size of the code challenge parameter isn't valid. |
| AADSTS50155 | DeviceAuthenticationFailed - Device authentication failed for this user. |
| AADSTS50102 | Unable to load CustomClaimsTransformer '{type}' was specified for principal '{principalId}'. |
| AADSTS50103 | There was an error transforming the claims for the token: {errorMessage} |
| AADSTS50105 | EntitlementGrantsNotFound - The signed in user isn't assigned to a role for the signed in app. Assign the user to the app. To learn more, see the troubleshooting article for error [AADSTS50105](/troubleshoot/azure/active-directory/error-code-aadsts50105-user-not-assigned-role). |
| AADSTS50107 |The requested federation realm object '{name}' doesn't exist. Application error - the login request was malformed and couldn't be matched with an existing authentication endpoint or instance. |
| AADSTS50108 | Claims transformation configuration could not be retrieved. |
| AADSTS50109 | Claim transformation is unknown from configuration. |
| AADSTS50111 | Unknown claim transformation was asked to be applied. |
| AADSTS50138 | Invalid encryption key environment. |
| AADSTS50139 | SessionMissingMsaOAuth2RefreshToken - The session is invalid due to a missing external refresh token. |
| AADSTS50140 | KmsiInterrupt - This error occurred due to "Keep me signed in" interrupt when the user was signing-in. This is an expected part of the sign in flow, where a user is asked if they want to remain signed into their current browser to make further logins easier. For more information, see [The new Microsoft Entra sign-in and β€œKeep me signed in” experiences rolling out now!](https://techcommunity.microsoft.com/t5/azure-active-directory-identity/the-new-azure-ad-sign-in-and-keep-me-signed-in-experiences/m-p/128267). You can [open a support ticket](~/fundamentals/how-to-get-support.md) with Correlation ID, Request ID, and Error code to get more details.|
| AADSTS50141 | Protected key isn't intended for the authenticated user. |
| AADSTS50142 | Password change is required due to a conditional access policy. |
| AADSTS50143 | Session mismatch - Session is invalid because user tenant doesn't match the domain hint due to different resource.Β [Open a support ticket](~/fundamentals/how-to-get-support.md) with Correlation ID, Request ID, and Error code to get more details. |
| AADSTS50144 | InvalidPasswordExpiredOnPremPassword - User's Active Directory password has expired. Generate a new password for the user or have the user use the self-service reset tool to reset their password. |
| AADSTS50147 | Invalid size of the code challenge parameter. Contact the application owner to correct their use of the PKCE parameters. |
| AADSTS50148 | The code_verifier doesn't match the code_challenge supplied in the authorization request for PKCE. Contact the application owner to correct their use of the PKCE parameters. |
| AADSTS50146 | MissingCustomSigningKey - This app is required to be configured with an app-specific signing key. It's either not configured with one, or the key has expired or isn't yet valid. Please contact the owner of the application. |
| AADSTS501461 | AcceptMappedClaims is only supported for a token audience matching the application GUID or an audience within the tenant's verified domains. Either change the resource identifier, or use an application-specific signing key. |
| AADSTS50147 | MissingCodeChallenge - The size of the code challenge parameter isn't valid. |
| AADSTS50155 | DeviceAuthenticationFailed - Device authentication failed for this user. |
+5 / -5 lines changed
Commit: Fixes links.
Changes:
Before
After
ms.author: kenwith
manager: femila
ms.topic: how-to
ms.date: 04/16/2025
ms.service: global-secure-access
ms.subservice: entra-private-access
ms.reviewer: shkhalid
1. Navigate to **Zscaler Client** > **Private Access**. Verify **Service Status** is `DISABLED`.
 
> [!NOTE]
> For information troubleshooting health check failures, see [Troubleshoot the Global Secure Access client diagnostics - Health check](troubleshoot-global-secure-access-client-diagnostics-health-check).
 
Test traffic flow:
1. In the system tray, right-click **Global Secure Access Client** and then select **Advanced Diagnostics**. Select the **Traffic** tab and select **Start collecting**.
1. Navigate to **Zscaler Client** > **Private Access**. Verify **Service Status** is `ON` and Authentication Status is `Authenticated`.
 
> [!NOTE]
> For information troubleshooting health check failures, see [Troubleshoot the Global Secure Access client diagnostics - Health check](troubleshoot-global-secure-access-client-diagnostics-health-check).
 
Test traffic flow:
ms.author: kenwith
manager: femila
ms.topic: how-to
ms.date: 04/30/2025
ms.service: global-secure-access
ms.subservice: entra-private-access
ms.reviewer: shkhalid
1. Navigate to **Zscaler Client** > **Private Access**. Verify **Service Status** is `DISABLED`.
 
> [!NOTE]
> For information troubleshooting health check failures, see [Troubleshoot the Global Secure Access client diagnostics - Health check](troubleshoot-global-secure-access-client-diagnostics-health-check.md).
 
Test traffic flow:
1. In the system tray, right-click **Global Secure Access Client** and then select **Advanced Diagnostics**. Select the **Traffic** tab and select **Start collecting**.
1. Navigate to **Zscaler Client** > **Private Access**. Verify **Service Status** is `ON` and Authentication Status is `Authenticated`.
 
> [!NOTE]
> For information troubleshooting health check failures, see [Troubleshoot the Global Secure Access client diagnostics - Health check](troubleshoot-global-secure-access-client-diagnostics-health-check.md).
 
Test traffic flow: