pingidentity/pingaccess

Ping Identity PingAccess™ Docker 镜像

1. 镜像概述和主要用途

PingAccess™ Docker 镜像提供 Ping Identity 的 PingAccess 产品容器化部署方案，专注于应用和 API 的访问安全，通过实时和风险感知的授权机制保护资源访问。该镜像旨在简化 PingAccess 的部署流程，适用于开发、测试及生产环境的容器化基础设施。

2. 核心功能和特性

• 实时授权：基于上下文和策略的动态资源访问控制
• 风险感知：结合用户行为、设备状态等多维度风险评估
• 应用与 API 保护：统一保护 Web 应用、移动应用及 API 接口
• 容器化优化：轻量级部署，支持 Kubernetes 等容器编排平台
• 灵活集成：与 PingFederate、OAuth 2.0/OpenID Connect 等身份服务无缝集成

3. 使用场景和适用范围

适用场景

• 企业级应用的访问安全防护
• API 网关的身份验证与授权集成
• 多因素认证（MFA）与单点登录（SSO）流程整合
• 容器化微服务架构中的资源访问控制
• 混合云环境下的统一访问管理

适用范围

• 开发/测试环境：快速搭建功能验证环境
• 生产环境：通过容器编排平台实现高可用部署
• 企业 IT 部门：简化安全策略管理与合规审计

4. 使用方法和配置说明

4.1 前提条件

• 已安装 Docker 或容器编排平台（如 Kubernetes）
• 接受 Ping Identity 最终用户许可协议（EULA）
• 已获取有效的 PingAccess 许可证（评估版或商业版）

4.2 基本部署（docker run）

bash
docker run \
  -d \
  --name pingaccess \
  -p 9000:9000 \
  -e PING_IDENTITY_ACCEPT_EULA=Yes \
  -e SERVER_PROFILE_URL=https://github.com/pingidentity/pingidentity-server-profiles.git \
  -e SERVER_PROFILE_PATH=pingaccess/getting-started \
  docker.xuanyuan.run/pingidentity/pingaccess:latest

说明：

• -p 9000:9000：映射容器的 9000 端口（管理控制台默认端口）到主机
• SERVER_PROFILE_URL 和 SERVER_PROFILE_PATH：指定服务器配置文件的 Git 仓库及路径，用于初始化 PingAccess 配置

4.3 Docker Compose 部署示例

yaml
version: '3.8'
services:
  pingaccess:
    image: docker.xuanyuan.run/pingidentity/pingaccess:latest
    container_name: pingaccess
    ports:
      - "9000:9000"  # 管理控制台端口
      - "443:443"    # HTTPS 服务端口
    environment:
      - PING_IDENTITY_ACCEPT_EULA=Yes
      - LICENSE_FILE=/license/pingaccess.lic
      - ADMIN_USER_PASSWORD=2FederateM0re!
    volumes:
      - ./license:/license
      - pingaccess-data:/opt/out/instance
    restart: unless-stopped

volumes:
  pingaccess-data:

4.4 配置参数说明

核心环境变量

数据持久化

建议通过 Docker 卷（Volume）挂载以下目录以实现数据持久化：

• /opt/out/instance：PingAccess 实例配置数据
• /opt/out/logs：日志文件

5. 许可证信息

5.1 许可协议接受

通过向环境变量 PING_IDENTITY_ACCEPT_EULA 传递值 Yes，镜像用户同意其对镜像中软件的使用受以下许可协议约束：

• 未购买商业许可：适用 https://www.pingidentity.com/en/legal/subscription-agreement.html，软件视为“试用产品”
• 已购买商业许可：优先适用用户与 Ping Identity 签署的软件许可协议；无签署协议时，仍适用上述订阅协议

5.2 许可证获取

运行镜像前必须获取有效许可证：

• 评估许可证：通过 https://devops.pingidentity.com/get-started/prereqs/#evaluation-license 定义的流程获取
• 商业许可证：联系 Ping Identity 销售团队购买

5.3 第三方软件许可

镜像可能包含基础分发版及依赖软件，其许可信息详见 https://github.com/pingidentity/pingidentity-devops-getting-started/blob/master/3RD_PARTY_SOFTWARE.md。用户需确保使用镜像时遵守所有包含软件的许可条款。

6. 商业支持

本镜像提供的软件按“现状”提供，不附带任何明示、暗示或法定的担保或陈述。
如需商业支持详情，请联系：***

7. Docker 镜像保留政策

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

8. Docker 支持政策

• Ping Identity 整体支持政策：https://devops.pingidentity.com/home/supportPolicy/
• Docker 镜像专项支持政策：https://devops.pingidentity.com/docker-images/imageSupport/

9. 版权信息

Copyright © 2023 Ping Identity. 保留所有权利。