tidepool/gatekeeper

Tidepool Gatekeeper Docker镜像文档

概述

Tidepool Gatekeeper是Tidepool开源糖尿病数据管理生态系统的核心服务组件，作为API网关和认证服务，提供用户身份验证、数据访问权限控制及API请求路由功能，确保糖尿病患者数据在平台中的安全流转与访问。

核心功能与特性

• 用户认证管理：支持OAuth2.0/OpenID Connect协议，处理用户登录、令牌发放与验证
• 数据访问控制：基于角色的权限管理(RBAC)，确保用户仅能访问授权数据
• API请求处理：请求路由、负载均衡及请求限流，保障后端服务稳定性
• 日志与监控：详细记录访问日志，支持集成监控系统进行服务健康状态跟踪
• 高可配置性：通过环境变量灵活配置服务参数，适应不同部署环境

使用场景与适用范围

• Tidepool糖尿病数据管理平台后端服务部署
• 需要安全认证与权限控制的***健康数据API网关
• 作为微服务架构中的认证中间件，连接前端应用与后端数据服务

使用方法与配置说明

基本Docker运行命令

bash
docker run -d \
  --name tidepool-gatekeeper \
  -p 3000:3000 \
  -e MONGODB_URI=mongodb://mongo:27017/tidepool \
  -e JWT_SECRET=your_jwt_secret_key \
  -e OAUTH_CLIENT_ID=your_oauth_client_id \
  -e OAUTH_CLIENT_SECRET=your_oauth_client_secret \
  tidepool/gatekeeper:latest

Docker Compose配置示例

yaml
version: '3'
services:
  gatekeeper:
    image: tidepool/gatekeeper:latest
    container_name: tidepool-gatekeeper
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=production
      - PORT=3000
      - MONGODB_URI=mongodb://mongo:27017/tidepool
      - JWT_SECRET=${JWT_SECRET}
      - OAUTH_CLIENT_ID=${OAUTH_CLIENT_ID}
      - OAUTH_CLIENT_SECRET=${OAUTH_CLIENT_SECRET}
      - LOG_LEVEL=info
      - CORS_ORIGIN=https://app.tidepool.org
    depends_on:
      - mongo
    restart: unless-stopped

  mongo:
    image: mongo:5
    container_name: tidepool-mongo
    volumes:
      - mongo-data:/data/db
    restart: unless-stopped

volumes:
  mongo-data:

关键配置参数（环境变量）

部署注意事项

• 生产环境中需使用强密钥（JWT_SECRET）并定期轮换
• 建议通过Docker Secrets或环境变量管理敏感配置（如数据库密码、OAuth密钥）
• 配合反向代理（如Nginx）使用，启用HTTPS以保障数据传输安全
• 定期更新镜像以获取最新安全补丁和功能改进

更多详细文档与源代码请参见：https://github.com/tidepool-org/gatekeeper