支持的版本: 当前 (17) / 16 / 15 / 14 / 13
开发版本: devel
不支持的版本: 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2

32.18. 连接参数的 LDAP 查找 #

如果 libpq 在编译时启用了 LDAP 支持(configure 命令的 --with-ldap 选项),则可以从中央服务器通过 LDAP 检索诸如 hostdbname 之类的连接选项。这样做的好处是,如果数据库的连接参数发生更改,则无需在所有客户端计算机上更新连接信息。

LDAP 连接参数查找使用连接服务文件 pg_service.conf (请参阅第 32.17 节)。pg_service.conf 节中以 ldap:// 开头的行将被识别为 LDAP URL,并将执行 LDAP 查询。结果必须是 关键字 = 值 对的列表,这些键值对将用于设置连接选项。该 URL 必须符合 RFC 1959 并采用以下形式

ldap://[hostname[:port]]/search_base?attribute?search_scope?filter

其中 hostname 默认为 localhostport 默认为 389。

在成功执行 LDAP 查找后,pg_service.conf 的处理将终止,但如果无法联系到 LDAP 服务器,则将继续处理。这样做是为了提供回退机制,以便使用指向不同 LDAP 服务器的其他 LDAP URL 行、经典的 关键字 = 值 对或默认连接选项。如果您希望在这种情况下收到错误消息,请在 LDAP URL 后添加语法不正确的行。

使用 LDIF 文件创建的示例如下 LDAP 条目

version:1
dn:cn=mydatabase,dc=mycompany,dc=com
changetype:add
objectclass:top
objectclass:device
cn:mydatabase
description:host=dbserver.mycompany.com
description:port=5439
description:dbname=mydb
description:user=mydb_user
description:sslmode=require

可以使用以下 LDAP URL 进行查询

ldap://ldap.mycompany.com/dc=mycompany,dc=com?description?one?(cn=mydatabase)

您还可以将常规服务文件条目与 LDAP 查找混合使用。pg_service.conf 中一个节的完整示例如下:

# only host and port are stored in LDAP, specify dbname and user explicitly
[customerdb]
dbname=customer
user=appuser
ldap://ldap.acme.com/cn=dbserver,cn=hosts?pgconnectinfo?base?(objectclass=*)

提交更正

如果您在文档中发现任何不正确、与您使用特定功能的经验不符或需要进一步说明的内容,请使用此表单报告文档问题。