rollekatalog/linux

rollekatalog/linux 镜像文档

镜像概述

rollekatalog/linux镜像是用于部署OS2rollekatalog服务的Docker镜像，提供企业级角色目录管理功能。该镜像支持与MySQL或SQL Server数据库集成，并通过SAML协议实现身份认证，适用于需要集中管理用户角色和权限的企业环境。

核心功能与特性

• 数据库兼容性：支持MySQL和SQL Server数据库，通过JDBC连接实现数据持久化
• SAML认证集成：支持SAML 2.0协议，可与Identity Provider（如ADFS）集成实现单点登录
• 灵活配置：通过环境变量配置客户信息、数据库连接、SAML参数等关键设置
• 多容器调度控制：支持多容器部署场景，可通过配置控制调度功能仅在单个容器启用

使用场景

• 企业内部角色与权限管理系统部署
• 需要SAML单点登录集成的身份管理平台
• 基于MySQL或SQL Server的角色目录服务搭建

使用方法与配置说明

基本部署示例（docker-compose）

以下是启动容器的基础docker-compose配置：

yaml
services:
  rollekatalog:
    image: rollekatalog/linux:2022-07-26
    ports:
      - 8090:8090  # 映射服务端口
    environment:
      # 基本客户信息
      rc.customer.cvr: "12345678"  # 客户CVR编号
      rc.customer.apikey: "00000000-0000-4000-0000-000000000000"  # 客户API密钥
      
      # 数据库配置（需提前部署MySQL或SQL Server）
      spring.datasource.username: "rollekatalog"  # 数据库用户名
      spring.datasource.password: "00000000-0000-4000-0000-000000000000"  # 数据库密码
      spring.datasource.url: "jdbc:mysql://mysql.domain.com/rollekatalog"  # 数据库连接URL
      
      # OS2rollekatalog的SAML服务提供商配置
      di.saml.sp.baseUrl: "https://kunde.rollekatalog.dk"  # SP基础URL
      
      # 登录用Identity Provider的SAML元数据配置
      di.saml.idp.metadataLocation: "url:https://kunde.dk/adfs/sso/FederationMetadata.xml"  # IDP元数据URL
      
      # SAML密钥库配置
      di.saml.keystore.location: "file:///home/cert/keystore.pfx"  # 密钥库文件路径
      di.saml.keystore.password: "password"  # 密钥库密码
      
      # 多容器部署时的调度控制（仅在一个容器启用）
      rc.scheduled.enabled: "true"  # 是否启用调度功能
    volumes:
      - ./cert:/home/cert  # 挂载本地证书目录到容器内

环境变量说明

卷挂载说明

• ./cert:/home/cert：本地证书目录挂载到容器内/home/cert路径，用于提供SAML密钥库文件（如keystore.pfx）

启动步骤

1. 准备数据库（MySQL或SQL Server）并创建相应数据库和用户
2. 准备SAML密钥库文件并放置在本地./cert目录
3. 根据实际环境修改docker-compose.yml中的环境变量配置
4. 执行docker-compose up -d启动服务
5. 访问http://<host>:8090验证服务是否正常运行