InCommon可信访问平台Grouper容器

镜像概述

该镜像为InCommon可信访问平台（InCommon Trusted Access Platform, ITAP）提供Grouper服务容器化部署方案。Grouper是一款开源的身份与访问管理工具，旨在简化用户组管理、权限分配及信任关系维护，是ITAP的核心组件之一。详细信息可参考***文档：InCommon Trusted Access Platform Release。

核心功能与特性

• 身份与访问管理：支持用户组创建、成员管理及细粒度权限分配，实现统一身份管控
• 信任关系维护：集成InCommon联盟标准，支持跨组织身份联合与信任机制构建
• 权限策略 enforcement：基于规则的权限自动分配与撤销，确保资源访问合规性
• 审计与日志：完整记录用户操作、权限变更日志，满足安全审计与合规要求
• 容器化部署：简化ITAP环境搭建流程，支持快速集成与扩展

使用场景与适用范围

• 高等教育机构：参与InCommon联盟的高校用于管理校内及跨校资源访问权限
• 研究机构：科研协作环境中的多组织用户身份联合与资源共享控制
• 企业组织：需要对接InCommon信任体系的企业，实现外部合作伙伴身份统一管理
• 服务提供商：为InCommon联盟成员提供身份验证与授权服务的平台运营商

使用方法与配置说明

基本部署

通过Docker命令快速启动容器：

bash
docker run -d \
  --name itap-grouper \
  -p 8080:8080 \  # Web管理界面端口
  -p 389:389 \    # LDAP服务端口（如启用）
  incommon/grouper-itap:latest

环境变量配置

通过环境变量自定义容器行为（具体参数需参考***文档）：

bash
docker run -d \
  --name itap-grouper \
  -e GROUPER_DB_URL=jdbc:mysql://db-host:3306/grouper \
  -e GROUPER_DB_USER=db-user \
  -e GROUPER_DB_PASSWORD=db-pass \
  -e GROUPER_ADMIN_PASSWORD=admin-pass \
  -p 8080:8080 \
  incommon/grouper-itap:latest

持久化存储

挂载数据卷保存配置与数据，避免容器重启后数据丢失：

bash
docker run -d \
  --name itap-grouper \
  -v /local/grouper/config:/opt/grouper/config \
  -v /local/grouper/data:/opt/grouper/data \
  -v /local/grouper/logs:/opt/grouper/logs \
  -p 8080:8080 \
  incommon/grouper-itap:latest

Docker Compose集成

在ITAP整体部署架构中，可通过docker-compose.yml整合Grouper与其他组件：

yaml
version: '3'
services:
  grouper:
    image: incommon/grouper-itap:latest
    ports:
      - "8080:8080"
    environment:
      - GROUPER_DB_URL=jdbc:mysql://mariadb:3306/grouper
      - GROUPER_DB_USER=${DB_USER}
      - GROUPER_DB_PASSWORD=${DB_PASS}
    depends_on:
      - mariadb
    volumes:
      - grouper-config:/opt/grouper/config
      - grouper-data:/opt/grouper/data

  mariadb:
    image: mariadb:10.6
    environment:
      - MYSQL_ROOT_PASSWORD=${DB_ROOT_PASS}
      - MYSQL_DATABASE=grouper
      - MYSQL_USER=${DB_USER}
      - MYSQL_PASSWORD=${DB_PASS}
    volumes:
      - mariadb-data:/var/lib/mysql

volumes:
  grouper-config:
  grouper-data:
  mariadb-data:

注意事项

1. 容器部署前需确保已配置外部数据库（如MySQL、PostgreSQL）并创建Grouper专用数据库
2. 生产环境中需启用HTTPS，可通过反向代理（如Nginx）配置SSL证书
3. 详细配置参数、升级策略及备份方案请参考***ITAP部署文档