SDD-006：复用公网域名填写认证入口

字段	内容
版本 / 级别	0.1 / S2
设计状态	已确定
实现状态	已实现，前端构建通过；线上交互待验证
日期	2026-10-22
关联需求	创建 OpenVPN OIDC 专线时自动引用已有 HTTPS 公网域名

1. 背景、目标与范围

OpenVPNOIDCGuide.vue 当前要求手填 oidc_base_url，已有 GET /api/tunnels/openvpn/oidc-readiness 返回 management_domain 和 https_management_ready。减少重复输入：仅在 HTTPS 已就绪、创建专线且字段为空时填入 https://<management_domain>；编辑既有专线及管理员手动地址不覆盖。此变更不提供 OIDC issuer，也不更改 Nginx 转发规则。

2. 需求与约束

FR-01：已有 HTTPS 管理入口时，创建向导自动填写认证入口根地址；编辑保持原配置。
FR-02：无有效 HTTPS 域名或旧后端不提供就绪信息时仍允许手动填写；用户手动更改后不覆盖。
NFR-01：显示清晰的状态，说明自动填写只是地址建议，现有管理 Nginx 尚未代理 OAuth2 路径，需先配置认证组件的 HTTPS 路由；不可显示为已连通。
NFR-02：发行者、Client ID/Secret 仍须来自实际 OIDC 提供方，不以管理域名推断 issuer。

3. 架构与契约

前端复用 readiness 的现有管理域名和 TLS 就绪字段，不增加服务端接口、数据字段或迁移；OIDC 配置仍存储实际字符串，不对其添加动态绑定语义。证书域名变化时已创建的专线需要管理员核对并更新回调配置。

4. 风险与验收

已签发管理证书不意味着 /oauth2/callback 已可达；页面持续显示未配置认证入口的告警，填充不代表可用。每条 OIDC 专线要求唯一入口，复用同域名仅适用于第一条；后续专线保持手动输入独立域名，已有后端冲突校验兜底。

验收	预期
新建且 HTTPS 已就绪	空地址自动填当前域名、显示“仅填写地址”的告警
编辑或已输入独立域名	不覆盖原值
无 HTTPS 或旧服务端	保持空地址并可手动编辑
发行者	不自动填写，不把管理站点误标成 OIDC issuer
检查	前端构建和后端相关单元测试通过；真实飞书/OIDC 登录仍待联调

5. 待决问题

同域认证入口的 Nginx 路由和自建身份服务均未实施。完成前不能将地址建议视为可用认证入口。

2.5 KiB Raw Blame History