使用员工身份联合进行 Looker (Google Cloud Core) 用户身份验证

借助员工身份联合,您可以使用外部身份提供方 (IdP) 对用户和用户群组进行身份验证,以便他们能够访问 Looker (Google Cloud Core)实例。通过使用员工身份联合,贵组织中的用户可以使用单点登录 (SSO) 访问 Looker (Google Cloud Core),而无需您为每个用户预配或同步 Google 账号(Cloud Identity 或 Google Workspace 账号)。

员工身份联合支持使用 OpenID Connect (OIDC) 或 SAML 2.0 的外部 IdP,例如 Microsoft Entra ID(以前称为 Azure Active Directory)、Okta、Ping Identity 等。

Looker (Google Cloud Core) 支持在使用公共安全连接、专用连接或混合连接的实例上使用员工身份联合。

员工身份联合如何与 Looker (Google Cloud Core)搭配使用

为 Looker (Google Cloud Core) 实例配置员工身份联合时,会发生以下过程:

  1. 身份验证:用户前往您的 Looker (Google Cloud Core) 实例网址。如果绕过登录页面设置已启用,用户会自动重定向到 Google Cloud 登录门户 (https://auth.cloud.google/authorize),该门户会将用户重定向到您的外部 IdP 进行身份验证。
  2. 令牌交换:用户通过 IdP 进行身份验证后,IdP 会向 Google Cloud Security Token Service (STS) 返回身份验证断言。STS 将断言交换为联合访问令牌和 ID 令牌。
  3. 授权:Looker(Google Cloud 核心版)会验证联合主账号是否对实例具有所需的 Identity and Access Management (IAM) 权限 (looker.instances.login)。
  4. 预配和角色分配:Looker (Google Cloud Core) 会在用户首次登录时创建用户账号(即时预配),并根据从 IdP 收到的声明应用群组到角色的映射和用户属性。

准备工作

在为 Looker (Google Cloud Core)配置员工身份联合之前,请确保您具有以下角色和配置:

所需 IAM 角色

如需配置员工身份联合并创建 Looker (Google Cloud Core) 实例,您需要拥有以下角色:

必需的 API

在您的 Google Cloud 项目中启用以下 API:

第 1 步:设置员工身份池和提供方

员工身份池和提供方是在 Google Cloud组织级层(而非项目级层)创建的。

完成以下步骤,设置员工身份池和提供方:

  1. 按照配置员工身份联合文档页面上的说明创建员工身份池。
  2. 为 OIDC 或 SAML 2.0 IdP 创建员工身份池提供方:
    • 对于 OIDC 提供方,请参阅配置 OIDC 员工身份联合。
    • 对于 SAML 提供方,请参阅配置 SAML 2.0 员工身份联合。
    • 在创建提供方期间立即定义以下属性映射:
      • 邮箱:将 IdP 的邮箱声明映射到 google.email。此映射是用户识别所必需的;如果缺少此映射,身份验证将失败。
      • 名字和姓氏:将 IdP 的名字和姓氏声明映射到 attribute.given_name(名字)和 attribute.family_name(姓氏)。这些映射是填充 Looker 用户个人资料所必需的;如果缺少这些映射,身份验证将失败。
  3. (可选)您还可以配置以下属性映射:

    • 群组:将 IdP 的群组声明(例如 assertion.groups)映射到 google.groups。如果您计划启用群组镜像并将 IdP 群组映射到 Looker 角色,则必须进行此映射。对于 OIDC 提供方,如果您的 IdP 需要,请确保您的提供方配置也请求 groups 范围(如需了解特定于 IdP 的要求,请参阅配置员工身份联合)。
    • 自定义属性:将自定义 IdP 声明映射到 attribute.<attribute_name>。您可以在 Looker (Google Cloud Core)中使用这些映射的属性来参数化数据库连接并应用行级数据访问过滤条件。

配置延长会话时长和后台同步

如需支持不间断的浏览器会话、长时间运行的预定传送、用户 API 密钥访问和连接器集成,请完成以下步骤:

  1. 在员工池提供方上配置后台属性同步,以便 Google Cloud 可以在后台定期刷新用户属性和群组成员资格:
    • 对于 OIDC 提供方:配置具有 offline_access 范围的 OIDC 授权代码流程(使用刷新令牌定期刷新用户属性和群组成员资格)或 SCIM 2.0 预配。如果用户属于大量群组,且群组数量超过 OIDC 令牌大小限制,请配置 SCIM 2.0 预配,以将群组成员资格同步到 Google Cloud。
    • 对于 SAML 提供方:在员工池提供方上配置 SCIM 2.0 预配。由于 SAML 断言不原生提供刷新令牌,因此需要使用 SCIM 2.0 才能启用离线预定传送和提醒。
  2. 使用 Access Context Manager 云绑定为员工池配置延长会话时长政策,并将政策设置为 90 天(7,776,000 秒)。

    此政策将会话时长上限和刷新令牌有效期设置为 90 天。如果未配置延长会话时长政策或将其设置为较短时长,则员工池刷新令牌有效期将优先于 Looker 的会话时长设置,从而导致浏览器会话、离线时间表、用户 API 密钥和关联的应用在刷新令牌过期时需要重新进行身份验证。

第 2 步:向员工主账号授予 IAM 权限

如需允许员工用户登录 Looker (Google Cloud Core) 实例,请向员工主账号或群组授予 Looker Instance User (roles/looker.instanceUser) 或 Looker Admin (roles/looker.admin) IAM 角色。

您可以使用以下主账号标识符向单个用户、整个群组或员工池中的所有主账号授予角色:

  • 单个员工用户:

    principal://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/subject/SUBJECT_ID
    

  • 员工群组:

    principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/group/GROUP_ID
    

  • 员工池中的所有主账号:

    principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/*
    

如需详细了解如何分配 IAM 角色,请参阅使用 IAM 进行 Looker (Google Cloud Core) 访问权限控制文档页面。

第 3 步:选择员工身份联合作为主要身份验证方法

您可以在创建新的 Looker (Google Cloud Core) 实例时或通过修改现有实例,选择员工身份联合作为主要身份验证方法。

在实例创建期间

创建新的 Looker (Google Cloud Core) 实例时,您可以选择员工身份联合作为主要身份验证方法:

控制台

  1. 在 Google Cloud 控制台中,前往 Looker (Google Cloud core) 页面。

    前往 Looker (Google Cloud Core)

  2. 点击创建实例。
  3. 按照相关文档中的说明完成实例名称、区域和版本配置,以创建使用公共安全连接、Private Service Connect 连接或专用服务访问通道连接的实例。
  4. 在身份验证部分中,选择员工身份联合 (SAML/OIDC) 作为主要身份验证方法。
  5. 点击创建。

如需将 OAuth 设置为辅助身份验证方法,请在实例创建后修改实例配置。

gcloud

使用 gcloud looker instances create 命令和 --workforce-auth-enabled 标志创建将员工身份联合作为主要身份验证方法的实例:

gcloud looker instances create INSTANCE_NAME \
--project=PROJECT_ID \
--region=REGION \
--edition=EDITION \
--workforce-auth-enabled \
--async

替换以下内容:

在 Google Cloud CLI 中,如果您未指定任何身份验证标志,则默认启用 Google 身份验证。每当启用 Google 身份验证时,gcloud looker instances create 都需要 --oauth-client-id 和 --oauth-client-secret。如果您指定 --workforce-auth-enabled 而不指定 --google-auth-enabled,该命令会停用实例上的 Google 身份验证,并且您无需提供 OAuth 凭据。

如需在创建实例时还允许将 OAuth 用作辅助身份验证方法,请添加 --google-auth-enabled、--oauth-client-id 和 --oauth-client-secret 标志:

gcloud looker instances create INSTANCE_NAME \
--project=PROJECT_ID \
--region=REGION \
--edition=EDITION \
--workforce-auth-enabled \
--google-auth-enabled \
--oauth-client-id=OAUTH_CLIENT_ID \
--oauth-client-secret=OAUTH_CLIENT_SECRET \
--async

将 OAUTH_CLIENT_ID 和 OAUTH_CLIENT_SECRET 替换为 OAuth 客户端的客户端 ID 和客户端密钥。

您可以向命令添加其他标志,以应用其他实例设置(例如维护窗口和发布渠道),或配置专用网络:

修改现有实例时

如果您已有 Looker (Google Cloud Core) 实例,则可以修改实例配置,选择员工身份联合作为主要身份验证方法,或将 OAuth 设置为次要身份验证方法:

控制台

  1. 在 Google Cloud 控制台中,前往 Looker (Google Cloud core) 页面。

    前往 Looker (Google Cloud Core)

  2. 点击要修改的实例的名称。
  3. 在实例详情标签页中,点击修改。
  4. 在身份验证部分中,选择员工身份联合 (SAML/OIDC) 作为主要身份验证方法。
  5. (可选)如需允许将 OAuth 用作辅助身份验证方法,请启用启用辅助 OAuth 切换开关。
  6. 点击保存。

gcloud

使用带有 --workforce-auth-enabled 标志的 gcloud looker instances update 命令,选择员工身份联合作为主要身份验证方法:

gcloud looker instances update INSTANCE_NAME \
--project=PROJECT_ID \
--region=REGION \
--workforce-auth-enabled \
--no-google-auth-enabled \
--async

替换以下内容:

  • INSTANCE_NAME:Looker (Google Cloud Core) 实例的名称。
  • PROJECT_ID:Looker (Google Cloud Core) 实例所在的 Google Cloud 项目的 ID。
  • REGION:Looker (Google Cloud Core) 实例所在的区域。

--no-google-auth-enabled 标志会停用实例上的 Google 身份验证。如需将 OAuth 保留为辅助身份验证方法,请将 --no-google-auth-enabled 标志替换为 --google-auth-enabled 标志。如果实例还没有 OAuth 客户端,请同时添加 --oauth-client-id=OAUTH_CLIENT_ID 和 --oauth-client-secret=OAUTH_CLIENT_SECRET 标志。

第 4 步:在 Looker 中配置员工身份设置

创建 Looker (Google Cloud Core) 实例后,管理员可以在 Looker 管理控制台的员工身份验证页面中配置用户属性映射、群组镜像和登录选项。

  1. 使用具有 Admin Looker 角色的账号登录 Looker (Google Cloud Core) 实例。
  2. 在导航菜单中,依次选择管理 > 身份验证 > 员工身份。
  3. 配置以下部分中所述的设置。

如需详细了解以下设置,请参阅员工身份验证页面文档。

合并用户账号

在合并用户时使用字段中,选择当用户首次使用员工身份联合登录时,应从中合并现有用户账号的身份验证系统。

支持合并的系统包括:

  • Google
  • SAML
  • OIDC

绕过登录页面

绕过登录页面选项用于控制是否将未经身份验证的用户自动重定向到企业单点登录门户:

  • 已启用(默认):当用户导航到您的实例网址时,系统会自动将其重定向到您的 IdP 登录界面,而不会显示 Looker 登录页面。
  • 已停用:用户会看到 Looker 登录页面,并可在可用的身份验证选项之间进行选择。

点击保存配置以应用您的设置。

用户属性映射

将 IdP 断言中的声明映射到 Looker 用户属性。用户属性可用于多种用途,例如参数化数据库连接和应用行级安全过滤条件。

  • 在属性映射部分,将 Google 员工属性映射到相应的 Looker 用户属性(例如,将 attribute.department 映射到 Looker 中的 department 用户属性)。

群组和角色

您可以通过群组镜像或默认角色分配来管理用户角色:

  • 从 IdP 镜像群组:启用此设置后,Looker (Google Cloud Core) 会创建 Looker 群组,这些群组会镜像 IdP 令牌断言中传递的群组。
    • 在群组映射表中,将外部 IdP 群组名称映射到 Looker 群组,并分配适当的 Looker 角色(例如 Viewer、User 或 Developer)。
  • 默认新用户角色:如果未使用群组镜像或群组镜像与用户不匹配,请指定新用户在首次登录时获得的默认角色。
  • 默认新用户群组:如果未使用群组镜像或群组镜像与用户不匹配,请指定要分配给新用户的默认群组。

会话管理和令牌有效性

Looker (Google Cloud Core) 中的用户会话和令牌受员工身份池政策(例如延长会话时长政策)中配置的会话时长和刷新令牌有效性的约束:

  • 浏览器会话:使用永久性会话时,Looker 会话时长设置支持最长 30 天的会话。不过,如果员工身份池的刷新令牌有效期短于 Looker 中配置的会话时长,则以员工身份池的刷新令牌有效期为准。刷新令牌过期后,用户必须重新登录。我们建议您在延长会话时长政策中将刷新令牌有效期设置为 90 天。
  • 预定传送和提醒(离线作业):只要时间表所有者拥有有效的 IdP 令牌,后台作业就会运行。如果时间表或提醒创建者超过 90 天(或员工池会话政策中配置的时长)未登录实例,其离线会话会过期,并且该用户拥有的预定传送或提醒会暂停。如需恢复已暂停的时间表或提醒,所有者必须登录实例,或者管理员必须分配时间表所有权。
  • Looker OAuth 服务器和连接器:使用 Looker OAuth 服务器的集成(例如数据洞察、关联工作表和第三方连接器)使用 30 天刷新令牌(或数据洞察中永不过期的刷新令牌)。如果员工池会话时长设置为少于 90 天,则用户可能需要在会话时长到期时重新向 Looker 进行身份验证。
  • 用户 API 密钥:由用户 API 密钥生成的 API 访问令牌的有效期为 1 小时,并且需要有效的用户 IdP 会话。如果用户的 IdP 会话过期(每 90 天或根据员工池会话时长),用户必须再次登录实例才能继续使用其 API 密钥。
  • 服务账号 API 密钥:服务账号 API 访问令牌不受员工池会话政策的影响。

后续步骤