Skip to content

Commit 981636b

Browse files
author
Barbara Selden
committed
addressing warning for note
1 parent fe2a0dc commit 981636b

File tree

1 file changed

+5
-6
lines changed

1 file changed

+5
-6
lines changed

articles/active-directory/hybrid/howto-troubleshoot-UPN-changes.md

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -19,12 +19,10 @@ ms.collection: M365-identity-device-management
1919

2020
A User Principal Name (UPN) is an attribute that is an internet communication standard for user accounts. A UPN consists of a UPN prefix (the user account name) and a UPN suffix (a DNS domain name). The prefix joins the suffix using the "@" symbol. For example, [email protected]. A UPN must be unique among all security principal objects within a directory forest.
2121

22-
> [!NOTE]
23-
> For developers, we recommend that you use the user objectID as the immutable identifier, rather than UPN.
24-
If your applications are currently using UPN, we recommend setting the UPN to match the user's primary email address to improve their experience.<br>
25-
**In a hybrid environment, it is important that the UPN for a user is identical in the on-premises directory and in Azure Active Directory**.
22+
> [!NOTE]
23+
> For developers, we recommend that you use the user objectID as the immutable identifier, rather than UPN. If your applications are currently using UPN, we recommend setting the UPN to match the user's primary email address to improve their experience.<br> **In a hybrid environment, it is important that the UPN for a user is identical in the on-premises directory and in Azure Active Directory**.
2624
27-
**This article assumes you're using UPN as the immutable ID. It addresses planning for UPN changes, and recovering from issues that may result from UPN changes.**
25+
**This article assumes you're using UPN as the user identifier. It addresses planning for UPN changes, and recovering from issues that may result from UPN changes.**
2826

2927
## Learn about UPNs and UPN changes
3028
Sign-in pages often prompt users to enter their email address when the required value is actually their UPN. Therefore, you should be sure to change users' UPN anytime their primary email address changes.
@@ -75,7 +73,8 @@ For example, you may want to add labs.contoso.com and have the users' UPNs and e
7573

7674
7775

78-
> [!IMPORTANT] If UPNs in Active directory and Azure Active Directory do not match, issues will arise. If you are [changing the suffix in Active Directory](https://docs.microsoft.com/azure/active-directory/fundamentals/add-custom-domain), you must ensure that a matching custom domain name has been [added and verified on Azure AD](https://docs.microsoft.com/azure/active-directory/fundamentals/add-custom-domain).
76+
>[!IMPORTANT]
77+
> If UPNs in Active directory and Azure Active Directory do not match, issues will arise. If you are [changing the suffix in Active Directory](https://docs.microsoft.com/azure/active-directory/fundamentals/add-custom-domain), you must ensure that a matching custom domain name has been [added and verified on Azure AD](https://docs.microsoft.com/azure/active-directory/fundamentals/add-custom-domain).
7978
8079
![A screenshot of verified domains](./media/howto-troubleshoot-upn-changes/custom-domains.png)
8180

0 commit comments

Comments
 (0)