cbioportal/keycloak

cBioPortal自定义Keycloak镜像文档

镜像概述

本镜像为cBioPortal实例定制的Keycloak镜像，基于开源身份和访问管理解决方案Keycloak构建，专门优化以适配cBioPortal的身份认证与授权需求，提供开箱即用的集成能力。

核心功能与特性

• cBioPortal集成优化：预配置与cBioPortal的认证流程兼容，减少集成复杂度
• 身份认证管理：支持用户注册、登录、密码重置等标准认证功能
• 授权控制：提供基于角色的访问控制(RBAC)，适配cBioPortal的权限模型
• 兼容性保障：针对cBioPortal特定版本进行测试，确保稳定运行

使用场景与适用范围

• cBioPortal实例的生产环境部署
• cBioPortal开发/测试环境的身份认证服务搭建
• 需要统一身份管理的cBioPortal多实例部署场景

使用方法与配置说明

基本运行命令

bash
docker run -d \
  --name cbio-keycloak \
  -p 8080:8080 \
  -e KEYCLOAK_ADMIN=admin \
  -e KEYCLOAK_ADMIN_PASSWORD=admin-password \
  cbio/keycloak:latest

Docker Compose配置示例

yaml
version: '3.8'
services:
  keycloak:
    image: cbio/keycloak:latest
    container_name: cbio-keycloak
    ports:
      - "8080:8080"
    environment:
      - KEYCLOAK_ADMIN=admin
      - KEYCLOAK_ADMIN_PASSWORD=admin-password
      - KC_DB=postgres
      - KC_DB_URL=jdbc:postgresql://postgres:5432/keycloak
      - KC_DB_USERNAME=keycloak
      - KC_DB_PASSWORD=keycloak-db-password
    depends_on:
      - postgres
    volumes:
      - keycloak-data:/opt/keycloak/data

  postgres:
    image: postgres:14
    container_name: keycloak-postgres
    environment:
      - POSTGRES_DB=keycloak
      - POSTGRES_USER=keycloak
      - POSTGRES_PASSWORD=keycloak-db-password
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  keycloak-data:
  postgres-data:

主要环境变量配置

数据持久化

通过挂载数据卷/opt/keycloak/data可实现配置和用户数据的持久化，避免容器重启后数据丢失。

与cBioPortal集成配置

1. 启动Keycloak容器后，访问http://localhost:8080/admin并使用管理员账号登录
2. 创建名为cbio-portal的realm
3. 在realm中创建客户端，配置回调URL为cBioPortal的访问地址
4. 配置角色和用户权限，确保与cBioPortal的权限模型匹配
5. 在cBioPortal配置文件中设置Keycloak相关参数（如认证URL、客户端ID等）