Skip to main content

添加出站SAML适配器

SAML 是一种认证标准,许多系统都使用,包括 Blackboard 用于认证登录请求。在无人机系统(UAS)中,你是在创建由身份提供者发起的SAML响应。你必须配置认证 Blackboard 适配器来接受来自无人机系统的响应。Blackboard 中的课程和 URL 转发是通过标准的 SAML RelayState 参数处理的。

SAML认证类型只能用于发出的认证响应,且你只能有一个激活的SAML配置。

配置无人机设置

在无人机设置界面,选择添加认证适配器。填写字段如下:

字段

描述

别名

这是适配器的独特名称,用于URL中。别名将以所有小写字母存储,且不应包含任何特殊的URL字符。

已启用

该开关决定适配器是否可用。

授权类型

SAML

私钥

x509私钥。这个数值只有在你创建适配器时才会显示。欲了解更多关于创建私钥的信息,请访问生成公钥和私钥

公钥

x509公钥。该密钥将通过生成的数据与SAML服务提供商共享。欲了解更多关于创建私钥的信息,请访问生成公钥和私钥

受众

这篇SAML回应的受众。推荐值是您的 Blackboard 系统基础 URL。

目标网址

在最初创建适配器时,这个URL可以是任何东西。初始配置完成后,您需要提供来自 Blackboard认证提供程序的 ACS URL(以下配置适配器过程中的第三步)。

发行

这就是你想识别无人机服务的方式。任何值都可以使用。建议的数值是UAS_SAML。

登出 POST URL

这是用户登出 Blackboard 时处理 POST 方法的 URL。此步骤是可选的。当这里输入 URL 时,用户在退出 Blackboard 后会被重定向到该网站。(大多数情况下,你只需指定重定向或 POST 网址,无需两者兼具。)

登出重定向网址

这是用户在登出 Blackboard 时被重定向到的URL。此步骤是可选的。当这里输入 URL 时,用户在退出 Blackboard 后会被重定向到该网站。(大多数情况下,你只需指定重定向或 POST 网址,无需两者兼具。)

违约

开启这个开关,将它设为默认的SAML配置。你一次只能启用一个默认选项。开启此开关将使所有其他SAML配置失效。

选择保存以保存你的配置。

配置 Blackboard 认证适配器

在开始之前,你需要复制你的网站ID。要做到这一点,请访问 Blackboard 的管理员面板。在云管理区域中选择云连接器。复制Site ID以便在后续流程中使用。

添加适配器

访问管理员面板。在集成部分中选择认证链接。选择创建提供者以创建新提供者,并选择SAML

创建提供者菜单扩展,显示CAC、CAS、外部ID认证提供商、LDAP、密码安全提供商、SAML和UserPass锁定。SAML以橙色标注。
  1. 提供描述性的姓名

  2. 设置为激活

  3. 根据系统为用户ID提供的数值,选择Username批处理 UID

  4. 选择限制此提供者仅指定的主机名,以防止链接显示在登录页面。你无法从登录页面启动认证流程并让它成功认证。

  5. 输入“localhost”以表示受限主机名

  6. 输入链接文本。这段文字没有显示在任何地方,但仍然需要。

  7. 选择保存并配置进入SAML配置。

配置适配器

  1. 确保ACS URL中有选项,并选择了你的网站。

  2. 指定实体ID的值。我们建议你把这个价值定为你的网站URL。

  3. 选择启用IdP发起的单点登录。一旦选中,这会改变你的ACS网址。复制ACS的URL值,并在UAS配置中更新SAML适配器目的URL

  4. 单一登出服务类型设置为默认。

  5. 数据源下拉菜单设置为默认。

  6. 选择合适的兼容数据源应允许使用该认证提供者。

  7. 不要选择启用JIT Provisioning

  8. 可选地,输入自定义错误提示,当用户无法通过SAML单点登录认证时,该提示会出现。

  9. 选择元数据URL以确定元数据类型。

    • URL 是 https://us.extensions.blackboard.com/api/v2/authadapters/sites/{siteId}/metadata 其中 {siteID} 位于云连接设置中(在此步骤开始时复制)。

    • 选择Verify按钮,应该会显示绿色勾选。如果你的UAS配置出现错误,请确认你已启用默认的SAML适配器并创建公钥和私钥,并确认你的URL是否正确。确保你已经按照第三步的步骤更新了Destination URL。你可以在新浏览器中测试该URL;它应该返回一个包含你元数据的XML文档。

  10. 将远程用户ID设置为NameID

  11. 选择提交以保存您的配置。