配置第三方身份

支持的国家/地区:

本指南适用于希望使用第三方身份提供方 (IdP) 在 Google SecOps 上对其员工(用户和群组)进行身份验证的 Google Security Operations 管理员。此流程可以通过利用Google Cloud 员工身份联合 来实现。

员工身份联合支持使用安全断言标记语言 (SAML 2.0) 或 OpenID Connect (OIDC) 的任何 IdP,例如 Okta、Microsoft Entra ID 和 Microsoft Active Directory Federation Services (AD FS)。

本文档介绍了通过员工身份联合使用基于 SAML 或基于 OIDC 的 IdP 设置身份验证的简要步骤:

  1. 规划所需资源。确定员工身份池和提供方详细信息,并确定配置 Google SecOps 功能访问权限所需的用户属性和群组。
  2. 配置第三方 IdP 应用。创建 IdP SAML 或 OIDC 应用,以便与员工身份联合和 Google SecOps 集成。
  3. 配置员工身份联合。配置员工身份池和提供方,并向 IdP 群组和用户授予 Google Cloud Identity and Access Management (IAM) 角色。
  4. 使用新创建的提供方配置单点登录 (SSO)。

完成这些步骤后,您可以使用身份提供方登录 Google SecOps,并使用 IAM 通过基于角色的功能访问权限控制 (RBAC) 管理用户访问权限。

常见使用场景

Google SecOps 要求在各种应用场景中使用员工身份联合作为单点登录代理。

遵守严格的安全标准

  • 目标:满足系统和云访问的严格监管标准。
  • 价值:通过安全地代理单点登录,帮助满足 FedRAMP High(或更高级别)合规要求。

管理企业访问权限控制

  • 目标:在整个组织内集中控制功能和数据访问权限。
  • 价值:通过使用 IAM,在 Google SecOps 中启用企业级 RBAC。

主要术语

  • 员工池:在组织级层定义的全局唯一 Google Cloud 资源,用于向员工授予对 Google SecOps 的访问权限。
  • 员工提供方:员工身份池的子资源,用于存储单个外部 IdP 的配置详细信息。
  • 特性映射:使用通用表达式语言 (CEL) 将 IdP 提供的断言特性转换为 Google Cloud 特性的过程。
  • 断言使用方服务 (ACS) 网址:用于配置 SAML 应用以与 Google SecOps 通信的特定网址(有时称为单点登录网址,具体取决于提供商)。
  • 实体 ID:一个全局唯一标识符网址,用于标识特定应用或服务(例如 Google SecOps),并在 IdP 中配置 SAML 应用。

过程概览

Google SecOps 支持服务提供商发起的 (SP-initiated) SAML 或 OIDC 单点登录。借助此功能,您可以直接前往 Google SecOps。Google SecOps 通过 IAM 员工身份联合向第三方 IdP 发出请求。

在 IdP 对用户身份进行身份验证后,用户会返回到 Google SecOps,并附带 SAML 身份验证断言或 OIDC ID 令牌。 Google Cloud 员工身份联合在身份验证流程中充当中介。

Google SecOps、 Google Cloud IAM 员工身份联合和 IdP 之间的通信

Google SecOps、IAM 员工身份联合和 IdP 之间的通信

概括来讲,通信过程如下:

  1. 用户进入 Google SecOps。
  2. Google SecOps 会在 Google Cloud员工身份池中查找 IdP 信息。
  3. 系统会向 IdP 发送请求。
  4. SAML 断言或 OIDC ID 令牌会发送到 Google Cloud 员工身份池。
  5. 如果身份验证成功,Google SecOps 只会收到您在员工身份池中配置员工提供方时定义的 SAML 属性或 OIDC 声明。

作为 Google SecOps 管理员,您可以在身份提供方中创建群组,配置 SAML 或 OIDC 应用以在断言或 ID 令牌中传递群组成员资格信息,并将用户和群组与 Google SecOps IAM 中的预定义角色或您创建的自定义角色相关联。

准备工作

规划实施

本部分介绍了在执行本文档中的步骤之前,您必须做出的决策和定义的信息。

定义员工身份池和员工提供方

如需通过 IdP 设置身份验证,您需要将员工身份联合配置为身份验证流程中的中介。在配置员工身份联合之前,请先定义以下Google Cloud 资源:

  • 员工池:员工身份池可向您的员工(例如员工)授予对 Google SecOps 的访问权限。
  • 员工提供方:员工身份池的子资源,用于存储有关单个 IdP 的详细信息。

员工身份池、员工提供方和 Google SecOps 实例(由单个客户子网域标识)之间的关系如下:

  • 员工身份池是在组织级层定义的。
  • 每个 Google SecOps 实例都配置了员工身份池并与之关联。
  • 一个员工身份池可以有多个员工提供方。
  • 每个员工提供方都会将第三方 IdP 与员工身份池集成。

  • 员工身份池必须专用于 Google SecOps。 您无法出于其他目的共享为 Google SecOps 创建的池。

  • 您必须将员工身份池放在包含绑定到 Google SecOps 的项目的同一Google Cloud 组织中。

以下是为员工池和员工提供方的密钥标识符定义值的准则:

  • 员工池 ID (WORKFORCE_POOL_ID):定义一个值,用于指明员工身份池的范围或用途。该值必须满足以下要求:
    • 必须是全局唯一的。
    • 只能使用小写字符 [a-z]、数字 [0-9] 和短划线 [-]。
    • 必须以小写字符 [a-z] 开头。
    • 必须以小写字符 [a-z] 或数字 [0-9] 结尾。
    • 长度在 4 到 61 个字符之间。
  • 员工池显示名 (WORKFORCE_POOL_DISPLAY_NAME):为员工身份池定义一个简单易懂的名称。
  • 员工池说明 (WORKFORCE_POOL_DESCRIPTION):定义员工身份池的详细说明。
  • 员工提供方 ID (WORKFORCE_PROVIDER_ID):定义一个值,用于指示其代表的 IdP。该值必须满足以下要求:
    • 只能使用小写字符 [a-z]、数字 [0-9] 和短划线 [-]。
    • 长度在 4 到 32 个字符之间。
  • 员工提供方显示名称 (WORKFORCE_PROVIDER_DISPLAY_NAME):为人性化的员工提供方定义一个名称。长度必须少于 32 个字符。
  • 员工提供方说明 (WORKFORCE_PROVIDER_DESCRIPTION):定义员工提供方的详细说明。

在 IdP 中定义用户属性和群组

在 IdP 中创建 SAML 或 OIDC 应用之前,请确定配置对 Google SecOps 中功能的访问权限所需的用户属性或 OIDC 声明和群组。典型的用户属性包括:

  • 主题
  • 电子邮件
  • 名字
  • 姓氏
  • 显示名称

在此过程的以下阶段,您需要有关用户群组和属性或 OIDC 声明的信息:

  • 配置 SAML 或 OIDC 应用时,您需要创建在规划期间定义的群组。您需要配置 IdP 应用,以便在 SAML 断言或 OIDC ID 令牌中传递群组成员资格。

  • 创建员工提供方时,您需要将 SAML 断言属性或 OIDC 声明和群组映射到 Google Cloud 属性。此信息会在断言或 ID 令牌中作为用户身份的一部分发送。

配置 IdP 应用

本部分仅介绍在 IdP SAML 或 OIDC 应用中与 Google Cloud员工身份联合和 Google SecOps 集成所需的特定配置。如需了解详细步骤,请参阅 IdP 文档。

在 IdP 中配置 SAML 应用

  1. 在 IdP 中创建群组(如果尚未创建)。

    最佳实践是使用群组(而非个人用户账号)来管理对 Google SecOps 实例的访问权限。Google 建议您在 IdP 中创建与默认 Google SecOps 角色直接对应的群组。

    请参阅以下示例:

    Google SecOps 角色 IdP 群组(建议)
    Chronicle API Admin chronicle_secops_admins
    Chronicle API Editor chronicle_secops_editor
    Chronicle API Viewer chronicle_secops_viewer
  2. 在 IdP 中创建新的 SAML 应用。

  3. 使用以下命令配置应用:

    1. 指定断言消费者服务 (ACS) 网址,该网址也称为单点登录网址,具体取决于服务提供商。

      https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID
      

      替换以下内容:

      • WORKFORCE_POOL_ID:您为员工身份池定义的标识符。
      • WORKFORCE_PROVIDER_ID:您为员工提供方定义的标识符。

      如需了解值说明,请参阅定义员工身份池和员工提供方。

    2. 指定以下实体 ID(也称为 SP 实体 ID)。

      https://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID
      
    3. 在 IdP 中配置名称标识符,以确保在 SAML 响应中返回 NameID 字段。

      您可以将其设置为支持贵组织政策的值,例如邮箱或用户名。如需了解如何配置此值,请参阅 IdP 文档。如需详细了解此要求,请参阅排查员工身份联合问题。

  4. 添加属性语句,以便将用户信息从 IdP 传递到 Application Integration。您在规划 IdP 实现时定义了这些属性。

    例如,您可以使用下表映射常用 IdP(如 Okta、Microsoft AD FS 或 Entra ID)中的属性:

    属性名称 Okta 值 AD FS / Entra ID(来源属性)
    subject user.email user.mail 或 user.userprincipalname
    emailaddress user.email user.mail
    first_name user.firstName user.givenname
    last_name user.lastName user.surname
    display_name user.displayName user.displayname
    groups 使用 IdP 中的群组过滤条件进行配置,例如匹配正则表达式,值为 .* 取自 IdP 中的群组映射

    如果您要配置 Okta IdP 应用,请确保在添加属性时选择未指定作为格式。如果使用 Microsoft AD FS 或 Entra ID 作为 IdP,请将命名空间留空。

  5. 在 IdP 中为应用分配适当的群组和用户。

    这些群组和用户将有权访问 Google SecOps。

  6. 下载应用元数据 XML 文件。

    在下一部分中,您将在配置员工身份提供方时使用此元数据文件。如果您使用 Google Cloud CLI,则需要使用 Cloud Shell 将此文件从本地系统上传到 Google Cloud 主目录。

在 IdP 中配置 OIDC 应用

如需在 IdP 中配置 OIDC 应用以与员工身份联合和 Google SecOps 集成,请完成以下步骤:

  1. 如果您尚未创建群组,请在 IdP 中创建。作为最佳实践,请使用群组(而非个人用户账号)来管理对 Google SecOps 实例的访问权限。

  2. 在 IdP 中创建新的 OIDC 应用,并按照创建 OIDC 员工池提供方中的 IdP 准备步骤操作。

  3. 使用以下两个重定向 URI(某些 IdP 称为回调网址或登录重定向 URI)配置应用:

    • 对于 Google SecOps 登录:

      https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID
      
    • 对于员工身份联合令牌和属性映射验证:

      https://auth.cloud.google/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID
      

    替换以下内容:

    • WORKFORCE_POOL_ID:您为员工身份池定义的标识符。
    • WORKFORCE_PROVIDER_ID:您为员工提供方定义的标识符。

    如需查看值说明,请参阅定义员工身份池和员工提供方。

  4. 在 IdP 应用中选择授权类型:推荐的授权代码流程或隐式流程。如果您使用隐式流,请确保将应用配置为返回 ID 令牌。

  5. 将 IdP 应用配置为返回 sub 声明以及您在规划 IdP 实现时确定的用户和群组声明。

    例如,使用下表映射常用 IdP(例如 Okta、Microsoft AD FS 或 Entra ID)中的声明:

    申领名称 Okta 值 AD FS / Entra ID(来源属性)
    sub user.email user.mail 或 user.userprincipalname
    email user.email user.mail
    given_name user.firstName user.givenname
    family_name user.lastName user.surname
    name user.displayName user.displayname
    groups 使用 IdP 中的群组过滤条件进行配置,例如匹配正则表达式,值为 .* 取自 IdP 中的群组映射

    如果您要配置 Okta 或 Entra ID IdP 应用,请确保已授予标准范围(例如 openid、profile 和 email)以传递这些声明。如果使用 Microsoft AD FS 或 Entra ID,请相应地配置声明映射。

    如果您的 Okta OIDC 应用使用组织授权服务器,则您在创建员工身份联合提供方时还必须将 groups 作为额外范围传递,以便 Okta 返回 groups 声明。如需了解详情,请参阅使用 Okta 配置员工身份联合。

  6. 在 IdP 中为 OIDC 应用分配适当的群组和用户。

  7. 记录 IdP 应用中的以下凭据,以便在创建 OIDC 员工身份池提供方时使用:

    • 授权代码流程:客户端 ID、颁发者 URI 和客户端密钥。
    • 隐式流:客户端 ID 和颁发者 URI。

配置员工身份联合

本部分仅介绍使用您在上一部分中创建的 IdP SAML 或 OIDC 应用配置员工身份联合所需的具体步骤。如需详细了解如何管理员工身份池,请参阅管理员工身份池提供方。

设置结算和配额项目

  1. 以对 Google SecOps 绑定项目拥有所需权限的用户身份打开 Google Cloud 控制台。您之前已识别或创建此用户。 请参阅准备工作部分。

  2. 启动 Cloud Shell 会话。

  3. 设置 Google Cloud 项目,该项目将为使用 gcloud CLI 执行的操作支付费用并扣减配额。以下面的 gcloud 命令为例:

    gcloud config set billing/quota_project PROJECT_ID
    

    将 PROJECT_ID 替换为您在为 Google SecOps 配置 Google Cloud 项目中创建的 Google SecOps 绑定项目的项目 ID。如需了解用于标识项目的字段,请参阅创建和管理项目。

    如需了解配额,请参阅以下文档:

    如果您遇到错误,请参阅排查配额错误。

创建和配置员工身份池

您可以将员工身份池配置为与外部身份提供方 (IdP) 或 Google Workspace 或 Cloud Identity 集成。

控制台

如需创建员工身份池,请执行以下操作:

  1. 在 Google Cloud 控制台中,前往员工身份池页面:

    转到“员工身份池”

  2. 为员工身份池选择组织。员工身份池可在组织中的所有项目和文件夹中使用。

  3. 点击创建池,然后执行以下操作:

    1. 在名称字段中,输入池的显示名称。池 ID 是根据您输入的名称自动派生的,并显示在名称字段下方。您可以点击池 ID 旁边的修改来更新池 ID。

    2. 可选:在说明中,输入池的说明。

  4. 点击下一步。

员工身份池的会话时长默认为 1 小时。此时长决定了 Google Cloud 访问令牌、Google Cloud 员工身份联合控制台和 gcloud CLI 登录会话的有效时长。您可以更新池,将自定义会话时长设置为 15 分钟到 12 小时之间。

gcloud

  1. 创建员工身份池。

    以下面的 gcloud 命令为例:

    gcloud iam workforce-pools create WORKFORCE_POOL_ID\
      --location="global" \
      --organization=ORGANIZATION_ID \
      --description="WORKFORCE_POOL_DESCRIPTION" \
      --display-name="WORKFORCE_POOL_DISPLAY_NAME" \
      --session-duration=SESSION_DURATION
    

    替换以下内容:

    • WORKFORCE_POOL_ID:您为员工身份池 ID 定义的值。
    • ORGANIZATION_ID:组织的数字 ID。
    • WORKFORCE_POOL_DESCRIPTION:员工身份池的可选说明。
    • WORKFORCE_POOL_DISPLAY_NAME:员工身份池的可选人性化名称。
    • SESSION_DURATION:会话时长的可选值,表示为附加了 s 的数字,例如 3600s。此时长决定了 Google Cloud访问令牌、Google Cloud 员工身份联合控制台和 gcloud CLI 登录会话的有效时长。您可以更新池,将自定义会话时长设置为 15 分钟到 12 小时之间。

    如需使用 Google Workspace 或 Cloud Identity 登录 Google SecOps,请在命令中添加 --allowed-services domain=backstory.chronicle.security 和 --disable-programmatic-signin 标志。

    gcloud iam workforce-pools create WORKFORCE_POOL_ID\
          --location="global" \
          --organization="ORGANIZATION_ID" \
          --description="WORKFORCE_POOL_DESCRIPTION" \
          --display-name="WORKFORCE_POOL_DISPLAY_NAME" \
          --session-duration=SESSION_DURATION \
          --allowed-services domain=backstory.chronicle.security \
          --disable-programmatic-signin
    

    此命令会创建一个不支持登录 Google Cloud的员工身份池。如需启用登录功能,您需要针对每种场景使用适当的标志。

  2. 如果系统提示您启用 Chronicle API,请输入 Yes。

创建员工身份池提供方

员工身份池提供方描述了Google Cloud 组织与 IdP 之间的关系。选择与您的身份验证协议匹配的部分:

创建 SAML 员工身份池提供方

控制台

如需配置员工身份池提供方,请执行以下操作:

  1. 在 Google Cloud 控制台中,前往员工身份池页面:

    转到“员工身份池”

  2. 在员工身份池表中,选择要为其创建提供方的池。

  3. 在提供方部分中,点击 添加提供方。

  4. 在选择提供方供应商中,选择您的 IdP。

    如果您的 IdP 未列出,请选择通用身份提供方。

  5. 在选择身份验证协议中,选择 SAML。

  6. 在创建提供方部分中,执行以下操作:

    1. 在名称中,输入提供方的名称。

    2. 可选:在说明中,输入提供方的说明。

    3. 在 IDP 元数据文件 (XML) 中,选择您在本指南前面部分生成的元数据 XML 文件。

    4. 确保启用提供方处于开启状态。

    5. 点击继续。

  7. 在分享提供方信息部分中,复制相应网址:

    • 在 IdP 中将第一个网址 (https://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID) 配置为实体 ID。
    • 第二个网址 (https://auth.cloud.google/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID) 用于员工身份联合令牌和映射验证(使用调试 IdP 令牌功能)。确保您的 IdP 同时包含此网址和您在在 IdP 中配置 SAML 应用中配置的 Google SecOps ACS 登录网址 (https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID)。
  8. 点击继续。

  9. 在配置提供方部分中,执行以下操作:

    1. 在属性映射中,在相应框中输入映射。例如:

      Google X(其中 X 为数字) SAML X(其中 X 是数字)
      google.subject assertion.subject
      google.groups assertion.attributes.groups
      google.display_name assertion.attributes.display_name[0]
      attribute.first_name assertion.attributes.first_name[0]
      attribute.last_name assertion.attributes.last_name[0]
      attribute.user_email assertion.attributes.emailaddress[0]

      如果您要为 Google Security Operations(包括 Google Security Operations SIEM 和 Google SecOps SOAR)执行此配置,请映射 Google SecOps SOAR 所需的以下属性:

      • attribute.first_name
      • attribute.last_name
      • attribute.user_email
      • google.groups
      • google.display_name
    2. 可选:如果您选择了 Microsoft Entra ID 作为 IdP,则可以通过执行以下操作来增加群组数量:

      1. 选择使用额外属性。
      2. 在额外属性签发方 URI 字段中,输入签发方网址。
      3. 在额外属性客户端 ID 字段中,输入客户端 ID。
      4. 在额外属性客户端密钥字段中,输入客户端密钥。
      5. 在额外属性类型列表中,选择额外属性的属性类型。
      6. 在额外属性过滤条件字段中,输入在查询 Microsoft Graph API 以获取群组时使用的过滤条件表达式。
    3. 可选:如需添加属性条件,请点击添加条件,然后输入表示属性条件的 CEL 表达式。例如,如需将 ipaddr 属性限制为特定 IP 范围,您可以设置条件 assertion.attributes.ipaddr.startsWith('98.11.12.')。 此示例条件可确保只有 IP 地址以 98.11.12. 开头的用户才能使用此员工提供方登录。

    4. 如需启用详细审计日志记录,请在详细日志记录中点击启用属性值审计日志记录切换开关。

  10. 如需创建提供方,请点击提交。

gcloud

如需配置员工身份池提供方,请执行以下操作:

  1. 点击 更多 >,将 SAML 应用元数据文件上传到 Cloud Shell 主目录。文件只能上传到主目录。如需了解在 Cloud Shell 和本地工作站之间传输文件的更多选项,请参阅从 Cloud Shell 上传和下载文件和文件夹。

  2. 记下您在 Cloud Shell 中上传 SAML 应用元数据 XML 文件的目录路径。下一步中您需要用到此路径。

  3. 创建员工身份池提供方并指定 IdP 详细信息。

    以下面的 gcloud 命令为例:

    gcloud iam workforce-pools providers create-saml WORKFORCE_PROVIDER_ID \
      --workforce-pool="WORKFORCE_POOL_ID" \
      --location="global" \
      --display-name="WORKFORCE_PROVIDER_DISPLAY_NAME" \
      --description="WORKFORCE_PROVIDER_DESCRIPTION" \
      --idp-metadata-path=PATH_TO_METADATA_XML \
      --attribute-mapping="ATTRIBUTE_MAPPINGS"
    

    如需了解值说明,请参阅规划实现。

    替换以下内容:

    • WORKFORCE_PROVIDER_ID:您为员工提供方 ID 定义的值。
    • WORKFORCE_POOL_ID:您为员工身份池 ID 定义的值。
    • WORKFORCE_PROVIDER_DISPLAY_NAME:员工提供方的可选易记名称。长度必须少于 32 个字符。
    • WORKFORCE_PROVIDER_DESCRIPTION:员工提供方的可选说明。
    • PATH_TO_METADATA_XML:您使用 Cloud Shell 上传的应用元数据 XML 文件的 Cloud Shell 目录位置,例如:/path/to/sso_metadata.xml。
    • ATTRIBUTE_MAPPINGS:定义如何将断言属性映射到 Google Cloud 属性。通用表达式语言用于解释这些映射。例如:
    google.subject=assertion.subject,google.display_name=assertion.attributes.name[0],google.groups=assertion.attributes.groups
    

    上一个示例映射了以下属性:

    • assertion.subject 转换为 google.subject。这是最低要求。
    • 将 assertion.attributes.name[0] 映射到 google.display_name。
    • assertion.attributes.groups google.groups属性。

    如果您要为 Google Security Operations(包括 Google Security Operations SIEM 和 Google SecOps SOAR)执行此配置,请映射 Google SecOps SOAR 所需的以下属性:

    • attribute.first_name
    • attribute.last_name
    • attribute.user_email
    • google.groups
    • google.display_name

    因此,完整的映射如下所示:

    google.subject=assertion.subject,google.groups=assertion.attributes.groups,attribute.first_name=assertion.attributes.first_name[0],attribute.last_name=assertion.attributes.last_name[0],attribute.user_email=assertion.attributes.emailaddress[0],google.display_name=assertion.attributes.display_name[0]
    

    如需了解详情,请参阅为 Google SecOps SOAR 预配和映射用户。

    在配置 SAML 应用以传递群组成员资格信息时,常见的群组属性名称包括 groups、idpGroup 和 memberOf。在员工身份联合属性映射中,请确保 assertion.attributes.ATTRIBUTE_NAME 中的属性名称与 IdP 中配置的确切名称(区分大小写)一致。

    以下示例将多个群组映射到 google.groups 属性:

    google.groups="(has(assertion.attributes.idpGroup) ? assertion.attributes.idpGroup : []) + (has(assertion.attributes.groups) ? assertion.attributes.groups : []) + (has(assertion.attributes.memberOf) ? assertion.attributes.memberOf : [])"
    

    以下示例将包含特殊字符的群组 http://schemas.xmlsoap.org/ws/2005/05/identity/claims/group 映射到 google.groups:

    google.groups="assertion.attributes['http://schemas.xmlsoap.org/ws/2005/05/identity/claims/group']"
    

    如需详细了解映射属性,请参阅属性映射。

创建 OIDC 员工身份池提供方

如需使用Google Cloud 控制台或 gcloud CLI 创建 OIDC 员工身份池提供方,请完成以下步骤:

  1. 按照创建 OIDC 员工池提供方中的说明在员工身份池中创建提供方。

  2. 配置 OIDC 提供方时,请应用以下 Google SecOps 设置:

    • 重定向 URI:确保您的 OIDC IdP 应用包含以下两个重定向 URI,如在 IdP 中配置 OIDC 应用中所述:

      • Google SecOps 登录重定向 URI (https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID)
      • 员工身份联合验证重定向 URI (https://auth.cloud.google/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID)
    • 属性映射:使用通用表达式语言 (CEL) 将 OIDC 声明映射到 Google Cloud 属性。至少将 google.subject 映射到 assertion.sub,将 google.groups 映射到 assertion.groups,以便 Google SecOps RBAC 按预期运行:

      google.subject=assertion.sub,google.groups=assertion.groups
      

      如果您要配置 Google Security Operations(包括 Google Security Operations SIEM 和 Google SecOps SOAR),请同时映射 Google SecOps SOAR 所需的属性。例如:

      google.subject=assertion.sub,google.groups=assertion.groups,attribute.first_name=assertion.given_name,attribute.last_name=assertion.family_name,attribute.user_email=assertion.email,google.display_name=assertion.name
      

      高级群组映射示例

      将 OIDC 应用配置为传递群组成员资格信息时,常见的群组声明名称包括 groups、idpGroup 和 memberOf。在员工身份联合属性映射中,确保 assertion.CLAIM_NAME 中的声明名称与 IdP 中配置的确切名称(区分大小写)一致。

      以下示例将多个群组映射到 google.groups 属性:

      google.groups="(has(assertion.idpGroup) ? assertion.idpGroup : []) + (has(assertion.groups) ? assertion.groups : []) + (has(assertion.memberOf) ? assertion.memberOf : [])"
      

      以下示例将包含特殊字符(如 URI 架构)的群组声明映射到 google.groups:

      google.groups="assertion['http://schemas.xmlsoap.org/ws/2005/05/identity/claims/group']"
      
  3. 可选:创建属性条件。如果您的多租户 IdP 具有单个颁发者 URI,您必须使用属性条件来确保仅向正确的租户授予访问权限。例如,您可以设置限制,只允许具有特定角色或电子邮件网域的用户登录。如需了解详情,请参阅与多租户身份提供方联合时使用属性条件。

  4. 创建 OIDC 员工提供方后,我们建议您使用调试 IdP 令牌验证令牌和特性映射,然后继续执行授予角色以启用 Google SecOps 登录,以完成本文档中的其余部分。

授予角色以允许登录 Google SecOps

以下步骤介绍了如何使用 IAM 授予特定角色,以便员工身份池中的群组和用户可以登录 Google SecOps。使用您之前创建的与 Google SecOps 绑定的 Google Cloud 项目执行配置。

控制台

  1. 在 Google Cloud 控制台中,前往 IAM 页面。

    转到 IAM

  2. 选择与 Google SecOps 绑定的 Google Cloud 项目。

  3. 在按主账号查看标签页上,点击 授予访问权限。

  4. 在添加主账号部分的新的主账号字段中,输入主账号标识符。

    例如:

    • 如需添加使用您之前创建的员工身份池和员工提供方管理的所有身份,请输入以下内容:

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

    • 如需将特定群组添加为主账号,请输入以下内容:

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

    替换以下内容:

    • WORKFORCE_POOL_ID:您为员工身份池 ID 定义的值。
    • GROUP_ID:映射的 google.groups 声明中的群组。您必须在 IdP 中创建此群组。
  5. 在分配角色部分,选择或搜索适用的 Chronicle API 角色,例如 Chronicle API Viewer (roles/chronicle.viewer)。

  6. 点击保存。

  7. 对您要授予角色的每个主账号重复执行第 3 步到第 5 步。

gcloud

  1. 向应有权访问 Google SecOps 应用的用户或群组授予 Chronicle API Viewer (roles/chronicle.viewer) 角色。

    • 以下示例向使用您之前创建的员工身份池和员工提供方管理的身份授予 Chronicle API Viewer 角色。
    gcloud projects add-iam-policy-binding PROJECT_ID \
      --role roles/chronicle.viewer \
      --member "principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/*"
    

    替换以下内容:

    • PROJECT_ID:替换为您在为 Google SecOps 配置 Google Cloud 项目中配置的 Google SecOps 绑定项目的项目 ID。如需了解用于标识项目的字段,请参阅创建和管理项目。
    • WORKFORCE_POOL_ID:您为员工身份池 ID 定义的值。

    • 如需向特定群组授予 Chronicle API Viewer 角色,请运行以下命令:

    gcloud projects add-iam-policy-binding PROJECT_ID \
      --role roles/chronicle.viewer \
      --member "principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/group/GROUP_ID"
    

    替换 GROUP_ID:映射的 google.groups 声明中的群组。您必须在 IdP 中创建此群组。

  2. 配置其他 IAM 政策,以满足贵组织的要求。

  3. 必需:如需完成身份验证并允许用户访问 Google SecOps 平台,您需要从 Google SecOps 的 SOAR 端配置用户访问权限。如需了解详情,请参阅在 Google SecOps 平台中映射用户。

重复上述步骤,授予其他角色。

为 Google SecOps 实例配置单点登录

将第三方 IdP 与 Google SecOps 集成的最后一项任务是配置单点登录。完成此步骤后,用户将能够使用其 IdP 凭据登录 Google SecOps。

以下是配置单点登录的步骤:

  1. 在 Google Cloud 控制台中,前往安全性 > Google SecOps 页面。
  2. 点击单点登录标签页,然后选择员工身份联合。
  3. 从可用提供方列表中,选择您在创建员工身份池提供方中创建的员工身份联合提供方。
  4. 可选:如需测试单点登录配置,请点击测试单点登录设置。如果配置成功,系统会将您重定向到 IdP 登录界面。
  5. 点击保存。

管理员工身份联合配置

本部分介绍了如何更新提供方设置,以及如何验证用户访问权限级别是否配置正确。

验证或配置 Google SecOps 功能访问权限控制

如果您在配置员工身份联合时将属性或群组映射到 google.groups 属性,则此信息会传递给 Google SecOps,以便您为 Google SecOps 功能配置 RBAC。

如果 Google SecOps 实例具有现有的 RBAC 配置,请验证原始配置是否按预期运行。

如果您之前未配置过访问权限控制,请参阅使用 IAM 配置功能访问权限控制,了解如何控制对功能的访问权限。

修改员工身份联合配置

如果您需要更新员工身份池或员工提供方,请参阅管理员工身份池提供方,了解如何更新配置。

创建 SAML 员工池提供方中的密钥管理部分介绍了如何更新 IdP 签名密钥,然后使用最新的应用元数据 XML 文件更新员工提供方配置。对于 OIDC 提供方,请参阅更新提供方和管理 OIDC JWK。

控制台

如需更新特定员工池,请执行以下操作:

  1. 进入员工身份池页面。

    转到“员工身份池”

  2. 在表格中,选择相应池。

  3. 更新池参数。

  4. 点击保存池。

如需更新提供商,请执行以下操作:

  1. 进入员工身份池页面。

    进入“员工身份池”

  2. 在表中,选择要为其更新提供方的池。

  3. 在提供方表中,点击 修改。

  4. 更新提供方详细信息。

  5. 如需保存更新后的提供商详细信息,请点击保存。

gcloud

以下是更新员工提供方配置的 gcloud 命令示例:

gcloud iam workforce-pools providers update-saml WORKFORCE_PROVIDER_ID \
  --workforce-pool=WORKFORCE_POOL_ID \
  --location="global" \
  --display-name="WORKFORCE_PROVIDER_DISPLAY_NAME" \
  --description="WORKFORCE_PROVIDER_DESCRIPTION" \
  --idp-metadata-path=PATH_TO_METADATA_XML \
  --attribute-mapping="ATTRIBUTE_MAPPINGS"

替换以下内容:

  • WORKFORCE_PROVIDER_ID:您为员工提供方 ID 定义的值。
  • WORKFORCE_POOL_ID:您为员工身份池 ID 定义的值。
  • WORKFORCE_PROVIDER_DISPLAY_NAME:员工提供方的人性化名称。该值必须少于 32 个字符。
  • WORKFORCE_PROVIDER_DESCRIPTION:员工提供方的说明。
  • PATH_TO_METADATA_XML:更新后的应用元数据 XML 文件的位置,例如:/path/to/sso_metadata_updated.xml。
  • ATTRIBUTE_MAPPINGS:映射到 Google Cloud 属性的断言属性。例如:

google.subject=assertion.subject,google.display_name=assertion.attributes.name[0],google.groups=assertion.attributes.memberOf

排查配置问题

如果您在此过程中遇到错误,请参阅排查员工身份联合问题,以解决常见问题。如果您的组织使用防火墙或 Web 代理,请验证您的网络许可清单是否包含所需的身份验证和员工身份联合网域,例如 auth.backstory.chronicle.security、iam.googleapis.com、accounts.google.com 和区域 accounts.google.ccTLD 网域。如需了解详情,请参阅网络访问权限和网域许可清单。 以下部分介绍了在执行本文档中的步骤时遇到的常见问题。

如果您仍然遇到问题,请与您的 Google SecOps 代表联系,并提供您的 Chrome 网络日志文件。

找不到命令

  • 创建员工身份池提供方并指定 IdP 详细信息时,您会收到以下错误:

    Error: bash: --attribute-mapping=google.subject=assertion.subject,
    google.display_name=assertion.attributes.name[0],
    google.groups=assertion.attributes.groups: command not found
    

检查 PATH_TO_METADATA_XML 是否是您将 SAML 应用元数据 XML 文件上传到 Cloud Shell 主目录的位置。

调用方无权限

  • 运行 gcloud projects add-iam-policy-binding 命令向用户或群组授予角色时,您会收到以下错误:

    ERROR: (gcloud.organizations.add-iam-policy-binding) User [ ] does not have
    permission to access organizations instance [538073083963:getIamPolicy]
    (or it may not exist): The caller does not have permission
    

检查您是否拥有所需权限。如需了解详情,请参阅必需的角色。

验证失败:请求中缺少会话 ID

  • 尝试进行身份验证时,您会在浏览器中看到以下错误:

    Verification failure: missing session ID in request
    

检查 ACS 和实体 ID 基础网址是否正确。如需了解详情,请参阅配置 IdP 应用。

调试 IdP 令牌

您可以使用员工身份联合中的调试 IdP 令牌功能来验证身份提供方是否传递了正确的特性和声明。强烈建议您在用户尝试登录 Google SecOps 之前执行此操作,因为这有助于防止登录和属性映射错误。

如需调试令牌,请执行以下操作:

  1. 在 Google Cloud 控制台中,前往员工身份联合。
  2. 选择您的矿池,然后选择您的提供商。
  3. 点击调试 IdP 令牌。

如需详细了解如何使用此功能验证设置,请参阅迁移前验证指南。

调试大于 4KB 的 JWT

如果您在登录 Google SecOps 时遇到问题,请确保您的 JSON Web 令牌 (JWT) 未超出 Google SecOps 的 4KB 限制。如果用户收到错误消息“Authentication JWT larger than 4KB. 请减少从 IdP 发送的群组成员资格数据,以解决此错误。”,请按照以下问题排查步骤操作:

  1. 调试令牌:您可以在员工身份联合内的提供方详情页面上调试令牌(方法是依次前往员工身份联合 > 员工池 > POOL_NAME > PROVIDER_NAME,然后点击调试 IdP 令牌)。如需使用此功能,您必须先将 Google Cloud 网址添加到身份提供方的重定向网址中。这适用于 SAML 和 OIDC 协议。如需了解详情,请参阅排查员工身份联合问题。
  2. 过滤群组声明:如果您的身份提供方发送了许多与 Google SecOps 无关的群组,请在提供方级别过滤群组声明。将外部提供方配置为仅发送 Google SecOps 所需的最小群组集,可减小 JWT 的大小并避免身份验证错误。

    • 示例 (Microsoft Entra ID):您可以使用 Microsoft Entra 群组过滤功能,仅发送最少量的相关群组。在 Entra 企业应用的“单点登录”下,修改群组声明以应用过滤条件(例如,使用前缀匹配),以便仅将所需群组发送到 Google SecOps。如需了解详情,请参阅 Microsoft Entra 群组过滤。

后续步骤

完成本文档中的步骤后,请执行以下操作:

需要更多帮助?获得社区成员和 Google SecOps 专业人士的解答。