Skip to main content

XProtect Management Client

外部 IDP

最後更新日期: 閱讀時間 8 分鐘
版本2026 R2
語言中文(繁體)

XProtect 支援与OpenID Connect (OIDC)相容的外部IDP。

使用者验证

如果已设定外部IDP, XProtect 用户端支援使用外部IDP作为额外验证选项。

当用户端登入画面中的电脑位址指向 XProtect VMS 使用外部 IDP 若已设定,将触发API呼叫,并显示外部的验证选项 IDP 将在登入画面上可用。只要启动客户端并更改地址,就会激活API调用。

客户端查询的特定API是不需要任何用户身份验证的公共API,因此客户端始终可以读取此信息。

要求

要求是用户或应用程序等实体对自己的声明。

此要求由要求名称和要求值组成。例如,要求名称可以是描述要求值内容的标准名称,要求值可以是组的名称。查看外部IDP声明的更多示例: 来自外部IDP的请求示例.

索赔不是强制性的。但是,为了将外部IDP用户自动链接到中的角色,需要这些权限 XProtect VMS用于确定用户的权限。这些要求包含在来自外部IDP的用户ID令牌中,并通过与角色的关联来确定用户的权限 XProtect.

如果索赔与 XProtect 未向外部IDP用户提供VMS角色,外部IDP用户可以在 XProtect 视讯管理软体首次登入时。在这种情况下,外部IDP用户未链接到任何角色。此 XProtect VMS管理员必须手动将使用者新增到角色中。

外部IDP的必要条件

在视讯管理软体中设定之前,应在外部IDP中完成以下步骤。

  • 与搭配使用的用户端ID和密码 XProtect VMS 必须已在外部建立 IDP. 如需更多資訊,請參閱外部IDP用户的唯一用户名。

  • 必须知道外部IDP的身份验证授权机构。有关详细信息,请参阅“选项”对话框中有关外部IDP身份验证授权机构的信息。

  • 将URI重新导向至 XProtect VMS 必须已经在中设定 IDP. 有关详细信息,请参阅为Web客户端添加重定向URI。

  • 或者,必须为IDP中的用户或组配置与视频管理软件相关的要求。

  • 此 XProtect VMS 必须使用凭证完整设定,以确保所有通讯都是透过加密的https完成。否则,大多数外部IDP将不会接受来自下列装置的要求 XProtect VMS 及其用户端,或部分通讯流程与安全性权杖交换将会失败。

  • 这对于下列项目来说必须是可能的 XProtect VMS 以及所有应使用外部 IDP 以联络外部 IDP的登入位址

让使用者登入 XProtect VMS 从外部 IDP

  • 从外部 IDP,建立使用者并建立要求以将使用者识别为外部 IDP 使用者 XProtect VMS. 创建索赔不是必需的步骤,但您可以通过此步骤自动将用户链接至职责。如需更多資訊,請參閱要求。

  • 从 XProtect VMS,建立启用下列功能的设定 Identity Provider,内置于视讯管理软体中,用于与外部 IDP. 有关如何为外部IDP创建配置的详细信息,请参阅 新增并设定外部IDP.

  • 从 XProtect VMS,通过将用户请求从外部IDP映射到以下位置来建立用户身份验证 XProtect 角色. 有关如何将声明映射到角色的详细信息,请参阅 将外部IDP中的要求映射到角色 XProtect.

  • 登入至 XProtect 使用外部IDP进行用户身份验证的客户端,请参阅 通过外部IDP登录.

重新导向URI

重新导向URI指定使用者在验证成功后要前往的页面。在您的外部IDP中,必须添加管理服务器的地址,然后添加您定义的回拨路径 XProtect Management Client. 例如, https://management-server-computer.company.com/idp/signin-oidc

视执行方式而定 XProtect 如何访问VMS,如何配置网络、服务器和MicrosoftActive Directory,可能需要几个重定向URI,您可以看到下面的一些示例:

範例:

管理伺服器(包含或不包含URL中的网域):

  • “https://[server_name]/idp/signin-oidc”

  • “https://[server_name].[domain_name]/idp/signin-oidc”

包含或不包含URL中网域的行动装置伺服器:

  • “https://[server_name]:[mobile_port]/idp/signin-oidc”

  • “https://[server_name].[domain_name]:[mobile_port]/idp/signin-oidc”

如果行动伺服器设定为可透过网际网路存取,您还必须新增公用位址和连接埠。

外部IDP用户的唯一用户名

系统会自动为登入的使用者建立使用者名称 Milestone XProtect 通过外部IDP。

外部IDP提供一组声明,用于自动为用户创建名称 XProtect,且在 XProtect 一种算法用于从外部IDP中选择在VMS数据库中唯一的名称。

来自外部IDP的请求示例

这些要求由要求名称和要求值组成。範例:

要求名稱

要求值

名稱

拉兹·凡

電子郵件

123@domain.com

amr

pwd

idp

00o2ghkgazggi9BIE5d7

preferred_username

321@domain.com

vmsRole

操作員

语言环境

zh-TW

given_name

Raz

family_name

林德贝格

zoneinfo

美洲/洛杉矶

电子邮件_已验证

True

使用要求的序号建立使用者名称 XProtect

在 XProtect,在中建立使用者时的搜寻优先权 XProtect VMS由下表中的索赔序号控制。第一个可用的要求名称将用于 XProtect VMS:

要求名稱

序号

說明

使用者名称要求类型

1

已使用一个要求配置映射以定义用户名。此要求定义于 用于建立使用者名称的要求 上的栏位 外部 IDP 索引标签下 工具 > 選項.

preferred_username

2

要求可以来自外部IDP。Oidc (OpenID Connect)中通常用于此目的的标准要求。

名稱

3

given_name family_name

4

名字和姓氏的组合,如鲍勃·约翰逊。

電子郵件

5

第一个可用要求+ #(第一个可用编号)

6

例如Bob#1

定义特定要求以创建用户名 XProtect

此 XProtect 管理员可以从外部定义特定要求 IDP 该使用者名称应用于 XProtect VMS. 当管理员定义要用于建立使用者名称的要求 XProtect VMS,要求名称的写入必须与来自外部的要求名称完全一致 IDP.

  • 用于使用者名称的要求可在“工具”>“选项”下的“外部IDP”标签上的“用于建立使用者名称”栏位中定义。

删除外部IDP用户

使用者建立于 XProtect 外部IDP登录的删除方式与基本用户相同,用户可在创建用户后随时删除。

如果使用者已删除于 XProtect 当使用者从外部IDP再次登入时,将建立新使用者 XProtect. 但是,与使用者相关联的资料在 XProtect 例如私人检视和角色已遗失,且必须在中再次为使用者建立此资讯 XProtect.

如果外部IDP已删除 Management Client,任何通过外部IDP连接到VMS的用户也将被删除。