Bridge an already-authenticated portal session into a YAMA web session via a new /sso endpoint, so portal administrators can enter the remote-desktop UI without a second login. Only the "admin" portal role is bridged; any other role (viewer, unknown) still falls back to the built-in login form, so a low-privileged portal account cannot bypass authentication. - wsauth: extract IssueToken from VerifyLogin so an out-of-band-authenticated identity (SSO) can mint a session token without the challenge/response. - web: add the SSODetector interface, a fail-closed JWT detector (HMAC-only), and the /sso handler gated to the admin role. - cmd: enable the JWT detector via YAMA_SSO_JWT_SECRET, the shared HS256 secret matching the parent portal. - web UI: attempt SSO before showing the login form, falling back to login when the server returns 401. - docs: document SSO (admin-only) and license trial-vs-paid troubleshooting in README and the env example. Co-Authored-By: deepseek-v4-pro
77 lines
3.2 KiB
Bash
77 lines
3.2 KiB
Bash
# ============================================================
|
||
# YAMA 服务端环境变量(完整版)
|
||
# systemd 通过 EnvironmentFile=-/etc/yama/server.env 读取
|
||
# 行首 "#" = 未启用(保持默认);去掉 "#" 即生效
|
||
# ============================================================
|
||
|
||
# ---------- 账号 / 密码 ----------
|
||
|
||
# Web 管理员账号 "admin" 的初始密码。回退链:
|
||
# YAMA_WEB_ADMIN_PASS → YAMA_PWD → 硬编码 "admin"
|
||
# 生产环境务必设置,否则会以 admin/admin 裸奔(启动日志会红色告警)
|
||
YAMA_WEB_ADMIN_PASS=ChangeMe_Strong
|
||
|
||
# 超级密码(明文)。TCP 授权用,也是上面 Web 管理员密码的回退来源
|
||
#YAMA_PWD=
|
||
|
||
# TCP 授权的密码哈希(SHA-256 十六进制)。与 YAMA_PWD 二选一;
|
||
# 未设置时用内置占位默认值(生产应覆盖)
|
||
#YAMA_PWDHASH=
|
||
|
||
# 持久化 Web 用户文件路径(默认相对工作目录的 users.json)
|
||
#YAMA_USERS_FILE=/opt/yama/users.json
|
||
|
||
# ---------- 网页端 / 反向代理 ----------
|
||
|
||
# 子路径部署前缀(方案B)。空 = 根路径(方案A);有值须与 nginx location 一致
|
||
YAMA_WEB_BASE_PATH=/remoter
|
||
|
||
# "1" = 信任反向代理的 X-Forwarded-For(nginx 在 Go 前面时务必开启,
|
||
# 否则登录限流会把所有客户端当成 nginx 同一个 IP)
|
||
YAMA_WEB_TRUST_PROXY=1
|
||
|
||
# WebSocket Origin 白名单(逗号分隔)。空 = 仅允许同源
|
||
#YAMA_WEB_ALLOWED_ORIGINS=https://你的域名
|
||
|
||
# ---------- SSO(单点登录,可选)----------
|
||
|
||
# 共享的 HS256 签名密钥。设置后启用 SSO:YAMA 校验父域名(如 FMS 网关)下发的
|
||
# auth_token JWT,通过后为门户管理员铸一枚 YAMA 会话、免二次登录。
|
||
# 取值必须与上游门户的签名密钥一致(FMS 即 SERVER_PRIVATE_KEY)。
|
||
# ⚠️ 仅 admin 角色的门户用户会被自动登录;其他角色(viewer / 未知)即使已登录
|
||
# 门户,也必须再输一遍 YAMA 自己的 Web 登录密码(/sso 返回 401 → 回退登录页)。
|
||
#YAMA_SSO_JWT_SECRET=
|
||
|
||
# ---------- 授权 / 许可(signer)----------
|
||
# 优先级:YAMA_SIGN_PASSWORD > YAMA_LICENSE_DISABLED=1 > YAMA_LICENSE_TOKEN > 匿名试用
|
||
|
||
# 本地签名主密钥(HMAC)。设置即进入 LocalSigner 模式(运营方自部署)
|
||
#YAMA_SIGN_PASSWORD=
|
||
|
||
# "1" = 关闭授权校验(NoOpSigner,离线/开发用;客户端将拒绝屏幕/文件功能)
|
||
#YAMA_LICENSE_DISABLED=1
|
||
|
||
# 许可服务器 URL(RemoteSigner 付费客户 / 试用模式的默认地址)
|
||
#YAMA_LICENSE_SERVER=
|
||
|
||
# 客户 JWT(付费客户解锁设备配额)
|
||
#YAMA_LICENSE_TOKEN=
|
||
|
||
# ⚠️ EnvironmentFile 只在服务启动时读一次:改本文件后必须 systemctl restart <服务>,
|
||
# 否则改动不生效(现象:启动日志仍是 "Signer mode: TRIAL" 而非 REMOTE)
|
||
|
||
# 缓存 TTL(小时,RemoteSigner 离线缓存,默认 24)
|
||
#YAMA_LICENSE_OFFLINE_HRS=24
|
||
|
||
# ---------- 兼做许可服务器(可选,LocalSigner-as-LS)----------
|
||
|
||
# issue-token 子命令用:RSA 私钥 PEM 路径(与公钥配对)
|
||
#YAMA_LICENSE_PRIVATE_KEY=
|
||
|
||
# 对外签发许可用:RSA 公钥 PEM 路径 + 监听地址(如 ":8443")
|
||
#YAMA_LICENSE_PUBLIC_KEY=
|
||
#YAMA_LICENSE_HTTP_ADDR=:8443
|
||
|
||
# 配额状态持久化文件路径
|
||
#YAMA_LICENSE_STATE_PATH=/opt/yama/license_state.json
|