Skip to main content
Version: 3.1

ldap-auth

描述#

ldap-auth 插件可用于给路由或服务添加 LDAP 身份认证,该插件使用 lua-resty-ldap 连接 LDAP 服务器。

该插件需要与 Consumer 一起配合使用,API 的调用方可以使用 basic authentication 与 LDAP 服务器进行认证。

属性#

Consumer 端:

名称类型必选项描述
user_dnstringLDAP 客户端的 dn,例如:cn=user01,ou=users,dc=example,dc=org

Route 端:

名称类型必选项默认值描述
base_dnstringLDAP 服务器的 dn,例如:ou=users,dc=example,dc=org
ldap_uristringLDAP 服务器的 URI。
use_tlsbooleanfalse如果设置为 true 则表示启用 TLS。
tls_verifybooleanfalse是否校验 LDAP 服务器的证书。如果设置为 true,你必须设置 config.yaml 里面的 ssl_trusted_certificate,并且确保 ldap_uri 里的 host 和服务器证书中的 host 匹配。
uidstringcnUID 属性。

启用插件#

首先,你需要创建一个 Consumer 并在其中配置该插件,具体代码如下:

curl http://127.0.0.1:9180/apisix/admin/consumers -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
{
"username": "foo",
"plugins": {
"ldap-auth": {
"user_dn": "cn=user01,ou=users,dc=example,dc=org"
}
}
}'

然后就可以在指定路由或服务中启用该插件,具体代码如下:

curl http://127.0.0.1:9180/apisix/admin/routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
{
"methods": ["GET"],
"uri": "/hello",
"plugins": {
"ldap-auth": {
"base_dn": "ou=users,dc=example,dc=org",
"ldap_uri": "localhost:1389",
"uid": "cn"
},
},
"upstream": {
"type": "roundrobin",
"nodes": {
"127.0.0.1:1980": 1
}
}
}'

测试插件#

通过上述方法配置插件后,可以通过以下命令测试插件:

curl -i -uuser01:password1 http://127.0.0.1:9080/hello
HTTP/1.1 200 OK
...
hello, world

如果授权信息请求头丢失或无效,则请求将被拒绝(如下展示了几种返回结果):

curl -i http://127.0.0.1:9080/hello
HTTP/1.1 401 Unauthorized
...
{"message":"Missing authorization in request"}
curl -i -uuser:password1 http://127.0.0.1:9080/hello
HTTP/1.1 401 Unauthorized
...
{"message":"Invalid user authorization"}
curl -i -uuser01:passwordfalse http://127.0.0.1:9080/hello
HTTP/1.1 401 Unauthorized
...
{"message":"Invalid user authorization"}

禁用插件#

当你需要禁用 ldap-auth 插件时,可以通过以下命令删除相应的 JSON 配置。APISIX 将自动重新加载,无需重启服务:

curl http://127.0.0.1:9180/apisix/admin/routes/1  -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
{
"methods": ["GET"],
"uri": "/hello",
"plugins": {},
"upstream": {
"type": "roundrobin",
"nodes": {
"127.0.0.1:1980": 1
}
}
}'