Skip to content

Commit d7c6e26

Browse files
authored
Merge pull request #89299 from billmath/fixes1
updating
2 parents 6d47516 + 26dae1d commit d7c6e26

File tree

3 files changed

+50
-50
lines changed

3 files changed

+50
-50
lines changed

articles/active-directory/hybrid/how-to-connect-sso-faq.md

Lines changed: 47 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -22,19 +22,19 @@ ms.collection: M365-identity-device-management
2222

2323
In this article, we address frequently asked questions about Azure Active Directory Seamless Single Sign-On (Seamless SSO). Keep checking back for new content.
2424

25-
## What sign-in methods do Seamless SSO work with?
25+
**Q: What sign-in methods do Seamless SSO work with**
2626

2727
Seamless SSO can be combined with either the [Password Hash Synchronization](how-to-connect-password-hash-synchronization.md) or [Pass-through Authentication](how-to-connect-pta.md) sign-in methods. However this feature cannot be used with Active Directory Federation Services (ADFS).
2828

29-
## Is Seamless SSO a free feature?
29+
**Q: Is Seamless SSO a free feature?**
3030

3131
Seamless SSO is a free feature and you don't need any paid editions of Azure AD to use it.
3232

33-
## Is Seamless SSO available in the [Microsoft Azure Germany cloud](https://www.microsoft.de/cloud-deutschland) and the [Microsoft Azure Government cloud](https://azure.microsoft.com/features/gov/)?
33+
**Q: Is Seamless SSO available in the [Microsoft Azure Germany cloud](https://www.microsoft.de/cloud-deutschland) and the [Microsoft Azure Government cloud](https://azure.microsoft.com/features/gov/)?**
3434

3535
No. Seamless SSO is only available in the worldwide instance of Azure AD.
3636

37-
## What applications take advantage of `domain_hint` or `login_hint` parameter capability of Seamless SSO?
37+
**Q: What applications take advantage of `domain_hint` or `login_hint` parameter capability of Seamless SSO?**
3838

3939
Listed below is a non-exhaustive list of applications that can send these parameters to Azure AD, and therefore provides users a silent sign-on experience using Seamless SSO (i.e., no need for your users to input their usernames or passwords):
4040

@@ -55,21 +55,21 @@ In the above tables, replace "contoso.com" with your domain name to get to the r
5555

5656
If you want other applications using our silent sign-on experience, let us know in the feedback section.
5757

58-
## Does Seamless SSO support `Alternate ID` as the username, instead of `userPrincipalName`?
58+
**Q: Does Seamless SSO support `Alternate ID` as the username, instead of `userPrincipalName`?**
5959

6060
Yes. Seamless SSO supports `Alternate ID` as the username when configured in Azure AD Connect as shown [here](how-to-connect-install-custom.md). Not all Office 365 applications support `Alternate ID`. Refer to the specific application's documentation for the support statement.
6161

62-
## What is the difference between the single sign-on experience provided by [Azure AD Join](../active-directory-azureadjoin-overview.md) and Seamless SSO?
62+
**Q: What is the difference between the single sign-on experience provided by [Azure AD Join](../active-directory-azureadjoin-overview.md) and Seamless SSO?**
6363

6464
[Azure AD Join](../active-directory-azureadjoin-overview.md) provides SSO to users if their devices are registered with Azure AD. These devices don't necessarily have to be domain-joined. SSO is provided using *primary refresh tokens* or *PRTs*, and not Kerberos. The user experience is most optimal on Windows 10 devices. SSO happens automatically on the Microsoft Edge browser. It also works on Chrome with the use of a browser extension.
6565

6666
You can use both Azure AD Join and Seamless SSO on your tenant. These two features are complementary. If both features are turned on, then SSO from Azure AD Join takes precedence over Seamless SSO.
6767

68-
## I want to register non-Windows 10 devices with Azure AD, without using AD FS. Can I use Seamless SSO instead?
68+
**Q: I want to register non-Windows 10 devices with Azure AD, without using AD FS. Can I use Seamless SSO instead?**
6969

7070
Yes, this scenario needs version 2.1 or later of the [workplace-join client](https://www.microsoft.com/download/details.aspx?id=53554).
7171

72-
## How can I roll over the Kerberos decryption key of the `AZUREADSSOACC` computer account?
72+
**Q: How can I roll over the Kerberos decryption key of the `AZUREADSSOACC` computer account?**
7373

7474
It is important to frequently roll over the Kerberos decryption key of the `AZUREADSSOACC` computer account (which represents Azure AD) created in your on-premises AD forest.
7575

@@ -78,66 +78,66 @@ It is important to frequently roll over the Kerberos decryption key of the `AZUR
7878
7979
Follow these steps on the on-premises server where you are running Azure AD Connect:
8080

81-
### Step 1. Get list of AD forests where Seamless SSO has been enabled
81+
**Step 1. Get list of AD forests where Seamless SSO has been enabled**
8282

83-
1. First, download, and install [Azure AD PowerShell](https://docs.microsoft.com/powershell/azure/active-directory/overview).
84-
2. Navigate to the `%programfiles%\Microsoft Azure Active Directory Connect` folder.
85-
3. Import the Seamless SSO PowerShell module using this command: `Import-Module .\AzureADSSO.psd1`.
86-
4. Run PowerShell as an Administrator. In PowerShell, call `New-AzureADSSOAuthenticationContext`. This command should give you a popup to enter your tenant's Global Administrator credentials.
87-
5. Call `Get-AzureADSSOStatus | ConvertFrom-Json`. This command provides you the list of AD forests (look at the "Domains" list) on which this feature has been enabled.
83+
1. First, download, and install [Azure AD PowerShell](https://docs.microsoft.com/powershell/azure/active-directory/overview).
84+
2. Navigate to the `%programfiles%\Microsoft Azure Active Directory Connect` folder.
85+
3. Import the Seamless SSO PowerShell module using this command: `Import-Module .\AzureADSSO.psd1`.
86+
4. Run PowerShell as an Administrator. In PowerShell, call `New-AzureADSSOAuthenticationContext`. This command should give you a popup to enter your tenant's Global Administrator credentials.
87+
5. Call `Get-AzureADSSOStatus | ConvertFrom-Json`. This command provides you the list of AD forests (look at the "Domains" list) on which this feature has been enabled.
8888

89-
### Step 2. Update the Kerberos decryption key on each AD forest that it was set it up on
89+
**Step 2. Update the Kerberos decryption key on each AD forest that it was set it up on**
9090

91-
1. Call `$creds = Get-Credential`. When prompted, enter the Domain Administrator credentials for the intended AD forest.
91+
1. Call `$creds = Get-Credential`. When prompted, enter the Domain Administrator credentials for the intended AD forest.
9292

93-
> [!NOTE]
94-
> We use the Domain Administrator's username, provided in the User Principal Names (UPN) ([email protected]) format or the domain qualified sam-account name (contoso\johndoe or contoso.com\johndoe) format, to find the intended AD forest. If you use domain qualified sam-account name, we use the domain portion of the username to [locate the Domain Controller of the Domain Administrator using DNS](https://social.technet.microsoft.com/wiki/contents/articles/24457.how-domain-controllers-are-located-in-windows.aspx). If you use UPN instead, we [translate it to a domain qualified sam-account name](https://docs.microsoft.com/windows/desktop/api/ntdsapi/nf-ntdsapi-dscracknamesa) before locating the appropriate Domain Controller.
93+
> [!NOTE]
94+
> We use the Domain Administrator's username, provided in the User Principal Names (UPN) ([email protected]) format or the domain qualified sam-account name (contoso\johndoe or contoso.com\johndoe) format, to find the intended AD forest. If you use domain qualified sam-account name, we use the domain portion of the username to [locate the Domain Controller of the Domain Administrator using DNS](https://social.technet.microsoft.com/wiki/contents/articles/24457.how-domain-controllers-are-located-in-windows.aspx). If you use UPN instead, we [translate it to a domain qualified sam-account name](https://docs.microsoft.com/windows/desktop/api/ntdsapi/nf-ntdsapi-dscracknamesa) before locating the appropriate Domain Controller.
9595

96-
2. Call `Update-AzureADSSOForest -OnPremCredentials $creds`. This command updates the Kerberos decryption key for the `AZUREADSSOACC` computer account in this specific AD forest and updates it in Azure AD.
97-
3. Repeat the preceding steps for each AD forest that you’ve set up the feature on.
96+
2. Call `Update-AzureADSSOForest -OnPremCredentials $creds`. This command updates the Kerberos decryption key for the `AZUREADSSOACC` computer account in this specific AD forest and updates it in Azure AD.
97+
3. Repeat the preceding steps for each AD forest that you’ve set up the feature on.
9898

99-
>[!IMPORTANT]
100-
>Ensure that you _don't_ run the `Update-AzureADSSOForest` command more than once. Otherwise, the feature stops working until the time your users' Kerberos tickets expire and are reissued by your on-premises Active Directory.
99+
>[!IMPORTANT]
100+
>Ensure that you _don't_ run the `Update-AzureADSSOForest` command more than once. Otherwise, the feature stops working until the time your users' Kerberos tickets expire and are reissued by your on-premises Active Directory.
101101

102-
## How can I disable Seamless SSO?
102+
**Q: How can I disable Seamless SSO?**
103103

104-
### Step 1. Disable the feature on your tenant
104+
**Step 1. Disable the feature on your tenant**
105105

106-
#### Option A: Disable using Azure AD Connect
106+
**Option A: Disable using Azure AD Connect**
107107

108-
1. Run Azure AD Connect, choose **Change user sign-in page** and click **Next**.
109-
2. Uncheck the **Enable single sign on** option. Continue through the wizard.
108+
1. Run Azure AD Connect, choose **Change user sign-in page** and click **Next**.
109+
2. Uncheck the **Enable single sign on** option. Continue through the wizard.
110110

111-
After completing the wizard, Seamless SSO will be disabled on your tenant. However, you will see a message on screen that reads as follows:
111+
After completing the wizard, Seamless SSO will be disabled on your tenant. However, you will see a message on screen that reads as follows:
112112

113-
"Single sign-on is now disabled, but there are additional manual steps to perform in order to complete clean-up. Learn more"
113+
"Single sign-on is now disabled, but there are additional manual steps to perform in order to complete clean-up. Learn more"
114114

115-
To complete the clean-up process, follow steps 2 and 3 on the on-premises server where you are running Azure AD Connect.
115+
To complete the clean-up process, follow steps 2 and 3 on the on-premises server where you are running Azure AD Connect.
116116

117-
#### Option B: Disable using PowerShell
117+
**Option B: Disable using PowerShell**
118118

119-
Run the following steps on the on-premises server where you are running Azure AD Connect:
119+
Run the following steps on the on-premises server where you are running Azure AD Connect:
120120

121-
1. First, download, and install [Azure AD PowerShell](https://docs.microsoft.com/powershell/azure/active-directory/overview).
122-
2. Navigate to the `%programfiles%\Microsoft Azure Active Directory Connect` folder.
123-
3. Import the Seamless SSO PowerShell module using this command: `Import-Module .\AzureADSSO.psd1`.
124-
4. Run PowerShell as an Administrator. In PowerShell, call `New-AzureADSSOAuthenticationContext`. This command should give you a popup to enter your tenant's Global Administrator credentials.
125-
5. Call `Enable-AzureADSSO -Enable $false`.
121+
1. First, download, and install [Azure AD PowerShell](https://docs.microsoft.com/powershell/azure/active-directory/overview).
122+
2. Navigate to the `%programfiles%\Microsoft Azure Active Directory Connect` folder.
123+
3. Import the Seamless SSO PowerShell module using this command: `Import-Module .\AzureADSSO.psd1`.
124+
4. Run PowerShell as an Administrator. In PowerShell, call `New-AzureADSSOAuthenticationContext`. This command should give you a popup to enter your tenant's Global Administrator credentials.
125+
5. Call `Enable-AzureADSSO -Enable $false`.
126126

127-
>[!IMPORTANT]
128-
>Disabling Seamless SSO using PowerShell will not change the state in Azure AD Connect. Seamless SSO will show as enabled in the **Change user sign-in** page.
127+
>[!IMPORTANT]
128+
>Disabling Seamless SSO using PowerShell will not change the state in Azure AD Connect. Seamless SSO will show as enabled in the **Change user sign-in** page.
129129

130-
### Step 2. Get list of AD forests where Seamless SSO has been enabled
130+
**Step 2. Get list of AD forests where Seamless SSO has been enabled**
131131

132-
Follow tasks 1 through 4 below if you have disabled Seamless SSO using Azure AD Connect. If you have disabled Seamless SSO using PowerShell instead, jump ahead to task 5 below.
132+
Follow tasks 1 through 4 below if you have disabled Seamless SSO using Azure AD Connect. If you have disabled Seamless SSO using PowerShell instead, jump ahead to task 5 below.
133133

134-
1. First, download, and install [Azure AD PowerShell](https://docs.microsoft.com/powershell/azure/active-directory/overview).
135-
2. Navigate to the `%programfiles%\Microsoft Azure Active Directory Connect` folder.
136-
3. Import the Seamless SSO PowerShell module using this command: `Import-Module .\AzureADSSO.psd1`.
137-
4. Run PowerShell as an Administrator. In PowerShell, call `New-AzureADSSOAuthenticationContext`. This command should give you a popup to enter your tenant's Global Administrator credentials.
138-
5. Call `Get-AzureADSSOStatus | ConvertFrom-Json`. This command provides you the list of AD forests (look at the "Domains" list) on which this feature has been enabled.
134+
1. First, download, and install [Azure AD PowerShell](https://docs.microsoft.com/powershell/azure/active-directory/overview).
135+
2. Navigate to the `%programfiles%\Microsoft Azure Active Directory Connect` folder.
136+
3. Import the Seamless SSO PowerShell module using this command: `Import-Module .\AzureADSSO.psd1`.
137+
4. Run PowerShell as an Administrator. In PowerShell, call `New-AzureADSSOAuthenticationContext`. This command should give you a popup to enter your tenant's Global Administrator credentials.
138+
5. Call `Get-AzureADSSOStatus | ConvertFrom-Json`. This command provides you the list of AD forests (look at the "Domains" list) on which this feature has been enabled.
139139

140-
### Step 3. Manually delete the `AZUREADSSOACCT` computer account from each AD forest that you see listed.
140+
**Step 3. Manually delete the `AZUREADSSOACCT` computer account from each AD forest that you see listed.**
141141

142142
## Next steps
143143

articles/active-directory/hybrid/how-to-connect-sso-how-it-works.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ Seamless SSO is enabled using Azure AD Connect as shown [here](how-to-connect-ss
3939
- The computer account's Kerberos decryption key is shared securely with Azure AD. If there are multiple AD forests, each computer account will have its own unique Kerberos decryption key.
4040

4141
>[!IMPORTANT]
42-
> The `AZUREADSSOACC` computer account needs to be strongly protected for security reasons. Only Domain Admins should be able to manage the computer account. Ensure that Kerberos delegation on the computer account is disabled, and that no other account in Active Directory has delegation permissions on the `AZUREADSSOACC` computer account.. Store the computer account in an Organization Unit (OU) where they are safe from accidental deletions and where only Domain Admins have access. The Kerberos decryption key on the computer account should also be treated as sensitive. We highly recommend that you [roll over the Kerberos decryption key](how-to-connect-sso-faq.md#how-can-i-roll-over-the-kerberos-decryption-key-of-the-azureadssoacc-computer-account) of the `AZUREADSSOACC` computer account at least every 30 days.
42+
> The `AZUREADSSOACC` computer account needs to be strongly protected for security reasons. Only Domain Admins should be able to manage the computer account. Ensure that Kerberos delegation on the computer account is disabled, and that no other account in Active Directory has delegation permissions on the `AZUREADSSOACC` computer account.. Store the computer account in an Organization Unit (OU) where they are safe from accidental deletions and where only Domain Admins have access. The Kerberos decryption key on the computer account should also be treated as sensitive. We highly recommend that you [roll over the Kerberos decryption key](how-to-connect-sso-faq.md) of the `AZUREADSSOACC` computer account at least every 30 days.
4343
4444
Once the set-up is complete, Seamless SSO works the same way as any other sign-in that uses Integrated Windows Authentication (IWA).
4545

@@ -52,7 +52,7 @@ The sign-in flow on a web browser is as follows:
5252
3. The user types in their user name into the Azure AD sign-in page.
5353

5454
>[!NOTE]
55-
>For [certain applications](./how-to-connect-sso-faq.md#what-applications-take-advantage-of-domain_hint-or-login_hint-parameter-capability-of-seamless-sso), steps 2 & 3 are skipped.
55+
>For [certain applications](./how-to-connect-sso-faq.md), steps 2 & 3 are skipped.
5656
5757
4. Using JavaScript in the background, Azure AD challenges the browser, via a 401 Unauthorized response, to provide a Kerberos ticket.
5858
5. The browser, in turn, requests a ticket from Active Directory for the `AZUREADSSOACC` computer account (which represents Azure AD).

articles/active-directory/hybrid/how-to-connect-sso-quick-start.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -216,7 +216,7 @@ In Step 2, Azure AD Connect creates computer accounts (representing Azure AD) in
216216
>[!IMPORTANT]
217217
>The Kerberos decryption key on a computer account, if leaked, can be used to generate Kerberos tickets for any user in its AD forest. Malicious actors can then impersonate Azure AD sign-ins for compromised users. We highly recommend that you periodically roll over these Kerberos decryption keys - at least once every 30 days.
218218
219-
For instructions on how to roll over keys, see [Azure Active Directory Seamless Single Sign-On: Frequently asked questions](how-to-connect-sso-faq.md#how-can-i-roll-over-the-kerberos-decryption-key-of-the-azureadssoacc-computer-account). We are working on a capability to introduce automated roll over of keys.
219+
For instructions on how to roll over keys, see [Azure Active Directory Seamless Single Sign-On: Frequently asked questions](how-to-connect-sso-faq.md). We are working on a capability to introduce automated roll over of keys.
220220

221221
>[!IMPORTANT]
222222
>You don't need to do this step _immediately_ after you have enabled the feature. Roll over the Kerberos decryption keys at least once every 30 days.

0 commit comments

Comments
 (0)