Python 连接 Windows AD#

1. LDAP 协议#

那么在开始之前，需要先了解 LDAP 协议。因为 Python 的 ldap3 的包就是基于 LDAP 协议的。

LDAP 的全称是 Lightweight Directory Access Protocol，「轻量目录访问协议」。

它约定了 Client 与 Server 之间的信息交互格式、使用的端口号、认证方式等内容。而「LDAP 协议的实现」，有着众多版本，例如微软的 Active Directory 是 LDAP 在 Windows 上的实现，AD 实现了 LDAP 所需的树形数据库、具体如何解析请求数据并到数据库查询然后返回结果等功能。再例如 OpenLDAP 是可以运行在 Linux 上的 LDAP 协议的开源实现。而我们平常说的 LDAP Server，一般指的是安装并配置了 Active Directory、OpenLDAP 这些程序的服务器。

2. 尝试首次连接吧#

那么，记得安装好包，顺带着也学了一下 .env 把凭据存在本地。

1
pip install ldap3
2
pip install dotenv

使用 dotenv 将密码存储在本地的 env 环境，配合 .gitignore 不让它 push 到 GitHub ~~（那可真是完蛋了）~~。然后使用以下方法调用即可。

1
load_dotenv()
2
user = os.environ['LDAP_USER']
3
password = os.environ['LDAP_PASS']

env 下面就可以写：

1
LDAP_USER=<username>
2
LDAP_PASS=<password>

那么就开始首次连接吧！

1
from ldap3 import Server, Connection, ALL
2

3
# 绑定服务器
4
server = Server('ldap://192.168.254.10',get_info=ALL)
5

6
# 创建并打开链接
7
conn = Connection(server)
8
conn.open()
9

10
# 查看连接状态
11
print("Connect Status:", conn.closed)
12
print("root DSE info",)
13
print(server.info)
14

15
# 取消绑定（关闭连接）
16
conn.unbind()

3. 尝试读取用户与计算机#

呼呼呼，既然已经成功连接到了目标 Server，那就进一步尝试读取 User 与 GPO 吧！

1
from ldap3 import Server, Connection, ALL, NTLM
2
from dotenv import load_dotenv
3
import os
4

5
load_dotenv()
6
user = os.environ['LDAP_USER']
7
password = os.environ['LDAP_PASS']
8

9
# 绑定服务器
10
server = Server('ldap://192.168.254.10',get_info=ALL)
11

12
# 创建并打开链接，使用 NTLM 协议
13
conn = Connection(
14
    server,
15
    user=user,
16
    password=password,
17
    authentication=NTLM,
18
    auto_bind=True
19
)
20

21
# 在此连接中进行查询
22
conn.search(
23
    search_base='DC=qy,DC=net',
24
    search_filter='(objectClass=user)',
25
    attributes=['sAMAccountName', 'displayName', 'distinguishedName', 'mail']
26
)
27

28
# For 循环将 conn.entires 中的对象遍历输出
29
for entry in conn.entries:
30
    print(entry.distinguishedName)
31
    print('  登录名:', entry.sAMAccountName)
32
    print('  显示名:', entry.displayName)
33
    print()