Canvas LMS 云应用

您可以使用安全断言标记语言 (SAML) 2.0 标准为多款云应用配置单点登录 (SSO)。您设置单点登录后,用户可以使用自己的 Google Workspace 凭据通过单点登录功能登录应用。

使用 SAML 为 Canvas LMS 设置单点登录

您必须以超级用户身份登录,才能执行此任务。

第 1 步:将 Google 设置为 SAML 身份提供方

  1. 在 Google 管理控制台中,依次点击“菜单”图标 然后 应用然后Web 应用和移动应用

    您必须以超级用户身份登录,才能执行此任务。

  2. 依次点击添加应用然后搜索应用
  3. 输入应用名称部分,输入 Canvas LMS
  4. 在搜索结果中,将鼠标指向 Canvas LMS,然后点击选择
  5. Google 身份提供方详细信息窗口中,对于方法 1:下载 IdP 元数据,点击下载元数据然后继续
  6. 服务提供商详细信息页面上,编辑 ACS 网址实体 ID启动网址,将 {your-account-id} 替换为您的 Canvas LMS 账号 ID,然后点击继续
  7. (可选)如需将 Google 目录属性映射到相应的应用属性,请在属性映射窗口中执行以下操作:
    1. 点击添加映射
    2. 点击选择字段然后 选择一个 Google 目录属性。
    3. 应用属性部分,输入相应的应用属性。
  8. (可选)如需输入与此应用相关的群组名称,请执行以下操作:
    1. 对于群组成员资格(可选),点击搜索群组,输入群组名称的一个或多个字母,然后选择群组名称。
    2. 根据需要添加其他群组(最多 75 个群组)。
    3. 对于应用属性,输入服务提供商的相应群组属性名称。

    无论您输入多少个群组名称,SAML 回复都仅包含用户所属(直接或间接)的群组。如需了解详情,请参阅群组成员资格映射简介

  9. 点击完成

第 2 步:将 Google 身份提供方元数据托管到公共文件服务器上

将您在第 1 步中下载的 Google 身份提供方元数据文件托管到可公开访问的文件服务器上。该文件必须可以直接访问,而不是通过重定向才能访问。该文件还必须始终可以通过一个固定网址进行访问。每次用户登录时,Canvas LMS 都会请求获取该文件。

第 3 步:将 Canvas LMS 设置为 SAML 2.0 服务提供商

  1. 在无痕模式下打开一个浏览器窗口,前往 Canvas LMS 登录页面,然后使用您的 Canvas LMS 管理员账号登录。
  2. 点击管理,然后选择身份验证
  3. SAML 添加为身份验证服务提供商。
  4. IdP 元数据网址字段,粘贴文件服务器上托管的 Google 身份提供方元数据的网址,如第 2 步中所述。
  5. 点击保存
    剩余的字段值会根据身份提供方元数据自动填充。
  6. 对于身份格式,请选择 nameid-format:emailAddress
  7. 身份验证上下文中,选择 classes:Password
  8. 启用 Just in Time Provisioning(即时预配)。
  9. SAML 身份验证部分中,为位置选择 1
  10. 点击保存

第 4 步:为用户启用应用

准备工作:如要为特定用户启用或停用服务,请将其账号添加到某个组织部门(按部门控制访问权限)或某个访问权限群组(跨部门或在部门内控制访问权限)。
  1. 在 Google 管理控制台中,依次点击“菜单”图标 然后 应用然后Web 应用和移动应用

    您必须以超级用户身份登录,才能执行此任务。

  2. 点击 Canvas LMS
  3. 点击用户访问权限
  4. 如要为组织中所有人启用或停用某项服务,请点击对所有人启用对所有人停用,然后点击保存

  5. (可选)如要为某个组织部门启用或停用服务,请执行以下操作:
    1. 在左侧,选择所需组织部门。
    2. 如要更改服务状态,请选择启用停用
    3. 根据需要选择相应操作:
      • 如果“服务状态”被设为已继承,而您想保留更新后的设置(即使在上级组织的设置发生变化时也保留该设置),请点击覆盖
      • 如果服务状态被设为已覆盖,您可以点击继承以恢复为与上级组织相同的设置,也可以点击保存以保留新设置,而不受上级组织的设置变更所影响。
        详细了解组织结构
  6. (可选)如要为一个或多个组织部门内的一组用户启用某项服务,请选择一个访问权限群组。如需了解详情,请参阅通过访问权限群组自定义服务访问权限
  7. 确保您的 Canvas LMS 用户账号电子邮件域名与贵组织受管理的 Google 账号的主域名一致。

第 5 步:确认单点登录是否正常运行

Canvas LMS 同时支持由身份提供方发起和由服务提供商发起的单点登录。

验证由身份提供方发起的单点登录

  1. 在 Google 管理控制台中,依次点击“菜单”图标 然后 应用然后Web 应用和移动应用

    您必须以超级用户身份登录,才能执行此任务。

  2. 点击 Canvas LMS
  3. Canvas LMS 部分,点击测试 SAML 登录

    系统应该会在另一标签页中打开该应用。如果未打开,请根据错误消息排查问题,然后重试。
    如需详细了解问题排查,请参阅 SAML 应用错误消息

验证由服务提供商发起的单点登录

  1. 关闭所有浏览器窗口。
  2. 打开 https://{your-account-id}.instructure.com。系统应该会将您重定向至 Google 登录页面。
  3. 输入用户名和密码。
    您的凭据通过身份验证后,系统会将您重定向回 Canvas LMS。

如果通过 Google IdP 身份验证的用户账号在 Canvas LMS 中尚不存在,Canvas LMS 会自动为登录的用户配置一个新用户账号。


Google、Google Workspace 以及相关标志和徽标是 Google LLC 的商标。其他所有公司名和产品名是其各自相关公司的商标。