RabbitMQ LDAP连接器镜像文档

镜像概述

RabbitMQ LDAP连接器Docker镜像，提供RabbitMQ与LDAP（轻量级目录访问协议）服务的集成能力，实现基于LDAP的用户认证、授权及角色映射，适用于企业级RabbitMQ部署中需要集中式身份管理的场景。

核心功能与特性

LDAP认证集成：支持通过LDAP服务器验证用户身份，替代RabbitMQ内置认证机制，实现统一身份管理
灵活角色映射：可配置LDAP用户/组到RabbitMQ角色（如administrator、policymaker、monitoring等）的映射规则
配置简化：通过环境变量快速配置LDAP连接参数，无需手动修改RabbitMQ配置文件，降低集成复杂度
兼容性广泛：支持主流LDAP服务（OpenLDAP、Active Directory、FreeIPA等）及标准LDAP协议（v3）
安全连接：可选启用TLS加密（LDAPS），保障认证数据在传输过程中的安全性

使用场景

企业级RabbitMQ部署：适用于需要集中管理用户身份的场景，如多部门共用RabbitMQ集群时通过LDAP统一用户管理
合规性要求场景：满足***、政务等行业对集中身份认证审计的需求，利用LDAP日志记录用户访问行为
现有LDAP环境集成：已部署OpenLDAP/Active Directory的企业，可直接复用现有LDAP用户体系，避免维护多套身份系统

使用方法与配置说明

环境变量配置

通过以下环境变量配置LDAP连接及认证规则，所有带*的为必填项：

环境变量	描述	默认值
`LDAP_HOST`*	LDAP服务器地址（域名或IP）	-
`LDAP_PORT`	LDAP服务器端口	389（非TLS）/636（TLS）
`LDAP_USE_TLS`	是否启用TLS加密连接（true/false）	false
`LDAP_BIND_DN`*	用于绑定LDAP的服务账户DN（如`cn=admin,dc=example,dc=com`）	-
`LDAP_BIND_PASSWORD`*	`LDAP_BIND_DN`对应的密码	-
`LDAP_USER_BASE_DN`*	用户搜索基准DN（如`ou=users,dc=example,dc=com`）	-
`LDAP_USER_FILTER`	用户搜索过滤器，`{username}`为占位符（如`(uid={username})`）	`(uid={username})`
`LDAP_ROLE_BASE_DN`	角色/组搜索基准DN（如`ou=groups,dc=example,dc=com`）	-
`LDAP_ROLE_FILTER`	角色搜索过滤器，`{userdn}`为用户DN占位符（如`(member={userdn})`）	`(member={userdn})`
`LDAP_ROLE_MAPPING`*	角色映射规则，格式`ldap_role:rabbitmq_role,...`（如`admin:administrator,dev:policymaker`）	-

Docker部署示例

1. 基础docker run命令

bash
docker run -d \
  --name rabbitmq-ldap-connector \
  -e LDAP_HOST=ldap.example.com \
  -e LDAP_PORT=389 \
  -e LDAP_USE_TLS=false \
  -e LDAP_BIND_DN="cn=admin,dc=example,dc=com" \
  -e LDAP_BIND_PASSWORD="ldap_admin_password" \
  -e LDAP_USER_BASE_DN="ou=users,dc=example,dc=com" \
  -e LDAP_ROLE_BASE_DN="ou=groups,dc=example,dc=com" \
  -e LDAP_ROLE_MAPPING="admin:administrator,developer:policymaker,viewer:monitoring" \
  rabbitmq-ldap-connector

2. Docker Compose配置

yaml
version: '3.8'

services:
  rabbitmq-ldap-connector:
    image: rabbitmq-ldap-connector
    environment:
      - LDAP_HOST=ldap.example.com
      - LDAP_PORT=636
      - LDAP_USE_TLS=true
      - LDAP_BIND_DN=cn=admin,dc=example,dc=com
      - LDAP_BIND_PASSWORD=ldap_admin_password
      - LDAP_USER_BASE_DN=ou=users,dc=example,dc=com
      - LDAP_USER_FILTER=(mail={username})  # 使用***作为登录名
      - LDAP_ROLE_BASE_DN=ou=groups,dc=example,dc=com
      - LDAP_ROLE_FILTER=(uniqueMember={userdn})  # OpenLDAP组过滤规则
      - LDAP_ROLE_MAPPING=mq-admin:administrator,mq-dev:policymaker,mq-viewer:monitoring
    restart: always
    network_mode: "host"  # 确保与RabbitMQ实例网络互通