Files
sso/scripts/seed-data.sh
T
ssw c8a02b8c49 feat: 从网关项目剥离为独立 SSO 统一认证服务
定位:身份层(IdP + IAP),不含动态域名转发 / LLM 上游代理 / 用量计费。

代码(source/rust,nginx 动态模块 + Rust,单进程零外部依赖)
- IdP:authorization_code(含 PKCE)/ refresh_token / client_credentials / password
  四种 grant,含 discovery / introspect / userinfo / jwks 占位
- IAP:access 阶段门禁,注入 X-Auth-* 到后端,客户端伪造同名头被覆盖
- MaxKey 互通:/oauth/v20/* 与 /oauth2.0/* 别名 + context-path 归一化 + 扁平字段
- 管理接口:账号(含角色/部门/用户组)与 OAuth 接入方注册表,热写穿共享内存
- 模块改名 ngx_http_sso_module,指令 sso_state / sso_data_dir / sso_api / sso_iap,
  Cookie sso_sid(终端用户)与 sso_admin_session(管理员)两套身份两套会话

配置(source/conf)
- nginx.conf 生产模板(TLS、IAP 子域、含 auth_sub 的日志格式)
- nginx.test.conf 本机验证配置(明文 18095-18099)
- tls/README.md 证书约定与公钥比对校验

前端(source/www/admin.html)
- 三 tab:账号管理 / 接入方 / 接入指南;去掉审核队列、域名、LLM 上游、用量统计

测试与脚本
- tests/ 三套端到端:协议基线 14 项 · MaxKey 互通与接入 24 项 · 管理接口 31 项,全绿
- tests/demo-system 演示业务系统(Python 标准库),覆盖应用自建客户端与 IAP 零改造两种姿势
- scripts/run-local-e2e.sh 本机一键起停;scripts/seed-data.sh 物化运行时数据目录

文档
- README.md 概览与快速开始;CLAUDE.md 硬约定与排障速查
- docs/design.md 完整设计;docs/roadmap.md 待执行任务(v2 RS256+JWKS、用户管理界面)
2026-09-12 21:42:06 +08:00

153 lines
5.8 KiB
Bash
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#!/usr/bin/env bash
# ============================================================================
# 物化运行时数据目录:source/data-seed/ -> source/data/
#
# 为什么需要这一步
# source/data/ 是**运行时**目录(可写、含真实口令散列),不进版本库;
# source/data-seed/ 是**种子模板**(只放演示客户端与示例账号),进版本库。
# 本脚本把两者接起来,并顺便把示例里的占位符换成真实值。
#
# 做的事:
# 1. source/data/oauth_clients.json <- source/data-seed/oauth_clients.json
# 2. source/data/users.json <- 由本脚本生成(admin / alice 两个账号)
# 3. source/data/users.json.example <- 同步一份示例(占位符,不含真实散列)
#
# 幂等:users.json 已存在时**默认不动**(避免覆盖你手工改过的账号),要重建加 --force。
#
# 用法:
# bash scripts/seed-data.sh # 缺什么补什么
# bash scripts/seed-data.sh --force # 重建 users.json(会丢已有账号)
# DATA_DIR=/path ADMIN_PASSWORD=xxx bash scripts/seed-data.sh
#
# 口令来源:ADMIN_PASSWORD(默认 123456)、ALICE_PASSWORD(默认 alice123)。
# 这两个默认值只用于**本机/CI 演示**,生产部署必须覆盖。
# ============================================================================
set -euo pipefail
HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
ROOT="$(cd "$HERE/.." && pwd)"
SEED_DIR="${SEED_DIR:-$ROOT/source/data-seed}"
DATA_DIR="${DATA_DIR:-$ROOT/source/data}"
ADMIN_PASSWORD="${ADMIN_PASSWORD:-123456}"
ALICE_PASSWORD="${ALICE_PASSWORD:-alice123}"
FORCE=0
for a in "$@"; do [ "$a" = "--force" ] && FORCE=1; done
PYTHON="${PYTHON:-python3}"
[ -d "$SEED_DIR" ] || { echo "!! 种子目录缺失:$SEED_DIR" >&2; exit 1; }
mkdir -p "$DATA_DIR"
# ---------------------------------------------------------------------------
# 1. OAuth 接入方注册表:直接拷贝(没有则视为空表)
# ---------------------------------------------------------------------------
if [ -f "$SEED_DIR/oauth_clients.json" ]; then
if [ ! -f "$DATA_DIR/oauth_clients.json" ] || [ "$FORCE" = "1" ]; then
cp "$SEED_DIR/oauth_clients.json" "$DATA_DIR/oauth_clients.json"
echo " [seed] oauth_clients.json 已写入 $DATA_DIR/oauth_clients.json"
else
echo " [seed] oauth_clients.json 已存在,跳过"
fi
else
echo " [seed] 警告:$SEED_DIR/oauth_clients.json 不存在,注册表留空"
fi
# ---------------------------------------------------------------------------
# 2. 账号表:生成真实散列。
#
# ⚠️ 散列算法必须与 source/rust/src/util.rs::hash_password 逐位一致,
# 否则生成的账号永远登录不上:
# x = sha256("salt:password") ← 注意中间是冒号
# 重复 HASH_ROUNDS(=1000,见 config.rs) 次:x = sha256(x + salt)
# 改了拼接顺序或轮数,存量 users.json 会全部失效。
# ---------------------------------------------------------------------------
if [ -f "$DATA_DIR/users.json" ] && [ "$FORCE" != "1" ]; then
echo " [seed] users.json 已存在,跳过(要重建加 --force)"
else
ADMIN_PASSWORD="$ADMIN_PASSWORD" ALICE_PASSWORD="$ALICE_PASSWORD" \
OUT="$DATA_DIR/users.json" USERS_EXAMPLE="$SEED_DIR/users.json.example" \
"$PYTHON" - <<'PYEOF'
import hashlib, json, os, secrets
HASH_ROUNDS = 1000 # 必须与 source/rust/src/config.rs 的 HASH_ROUNDS 一致
def pwd_hash(salt, password):
x = hashlib.sha256(("%s:%s" % (salt, password)).encode()).hexdigest()
for _ in range(HASH_ROUNDS):
x = hashlib.sha256((x + salt).encode()).hexdigest()
return x
def entry(username, display_name, password, role, email, department, groups,
api_key, created_at=1768000000):
salt = secrets.token_hex(16) # 32 位 hex
return {
"username": username,
"display_name": display_name,
"role": role,
"salt": salt,
"pwd_hash": pwd_hash(salt, password),
"api_key": api_key,
"email": email,
"department": department,
"groups": groups,
"created_at": created_at,
}
users = {
"admin": entry(
"admin", "管理员", os.environ["ADMIN_PASSWORD"], "admin",
"[email protected]", "平台", ["admin"],
"sk_" + secrets.token_hex(20),
),
"alice": entry(
"alice", "爱丽丝", os.environ["ALICE_PASSWORD"], "user",
"[email protected]", "研发部", ["rd", "eng"],
"sk_" + secrets.token_hex(20),
),
}
out = os.environ["OUT"]
with open(out, "w", encoding="utf-8") as f:
json.dump(users, f, ensure_ascii=False, indent=2)
f.write("\n")
# 同步一份「占位符版」示例回种子目录,让后来人一眼看懂字段含义
HASH_NOTE = "sha256('<salt>:<password>') 后迭代 1000 轮 sha256(x + salt)"
example = {
"admin": {
"username": "admin",
"display_name": "管理员",
"role": "admin",
"salt": "<openssl rand -hex 16>",
"pwd_hash": "<%s>" % HASH_NOTE,
"api_key": "sk_<随机>",
"email": "[email protected]",
"department": "平台",
"groups": ["admin"],
"created_at": 0,
},
"alice": {
"username": "alice",
"display_name": "爱丽丝",
"role": "user",
"salt": "<openssl rand -hex 16>",
"pwd_hash": "<%s>" % HASH_NOTE,
"api_key": "sk_<随机>",
"email": "[email protected]",
"department": "研发部",
"groups": ["rd", "eng"],
"created_at": 0,
},
}
with open(os.environ["USERS_EXAMPLE"], "w", encoding="utf-8") as f:
json.dump(example, f, ensure_ascii=False, indent=2)
f.write("\n")
print(" [seed] users.json 已生成 %s(admin + alice)" % out)
PYEOF
fi
echo " [seed] 数据目录就绪:$DATA_DIR"