Merge pull request #1591 from wojiushixiaobai/docs

[Add]增加ldap文档

docs/faq.rst

@@ -3,6 +3,7 @@ FAQ
 .. toctree::
    :maxdepth: 1
 
+   Ldap 使用说明 <faq_ldap.rst>
    Sftp 使用说明 <faq_sftp.rst>
    Telnet 使用说明 <faq_telnet.rst>
    安装过程 常见问题 <faq_install.rst>

docs/faq_ldap.rst

+LDAP 使用说明
+------------------------------
+
+LDAP 支持 使用 LADP 与 Windows AD 的用户作为 jumpserver 登录用户
+
+1. LDAP 设置说明
+
+::
+
+    # LDAP地址  ldap://serverurl:389  或者  ldaps://serverurl:636（需要勾选ssl）
+    # 此处是设置LDAP的服务器，推荐使用IP，防止解析问题
+
+    # 绑定DN  cn=admin,dc=jumpserver,dc=org
+    # 这里是设置认证用户的信息，jumpserver会使用这个用户去校验ldap的信息是否正确
+
+    # 密码   上面认证用户的密码
+
+    # 用户OU  ou=jumpserver,dc=jumpserver,dc=org
+    # 这里是设置用来登录jumpserver的组织单元，比如我要用某个ou的用户来登录jumpserver
+
+    # 用户过滤器  (cn=%(user)s)
+    # 这里是设置筛选ldap用户的哪些属性
+
+    # LADP属性映射  {"username": "cn", "name": "sn", "email": "mail"}
+    # username name email 是jumpserver的用户属性（不可更改）
+    # cn       sn   mail  是ldap的用户属性（可自定义）
+    # 这里的意思是，把ldap用户的属性映射到jumpserver上
+
+    # 使用SSL
+    # 勾选后 LDAP地址 需要设置成 ldaps://serverurl:636
+
+    # 启动LDAP认证
+    # 如果需要使用 LDAP或域用户 登录 jumpserver ，则必选
+
+2. 补充
+
+::
+
+    # DN 一定要是完整的DN，不能跳过OU，可以使用其他工具查询
+    # 如：cn=admin,ou=aaa,dc=jumpserver,ou=org，必须要写成cn=admin,ou=aaa,dc=jumpserver,ou=org 不能缩写成cn=admin,dc=jumpserver,dc=org
+
+    # 用户OU 用户OU可以只写顶层OU，不写子OU
+    # 如：ou=aaa,ou=bbb,ou=ccc,dc=jumpserver,ou=org，可以只写ou=ccc,dc=jumpserver,dc=org，根据需求自行修改
+
+    # 用户过滤器  筛选用户的规则，点击测试连接就是根据这个规则到用户OU里面去检索用户，可以自定义规则
+    # 如：(uid=%(user)s) 或 (sAMAccountName=%(user)s)  等，这里的属性需要与下面的属性映射设置一致
+
+    # LADP属性映射  username name email 这三项不可修改删除，cn sn 可自定义，mail必须存在
+    # 如：{"username": "uid", "name": "sn", "email": "mail"} 或 {"username": "sAMAccountName", "name": "cn", "email": "mail"}
+    # "username": "uid" 这里的 uid 必须和上面的 (uid=%(user)s) 这里的 uid 一致
+    # 如果上面是(sAMAccountName=%(user)s) 那么下面也应该修改为{"username": "sAMAccountName",