mfsecurity/aaf-repldb

认证数据复制服务

概述

认证数据复制服务是一款用于分布式系统环境的专用服务，主要功能是在多个节点或系统间同步用户认证相关数据，包括但不限于用户账户信息、权限配置、认证凭证等。通过实时或定时的数据复制机制，确保各节点认证数据的一致性，提升系统的可靠性和用户访问体验。

核心功能与特性

• 实时数据同步：支持低延迟的认证数据实时复制，确保数据变更快速同步至目标节点
• 多源多目标支持：可配置多个数据来源和目标节点，适应复杂的分布式架构
• 冲突解决机制：内置数据冲突检测与自动解决策略（如基于时间戳、优先级的冲突处理）
• 数据安全保障：提供传输加密（TLS/SSL）和数据校验功能，防止认证信息泄露或篡改
• 协议兼容性：支持主流认证协议数据同步，如LDAP、Active Directory、OAuth 2.0、SAML等
• 监控与可观测性：提供同步状态监控接口和日志记录，支持集成Prometheus等监控工具

使用场景

• 企业分布式系统：在多节点部署的业务系统中保持用户认证数据一致
• 多区域部署架构：跨地域数据中心间同步认证信息，提升全球用户访问体验
• 混合云/多云环境：同步私有云与公有云平台的用户认证数据，实现统一身份管理
• 高可用集群：构建认证数据冗余副本，避免单点故障导致的服务不可用
• 系统迁移过渡：新旧系统并行运行期间，确保认证数据双向同步

使用方法与配置说明

基本部署（Docker Run）

bash
docker run -d \
  --name auth-data-replicator \
  -e SOURCE_TYPE=ldap \
  -e SOURCE_URL=ldap://source-ldap:389 \
  -e SOURCE_BIND_DN="cn=admin,dc=example,dc=com" \
  -e SOURCE_BIND_PASSWORD="secure-password" \
  -e TARGET_TYPE=active_directory \
  -e TARGET_URL=ldap://target-ad:389 \
  -e TARGET_BIND_DN="cn=admin,dc=example,dc=com" \
  -e TARGET_BIND_PASSWORD="secure-password" \
  -e SYNC_INTERVAL=60s \  # 同步间隔，支持s(秒)/m(分)/h(时)
  -e ENCRYPTION_ENABLED=true \
  -p 8080:8080 \  # 监控接口端口
  auth-data-replicator:latest

核心环境变量配置

数据持久化

通过挂载数据卷保存同步日志和配置文件：

bash
docker run -d \
  --name auth-data-replicator \
  -v /host/path/config:/app/config \  # 挂载自定义配置文件
  -v /host/path/logs:/app/logs \      # 挂载日志目录
  -e CONFIG_FILE=/app/config/custom.conf \  # 指定自定义配置文件路径
  auth-data-replicator:latest

监控与日志

• 监控接口：访问 http://<container-ip>:8080/metrics 获取Prometheus格式监控指标（如同步成功率、延迟等）
• 日志输出：默认输出至stdout，可通过LOG_LEVEL环境变量调整日志级别（debug/info/warn/error）

注意事项

• 首次同步前建议备份源和目标节点的认证数据，避免数据冲突导致的意外覆盖
• 高并发场景下建议调整SYNC_INTERVAL和资源限制（如--memory、--cpus），确保同步性能
• 敏感信息（如密码）建议通过Docker Secrets或环境变量加密工具管理，避免明文暴露