📋 Microsoft Entra Documentation Changes

Changes for May 18th 2025

Period: May 17th 2025, 12:00 AM to May 18th 2025, 12:00 AM

📚 Historical Report: This report shows documentation changes that occurred during the 24-hour period ending on May 18th 2025.

📊 Summary

65
Total Commits
0
New Files
29
Modified Files
0
Deleted Files
25
Contributors

📝 Modified Documentation Files

+233 / -371 lines changed
Commit: Update concept-mfa-regional-opt-in.md
Changes:
Before
After
 
IRSF poses a significant threat to online businesses and can cause reputational damage. By understanding IRSF, you can be more aware of the problem and can engage in implementing preventive measures such as regional restrictions, rate limiting, and phone number verification.
 
## SMS verification
 
For SMS verification, the following region codes require an opt-in. This means that if you'd like to use telecom in these regions, you'll have to reach out to support.
 
| Region Code | Region Name |
|------------|------------|
| 7 | Russia |
| 20 | Egypt |
| 53 | Cuba |
| 58 | Venezuela |
| 62 | Indonesia |
| 63 | Philippines |
| 84 | Vietnam |
| 92 | Pakistan |
| 93 | Afghanistan |
| 94 | Sri Lanka |
| 95 | Myanmar |
 
IRSF poses a significant threat to online businesses and can cause reputational damage. By understanding IRSF, you can be more aware of the problem and can engage in implementing preventive measures such as regional restrictions, rate limiting, and phone number verification.
 
## SMS and Voice Verification
For SMS and Voice verification, the following region codes require an opt-in. This means that if you'd like to use telecom in these regions, you'll have to reach out to support.
 
| Region Code | Region Name |
|------------|------------|
| 7 | Russia |
| 20 | Egypt |
| 27 | South Africa |
| 30 | Greece |
| 31 | Netherlands |
| 32 | Belgium |
| 36 | Hungary |
| 39 | Italy |
| 40 | Romania |
| 41 | Switzerland |
| 43 | Austria |
+240 / -29 lines changed
Commit: updated linkables for spo and teams
Changes:
Before
After
 
# Track and investigate identity activities with linkable identifiers in Microsoft Entra (preview)
 
Microsoft includes certain identifiers in all tokens that can be used to link activities from one root authentication. Linkable identifiers are currently in preview and exposed in customer-facing logs. Linkable identifiers help threat hunters and analysts investigate and remediate identity-related attacks. They significantly improve how security analysts and professionals can track, investigate, and remediate identity-related attacks across sessions and tokens, providing you with a more secure and transparent ecosystem.
 
There are two types of linkable identifiers:
 
- One is based on session ID (SID). It helps link all authentication artifacts issued from a single root authentication with the same identifier, which can be used to link or connect tokens in a single chain together. For example, a SID-based linkable identifier can track all the activities done by all the access tokens issued from a long-lived token, like a [refresh token (RT)](/entra/identity-platform/refresh-tokens) or session cookies.
- Another tracks activities done by a specific token access, like an [access token (AT)](/entra/identity-platform/access-tokens) or [ID token](/entra/identity-platform/id-tokens).
 
To help link all authentication artifacts issued from a single root authentication, the SID claim is created and included in primary refresh tokens (PRT), refresh token, or session cookie each time a user performs an interactive authentication for an account. The same SID value is added to each access token issued from a refresh token or in session cookie. It can be used to link all authentication artifacts, and can further filter for a specific user or device within a session.
 
SID-based scenarios include:
 
- Start with a session ID from Microsoft Entra sign in logs, and join with workload logs like Exchange Online audit logs or Microsoft Graph activity logs to identify all the activities done by all of the access tokens with the same session ID.
- Filter results further by UserId or DeviceId, or with a token issued within a time frame of a specific session.
- Determine how many sessions are alive for a given user (UserId) or a given device (DeviceId).
 
In addition, Microsoft Entra has another important linkable security claim called unique token identifier (UTI) that is a unique GUID present in all Microsoft Entra tokens. It serves to uniquely identify a token or request.
 
 
# Track and investigate identity activities with linkable identifiers in Microsoft Entra (preview)
 
## Overview
 
Microsoft embeds specific identifiers in all access tokens that enable the correlation of activities back to a single root authentication event. These linkable identifiers are surfaced in customer-facing logs to support threat hunters and security analysts in investigating and mitigating identity-based attacks. By leveraging these identifiers, security professionals can more effectively trace, analyze, and respond to malicious activity across sessions and tokens, enhancing both the transparency and security of the environment.
 
There are two types of linkable identifiers used to to support advanced identity investigation and threat hunting scenarios:
 
**Session ID (SID)-Based Identifier**
The SID-based identifier enables correlation of all authentication artifacts such as [access token (AT)](/entra/identity-platform/access-tokens), [refresh token (RT)](/entra/identity-platform/refresh-tokens), and session cookies issued from a single root authentication event. This identifier is especially useful for tracking activity across a session.
 
Common SID-based investigation scenarios include:
 
- Correlating activity across services: Start with a session ID from Microsoft Entra sign-in logs and join it with workload logs (e.g., Exchange Online audit logs or Microsoft Graph activity logs) to identify all actions performed by access tokens sharing the same session ID.
- Filtering by user or device: Narrow results using UserId, DeviceId, or by filtering tokens issued within a specific session timeframe.
Session enumeration: Determine how many active sessions exist for a specific user (UserId) or device (DeviceId).
- The SID claim is generated during interactive authentication and included in the primary refresh token (PRT), refresh token, or session cookie. All access tokens issued from these sources inherit the same SID, enabling consistent linkage across authentication artifacts.
 
**Unique Token Identifier (UTI)**
Modified by ShawnJackson on May 17, 2025 8:01 AM
📖 View on learn.microsoft.com
+58 / -61 lines changed
Commit: edit pass: articles-about-tenant-restrictions
Changes:
Before
After
---
title: Plan a tenant restrictions v1 migration to tenant restrictions v2
description: Learn about tenant-level restrictions and controls for users, groups, and applications, also policy management in a cloud-based portal.
author: gargi-sinha
manager: martinco
ms.service: entra-id
[!INCLUDE [applies-to-workforce-only](./includes/applies-to-workforce-only.md)]
Administrators use [tenant restrictions v1](~/identity/enterprise-apps/tenant-restrictions.md) to control user access to external tenants on their network. However, [tenant restrictions v2](tenant-restrictions-v2.md) with cross tenant access settings adds tenant-level restrictions and more granularity such as individual user, group, and application controls. Tenant restrictions v2 moves policy management from network proxies to a cloud-based portal. Organizations no longer hit a maximum number of targeted tenants due to proxy header size limitations.
Migration from tenant restrictions v1 to tenant restrictions v2 is a one-time process with no other licensing requirements. As you plan the migration, include stakeholders from networking and identity teams.
## Prerequisites
Ensure the following prerequisites are met.
* Administrator access to proxies injecting the tenant restrictions v1 headers
* Proxies can use on-premises or a cloud-based service
* [Microsoft Entra ID P1 or P2](~/fundamentals/get-started-premium.md) licenses
---
title: Plan a Tenant Restrictions v1 Migration to Tenant Restrictions v2
description: Learn about tenant-level restrictions and controls for users, groups, and applications, along with policy management in a cloud-based portal.
author: gargi-sinha
manager: martinco
ms.service: entra-id
[!INCLUDE [applies-to-workforce-only](./includes/applies-to-workforce-only.md)]
Administrators use [tenant restrictions v1](~/identity/enterprise-apps/tenant-restrictions.md) to control user access to external tenants on their network. However, [tenant restrictions v2](tenant-restrictions-v2.md) with cross-tenant access settings adds tenant-level restrictions. Tenant restrictions v2 also adds more granularity, such as individual user, group, and application controls.
Tenant restrictions v2 moves policy management from network proxies to a cloud-based portal. Organizations no longer hit a maximum number of targeted tenants due to size limitations for proxy headers.
Migration from tenant restrictions v1 to tenant restrictions v2 is a one-time process with no other licensing requirements. As you plan the migration, include stakeholders from network and identity teams.
## Prerequisites
* Administrator access to proxies that inject the tenant restrictions v1 headers. Proxies can be on-premises or from a cloud-based service.
* [Microsoft Entra ID P1 or P2](~/fundamentals/get-started-premium.md) license.
* Verification of migration feasibility. See the [unsupported scenarios for tenant restrictions v2](tenant-restrictions-v2.md#unsupported-scenarios).
+22 / -46 lines changed
Commit: Update how-to-manage-ssh-server-administration.md
Changes:
Before
After
---
title: Management for SSH-based server administration
description: Learn to configure and establish a Secure Shell (SSH) connection using Microsoft Entra Private Access for enhanced security.
author: jricketts
manager: martinco
ai-usage: human-only
---
# Management for SSH-based server administration
Secure Shell (SSH) is widely recognized across the IT industry as a critical service for system administrators. It provides a secure and encrypted method to access and manage remote systems over unsecured networks.
IT administrators rely on SSH to perform essential tasks securely, including the configuration, deployment, and maintenance of servers and applications in an organization’s infrastructure.
In this guide and [in this video](https://www.youtube.com/watch?v=n6gTjAK-Y0Y), you learn how to configure and establish an SSH connection using Microsoft Entra Private Access to enhance security in your remote access workflows.
You can [learn more about Private Access](concept-private-access.md).
## Establish SSH connections with Private Access
Microsoft Entra Private Access enhances the security and efficiency of SSH management traffic by providing a secure, identity-centric Zero Trust Network Access (ZTNA) solution by allowing IT administrators to establish SSH connections to remote servers securely.
---
title: Use SSH to administer servers with Microsoft Entra Private Access
description: Learn to configure and establish a Secure Shell (SSH) connection using Microsoft Entra Private Access for enhanced security.
author: jricketts
manager: martinco
ai-usage: human-only
---
# Use SSH to administer remote servers
Secure Shell (SSH) is widely recognized across the IT industry as a critical service for system administrators. It provides a secure and encrypted method to access and manage remote systems over unsecured networks.
IT administrators rely on SSH to perform essential tasks securely, including the configuration, deployment, and maintenance of servers and applications in an organization’s infrastructure.
In this guide and [in this video](https://www.youtube.com/watch?v=n6gTjAK-Y0Y), you learn how to configure and establish an SSH connection using Microsoft Entra Private Access to enhance security in your remote access workflows.
## Establish SSH connections with Microsoft Entra Private Access
Microsoft Entra Private Access enhances the security and efficiency of SSH management traffic by providing a secure, identity-centric Zero Trust Network Access (ZTNA) solution by allowing IT administrators to establish SSH connections to remote servers securely.
* Learn more about [Microsoft Entra plans and pricing](https://aka.ms/azureadlicense)
+29 / -29 lines changed
Commit: May 16 completed draft
Changes:
Before
After
 
---
# Global Secure Access certifications
Global Secure Access supports compliance across different regulated industries and global markets. This article lists the current certifications and updates the list as new certifications are completed.
 
## Supported certifications
Global Secure Access is included in several Azure compliance audits. The supported certifications are:
| Certification | Details | Inherited from | Status |
| --- | --- | --- | --- |
| [Canadian Privacy Laws](https://global.azure.com/auditmanager/certificates/views/cert/217) | Canadian privacy laws—such as the Privacy Act, Personal Information Protection and Electronic Documents Act (PIPEDA), Alberta Personal Information Protection Act (PIPA), and British Columbia Freedom of Information and Protection of Privacy Act (BC FIPPA)—aim to protect the privacy of individuals and give them the right to access information gathered about them. For more information, see [Canadian Privacy Laws](/azure/compliance/offerings/offering-canada-privacy-laws) | [ISO 27001:2013](https://global.azure.com/auditmanager/certificates/views/cert/95) | |
| [CDSA](https://global.azure.com/auditmanager/certificates/views/cert/94) | The Content Delivery & Security Association (CDSA) Content Protection & Security (CPS) Standard provides guidance and requirements for securing media assets within a Content Security Management System (CSMS). The standard specifies a set of controls designed to ensure the integrity of intellectual property and the confidentiality and security of media assets at every stage of the digital media supply chain. For more information, see [Content Delivery & Security Association (CDSA) - Azure Compliance](/azure/compliance/offerings/offering-cdsa) | [ISO 27001:2013](https://global.azure.com/auditmanager/certificates/views/cert/95) | Certification available |
| [CSA STAR](https://global.azure.com/auditmanager/certificates/views/cert/132) | The CSA STAR Certification is based on achieving ISO 27001 certification and meeting criteria specified in the Cloud Controls Matrix (CCM). It demonstrates that a cloud service provider conforms to the applicable requirements of ISO 27001, has addressed issues critical to cloud security as outlined in the CCM, and has been assessed against the STAR Capability Maturity Model for the management of activities in CCM control areas. For more information, see [CSA STAR Certification](/azure/compliance/offerings/offering-csa-star-certification) | [ISO 27001:2013](https://global.azure.com/auditmanager/certificates/views/cert/95) | |
| [DoD DISA SRG Level 2](https://global.azure.com/auditmanager/certificates/views/cert/122) | The Defense Information Systems Agency (DISA) is an agency of the US Department of Defense (DoD) that is responsible for developing and maintaining the DoD Cloud Computing Security Requirements Guide (SRG). The SRG defines the baseline security requirements used by DoD to assess the security posture of a cloud service provider (CSP), supporting the decision to grant a DoD Provisional Authorization (PA) that allows a CSP to host DoD missions. It incorporates, supersedes, and rescinds the previously published DoD Cloud Security Model (CSM). For more information, see [DoD DISA SRG Level 2](/azure/compliance/offerings/offering-dod-il2) | [FedRAMP High](https://global.azure.com/auditmanager/certificates/views/cert/139) | |
| [EAR](https://global.azure.com/auditmanager/certificates/views/cert/191) | The US Department of Commerce is responsible for enforcing the Export Administration Regulations (EAR) through the Bureau of Industry and Security (BIS). According to BIS definitions, Export is the transfer of protected technology or information to a foreign destination or release of protected technology or information to a foreign person in the United States (also known as Deemed Export). For more information, see [EAR](/azure/compliance/offerings/offering-ear) | [FedRAMP High](https://global.azure.com/auditmanager/certificates/views/cert/139) | |
| [FedRAMP High](https://global.azure.com/auditmanager/certificates/views/cert/139) | The US Federal Risk and Authorization Management Program (FedRAMP) was established in December 2011 to provide a standardized approach for assessing, monitoring, and authorizing cloud service providers (CSPs). For more information, see [FedRAMP High](/azure/compliance/offerings/offering-fedramp) | NA | |
| [FIPS 140-2](https://global.azure.com/auditmanager/certificates/views/cert/147) | The Federal Information Processing Standard (FIPS) Publication 140-2 is a US government standard that defines minimum security requirements for cryptographic modules in products and systems. Validation against the FIPS 140-2 standard is required for all US federal government agencies that use cryptography-based security systems to protect sensitive but unclassified information stored digitally. For more information, see [FIPS 140-2](/azure/compliance/offerings/offering-fips-140-2) | [FedRAMP High](https://global.azure.com/auditmanager/certificates/views/cert/139) | |
| [GDPR](https://global.azure.com/auditmanager/certificates/views/cert/218) | The General Data Protection Regulation (GDPR) is a European privacy law that became effective in May 2018. It imposes new rules on organizations that offer goods and services to people in the European Union (EU) or that collect and analyze data belonging to EU individuals. The GDPR requires that data controllers (such as organizations using Azure) only use data processors (such as Microsoft) that provide sufficient guarantees to meet key requirements of the GDPR. For more information, see [GDPR](/compliance/regulatory/gdpr) | [ISO 27001:2013](https://global.azure.com/auditmanager/certificates/views/cert/95) | |
| [GxP (FDA 21 CFR Part 11)](https://global.azure.com/auditmanager/certificates/views/cert/156) | Azure can help customers meet their requirements under Good Clinical, Laboratory, and Manufacturing Practices (GxP), as well as regulations enforced by the US Food and Drug Administration (FDA) under 21 CFR Part 11. For more information, see [GxP (FDA 21 CFR Part 11)](/azure/compliance/offerings/offering-gxp) | [ISO 27001:2013](https://global.azure.com/auditmanager/certificates/views/cert/95) | |
| [HDS (France)](https://global.azure.com/auditmanager/certificates/views/cert/209) | Microsoft Azure has been granted the Health Data Hosting (Hébergeurs de Données de Santé, HDS) certification, which is required for all entities hosting personal health data governed by French law. This made Microsoft the first major cloud service provider to meet the strict French standards for storing and processing health data. For more information, see [HDS (France)](/compliance/regulatory/offering-hds-france) | [ISO 27001:2013](https://global.azure.com/auditmanager/certificates/views/cert/95) | |
 
---
# Global Secure Access certifications
Global Secure Access supports compliance across different regulated industries and global markets. This article lists the current certifications and updates as Global Secure Access acquires new certifications.
 
## Supported certifications
Global Secure Access is included in several Azure compliance audits. The supported certifications are:
| Certification | Details | Inherited from | Status |
| --- | --- | --- | --- |
| [Canadian Privacy Laws](https://global.azure.com/auditmanager/certificates/views/cert/217) | Canadian privacy laws aim to protect the privacy of individuals and give them the right to access information gathered about them. These privacy laws include the Privacy Act, Personal Information Protection and Electronic Documents Act (PIPEDA), Alberta Personal Information Protection Act (PIPA), and British Columbia Freedom of Information and Protection of Privacy Act (BC FIPPA). For more information, see [Canadian Privacy Laws](/azure/compliance/offerings/offering-canada-privacy-laws). | [ISO 27001:2013](https://global.azure.com/auditmanager/certificates/views/cert/95) | |
| [CDSA](https://global.azure.com/auditmanager/certificates/views/cert/94) | The Content Delivery & Security Association (CDSA) Content Protection & Security (CPS) standard provides guidance and requirements for securing media assets within a Content Security Management System (CSMS). The standard includes controls to protect intellectual property and keep media assets secure and confidential throughout the digital media supply chain. For more information, see [Content Delivery & Security Association (CDSA) - Azure Compliance](/azure/compliance/offerings/offering-cdsa). | [ISO 27001:2013](https://global.azure.com/auditmanager/certificates/views/cert/95) | Certification available |
| [CSA STAR](https://global.azure.com/auditmanager/certificates/views/cert/132) | Cloud Security Alliance (CSA) STAR certification is based on achieving ISO 27001 certification and meeting criteria in the Cloud Controls Matrix (CCM). It shows that a cloud service provider meets ISO 27001 requirements, addresses key cloud security issues in the CCM, and is assessed against the STAR Capability Maturity Model for managing activities in CCM control areas. For more information, see [CSA STAR certification](/azure/compliance/offerings/offering-csa-star-certification). | [ISO 27001:2013](https://global.azure.com/auditmanager/certificates/views/cert/95) | |
| [DoD DISA SRG Level 2](https://global.azure.com/auditmanager/certificates/views/cert/122) | The Defense Information Systems Agency (DISA) is an agency of the US Department of Defense (DoD) that is responsible for developing and maintaining the DoD Cloud Computing Security Requirements Guide (SRG). The SRG defines the baseline security requirements used by DoD to assess the security posture of a cloud service provider (CSP), supporting the decision to grant a DoD Provisional Authorization (PA) that allows a CSP to host DoD missions. It incorporates, supersedes, and rescinds the previously published DoD Cloud Security Model (CSM). For more information, see [DoD DISA SRG Level 2](/azure/compliance/offerings/offering-dod-il2). | [FedRAMP High](https://global.azure.com/auditmanager/certificates/views/cert/139) | |
| [EAR](https://global.azure.com/auditmanager/certificates/views/cert/191) | The US Department of Commerce is responsible for enforcing the Export Administration Regulations (EAR) through the Bureau of Industry and Security (BIS). According to BIS definitions, Export is the transfer of protected technology or information to a foreign destination or release of protected technology or information to a foreign person in the United States (also known as Deemed Export). For more information, see [EAR](/azure/compliance/offerings/offering-ear) | [FedRAMP High](https://global.azure.com/auditmanager/certificates/views/cert/139) | |
| [FedRAMP High](https://global.azure.com/auditmanager/certificates/views/cert/139) | The US Federal Risk and Authorization Management Program (FedRAMP) was established in December 2011 to provide a standardized approach for assessing, monitoring, and authorizing cloud service providers (CSPs). For more information, see [FedRAMP High](/azure/compliance/offerings/offering-fedramp). | NA | |
| [FIPS 140-2](https://global.azure.com/auditmanager/certificates/views/cert/147) | The Federal Information Processing Standard (FIPS) Publication 140-2 is a US government standard that defines minimum security requirements for cryptographic modules in products and systems. Validation against the FIPS 140-2 standard is required for all US federal government agencies that use cryptography-based security systems to protect sensitive but unclassified information stored digitally. For more information, see [FIPS 140-2](/azure/compliance/offerings/offering-fips-140-2). | [FedRAMP High](https://global.azure.com/auditmanager/certificates/views/cert/139) | |
| [GDPR](https://global.azure.com/auditmanager/certificates/views/cert/218) | The General Data Protection Regulation (GDPR) is a European privacy law that became effective in May 2018. It imposes new rules on organizations that offer goods and services to people in the European Union (EU) or that collect and analyze data belonging to EU individuals. The GDPR requires that data controllers, such as organizations using Azure, only use data processors, such as Microsoft, that provide sufficient guarantees to meet key requirements of the GDPR. For more information, see [GDPR](/compliance/regulatory/gdpr). | [ISO 27001:2013](https://global.azure.com/auditmanager/certificates/views/cert/95) | |
| [GxP (FDA 21 CFR Part 11)](https://global.azure.com/auditmanager/certificates/views/cert/156) | Azure can help customers meet their requirements under Good Clinical, Laboratory, and Manufacturing Practices (GxP), as well as regulations enforced by the US Food and Drug Administration (FDA) under 21 CFR Part 11. For more information, see [GxP (FDA 21 CFR Part 11)](/azure/compliance/offerings/offering-gxp). | [ISO 27001:2013](https://global.azure.com/auditmanager/certificates/views/cert/95) | |
| [HDS (France)](https://global.azure.com/auditmanager/certificates/views/cert/209) | Microsoft Azure has the Health Data Hosting (Hébergeurs de Données de Santé, HDS) certification, which is required for all entities that host personal health data governed by French law. Microsoft is the first major cloud service provider to meet the strict French standards for storing and processing health data. For more information, see [HDS (France)](/compliance/regulatory/offering-hds-france). | [ISO 27001:2013](https://global.azure.com/auditmanager/certificates/views/cert/95) | |
Modified by Justin on May 17, 2025 7:41 AM
📖 View on learn.microsoft.com
+24 / -33 lines changed
Commit: Updated doc corrections for acrolynx
Changes:
Before
After
# For more information, see https://review.learn.microsoft.com/en-us/help/platform/learn-editor-add-metadata?branch=main
# For valid values of ms.service, ms.prod, and ms.topic, see https://review.learn.microsoft.com/en-us/help/platform/metadata-taxonomies?branch=main
 
title: Microsoft Single Sign-on for Linux
description: Overview of Single Sign-on for Linux for Microsoft Entra ID registered devices.
author: ploegert # GitHub alias
ms.author: jploegert # Microsoft alias
ms.service: entra-id
ms.topic: overview
ms.date: 03/18/2025
ms.subservice: devices
---
 
# Microsoft Single Sign-on to Linux
 
 
Microsoft Single Sign-on for Linux is powered by a component that can be installed onto a Linux device that integrates with Microsoft Entra Id to enable users to use their Microsoft Entra ID credentials to login to other apps without being prompted for credentials each time a resource is accessed. This feature provides benefits for admins by simplifying the sign-in process for users and reducing the number of passwords they need to remember.
 
## Features
 
# For more information, see https://review.learn.microsoft.com/en-us/help/platform/learn-editor-add-metadata?branch=main
# For valid values of ms.service, ms.prod, and ms.topic, see https://review.learn.microsoft.com/en-us/help/platform/metadata-taxonomies?branch=main
 
title: Microsoft single sign-on For Linux
description: Overview of Single Sign-on for Linux for Microsoft Entra ID registered devices.
author: ploegert # GitHub alias
ms.author: jploegert # Microsoft alias
ms.service: entra-id
ms.topic: overview
ms.date: 05/16/2025
ms.subservice: devices
---
 
# What is Microsoft Single Sign-on to Linux?
 
Microsoft Single Sign-on (SSO) for Linux is powered by a software component that can be installed onto a Linux device that integrates with Microsoft Entra ID. Microsoft SSO for Linux enable users to use their Microsoft Entra ID credentials to sign-in to other apps without being prompted for credentials each time a resource is accessed. This feature provides benefits for admins by simplifying the sign-in process for users and reducing the number of passwords they need to remember.
 
## Features
 
This feature empowers users on Linux desktop clients to register their devices with Microsoft Entra ID, enroll into Intune management, and satisfy device-based conditional access policies when accessing their corporate resources.
Modified by csmulligan on May 17, 2025 12:17 AM
📖 View on learn.microsoft.com
+26 / -26 lines changed
Commit: Hub update.
Changes:
Before
After
 
### New articles
 
- [Migrating users to Microsoft Entra External ID](how-to-migrate-users.md)
 
### Updated articles
 
- [Customize the language of the authentication experience](how-to-customize-languages-customers.md) - Editorial updates
- [Add OpenID Connect as an external identity provider](how-to-custom-oidc-federation-customers.md) - OpenID Connect federation is generally available
- [Add Facebook as an identity provider](how-to-facebook-federation-customers.md) - Facebook federation is generally available
- [Add Google as an identity provider](how-to-google-federation-customers.md) - Google federation is generally available
- [Create a sign-up and sign-in user flow for an external tenant app](how-to-user-flow-sign-up-sign-in-customers.md) - Removed disable sign-up in a sign-up and sign-in user flow
- [Add and manage admin accounts](how-to-manage-admin-accounts.md) - Added clarification
- [Manage user accounts for consumers and business customers](how-to-manage-customer-accounts.md) - Added clarification
- [Default user permissions in external tenants](reference-user-permissions.md) - Updated default permissions
- [Supported features in workforce and external tenants](concept-supported-features-customers.md) - Added default permissions
 
## February 2025
 
### New articles
 
### New articles
 
- [Migrating users to Microsoft Entra External ID](customers/how-to-migrate-users.md)
 
### Updated articles
 
- [Customize the language of the authentication experience](customers/how-to-customize-languages-customers.md) - Editorial updates
- [Add OpenID Connect as an external identity provider](customers/how-to-custom-oidc-federation-customers.md) - OpenID Connect federation is generally available
- [Add Facebook as an identity provider](customers/how-to-facebook-federation-customers.md) - Facebook federation is generally available
- [Add Google as an identity provider](customers/how-to-google-federation-customers.md) - Google federation is generally available
- [Create a sign-up and sign-in user flow for an external tenant app](customers/how-to-user-flow-sign-up-sign-in-customers.md) - Removed disable sign-up in a sign-up and sign-in user flow
- [Add and manage admin accounts](customers/how-to-manage-admin-accounts.md) - Added clarification
- [Manage user accounts for consumers and business customers](customers/how-to-manage-customer-accounts.md) - Added clarification
- [Default user permissions in external tenants](customers/reference-user-permissions.md) - Updated default permissions
- [Supported features in workforce and external tenants](customers/concept-supported-features-customers.md) - Added default permissions
 
## February 2025
 
### New articles
Modified by ShawnJackson on May 17, 2025 8:01 AM
📖 View on learn.microsoft.com
+23 / -23 lines changed
Commit: edit pass: articles-about-tenant-restrictions
Changes:
Before
After
 
### Supported scenarios
 
You can scope tenant restrictions v2 to specific users, groups, organizations, or external apps. Apps built on the network stack for the Windows operating system are protected. The following scenarios are supported:
 
- All Office apps (all versions/release channels)
- Universal Windows Platform (UWP) .NET applications
This header enforces your tenant restrictions v2 policy on all sign-ins on your network. This header doesn't block anonymous access to Teams meetings, SharePoint files, or other resources that don't require authentication.
 
> [!IMPORTANT]
> Tenant restrictions v1 and v2 on the proxy require decryption of requests to login URLs such as login.microsoftonline.com. Microsoft supports the decryption of traffic for those login domains for the purpose of header insertion for tenant restrictions. This decryption is a valid exception from the policies at [Use third-party network devices or solutions with Microsoft 365](/microsoft-365/troubleshoot/miscellaneous/office-365-third-party-network-devices).
 
#### Tenant restrictions v2 with no support for break and inspect
 
For non-Windows platforms, you can break and inspect traffic to add the tenant restrictions v2 parameters into the header via proxy. However, some platforms don't support break and inspect, so tenant restrictions v2 doesn't work. For these platforms, the following features of Microsoft Entra ID can provide protection:
 
- [Conditional Access: Only allow use of managed/compliant devices](/mem/intune/protect/conditional-access-intune-common-ways-use#device-based-conditional-access)
- [Conditional Access: Manage access for guest/external users](/microsoft-365/security/office-365-security/identity-access-policies-guest-access)
- [B2B collaboration: Restrict outbound rules by cross-tenant access for the same tenants listed in the parameter Restrict-Access-To-Tenants](~/external-id/cross-tenant-access-settings-b2b-collaboration.yml)
- [B2B collaboration: Restrict invitations to B2B users to the same domains listed in the Restrict-Access-To-Tenants parameter](~/external-id/allow-deny-list.md)
 
### Supported scenarios
 
You can scope tenant restrictions v2 to specific users, groups, organizations, or external apps. Apps built on the networking stack for the Windows operating system are protected. The following scenarios are supported:
 
- All Office apps (all versions/release channels)
- Universal Windows Platform (UWP) .NET applications
This header enforces your tenant restrictions v2 policy on all sign-ins on your network. This header doesn't block anonymous access to Teams meetings, SharePoint files, or other resources that don't require authentication.
 
> [!IMPORTANT]
> Tenant restrictions v1 and v2 on the proxy require decryption of requests to sign-in URLs such as login.microsoftonline.com. Microsoft supports the decryption of traffic for those sign-in domains for the purpose of header insertion for tenant restrictions. This decryption is a valid exception to the policies at [Use third-party network devices or solutions with Microsoft 365](/microsoft-365/troubleshoot/miscellaneous/office-365-third-party-network-devices).
 
#### Tenant restrictions v2 with no support for break and inspect
 
For non-Windows platforms, you can break and inspect traffic to add the tenant restrictions v2 parameters into the header via proxy. However, some platforms don't support break and inspect, so tenant restrictions v2 doesn't work. For these platforms, the following features of Microsoft Entra ID can provide protection:
 
- [Conditional Access: Allow use of only managed or compliant devices](/mem/intune/protect/conditional-access-intune-common-ways-use#device-based-conditional-access)
- [Conditional Access: Manage access for guest or external users](/microsoft-365/security/office-365-security/identity-access-policies-guest-access)
- [B2B collaboration: Restrict outbound rules by cross-tenant access for the same tenants listed in the parameter Restrict-Access-To-Tenants](~/external-id/cross-tenant-access-settings-b2b-collaboration.yml)
- [B2B collaboration: Restrict invitations to B2B users to the same domains listed in the Restrict-Access-To-Tenants parameter](~/external-id/allow-deny-list.md)
+25 / -11 lines changed
Commit: freshness update
Changes:
Before
After
manager: CelesteDG
ms.author: cwerner
ms.custom: has-adal-ref
ms.date: 06/06/2024
ms.reviewer: saeeda
ms.service: identity-platform
 
- [Client ID](#client-id)
- [Redirect URI](#redirect-uri)
- [Client secret](#client-secret) (for confidential client applications)
- [Logging options](#logging), including log level, control of personal data, and the name of the component using the library
 
## Authority
 
The *instance* is used to specify if your app is signing users from the Azure public cloud or from national clouds. Using MSAL in your code, you can set the Azure cloud instance by using an enumeration or by passing the URL to the [national cloud instance](authentication-national-cloud.md#azure-ad-authentication-endpoints) as the `Instance` member.
 
MSAL.NET will throw an explicit exception if both `Instance` and `AzureCloudInstance` are specified.
 
If you don't specify an instance, your app will target the Azure public cloud instance (the instance of URL `https://login.onmicrosoftonline.com`).
 
manager: CelesteDG
ms.author: cwerner
ms.custom: has-adal-ref
ms.date: 05/14/2025
ms.reviewer: saeeda
ms.service: identity-platform
 
- [Client ID](#client-id)
- [Redirect URI](#redirect-uri)
- [Client secret](#client-secret) (for confidential client applications)
- [Certificate](#certificate) (for confidential client applications)
- [Federated credentials](#federated-credentials) (for confidential client applications)
- [Logging options](#logging), including log level, control of personal data, and the name of the component using the library
 
## Authority
 
The *instance* is used to specify if your app is signing users from the Azure public cloud or from national clouds. Using MSAL in your code, you can set the Azure cloud instance by using an enumeration or by passing the URL to the [national cloud instance](authentication-national-cloud.md#azure-ad-authentication-endpoints) as the `Instance` member.
 
MSAL.NET throws an explicit exception if both `Instance` and `AzureCloudInstance` are specified.
 
Modified by Alexander Filipin on May 17, 2025 10:21 AM
📖 View on learn.microsoft.com
+26 / -4 lines changed
Commit: Improve support statement
Changes:
Before
After
1. In the message that appears asking if you want to continue, select **Yes**.
1. You should no longer see your terms of use policy.
 
## B2B guests
 
Using Conditional Access and terms of use policies, you can enforce a policy directly towards B2B guest users. During the invitation redemption flow, the user is presented with the terms of use policy.
 
Terms of use policies are only displayed when the user has a guest account in Microsoft Entra ID. SharePoint Online currently has an [external sharing recipient experience](/sharepoint/what-s-new-in-sharing-in-targeted-release) to share a document or a folder that doesn't require the user to have a guest account. In this case, a terms of use policy isn't displayed.
 
## Support for cloud apps
 
Terms of use policies can be used for different cloud apps, such as Azure Information Protection and Microsoft Intune. This support is currently in preview.
 
### Azure Information Protection
 
You can configure a Conditional Access policy for the Azure Information Protection app and require a terms of use policy when a user accesses a protected document. This configuration triggers a terms of use policy before a user accessing a protected document for the first time.
 
 
 
 
1. In the message that appears asking if you want to continue, select **Yes**.
1. You should no longer see your terms of use policy.
 
## Platform and browser support
 
Microsoft Entra terms of use is designed to function optimally on the following platforms and browsers.
 
Supported desktop and mobile operating systems (latest stable versions):
1. Windows
1. macOS
1. Linux
1. Android
1. iOS
Supported modern web browsers (latest stable versions):
1. Microsoft Edge
1. Mozilla Firefox
1. Google Chrome
1. Safari
 
+12 / -12 lines changed
Commit: edit pass: articles-about-tenant-restrictions
Changes:
Before
After
ai-usage: ai-assisted
---
 
# Universal tenant restrictions
 
Universal tenant restrictions enhance the functionality of [tenant restrictions v2](https://aka.ms/tenant-restrictions-enforcement). They use Global Secure Access to tag all traffic no matter the operating system, browser, or device form factor. They allow support for both client and remote network connectivity.
 
 
| Step | Description |
| --- | --- |
| **1** | Contoso configures a tenant restrictions v2 policy in its cross-tenant access settings to block all external accounts and external apps. Contoso enforces the policy by using Global Secure Access universal tenant restrictions. |
| **2** | A user with a Contoso-managed device tries to access a Microsoft Entra integrated app with an unsanctioned external identity. |
| **3** | *Authentication plane protection:* With Microsoft Entra ID, Contoso's policy blocks unsanctioned external accounts from accessing external tenants. Additionally, if a Microsoft Graph token is obtained through another device and is brought into the environment within its lifetime, this token can't be replayed from the devices that have the Global Secure Access client or via remote networks. |
| **4** | *Data plane protection:* If a Microsoft Graph token is obtained through another device and is brought into the environment within its lifetime, this token can't be replayed from the devices that have the Global Secure Access client or via remote networks. |
 
Universal tenant restrictions help prevent data exfiltration across browsers, devices, and networks in the following ways:
 
- They enable Microsoft Entra ID, Microsoft accounts, and Microsoft applications to look up and enforce the associated tenant restrictions v2 policy. This lookup enables consistent policy application.
- They work with all Microsoft Entra integrated third-party apps at the authentication plane during sign-in.
- They help protect Microsoft Graph.
ai-usage: ai-assisted
---
 
# Turn on universal tenant restrictions
 
Universal tenant restrictions enhance the functionality of [tenant restrictions v2](https://aka.ms/tenant-restrictions-enforcement). They use Global Secure Access to tag all traffic no matter the operating system, browser, or device form factor. They allow support for both client and remote network connectivity.
 
 
| Step | Description |
| --- | --- |
| **1** | Contoso configures a tenant restrictions v2 policy in its cross-tenant access settings to block all external accounts and external apps. Contoso enforces the policy by using Global Secure Access and universal tenant restrictions. |
| **2** | A user with a Contoso-managed device tries to access a Microsoft Entra-integrated app with an unsanctioned external identity. |
| **3** | *Authentication plane protection:* With Microsoft Entra ID, Contoso's policy blocks unsanctioned external accounts from accessing external tenants. Additionally, if a Microsoft Graph token is obtained through another device and is brought into the environment within its lifetime, this token can't be replayed from the devices that have the Global Secure Access client or via remote networks. |
| **4** | *Data plane protection:* If a Microsoft Graph token is obtained through another device and is brought into the environment within its lifetime, this token can't be replayed from the devices that have the Global Secure Access client or via remote networks. |
 
Universal tenant restrictions help prevent data exfiltration across browsers, devices, and networks in the following ways:
 
- They enable Microsoft Entra ID, Microsoft accounts, and Microsoft applications to look up and enforce the associated tenant restrictions v2 policy. This lookup enables consistent policy application.
- They work with all Microsoft Entra-integrated third-party apps at the authentication plane during sign-in.
- They help protect Microsoft Graph.
Modified by Justin on May 17, 2025 7:41 AM
📖 View on learn.microsoft.com
+11 / -11 lines changed
Commit: Updated doc corrections for acrolynx
Changes:
Before
After
# For more information, see https://learn.microsoft.com/en-us/help/platform/learn-editor-add-metadata
# For valid values of ms.service, ms.prod, and ms.topic, see https://learn.microsoft.com/en-us/help/platform/metadata-taxonomies
 
title: # Add a title for the browser tab
description: # Add a meaningful description for search results
author: ploegert # GitHub alias
ms.author: jploegert # Microsoft alias
ms.service: # Add the ms.service or ms.prod value
# ms.prod: # To use ms.prod, uncomment it and delete ms.service
ms.topic: # Add the ms.topic value
ms.date: 05/09/2025
---
 
# What's new in Microsoft Single Sign-on for Linux
This article provides information about the latest updates to Microsoft Single Sign-on for Linux.
 
### Package Repositories
Microsoft uses the following package repositories to distribute the Microsoft Identity Broker and Microsoft Identity Diagnostics for Linux. Packages are avilable in either .deb or .rpm format, however only Ubuntu LTS & Red Hat Enterprise Linux are supported today.
 
 
# For more information, see https://learn.microsoft.com/en-us/help/platform/learn-editor-add-metadata
# For valid values of ms.service, ms.prod, and ms.topic, see https://learn.microsoft.com/en-us/help/platform/metadata-taxonomies
 
title: What's new in Microsoft Single Sign-on for Linux
description: Discusses new feature releases of Microsoft Single Sign-on for Linux
author: ploegert # GitHub alias
ms.author: jploegert # Microsoft alias
ms.service: entra-id
ms.topic: whats-new
ms.date: 05/16/2025
ms.subservice: devices
---
 
# What's new in Microsoft Single Sign-on for Linux
This article provides information about the latest updates to Microsoft Single Sign-on for Linux.
 
### Package Repositories
Microsoft uses the following package repositories to distribute the Microsoft Identity Broker and Microsoft Identity Diagnostics for Linux. Packages are available in either `.deb` or `.rpm` format, however only Ubuntu Long-Term Support (LTS) & Red Hat Enterprise Linux (LTS) are supported today.
 
 
Modified by Chris Werner on May 17, 2025 1:31 AM
📖 View on learn.microsoft.com
+10 / -10 lines changed
Commit: freshness update
Changes:
Before
After
manager: CelesteDG
ms.author: cwerner
ms.custom: curation-claims
ms.date: 06/10/2024
ms.service: identity-platform
 
ms.topic: concept-article
 
# Access tokens in the Microsoft identity platform
 
Access tokens are a type of security token designed for authorization, granting access to specific resources on behalf on an authenticated user. Information in access tokens determine whether a user has the right to access a particular resource, similar to keys unlocking specific doors in a building. These individual pieces of information that make up tokens are called claims. Therefore, they are sensitive credentials and pose a security risk if not handled correctly. Access tokens differ from [ID tokens](./id-tokens.md) which serve as proof of authentication.
 
Access tokens enable clients to securely call protected web APIs. Although client applications can receive and use access tokens, they should be treated as opaque strings. The client application should not attempt to validate access tokens. The resource server should validate the access token before accepting it as proof of authorization. The contents of the token are intended only for the API, which means that access tokens must be treated as opaque strings. For validation and debugging purposes *only*, developers can decode JWTs using a site like [jwt.ms](https://jwt.ms). Tokens that a Microsoft API receives might not always be a JWT that can be decoded.
 
Clients should use the token response data that's returned with the access token for details on what's inside it. When the client requests an access token, the Microsoft identity platform also returns some metadata about the access token for the consumption of the application. This information includes the expiry time of the access token and the scopes for which it's valid. This data allows the application to do intelligent caching of access tokens without having to parse the access token itself. This article explains essential information about access tokens, including formats, ownership, lifetimes and how APIs can validate and use the claims inside an access token.
 
- Web APIs must validate access tokens sent to them by a client. They must only accept tokens containing one of their AppId URIs as the `aud` claim.
- Web apps must validate ID tokens sent to them by using the user's browser in the hybrid flow, before allowing access to a user's data or establishing a session.
 
If none of the previously described scenarios apply, there's no need to validate the token. Public clients like native, desktop or single-page applications don't benefit from validating ID tokens because the application communicates directly with the IDP where SSL protection ensures the ID tokens are valid. They shouldn't validate the access tokens, as they are for the web API to validate, not the client.
manager: CelesteDG
ms.author: cwerner
ms.custom: curation-claims
ms.date: 05/14/2025
ms.service: identity-platform
 
ms.topic: concept-article
 
# Access tokens in the Microsoft identity platform
 
Access tokens are a type of security token designed for authorization, granting access to specific resources on behalf on an authenticated user. Information in access tokens determines whether a user has the right to access a particular resource, similar to keys unlocking specific doors in a building. These individual pieces of information that make up tokens are called claims. Therefore, they are sensitive credentials and pose a security risk if not handled correctly. Access tokens differ from [ID tokens](./id-tokens.md) which serve as proof of authentication.
 
Access tokens enable clients to securely call protected web APIs. Although client applications can receive and use access tokens, they should be treated as opaque strings. The client application shouldn't attempt to validate access tokens. The resource server should validate the access token before accepting it as proof of authorization. The contents of the token are intended only for the API, which means that access tokens must be treated as opaque strings. For validation and debugging purposes *only*, developers can decode JWTs using a site like [jwt.ms](https://jwt.ms). Tokens that a Microsoft API receives might not always be a JWT that can be decoded.
 
Clients should use the token response data that's returned with the access token for details on what's inside it. When the client requests an access token, the Microsoft identity platform also returns some metadata about the access token for the consumption of the application. This information includes the expiry time of the access token and the scopes for which it's valid. This data allows the application to do intelligent caching of access tokens without having to parse the access token itself. This article explains essential information about access tokens, including formats, ownership, lifetimes and how APIs can validate and use the claims inside an access token.
 
- Web APIs must validate access tokens sent to them by a client. They must only accept tokens containing one of their AppId URIs as the `aud` claim.
- Web apps must validate ID tokens sent to them by using the user's browser in the hybrid flow, before allowing access to a user's data or establishing a session.
 
If none of the previously described scenarios apply, there's no need to validate the token. Public clients like native, desktop, or single-page applications don't benefit from validating ID tokens because the application communicates directly with the IDP where SSL protection ensures the ID tokens are valid. They shouldn't validate the access tokens, as they are for the web API to validate, not the client.
+6 / -8 lines changed
Commit: License requirements, Limitations
Changes:
Before
After
 
## License requirements
 
In the source tenant: Using this feature requires Microsoft Entra ID P1 licenses. Each user who is synchronized with cross-tenant synchronization must have a P1 license in their home/source tenant. To find the right license for your requirements, see [Compare generally available features of Microsoft Entra ID](https://www.microsoft.com/security/business/identity-access-management/azure-ad-pricing).
 
In the target tenant: Cross-tenant sync relies on the Microsoft Entra External ID billing model. To understand the external identities licensing model, see [MAU billing model for Microsoft Entra External ID](~/external-id/external-identities-pricing.md). You will also need at least one Microsoft Entra ID P1 license in the target tenant to enable auto-redemption.
 
[Cross-cloud synchronization](cross-tenant-synchronization-configure.md?pivots=cross-cloud-synchronization) requires Microsoft Entra ID Governance or Microsoft Entra Suite licenses. For more information, see [Microsoft Entra ID Governance licensing fundamentals](../../id-governance/licensing-fundamentals.md).
 
The following table lists the required licenses depending on your scenario.
 
| Scenario | Source tenant | Target tenant |
| Cross-tenant synchronization (same cloud) | Microsoft Entra ID P1 licenses | N/A |
| [Cross-cloud synchronization](cross-tenant-synchronization-configure.md?pivots=cross-cloud-synchronization) | Microsoft Entra ID Governance or Microsoft Entra Suite licenses | N/A |
 
## Frequently asked questions
 
#### Clouds
What are the differences between cross-tenant synchronization and cross-cloud synchronization?
 
 
## License requirements
 
The following table lists the required licenses depending on your scenario.
 
| Scenario | Source tenant | Target tenant |
| Cross-tenant synchronization (same cloud) | Microsoft Entra ID P1 licenses | N/A |
| [Cross-cloud synchronization](cross-tenant-synchronization-configure.md?pivots=cross-cloud-synchronization) | Microsoft Entra ID Governance or Microsoft Entra Suite licenses | N/A |
 
In the source tenant: Each user who is synchronized with cross-tenant synchronization must have a Microsoft Entra ID P1 license in their home/source tenant. Each user who is synchronized with cross-cloud synchronization must have a Microsoft Entra ID Governance or Microsoft Entra Suite license in their home/source tenant. For more information, see [Compare generally available features of Microsoft Entra ID](https://www.microsoft.com/security/business/identity-access-management/azure-ad-pricing) or [Microsoft Entra ID Governance licensing fundamentals](../../id-governance/licensing-fundamentals.md).
 
In the target tenant: Licenses aren't required for cross-tenant synchronization or cross-cloud synchronization in the target tenant. However, depending on the features you are using in the target tenant, you might need additional licensing. For example, if you have Microsoft Entra External ID billing enabled, you might get charged for external guests. To understand the external identities licensing model, see [MAU billing model for Microsoft Entra External ID](../../external-id/external-identities-pricing.md).
 
## Frequently asked questions
 
#### Clouds
What are the differences between cross-tenant synchronization and cross-cloud synchronization?
 
- Cross-tenant synchronization and cross-cloud synchronization are built using the same technologies and are fundamentally the same. The primary difference is that synchronization occurs across clouds instead of within the same cloud.
 
+5 / -8 lines changed
Commit: freshness update
Changes:
Before
After
manager: CelesteDG
ms.author: cwerner
ms.custom: has-adal-ref
ms.date: 06/10/2024
ms.reviewer: sureshja
ms.service: identity-platform
 
 
## Prerequisites
 
* An Azure account with an active subscription - [create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F)
* Completion of [Quickstart: Set up a tenant](quickstart-create-new-tenant.md)
* An application registered in the Microsoft Entra admin center. If you don't have one, [register an application](quickstart-register-app.md#register-an-application) now.
 
## Register the web API
 
1. In the new window, find and select the owner(s) that you want to assign to the application. Selected owners appear in the right panel. Once done, confirm with **Select**. The app owner(s) will now appear in the owner's list.
 
>[!NOTE]
> Ensure that both the API application and the application you want to add permissions to both have an owner, otherwise the API will not be listed when requesting API permissions.
manager: CelesteDG
ms.author: cwerner
ms.custom: has-adal-ref
ms.date: 05/14/2025
ms.reviewer: sureshja
ms.service: identity-platform
 
 
## Prerequisites
 
* An Azure account with an active subscription. If you don't have one, [create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
* An application registered in the [Microsoft Entra admin center](https://entra.microsoft.com/). If you don't have one, [register an application](quickstart-register-app.md#register-an-application) now.
 
## Register the web API
 
1. In the new window, find and select the owner(s) that you want to assign to the application. Selected owners appear in the right panel. Once done, confirm with **Select**. The app owner(s) will now appear in the owner's list.
 
>[!NOTE]
> Ensure that an owner is assigned to both the API application and the application you want to add permissions to, otherwise the API will not be listed when requesting API permissions.