windows-itpro-docs/windows/security/identity-protection/hello-for-business/hello-hybrid-cert-whfb-settings-dir-sync.md
Paolo Matarazzo 2a74e340ca updates
2022-11-21 11:18:34 -05:00

4.3 KiB

title, description, ms.date, appliesto, ms.topic
title description ms.date appliesto ms.topic
Configure Hybrid Azure AD joined Windows Hello for Business Directory Synch Discussing Directory Synchronization in a Hybrid deployment of Windows Hello for Business 4/30/2021
<a href=https://learn.microsoft.com/windows/release-health/supported-versions-windows-client target=_blank>Windows 10 and later</a>
article

Configure Hybrid Azure AD joined Windows Hello for Business- Directory Synchronization

[!INCLUDE hello-hybrid-key-trust]

Directory Synchronization

In hybrid deployments, users register the public portion of their Windows Hello for Business credential with Azure. Azure AD Connect synchronizes the Windows Hello for Business public key to Active Directory.

The key-trust model needs Windows Server 2016 domain controllers, which configure the key registration permissions automatically; however, the certificate-trust model does not and requires you to add the permissions manually.

Important

If you already have a Windows Server 2016 domain controller in your domain, you can skip Configure Permissions for Key Synchronization. In this case, you should use the pre-created group KeyAdmins in step 3 of the "Group Memberships for the Azure AD Connect Service Account" section of this article.

Configure Permissions for Key Synchronization

Sign-in a domain controller or management workstations with Domain Admin equivalent credentials.

  1. Open Active Directory Users and Computers.
  2. Right-click your domain name from the navigation pane and click Properties.
  3. Click Security (if the Security tab is missing, turn on Advanced Features from the View menu).
  4. Click Advanced. Click Add. Click Select a principal.
  5. The Select User, Computer, Service Account, or Group dialog box appears. In the Enter the object name to select text box, type KeyCredential Admins. Click OK.
  6. In the Applies to list box, select Descendant User objects.
  7. Using the scroll bar, scroll to the bottom of the page and click Clear all.
  8. In the Properties section, select Read msDS-KeyCredentialLink and Write msDS-KeyCredentialLink.
  9. Click OK three times to complete the task.

Group Memberships for the Azure AD Connect Service Account

The KeyAdmins or KeyCredential Admins global group provides the Azure AD Connect service with the permissions needed to read and write the public key to Active Directory.

Sign-in a domain controller or management workstation with Domain Admin equivalent credentials.

  1. Open Active Directory Users and Computers.
  2. Click the Users container in the navigation pane.
  3. Right-click either the KeyAdmins or KeyCredential Admins in the details pane and click Properties.
  4. Click the Members tab and click Add
  5. In the Enter the object names to select text box, type the name of the Azure AD Connect service account. Click OK.
  6. Click OK to return to Active Directory Users and Computers.

Note

If your AD forest has multiple domains, make sure you add the ADConnect sync service account (ie. MSOL_12121212) into "Enterprise Key Admins" group to gain permission across the domains in the forest.

Note

Transfer the PDC emulator FSMO role to a domain controller running Windows Server 2016 (or later) to be able to search the Key Admins and Enterprise Key Admins groups (domain controllers running previous versions of Windows Server cannot translate the security identifier to a name for these groups).

Section Review

[!div class="checklist"]

  • Configure Permissions for Key Synchronization
  • Configure group membership for Azure AD Connect

[!div class="step-by-step"] < Configure Active Directory Configure PKI >




Follow the Windows Hello for Business hybrid certificate trust deployment guide

  1. Overview
  2. Prerequisites
  3. New Installation Baseline
  4. Configure Azure Device Registration
  5. Configure Windows Hello for Business settings: Directory Synchronization (You are here)
  6. Sign-in and Provision