本文介绍如何基于腾讯云 Elasticsearch Service 配置轻量目录访问协议 LDAP（Lightweight Directory Access Protocol）认证，以实现相应角色的 LDAP 用户访问腾讯云 Elasticsearch Service。
使用限制
LDAP 身份验证是 Elasticsearch 官方商业特性 X-pack 提供的高级功能，当前仅在白金版集群支持。其他版本集群如需使用，请先升级至白金版。
由于网络架构原因，2020年5月20号之前创建的集群无法访问外部服务，不支持使用 LDAP。如需开启 LDAP 身份验证服务，可重新 创建集群。
设置 LDAP 身份验证
1. 登录腾讯云 Elasticsearch 控制台，单击集群名称访问目标集群，跳转至基础配置页面。
2. 在访问控制模块，单击身份验证的编辑按钮，进入身份验证设置界面。
3. 填写相关内容
url：LDAP 服务器地址。ldap 服务器地址，以 “ldap://” 开头，后面填写域名或者IP地址。请确保填写的 URL 可在您的 VPC 下内网访问，否则该配置将无法生效。
bind_dn：用于 LDAP 服务器认证的成员 DN。需满足 DN 层次型语法结构，如：cn=admin,dc=husor,dc=com，长度不超过200个字符。
bind_password：LDAP 服务器连接密码。支持大小写字母、数字及符号的组合，长度为6 - 63个字符。
user_search.base_dn：用于检索已绑定 LDAP 成员的基准 DN。需满足 DN 层次型语法结构，如：ou=HusorSSO,ou=People,dc=husor,dc=com，长度不超过200个字符。
user_search.filter：查询过滤条件，系统将过滤满足条件的绑定关系。如：(uid={0})。
group_search.base_dn：用于检索已绑定 LDAP 用户组的基准 DN。需满足 DN 层次型语法结构，如：ou=HusorSSO,ou=People,dc=husor,dc=com，长度不超过200个字符。
4. 确认填写内容无误后，单击确定，在弹出的对话框中，阅读注意事项，确认后，集群将会重启，可以在集群变更记录中查看变更进度。
5. 设置成功后，您将会在身份验证看到LDAP 已开启，如需修改LDAP身份验证设置，单击LDAP 已开启即可进行编辑。
配置 LDAP 用户角色权限
1. 设置了 LDAP 身份验证后，LDAP 用户还没有被分配任何权限，无法使用 LDAP 方式访问 ES 集群/Kibana，需要在 Kibana 中对 LDAP 用户进行角色映射。
2. 登录腾讯云 Elasticsearch 控制台，跳转进入集群的 Kibana 主页，进入 Kibana 的 Dev Tools 页面。
3. 参考官方文档 role mapping API，创建 LDAP 用户与角色的映射关系。例如下面的示例，为 LDAP 用户 zhangsan 赋予了 superuser 角色的权限。
POST _xpack/security/role_mapping/ldap_role_mapping_zhangsan?pretty{"roles": [ "superuser" ],"enabled": true,"rules": {"any": [{"field": {"username": "zhangsan"}}]}}
关闭 LDAP 身份验证
1. 登录腾讯云 Elasticsearch 控制台，单击集群名称访问目标集群，跳转至基础配置页面。
2. 在访问控制模块，单击身份验证中的关闭按钮，在弹出的对话框中，阅读注意事项，确认后，LDAP 关闭操作开始，集群将会重启，可以在集群变更记录中查看变更进度。
注意事项
如果集群健康状态为 YELLOW 或 RED，进行修改配置操作有较大风险，需要先修复集群状态，再进行操作。
如果集群存在无副本索引，修改集群配置时会有强制重启的提示和选项框，此时进行修改重启操作有较大风险，可能会出现部分数据短暂无法访问的情况，建议为所有索引添加副本之后，再进行修改配置操作。
