Ping Identity LDAP SDK Tools Docker镜像文档

1. 镜像概述和主要用途

Ping Identity LDAP SDK Tools Docker镜像是一个便携、易运行且功能全面的LDAP工具集容器化解决方案。该镜像封装了完整的LDAP SDK工具，旨在为开发人员和系统管理员提供便捷的LDAP客户端工具环境，支持LDAP协议相关的查询、管理、测试及集成操作。

2. 核心功能和特性

• 便携性：容器化设计，可在任何支持Docker的环境中快速部署，无需手动配置依赖。
• 易用性：简化的运行流程，通过环境变量即可完成基础配置。
• 全功能LDAP工具集：集成完整的LDAP SDK工具，支持标准LDAP操作（如查询、添加、修改、删除条目等）。

3. 使用场景和适用范围

适用场景

• 开发环境中LDAP目录服务的测试与调试。
• 系统管理员对LDAP服务的日常维护（如数据查询、权限验证）。
• 与LDAP集成的应用程序的兼容性测试。
• 自动化脚本中调用LDAP工具执行批量操作。

适用人群

• 开发人员（需要LDAP客户端工具的应用开发）。
• 系统管理员（LDAP服务管理与维护）。
• DevOps工程师（自动化部署与集成测试）。

4. 使用方法和配置说明

4.1 前提条件

• 已安装Docker Engine（20.10+推荐）。
• 已获取有效的Ping Identity软件许可证（评估许可或商业许可，详见5.许可证信息）。
• 接受许可协议（通过环境变量声明）。

4.2 基础运行命令

通过docker run命令启动镜像，需指定PING_IDENTITY_ACCEPT_EULA环境变量以接受许可协议：

docker run --rm \
  -e PING_IDENTITY_ACCEPT_EULA=Yes \
  pingidentity/ldap-sdk-tools:latest

说明：--rm参数表示容器退出后自动删除，适用于临时工具调用场景。

4.3 典型使用示例

示例1：执行LDAP查询命令

通过docker run的command参数直接调用LDAP工具（如ldapsearch）：

docker run --rm \
  -e PING_IDENTITY_ACCEPT_EULA=Yes \
  pingidentity/ldap-sdk-tools:latest \
  ldapsearch -h ldap.example.com -p 389 -D "cn=admin" -w "password" -b "dc=example,dc=com" "(objectClass=*)"

示例2：挂载本地配置文件

将本地LDAP配置文件（如ldaprc）挂载到容器，实现工具参数复用：

docker run --rm \
  -e PING_IDENTITY_ACCEPT_EULA=Yes \
  -v $(pwd)/ldaprc:/root/.ldaprc \  # 挂载本地ldaprc到容器用户目录
  pingidentity/ldap-sdk-tools:latest \
  ldapsearch "(objectClass=*)"  # 直接使用ldaprc中的默认参数（如服务器地址、端口）

4.4 Docker Compose配置示例

如需在多容器环境中集成，可通过docker-compose.yml定义服务：

version: "3.8"
services:
  ldap-tools:
    image: pingidentity/ldap-sdk-tools:latest
    environment:
      - PING_IDENTITY_ACCEPT_EULA=Yes
    volumes:
      - ./ldap-tools-config:/root/.ldap  # 挂载工具配置目录
    command: ldapsearch -h ldap-service -p 389 -b "dc=example,dc=com"  # 连接其他容器中的LDAP服务

4.5 环境变量配置

5. 许可证信息

5.1 许可协议接受

通过设置环境变量PING_IDENTITY_ACCEPT_EULA=Yes，即表示您同意以下许可条款：

• 未购买商业许可：软件视为“试用产品”，条款详见Ping Identity订阅协议。
• 已购买商业许可：若已与Ping Identity签署软件许可协议，以该协议为准；否则仍适用上述订阅协议。

5.2 许可证获取方式

• 评估许可：通过Ping DevOps评估许可流程申请。
• 商业许可：联系Ping Identity销售团队购买，详情参见Ping DevOps注册页面。

5.3 第三方软件许可

镜像中包含的基础系统及依赖软件可能涉及其他开源许可，完整第三方软件及许可列表见3RD_PARTY_SOFTWARE.md。用户需自行确保符合所有软件许可要求。

6. Docker镜像保留政策

Ping Identity维护的Docker镜像在Docker Hub上的保留期为1个日历年（自发布日期起）。为确保稳定性，建议将所需版本镜像标记并推送到自有容器仓库。Ping Identity不保证Docker Hub上镜像的长期可用性。

7. 支持政策

7.1 商业支持

软件按“现状”提供，不含明示或默示担保。如需商业支持，请联系：***。

7.2 官方支持政策

• Ping Identity整体支持政策：[***]
• 镜像专项支持政策：[***]

8. 参考文档

• LDAP SDK Tools Docker镜像官方文档
• Ping DevOps入门指南
• Ping DevOps GitHub仓库（含构建脚本、入门示例及服务器配置文件）

9. 版权信息

Copyright © 2023 Ping Identity. All rights reserved.