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=[***] \
  -e SERVER_PROFILE_PATH=pingaccess/getting-started \
  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: 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 配置参数说明

核心环境变量

环境变量	说明	必需性
`PING_IDENTITY_ACCEPT_EULA`	接受 Ping Identity 最终用户许可协议，值为 `Yes` 表示同意	是
`LICENSE_FILE`	许可证文件路径（容器内路径），适用于商业许可	否
`LICENSE_KEY`	评估版许可证密钥，通过 Ping DevOps 计划获取	否
`SERVER_PROFILE_URL`	服务器配置文件的 Git 仓库 URL（用于初始化配置）	否
`SERVER_PROFILE_PATH`	配置文件在 Git 仓库中的路径	否
`ADMIN_USER_PASSWORD`	管理员用户（默认 `administrator`）的初始密码	否