配置登录与组织初始化
概述
本文面向私有化部署的管理员,介绍部署完成后如何让用户登录 DecideX 并进入所属组织。根据部署采用的登录模式,完成以下一条流程:
- 观远 BI 单点登录:配置 Galaxy OIDC,测试并启用后,由用户从登录页通过「观远 BI」登录。DecideX 按 BI 的 Domain 关联组织和成员。
- 本地账号登录:由平台管理员开通组织并指定初始拥有者(Owner),再由组织拥有者管理成员。
以下平台配置操作需要平台管理员权限,组织拥有者权限不能替代平台管理员权限。私有化部署时初始化的平台管理员账号不会自动创建组织,仍需按所采用的登录模式完成组织初始化。
前提条件
- DecideX 已完成部署,并已初始化本地平台管理员账号。可通过实际 DecideX 地址下的
/platform-login登录,例如https://decidex.example.com/platform-login。 - 已确认用户实际访问的 DecideX 地址;使用 BI 单点登录时,还需确认 BI 地址,并由 BI 管理员配置 OIDC 应用。
- 使用 BI 单点登录的实例需采用 Galaxy 部署模式,且 BI 环境支持 OIDC。若未显示「Galaxy 登录」页签,请联系部署管理员确认。登录模式由部署配置决定,不能仅通过开通组织来切换。
下文中的 https://decidex.example.com 和 https://bi.example.com 均为示例,请替换为实际地址。
配置观远 BI 单点登录
创建 BI OIDC 应用
-
BI 管理员进入「管理中心 > 通用配置」,将 BI 访问地址设置为实际地址,例如
https://bi.example.com。 -
进入「管理中心 > 系统设置 > 登录设置 > 管理后台授权」,获取动态授权码。访问实际 BI 地址下的
/system-backend,使用授权码登录。 -
进入「OIDC 应用管理」,点击「新建应用」,填写以下内容。
配置项 说明 「应用编号」「应用名称」 使用便于识别的名称,例如 decidex。「回调地址」 填写实际 DecideX 地址加 /api/auth/galaxy/oidc/callback,例如https://decidex.example.com/api/auth/galaxy/oidc/callback。后续需与 DecideX 页面生成的地址核对。「令牌有效期」 无特殊要求时留空。 「登出回调」「后端登出通知」 基础登录配置可留空;需要登出联动时另行配置。 -
保存应用,记录 Client ID 和对应的 Client Secret。Client Secret 仅显示一次,后续配置 DecideX 时需要使用。
配置 DecideX 访问地址
-
使用平台管理员账号登录 DecideX,点击左下角个人头像,进入「设置 > 平台管理 > 访问与登录」。
-
在「Decidex 外部访问地址」中填写用户实际访问的根地址,例如
https://decidex.example.com。地址不能包含子路径、查询参数或锚点。 -
根据实际使用的协议设置以下选项,点击「保存修改」。配置保存后立即生效,无需重启。
使用场景 配置方式 用户通过 HTTP 访问 DecideX 开启「允许通过 HTTP 登录」。 BI OIDC 服务使用 HTTP 开启「允许通过 HTTP 连接 OIDC 服务」。 对应服务使用 HTTPS 对应的 HTTP 选项保持关闭。
测试并启用 Galaxy 登录
-
进入「设置 > 平台管理 > Galaxy 登录」,填写连接配置。
配置项 说明 「Issuer 地址」 填写实际 BI 地址加 /backend,例如https://bi.example.com/backend。「Client ID」 填写上一步创建的 BI OIDC 应用的 Client ID。 「客户端密钥」 填写该 Client ID 对应的 Client Secret。 「Scope」 填写 openid profile email,其中必须包含openid。 -
复制页面「在上游登记此回调地址」显示的地址,与 BI OIDC 应用中的「回调地址」逐字核对,确保协议、域名、端口和路径一致。「高级设置」中的「覆盖回调地址(可选)」通常留空,使用页面生成的地址。
-
点击「保存并测试」,按页面引导前往 BI 完成登录授权,返回 DecideX 查看测试结果。测试期间保留当前平台管理员登录状态。
-
测试通过后,点击「开启登录」,确认「当前登录」显示「已开启」。修改已有配置时,测试通过后点击「应用到登录」。此操作无需重启服务。
「仅保存草稿」不会启用登录,测试通过也不会自动启用。测试用于验证连接,不会创建客户组织和成员;完成启用后,还需按下一节进行一次正式 BI 登录。
首次登录并关联组织
- 退出当前平台管理员账号,进入 DecideX 登录页,例如
https://decidex.example.com/login。 - 点击「观远 BI」,使用客户 BI 管理员账号完成登录授权。
- 正常返回 DecideX 后,检查所属组织和成员身份。系统按 BI 返回的 Domain 创建或关联组织,并建立当前用户的成员关系,无需为该 BI Domain 另外手工开通本地组织。
组织角色由 BI 返回的身份决定:BI 管理员或超级管理员对应组织拥有者,其他用户对应成员;不是由“谁先登录”决定。后续同一 Domain 的用户通过 BI 登录时,会关联到同一组织。
维护登录配置
- 调整连接:修改配置后重新点击「保存并测试」,测试通过后点击「应用到登录」。草稿不会直接替换正在使用的配置;「客户端密钥」留空时保留已保存的密钥。
- 关闭登录:点击「关闭登录」后,将阻止新的 BI 登录及尚未完成的登录回调,已有会话和 BI 连接不受影响。平台管理员仍可使用独立的
/platform-login入口维护配置。
为本地账号开通组织
此流程适用于采用本地账号登录的实例,由平台管理员指定初始组织拥有者。
-
使用平台管理员账号进入「设置 > 平台管理 > 组织管理」,点击「开通组织」。
-
在「开通客户组织」窗口填写以下信息。
配置项 说明 「组织名称」 必填,填写客户或团队名称。 「组织拥有者邮箱」 必填,填写初始组织拥有者的邮箱,不能使用平台管理员账号。 「组织拥有者名称」 选填,用于识别组织拥有者。 「初始密码」 必填,至少 8 个字符。若该邮箱已有可用的本地密码,系统保留原密码,不会被此处填写的密码覆盖。 -
点击「开通组织」,确认组织创建成功。
-
由指定的拥有者使用本地账号登录,确认可以进入该组织,再按需 添加和管理组织成员。新账号使用设置的初始密码,已有本地账号使用原密码。
验证与后续配置
完成对应流程后,确认平台管理员可以进入管理页面,业务用户可以通过所选方式登录并进入正确组织,再完成业务使用所需的配置。
| 检查项 | 操作与预期结果 |
|---|---|
| 登录与组织 | BI 模式下,分别使用 BI 管理员和普通成员账号登录,核对组织及角色;本地模式下,使用指定拥有者账号登录,核对组织及管理权限。 |
| 模型可用 | 由平台管理员 接入并测试模型,启用模型并设置默认模型后,由业务用户发起一次对话,确认能正常回答。 |
| 文件处理 | 上传一个小文件,请智能体读取内容并生成可下载文件,确认处理和下载正常。 |
| BI 数据访问 | 需要使用 BI 数据时,由组织拥有者继续 配置组织 BI 环境,再由成员按各自在 BI 中的权限访问资源。 |
OIDC 应用凭证用于登录认证,系统集成中的 BI 应用凭证用于访问 BI 数据,两者需要分别配置。完成 BI 登录不会自动完成组织 BI 数据连接,也不会为成员创建个人 BI 连接。