citizensadvice/mokta

Mokta - Okta模拟服务

镜像概述

Mokta是一个模拟Okta认证服务的Docker镜像，旨在帮助开发者在本地或测试环境中快速搭建认证模拟服务，无需依赖真实的Okta实例，方便验证应用的认证流程。

核心功能

• 自动从用户名生成JWT claims（姓氏、名字、sub等）
• 支持通过自定义表单添加额外claims
• 可选启用OTP-based双因素认证（需提供OTP_SECRET环境变量）
• 忽略密码验证（专注于认证流程测试而非密码安全）
• 用户名中可省略@citizensadvice.org.uk域名（与Okta行为一致）

使用场景

• 开发阶段：在本地环境测试应用的认证逻辑，无需连接真实Okta服务
• 集成测试：模拟Okta认证流程，确保应用与认证服务的集成正确性
• 演示环境：快速搭建带认证功能的演示应用，无需配置真实Okta账户

配置说明

部署示例

构建镜像

bash
docker build -t citizensadvice/mokta .

启动服务

方式一：使用docker-compose

bash
docker-compose up

方式二：自定义表单启动

bash
docker-compose run -p 4001:4001 -v /path/to/custom/form:/app/form app

启动后访问：http://localhost:4001/embed_uri

示例docker-compose.yml

yaml
version: "3"

services:
  app:
    build: .
    links:
      - okta:okta.test

  okta:
    image: citizensadvice/mokta
    ports: 4001:4001
    volumes: ./fixtures/okta:/app/data
    env_file: ./default.env

测试

bash
docker-compose run --rm app bundle exec rspec