33=== Active Directory user authentication
44
55You can configure {stack} {security-features} to communicate with Active
6- Directory to authenticate users. To integrate with Active Directory, you
7- configure an `active_directory` realm and map Active Directory users and groups
8- to roles in the <<mapping-roles, role mapping file>>.
9-
10- See {ref}/configuring-ad-realm.html[Configuring an active directory realm].
6+ Directory to authenticate users. See <<ad-realm-configuration>>.
117
128The {security-features} use LDAP to communicate with Active Directory, so
139`active_directory` realms are similar to <<ldap-realm, `ldap` realms>>. Like
@@ -33,25 +29,10 @@ Active Directory. Once the user has been found, the Active Directory realm then
3329retrieves the user's group memberships from the `tokenGroups` attribute on the
3430user's entry in Active Directory.
3531
36- [[ad-load-balancing]]
37- ==== Load balancing and failover
38- The `load_balance.type` setting can be used at the realm level to configure how
39- the {security-features} should interact with multiple Active Directory servers.
40- Two modes of operation are supported: failover and load balancing.
41-
42- See
43- {ref}/security-settings.html#load-balancing[Load balancing and failover settings].
44-
45- [[ad-settings]]
46- ==== Active Directory realm settings
47-
48- See
49- {ref}/security-settings.html#ref-ad-settings[Active Directory realm settings].
50-
51- [[mapping-roles-ad]]
52- ==== Mapping Active Directory users and groups to roles
32+ [[ad-realm-configuration]]
33+ ==== Configuring an Active Directory realm
5334
54- See {ref}/ configuring-ad- realm.html[Configuring an Active Directory realm].
35+ include:: configuring-active-directory- realm.asciidoc[]
5536
5637[[ad-user-metadata]]
5738==== User metadata in Active Directory realms
@@ -67,14 +48,22 @@ properties are populated in the user's _metadata_:
6748|=======================
6849
6950This metadata is returned in the
70- {ref}/ security-api-authenticate.html[ authenticate API] and can be used with
51+ << security-api-authenticate, authenticate API>> and can be used with
7152<<templating-role-query, templated queries>> in roles.
7253
7354Additional metadata can be extracted from the Active Directory server by configuring
7455the `metadata` setting on the Active Directory realm.
7556
57+ [[ad-load-balancing]]
58+ ==== Load balancing and failover
59+ The `load_balance.type` setting can be used at the realm level to configure how
60+ the {security-features} should interact with multiple Active Directory servers.
61+ Two modes of operation are supported: failover and load balancing.
62+
63+ See
64+ <<load-balancing>>.
65+
7666[[active-directory-ssl]]
7767==== Setting up SSL between Elasticsearch and Active Directory
7868
79- See
80- {ref}/configuring-tls.html#tls-active-directory[Encrypting communications between {es} and Active Directory].
69+ See <<tls-active-directory>>.
0 commit comments