VMware ESXi and vSphere Cluster Management
Configure vCenter Server Authentication with Microsoft Active Directory
Learn how to connect vCenter SSO to Microsoft Active Directory, configure LDAP or LDAPS, and grant AD groups appropriate vCenter permissions.
Integrating Microsoft Active Directory with vCenter Server lets administrators use existing domain users and groups to sign in to the vSphere Client. The integration centralizes identity management, but it does not automatically give every domain user access to vCenter. Authentication and authorization remain separate configuration steps.
Authentication and authorization are different
Authentication verifies who a user is. Authorization determines what that authenticated user may do. vCenter Single Sign-On (SSO) performs or coordinates authentication through configured identity sources, while vCenter permissions and roles enforce authorization.
| Stage | Component | Question answered | Typical configuration |
|---|---|---|---|
| Authentication | vCenter SSO and Active Directory identity source | Who is this user? | AD domain, LDAP or LDAPS endpoints, search bases, and directory credentials |
| Authorization | vCenter permissions and roles | What may this user do? | AD group assigned to an SSO group or a vCenter role |
| Inventory scope and inheritance | vCenter inventory permissions | Where do the permissions apply? | vCenter, datacenter, cluster, folder, resource pool, VM, or another object, with inheritance enabled or disabled |
Adding an Active Directory identity source makes its users and groups available to SSO. It does not grant all domain users access. A user generally needs membership in an appropriate vCenter SSO group or an explicit inventory permission before a successful login provides useful access.
Architecture and identity-source choices
The main components are the vCenter Server Appliance (VCSA), vCenter SSO, the vSphere Client, DNS, and one or more Active Directory domain controllers. The vSphere Client sends a login request to vCenter. SSO validates the identity through the configured identity source, and vCenter then evaluates roles and permissions.
Domain controllers provide directory lookups and, depending on the integration method, authentication services. DNS is essential because vCenter and the domain controllers must locate one another by fully qualified domain name (FQDN). LDAP provides directory queries. LDAPS is LDAP protected with TLS and is preferred for production because it encrypts directory traffic and bind credentials.
- Integrated Windows authentication: Available only in versions and deployment models that support it. It can use the appliance's domain relationship and Windows authentication mechanisms with less manual LDAP path configuration.
- Active Directory over LDAP or LDAPS: A manually defined identity source. This normally requires domain information, user and group search bases, server URLs, and, when required, a bind account.
- Other identity sources: Some vCenter releases support additional directory or federation models. Their administration pages and fields differ from manual LDAP configuration.
Prerequisites and planning
- Confirm that the VCSA and each selected domain controller resolve each other's FQDNs. Check forward DNS and, where used by the environment, reverse DNS.
- Confirm network reachability for DNS, LDAP or LDAPS, Kerberos where relevant, and other time or domain services required by the selected integration. Typical references include DNS on TCP/UDP 53, LDAP on TCP/UDP 389 as applicable, LDAPS on TCP 636, and Kerberos on TCP/UDP 88.
- Synchronize time between vCenter, domain controllers, and supporting infrastructure. Kerberos is sensitive to time differences, and certificate validation also depends on a correct system clock.
- Identify a primary domain controller and, preferably, a secondary controller in the same or an appropriate resilient directory service.
- Choose LDAP or LDAPS. Use LDAPS in production and plan how the VCSA will trust the complete certificate chain issued to the domain controllers.
- Prepare a dedicated least-privilege bind account if the selected identity-source method requires one. It should be able to perform the necessary directory searches, not administer the domain.
- Identify the containers or organizational units (OUs) holding the users and groups that vCenter must search.
- Create an AD security group for vCenter administrators. Group-based delegation is easier to audit and change than assigning administrative access directly to individuals.
- Keep a local SSO or appliance administrative account available as a recovery path. Test and protect this break-glass account.
Before changing authentication, record the intended domain, search bases, endpoints, certificate authority details, bind-account owner, and recovery accounts. This documentation is especially important when service-account passwords or domain-controller certificates are rotated.
Join or enable directory integration on the appliance
Some vCenter workflows first join the VCSA to the Active Directory domain and then separately register Active Directory as an SSO identity source. This historical workflow should not be assumed to be required in every current release; newer versions may expose a different supported identity-provider model.
- Sign in to the VCSA management interface with an authorized appliance administrator account.
- Open the directory-service or domain-membership administration page provided by the vCenter release.
- Supply the AD domain FQDN and credentials authorized to join the appliance to that domain. Use an appropriately delegated account rather than broad Domain Admin membership when organizational policy supports delegated joining.
- Apply the change. Older deployment workflows may require a service restart or appliance reboot.
- After the operation, verify domain-membership status, DNS resolution, time synchronization, and connectivity to the domain controllers.
Add Active Directory as an SSO identity source
In the vSphere Client, open the vCenter administration area and locate the SSO identity-source configuration page. When performing manual integration, select the Active Directory LDAP option supported by the release. Enter the values carefully, test the connection, and save only after the test succeeds.
| Setting | Purpose | Example value | Common mistake |
|---|---|---|---|
| Identity source type | Selects the directory integration method | Active Directory over LDAP or LDAPS | Choosing a method unsupported by the vCenter release |
| Identity source name | Friendly label shown in administration and login selection | Example AD | Using an unclear or duplicate label |
| Domain name | Identifies the AD DNS domain | example.local | Entering a short host name instead of the domain FQDN |
| Domain alias | Short or alternate identity label used by supported configurations | EXAMPLE | Using an alias that does not match the environment's login convention |
| User base DN | Starting point for user searches | CN=Users,DC=example,DC=local | Pointing to the wrong container or omitting a domain component |
| Group base DN | Starting point for group searches | CN=Users,DC=example,DC=local | Assuming groups are in the same OU as users |
| Primary LDAP or LDAPS URL | Preferred directory endpoint | ldaps://dc01.example.local:636 | Using an unresolvable name or a certificate-mismatched name |
| Secondary LDAP or LDAPS URL | Alternate endpoint when supported | ldaps://dc02.example.local:636 | Adding an endpoint that is not reachable or configured equivalently |
| Bind username | Account used to search the directory | svc_vcenter_ldap@example.local | Using a personal or overprivileged account |
| Bind password | Secret for the bind account | Stored securely in vCenter | Publishing it in scripts or documentation, or forgetting to update it after rotation |
- Enter the identity-source name, domain name, and domain alias if those fields are provided.
- Enter separate user and group base DNs. They may be identical when both object types are in the same container.
- Enter the primary server URL and an optional secondary URL. Use FQDNs rather than IP addresses, particularly for LDAPS certificate validation.
- Enter the bind account and password if required by the selected method. Protect the credentials and follow the organization's rotation policy.
- Use the connection-test function. Resolve failures before saving.
- Save the identity source and confirm that it appears in the configured source list.
- Review the default domain or default identity-source setting if the vCenter version provides one. Otherwise, select the source explicitly during user or group lookup and login.
LDAP distinguished names and search bases
A distinguished name (DN) is an LDAP path that identifies an object or search location. Active Directory DNS labels become domain components prefixed with DC=. Containers use CN=, and organizational units use OU=. Components are separated by commas.
| Directory location | Active Directory-style location | LDAP distinguished name |
|---|---|---|
| Domain root | example.local | DC=example,DC=local |
| Default Users container | Users under example.local | CN=Users,DC=example,DC=local |
| Custom users OU | Virtualization Users OU | OU=Virtualization Users,DC=example,DC=local |
| Custom groups OU | Virtualization Groups OU | OU=Virtualization Groups,DC=example,DC=local |
A base DN limits where searches begin. If users are in OU=Virtualization Users,DC=example,DC=local and groups are in OU=Virtualization Groups,DC=example,DC=local, configure those separate paths rather than using the default Users container.
Domain: example.local
Users base DN: OU=Virtualization Users,DC=example,DC=local
Groups base DN: OU=Virtualization Groups,DC=example,DC=local
Primary endpoint: ldaps://dc01.example.local:636
Secondary endpoint: ldaps://dc02.example.local:636
Bind user: svc_vcenter_ldap@example.local
An LDAP server URI identifies the protocol, host, and usually the port. Common forms are ldap://dc01.example.local:389 and ldaps://dc01.example.local:636. The hostname must resolve from vCenter and should match the name on the domain controller certificate when using LDAPS.
A secondary server improves resilience when the primary controller is unavailable, but it is not a complete high-availability solution. DNS, network paths, certificates, directory replication, account status, and time synchronization must also remain healthy.
Grant AD users and groups access to vCenter
After the identity source is configured, verify that vCenter can search for representative users and groups. In the vCenter administration interface, locate the SSO users and groups or permissions area and select the configured AD source.
- Create an AD security group such as
GG-vCenter-Administrators. - Add designated administrators to that group in Active Directory.
- For full administrative access, add the AD group to the applicable vCenter SSO administrative group when supported, or assign the built-in Administrator role at the required vCenter scope.
- For ordinary operations, assign a narrower vCenter role to an AD group at a specific inventory scope.
- Enable permission inheritance only when child objects should receive the permission. Review inheritance and conflicting permissions before testing.
Prefer groups over individual accounts. Useful role-based groups might include GG-vCenter-Administrators, GG-vCenter-VM-Operators, GG-vCenter-ReadOnly-Auditors, and GG-vCenter-Backup-Operators.
- Administrators: Reserved for trusted personnel who require broad vCenter control.
- VM operators: Assigned approved virtual-machine tasks at a VM folder or resource-pool scope.
- Read-only auditors: Granted inventory visibility and inspection without change privileges.
- Backup operators: Granted only the privileges required by the backup workflow.
For example, assign a VM operations group a constrained role on a VM folder instead of granting global administration. Test that members can perform approved VM tasks but cannot change hosts, SSO settings, or global permissions.
Validate the configuration
- Run the identity-source connection test.
- Search for a known AD user and a known AD group. Confirm that both resolve from the intended identity source.
- Sign in to the vSphere Client with a non-personal test account that has the intended group membership.
- Verify the account receives only the expected role and inventory visibility.
- Attempt an operation that should be allowed and one that should be denied.
- If a secondary directory server is configured, test behavior with the primary endpoint unavailable during an approved maintenance window.
- Record search bases, endpoints, bind-account ownership, certificate details, recovery accounts, and the date of the test.
Keep the recovery account independent of the AD dependency. This account is essential if directory connectivity, domain membership, certificates, or bind credentials fail.
Security and lifecycle practices
- Prefer LDAPS and validate the domain-controller certificate name, validity period, issuing CA, and complete intermediate chain.
- Do not use Domain Admin membership as the normal way to grant vCenter access.
- Use dedicated AD groups and least-privilege vCenter roles.
- Protect bind credentials, restrict their directory rights, and rotate them according to policy. Update the identity source immediately after a password change.
- Monitor certificate expiration, bind-account status, domain-controller availability, DNS records, and time synchronization.
- Maintain local break-glass administrative access and document emergency procedures.
- Review permissions when AD users or groups are disabled, deleted, renamed, or moved. A moved object may no longer fall within the configured search base, while a deleted or disabled identity may leave permissions that need cleanup.
Troubleshooting
| Symptom | Likely cause | How to verify | Corrective action |
|---|---|---|---|
| Identity-source test fails | Wrong URI, bind credentials, DNS, firewall, base DN, or certificate trust | Resolve the controller FQDN, check the selected port, validate credentials and DN syntax | Correct the endpoint or search settings; fix routing or firewall rules; establish CA trust for LDAPS |
| Users or groups cannot be found | Wrong search base, objects outside the base, insufficient directory read access, or wrong source selection | Inspect representative object DNs and search using the intended identity source | Use accurate, separate user and group base DNs and verify bind-account read access |
| Domain login fails | Incorrect domain or alias, invalid credentials, time skew, or domain connectivity failure | Check the selected source, account status, DNS, time, and controller reachability | Correct identity-source selection and restore DNS, time, or directory connectivity |
| Login succeeds but access is denied | No vCenter role, missing SSO-group membership, wrong scope, disabled inheritance, or conflicting permission | Review effective permissions and AD group membership | Assign the intended group-based role at the correct inventory scope and review inheritance |
| LDAPS certificate failure | Expired certificate, name mismatch, untrusted CA, or missing intermediate CA | Inspect the certificate presented by the configured FQDN and its chain | Use the certificate name, renew the certificate, or establish trust for the complete CA chain |
| Intermittent directory lookup failures | Only one server, broken secondary endpoint, unhealthy DNS, or time skew | Test both endpoints, DNS responses, controller health, and system clocks | Configure and test a secondary server and correct DNS or time problems |
Common bind-account failure
If previously working lookups stop after a service-account password change, the identity source may still contain the old password. Update the stored bind credential, confirm that the account is not locked, disabled, or expired, and run the connection test again. Document ownership and rotation procedures so this dependency is not missed.
Common DN failure
Incorrect OU names, missing commas, incorrect capitalization in environments that validate names strictly, or an unsuitable search level can prevent discovery. Compare the configured DN with the actual distinguished name of a known user and group, then test each base separately.
Exam-relevant notes
- Authentication answers “who are you?”; authorization answers “what may you do?”
- Adding an AD identity source does not automatically grant vCenter access.
- Users and groups can have different base DNs.
- LDAPS requires both a reachable endpoint and a trusted, correctly named certificate.
- Group-based permissions support least privilege, auditing, and lifecycle management.
- Permission scope and inheritance determine which inventory objects a role affects.
- A local recovery account should remain available even when AD is unavailable.
Configuration workflow summary
- Confirm DNS, time, reachability, certificates, directory paths, and recovery access.
- Join or enable appliance directory integration only when required by the vCenter release and chosen method.
- Configure Active Directory as an SSO identity source.
- Test and save the connection.
- Add an AD security group to the appropriate SSO group or assign it a scoped vCenter role.
- Test sign-in, allowed actions, denied actions, inventory scope, and secondary-server behavior.
- Document the configuration and monitor its certificates, accounts, controllers, DNS, and time.
For related administration guidance, see vCenter Server and Active Directory.