跳到主要内容

配置登录与组织初始化

概述

本文面向私有化部署的管理员,介绍部署完成后如何让用户登录 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 应用

  1. BI 管理员进入「管理中心 > 通用配置」,将 BI 访问地址设置为实际地址,例如 https://bi.example.com。

  2. 进入「管理中心 > 系统设置 > 登录设置 > 管理后台授权」,获取动态授权码。访问实际 BI 地址下的 /system-backend,使用授权码登录。

  3. 进入「OIDC 应用管理」,点击「新建应用」,填写以下内容。

    配置项说明
    「应用编号」「应用名称」使用便于识别的名称,例如 decidex。
    「回调地址」填写实际 DecideX 地址加 /api/auth/galaxy/oidc/callback,例如 https://decidex.example.com/api/auth/galaxy/oidc/callback。后续需与 DecideX 页面生成的地址核对。
    「令牌有效期」无特殊要求时留空。
    「登出回调」「后端登出通知」基础登录配置可留空;需要登出联动时另行配置。
  4. 保存应用,记录 Client ID 和对应的 Client Secret。Client Secret 仅显示一次,后续配置 DecideX 时需要使用。

配置 DecideX 访问地址

  1. 使用平台管理员账号登录 DecideX,点击左下角个人头像,进入「设置 > 平台管理 > 访问与登录」。

  2. 在「Decidex 外部访问地址」中填写用户实际访问的根地址,例如 https://decidex.example.com。地址不能包含子路径、查询参数或锚点。

  3. 根据实际使用的协议设置以下选项,点击「保存修改」。配置保存后立即生效,无需重启。

    使用场景配置方式
    用户通过 HTTP 访问 DecideX开启「允许通过 HTTP 登录」。
    BI OIDC 服务使用 HTTP开启「允许通过 HTTP 连接 OIDC 服务」。
    对应服务使用 HTTPS对应的 HTTP 选项保持关闭。

测试并启用 Galaxy 登录

  1. 进入「设置 > 平台管理 > Galaxy 登录」,填写连接配置。

    配置项说明
    「Issuer 地址」填写实际 BI 地址加 /backend,例如 https://bi.example.com/backend。
    「Client ID」填写上一步创建的 BI OIDC 应用的 Client ID。
    「客户端密钥」填写该 Client ID 对应的 Client Secret。
    「Scope」填写 openid profile email,其中必须包含 openid。
  2. 复制页面「在上游登记此回调地址」显示的地址,与 BI OIDC 应用中的「回调地址」逐字核对,确保协议、域名、端口和路径一致。「高级设置」中的「覆盖回调地址(可选)」通常留空,使用页面生成的地址。

  3. 点击「保存并测试」,按页面引导前往 BI 完成登录授权,返回 DecideX 查看测试结果。测试期间保留当前平台管理员登录状态。

  4. 测试通过后,点击「开启登录」,确认「当前登录」显示「已开启」。修改已有配置时,测试通过后点击「应用到登录」。此操作无需重启服务。

注意

「仅保存草稿」不会启用登录,测试通过也不会自动启用。测试用于验证连接,不会创建客户组织和成员;完成启用后,还需按下一节进行一次正式 BI 登录。

首次登录并关联组织

  1. 退出当前平台管理员账号,进入 DecideX 登录页,例如 https://decidex.example.com/login。
  2. 点击「观远 BI」,使用客户 BI 管理员账号完成登录授权。
  3. 正常返回 DecideX 后,检查所属组织和成员身份。系统按 BI 返回的 Domain 创建或关联组织,并建立当前用户的成员关系,无需为该 BI Domain 另外手工开通本地组织。

组织角色由 BI 返回的身份决定:BI 管理员或超级管理员对应组织拥有者,其他用户对应成员;不是由“谁先登录”决定。后续同一 Domain 的用户通过 BI 登录时,会关联到同一组织。

维护登录配置

  • 调整连接:修改配置后重新点击「保存并测试」,测试通过后点击「应用到登录」。草稿不会直接替换正在使用的配置;「客户端密钥」留空时保留已保存的密钥。
  • 关闭登录:点击「关闭登录」后,将阻止新的 BI 登录及尚未完成的登录回调,已有会话和 BI 连接不受影响。平台管理员仍可使用独立的 /platform-login 入口维护配置。

为本地账号开通组织

此流程适用于采用本地账号登录的实例,由平台管理员指定初始组织拥有者。

  1. 使用平台管理员账号进入「设置 > 平台管理 > 组织管理」,点击「开通组织」。

  2. 在「开通客户组织」窗口填写以下信息。

    配置项说明
    「组织名称」必填,填写客户或团队名称。
    「组织拥有者邮箱」必填,填写初始组织拥有者的邮箱,不能使用平台管理员账号。
    「组织拥有者名称」选填,用于识别组织拥有者。
    「初始密码」必填,至少 8 个字符。若该邮箱已有可用的本地密码,系统保留原密码,不会被此处填写的密码覆盖。
  3. 点击「开通组织」,确认组织创建成功。

  4. 由指定的拥有者使用本地账号登录,确认可以进入该组织,再按需 添加和管理组织成员。新账号使用设置的初始密码,已有本地账号使用原密码。

验证与后续配置

完成对应流程后,确认平台管理员可以进入管理页面,业务用户可以通过所选方式登录并进入正确组织,再完成业务使用所需的配置。

检查项操作与预期结果
登录与组织BI 模式下,分别使用 BI 管理员和普通成员账号登录,核对组织及角色;本地模式下,使用指定拥有者账号登录,核对组织及管理权限。
模型可用由平台管理员 接入并测试模型,启用模型并设置默认模型后,由业务用户发起一次对话,确认能正常回答。
文件处理上传一个小文件,请智能体读取内容并生成可下载文件,确认处理和下载正常。
BI 数据访问需要使用 BI 数据时,由组织拥有者继续 配置组织 BI 环境,再由成员按各自在 BI 中的权限访问资源。

OIDC 应用凭证用于登录认证,系统集成中的 BI 应用凭证用于访问 BI 数据,两者需要分别配置。完成 BI 登录不会自动完成组织 BI 数据连接,也不会为成员创建个人 BI 连接。