gatewayapps/grayskull

grayskull

镜像概述和主要用途

grayskull 是一个 OpenID Connect 服务器，专注于提供联邦用户认证功能（不包含授权功能）。它允许应用程序通过标准化的 OpenID Connect 协议进行用户身份验证，适用于需要统一身份管理的场景。

核心功能和特性

• 支持 OpenID Connect 协议，提供标准化的用户认证流程
• 联邦认证能力，可集成多来源身份信息
• 基于环境变量的灵活配置，支持多种数据库后端
• 集成 Cloudinary 服务用于文件上传存储

使用场景和适用范围

• 多应用系统的统一身份认证服务
• 需要联邦身份管理的企业级应用
• 基于 OpenID Connect 协议的第三方应用集成
• 需支持多种数据库（如 PostgreSQL、MSSQL、SQLite 等）的认证系统

使用方法和配置说明

环境变量配置

以下环境变量用于配置 grayskull 服务：

Docker 部署示例

使用 docker run 部署

bash
docker run -d \
  -p 3000:3000 \
  -e CLOUDINARY_URL="cloudinary://your_api_key:your_api_secret@your_cloud_name" \
  -e CLOUDINARY_FOLDER="grayskull/production/" \
  -e GRAYSKULL_GLOBAL_SECRET="your-secure-global-secret" \
  -e GRAYSKULL_DB_PROVIDER="postgres" \
  -e GRAYSKULL_DB_HOST="postgres-host" \
  -e GRAYSKULL_DB_LOGIN="grayskull-user" \
  -e GRAYSKULL_DB_PASSWORD="secure-db-password" \
  -e GRAYSKULL_DB_CONNECTION_STRING="postgres://grayskull-user:secure-db-password@postgres-host:5432/grayskull" \
  --name grayskull-server \
  grayskull:latest

使用 docker-compose 部署

yaml
version: '3'
services:
  grayskull:
    image: grayskull:latest
    ports:
      - "3000:3000"
    environment:
      - CLOUDINARY_URL=cloudinary://your_api_key:your_api_secret@your_cloud_name
      - CLOUDINARY_FOLDER=grayskull/production/
      - GRAYSKULL_GLOBAL_SECRET=your-secure-global-secret
      - GRAYSKULL_DB_PROVIDER=postgres
      - GRAYSKULL_DB_HOST=postgres
      - GRAYSKULL_DB_LOGIN=grayskull-user
      - GRAYSKULL_DB_PASSWORD=secure-db-password
      - GRAYSKULL_DB_CONNECTION_STRING=postgres://grayskull-user:secure-db-password@postgres:5432/grayskull
    depends_on:
      - postgres

  postgres:
    image: postgres:14
    environment:
      - POSTGRES_USER=grayskull-user
      - POSTGRES_PASSWORD=secure-db-password
      - POSTGRES_DB=grayskull
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  postgres-data: