本文介绍Ranger Admin如何集成LDAP，以便于您使用LDAP中的用户登录Ranger WebUI。

背景信息

Ranger的用户可以分为Internal User和External User。LDAP和UNIX用户同步至Ranger后属于Internal User，在Ranger WebUI中创建的用户属于Internal User。在Ranger中配置权限时，可以给Internal User和External User授权。

Ranger Admin集成LDAP后，LDAP中的用户可以登录Ranger WebUI。登录后，Ranger会在用户管理中同步创建该用户为External User。初始状态下，该用户仅能查看Ranger Service和Policy。管理员用户admin可以在用户管理中，升级普通用户为管理员用户。

EMR-3.28.0及后续版本（EMR 3.x系列）和EMR-4.3.0及后续版本配置方法

  1. 进入配置页签。
    1. 登录阿里云E-MapReduce控制台。
    2. 在顶部菜单栏处，根据实际情况选择地域（Region）和资源组。
    3. 单击上方的集群管理页签。
    4. 在集群管理页面，单击待操作集群所在行的详情。
    5. 在左侧导航栏，单击集群服务 > RANGER。
    6. 单击配置页签。
  2. 在ranger-admin-site页面，配置各项参数。
    1. 在服务配置区域，单击ranger-admin-site页签。
    2. 配置如下参数，同步LDAP用户至Ranger。
      参数 固定值
      ranger.ldap.bind.dn uid=admin,o=emr
      ranger.ldap.bind.password 密码为OpenLDAP的配置页面，manager_password的值。
      ranger.ldap.base.dn ou=people,o=emr
      ranger.authentication.method LDAP
      ranger.ldap.url ldap://emr-header-1:10389
      ranger.ldap.user.dnpattern uid={0},ou=people,o=emr
  3. 重启Ranger Admin，使配置生效。
    1. 在左侧导航栏，单击集群服务 > RANGER。
    2. 在组件列表区域，单击RangerAdmin所在行的重启。
    3. 在执行集群操作对话框中，配置各项参数。
    4. 单击确定。
    5. 在确认对话框中，单击确定。

EMR-3.28.0之前版本（EMR 3.x系列）和EMR-4.3.0之前版本（EMR 4.x系列）配置方法

  1. 登录集群的emr-header-1节点，详情请参见使用SSH连接主节点。
  2. 编辑install.properties文件。
    cd /usr/lib/ranger-usersync-current
vim install.properties
  3. 修改如下配置项。 
    authentication_method = LDAP
xa_ldap_url = ldap://emr-header-1:10389
xa_ldap_userDNpattern = uid={0},ou=people,o=emr
xa_ldap_base_dn = ou=people,o=emr
xa_ldap_bind_dn = uid=admin,o=emr
xa_ldap_bind_password = [password]
    本示例给出的配置值均为对接的EMR OpenLDAP的值。如果您需要对接自建的LDAP，需要修改各参数值为自建LDAP对应的值。各参数详细解释，请参见Ranger Admin官方安装教程。
    配置项 说明
    xa_ldap_url LDAP服务的地址。例如ldap://ldap.example.com:389。
    xa_ldap_userDNpattern 登录用户匹配LDAP dn的pattern。例如uid={0},ou=users,dc=example,dc=com，表示当用户hadoop在WebUI登录时，其对应检查的LDAP dn为uid=hadoop,ou=users,dc=example,dc=com。
    xa_ldap_base_dn LDAP中用户搜索域。例如ou=users,dc=example,dc=com。
    xa_ldap_bind_dn 连接LDAP进行用户和用户组查询的dn。例如cn=ldapadmin,ou=users,dc=example,dc=com。
    xa_ldap_bind_password 用于连接的dn对应的密码。
  4. 在emr-header-1节点的/usr/lib/ranger-usersync-current路径下执行setup.sh。
    cd /usr/lib/ranger-usersync-current
sh setup.sh
  5. 重启Ranger Admin，使配置生效。
    1. 在左侧导航栏，单击集群服务 > RANGER。
    2. 在组件列表区域，单击RangerAdmin所在行的重启。
    3. 在执行集群操作对话框中，配置各项参数。
    4. 单击确定。
    5. 在确认对话框中，单击确定。