Skip to main content

添加一个入令令牌适配器

令牌认证允许用户通过电子邮件发送一次性令牌进行身份验证。你可以设置令牌认证，通过密码或SAML服务提供商适配器来保护，从而将该令牌作为多因素认证的方法。

配置无人机设置

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

字段

描述

别名

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

已启用

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

类型

令 牌

使用外接适配器

选择用于向外部服务进行出站认证的认证适配器。如果没有选择，默认的出站适配器将被使用。

调试启用

该开关决定是否将调试语句写入日志以进行故障排除。

CSS 网址

输入你想用来为登录页面样式设计的任何CSS的URL。

标志网址

输入你希望出现在登录页面上的任何标志的URL。

用户名提示文本

输入你希望显示的文本，用户应在输入用户名的位置。默认情况下，这个页面会显示“用户名”。

提交按钮文本

输入你希望显示在用户提交用户名的按钮上的文本。默认情况下，这个页面会显示“提交”。

帮助文本

请在登录详情下方输入你想显示的任意文字。这可以是帮助文本、一般信息，或者你想要的其他任何内容。本文为可选内容。字符数限制为1000个。

学习网址

这个字段应该会自动填充您 Blackboard 系统的 URL。

允许的机构角色

从下拉列表中选择允许使用该认证方法的角色。你可以选择多个角色。如果你把这个字段留空，所有角色都能用这种方法认证。

来自地址

这就是令牌邮件似乎来自的地址。如果您想定制该地址，请提交工单。

主题

请输入令牌邮件的主题行。

电子邮件模板

为发送给用户的令牌邮件正文撰写模板。以下令牌可用于邮件：

  • ${token}

  • ${username}

  • ${email}

  • ${givenName}

  • ${familyName}

  • ${requestId}

确保你包含${token}，这样用户才能收到允许他们登录的代币。

代币存续期

输入该代币有效期的分钟数，必须重新生成一个代币。

安全性：无（仅当你想使用令牌认证时使用）

无需选择其他参数。

安全性：密码（当你想在密码认证中添加令牌认证时使用）

允许的最大登录次数

输入用户在指定时间内允许的最大登录尝试次数。留空或输入0即可无限制。

登录超时失败

输入登录尝试被追踪的分钟数;默认是五。

加密码

输入传输中加密密码值的代码。这些代码应由你的实施顾问提供;如果您没有，请提交工单。

邮件 属性 1

输入将用于选择令牌发送邮箱地址的邮箱属性。（邮件属性取自Learn ReST用户API。）如果该字段留空，默认为 contact.email。

邮件 Property 2

如果你在这里输入第二个电子邮件属性，用户可以选择想发送令牌到哪一个邮箱地址。该字段可以留空;没有默认值。

安全性：服务提供者（用于在UAS中已配置的入站SAML服务提供者添加令牌认证）

服务

选择你想使用的配置入站SAML服务提供商。

生成元数据

选择创建一个文件，用于为现有的身份提供者认证添加多因素认证。

邮件 属性 1

输入将用于选择令牌发送邮箱地址的邮箱属性。（邮件属性取自Learn ReST用户API。）如果该字段留空，默认为 contact.email。

邮件 Property 2

如果你在这里输入第二个邮箱属性，用户可以选择将令牌发送到两个邮箱中的哪个。该字段可以留空;没有默认值。

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

配置适配器的URL是https://{region}.扩展.blackboard.com/api/v2/authadapters/sites/{siteId}/auth/{alias}。