サードパーティ ID を構成する

以下でサポートされています。

このガイドは、サードパーティの ID プロバイダ(IdP)を使用して Google SecOps でワークフォース(ユーザーとグループ)を認証する Google Security Operations 管理者を対象としています。このプロセスは、Google Cloud Workforce Identity 連携を活用することで可能になります。

Workforce Identity 連携は、Security Assertion Markup Language(SAML 2.0)または OpenID Connect(OIDC)を使用する任意の IdP(Okta、Microsoft Entra ID、Microsoft Active Directory Federation Services(AD FS)など)をサポートしています。

このドキュメントでは、Workforce Identity 連携を使用して SAML ベースまたは OIDC ベースの IdP による認証を設定する際の概要について説明します。

  1. 必要なリソースを計画する。Workforce Identity プールとプロバイダの詳細を決定し、Google SecOps の機能へのアクセスを構成するために必要なユーザー属性とグループを特定します。
  2. サードパーティの IdP アプリケーションを構成する。Workforce Identity 連携および Google SecOps と統合する IdP SAML または OIDC アプリケーションを作成します。
  3. Workforce Identity 連携を構成します。Workforce Identity プールとプロバイダを構成し、IdP グループとユーザーに Google Cloud Identity and Access Management(IAM)ロールを付与します。
  4. 新しく作成したプロバイダを使用してシングル サインオン(SSO)を構成します。

これらの手順を完了すると、ID プロバイダを使用して Google SecOps にログインし、IAM を使用して機能のロールベース アクセス制御(RBAC)でユーザー アクセスを管理できます。

一般的なユースケース

Google SecOps では、さまざまなユースケースで Workforce Identity 連携を SSO ブローカーとして使用する必要があります。

厳格なセキュリティ基準に準拠する

  • 目標: システムとクラウドへのアクセスに関する厳格な規制基準を満たす。
  • 価値: SSO を安全に仲介することで、FedRAMP High(またはそれ以上)のコンプライアンス要件に準拠できます。

エンタープライズ アクセス制御を管理する

  • 目的: 組織全体で機能とデータアクセスを一元的に制御する。
  • 値: IAM を使用して Google SecOps でエンタープライズ レベルの RBAC を有効にします。

主な用語

  • Workforce プール: 組織レベルで定義されたグローバルに一意の Google Cloud リソース。従業員に Google SecOps へのアクセス権を付与します。
  • Workforce プロバイダ: 単一の外部 IdP の構成の詳細を保存する Workforce Identity プールのサブリソース。
  • 属性マッピング: IdP から提供されたアサーション属性を、Common Expression Language(CEL)を使用して Google Cloud 属性に変換するプロセス。
  • Assertion Consumer Service(ACS)URL: Google SecOps と通信するように SAML アプリケーションを構成するために使用される特定の URL(プロバイダによってはシングル サインオン URL と呼ばれることもあります)。
  • エンティティ ID: Google SecOps などの特定のアプリケーションまたはサービスを識別し、IdP 内で SAML アプリケーションを設定する、グローバルに一意の固有識別子 URL。

プロセスの概要

Google SecOps は、サービス プロバイダを起点とする(SP を起点とする)SAML または OIDC SSO をサポートしています。これにより、Google SecOps に直接移動できます。Google SecOps は、IAM Workforce Identity 連携を通じて、サードパーティの IdP に対してリクエストを発行します。

IdP がユーザー ID を認証すると、ユーザーは SAML 認証アサーションまたは OIDC ID トークンとともに Google SecOps に戻されます。 Google Cloud Workforce Identity 連携は、認証フローの仲介役として機能します。

Google SecOps、 Google Cloud IAM Workforce Identity 連携、IdP 間の通信

Google SecOps、IAM Workforce Identity 連携、IdP 間の通信

大まかな通信は次のとおりです。

  1. ユーザーが Google SecOps に移動します。
  2. Google SecOps は、 Google CloudWorkforce Identity プールで IdP 情報を検索します。
  3. リクエストが IdP に送信されます。
  4. SAML アサーションまたは OIDC ID トークンは、 Google Cloud Workforce Identity プールに送信されます。
  5. 認証が成功すると、Google SecOps は、Workforce Identity プールで Workforce プロバイダを構成したときに定義された SAML 属性または OIDC クレームのみを受け取ります。

Google SecOps 管理者は、ID プロバイダでグループを作成し、アサーションまたは ID トークンでグループ メンバーシップ情報を渡すように SAML または OIDC アプリケーションを構成し、ユーザーとグループを Google SecOps の IAM の事前定義ロールまたは作成したカスタムロールに関連付けます。

始める前に

実装を計画する

このセクションでは、このドキュメントの手順を実行する前に決める事項と定義する情報について説明します。

Workforce Identity プールとワーカー プロバイダを定義する

IdP を介した認証を設定するには、認証フローの仲介役として Workforce Identity 連携を構成する必要があります。Workforce Identity 連携を構成する前に、次のGoogle Cloud リソースを定義します。

  • Workforce プール: Workforce Identity プールを使用すると、人材(従業員など)に Google SecOps へのアクセス権を付与できます。
  • Workforce プロバイダ: 1 つの IdP に関する詳細を保存する Workforce Identity プールのサブリソース。

Workforce Identity プール、従業員プロバイダ、Google SecOps インスタンス(単一のお客様のサブドメインで識別される)の関係は次のとおりです。

  • Workforce Identity プールは組織レベルで定義されます。
  • 各 Google SecOps インスタンスには、Workforce Identity プールが構成され、関連付けられています。
  • 1 つの Workforce Identity プールに複数の Workforce プロバイダを設定できます。
  • 各 Workforce プロバイダは、サードパーティの IdP を Workforce Identity プールと統合します。

  • Workforce Identity プールは Google SecOps 専用にする必要があります。Google SecOps 用に作成されたプールを他の目的で共有することはできません。

  • Workforce Identity プールは、Google SecOps にバインドされたプロジェクトを含む同じGoogle Cloud 組織に存在する必要があります。

Workforce プールと Workforce プロバイダのキー識別子の値を定義する際のガイドラインは次のとおりです。

  • Workforce Identity プール ID(WORKFORCE_POOL_ID): Workforce プールの範囲または目的を示す値を定義します。値は次の要件を満たす必要があります。
    • グローバルに一意でなければなりません。
    • 使用できるのは、小文字の [a-z]、数字 [0-9]、ダッシュ [-] のみです。
    • 先頭は小文字の [a-z] にする必要があります。
    • 末尾は小文字の [a-z] または数字 [0-9] にする必要があります。
    • 長さは 4~61 文字にできます。
  • Workforce Identity プールの表示名(WORKFORCE_POOL_DISPLAY_NAME): Workforce Identity プールのユーザー フレンドリーな名前を定義します。
  • Workforce Identity プールの説明(WORKFORCE_POOL_DESCRIPTION): Workforce プールの詳細な説明を定義します。
  • Workforce プロバイダ ID(WORKFORCE_PROVIDER_ID): それが表す IdP を示す値を定義します。値は次の要件を満たす必要があります。
    • 使用できるのは、小文字の [a-z]、数字 [0-9]、ダッシュ [-] のみです。
    • 長さは 4~32 文字にできます。
  • Workforce プロバイダの表示名(WORKFORCE_PROVIDER_DISPLAY_NAME): Workforce プロバイダには、ユーザー フレンドリーな名前を定義します。32 文字未満で指定してください。
  • Workforce プロバイダの説明(WORKFORCE_PROVIDER_DESCRIPTION): Workforce プロバイダの詳細な説明を定義します。

IdP でユーザー属性とグループを定義する

IdP で SAML または OIDC アプリケーションを作成する前に、Google SecOps の機能へのアクセスを構成するために必要なユーザー属性または OIDC クレームとグループを特定します。一般的なユーザー属性には、次のようなものがあります。

  • 件名
  • メール
  • 名
  • 姓
  • 表示名

このプロセスの次のフェーズでは、ユーザー グループと属性または OIDC クレームに関する情報が必要です。

  • SAML または OIDC アプリケーションを構成するときに、計画時に定義したグループを作成します。SAML アサーションまたは OIDC ID トークンでグループ メンバーシップを渡すように IdP アプリケーションを構成します。

  • Workforce プロバイダを作成するときに、SAML アサーション属性または OIDC クレームとグループを Google Cloud 属性にマッピングします。この情報は、ユーザーの ID の一部としてアサーションまたは ID トークンで送信されます。

IdP アプリケーションを構成する

このセクションでは、 Google CloudWorkforce Identity 連携と Google SecOps と統合するために IdP SAML または OIDC アプリケーションで必要な特定の構成のみについて説明します。詳細な手順については、IdP のドキュメントをご覧ください。

IdP で SAML アプリケーションを構成する

  1. IdP でグループを作成します(まだ作成していない場合)。

    効果的な手法として、Google SecOps インスタンスへのアクセスを管理するには、個々のユーザー アカウントではなくグループを使用します。Google では、デフォルトの Google SecOps ロールに直接対応するグループを IdP に作成することをおすすめします。

    次の例をご覧ください。

    Google SecOps のロール IdP グループ(推奨)
    Chronicle API 管理者 chronicle_secops_admins
    Chronicle API 編集者 chronicle_secops_editor
    Chronicle API 閲覧者 chronicle_secops_viewer
  2. IdP で新しい SAML アプリケーションを作成します。

  3. アプリケーションを次のように構成します。

    1. Assertion Consumer Service(ACS)URL を指定します。サービス プロバイダによっては、シングル サインオン URL とも呼ばれます。

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

      次のように置き換えます。

      • WORKFORCE_POOL_ID: Workforce Identity プールに定義した識別子。
      • WORKFORCE_PROVIDER_ID: Workforce プロバイダに定義した識別子。

      値の説明については、Workforce Identity プールとワーカー プロバイダを定義するをご覧ください。

    2. 次のエンティティ ID(SP エンティティ ID とも呼ばれます)を指定します。

      https://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID
      
    3. NameID フィールドが SAML レスポンスで返されるように、IdP で名前識別子を構成します。

      これは、組織ポリシーをサポートする値(メールアドレスやユーザー名など)に設定できます。この値の構成については、IdP のドキュメントをご覧ください。この要件の詳細については、Workforce Identity 連携のトラブルシューティングをご覧ください。

  4. IdP から Application Integration にユーザー情報を渡すことができる属性ステートメントを追加します。属性は、IdP の実装を計画したときに定義しています。

    たとえば、次の表を使用して、Okta、Microsoft AD FS、Entra ID などの一般的に使用される IdP の属性をマッピングします。

    属性名 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 ファイルをダウンロードします。

    次のセクションでは、Workforce Identity ID プロバイダを構成するときに、このメタデータ ファイルを使用します。Google Cloud CLI を使用する場合は、Cloud Shell を使用して、このファイルをローカル システムから Google Cloud ホーム ディレクトリにアップロードする必要があります。

IdP で OIDC アプリケーションを構成する

Workforce Identity 連携と Google SecOps と統合するように IdP で OIDC アプリケーションを構成するには、次の操作を行います。

  1. まだグループを作成していない場合は、IdP で作成します。ベスト プラクティスとして、個々のユーザー アカウントではなくグループを使用して、Google SecOps インスタンスへのアクセスを管理します。

  2. IdP で新しい OIDC アプリケーションを作成し、OIDC Workforce プール プロバイダを作成するの IdP の準備手順に沿って操作します。

  3. 次の両方のリダイレクト URI(一部の IdP ではコールバック URL またはログイン リダイレクト URI と呼ばれます)を使用してアプリケーションを構成します。

    • Google SecOps へのログイン:

      https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID
      
    • Workforce Identity 連携のトークンと属性マッピングの検証:

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

    次のように置き換えます。

    • WORKFORCE_POOL_ID: Workforce Identity プールに定義した識別子。
    • WORKFORCE_PROVIDER_ID: Workforce プロバイダに定義した識別子。

    値の説明については、Workforce Identity プールとワーカー プロバイダを定義するをご覧ください。

  4. IdP アプリケーションで権限付与タイプを選択します。推奨される認可コードフローまたは暗黙的フローのいずれかを選択します。暗黙的フローを使用する場合は、ID トークンを返すようにアプリケーションが構成されていることを確認してください。

  5. sub クレームと、IdP の実装を計画したときに特定したユーザー クレームとグループ クレームを返すように IdP アプリケーションを構成します。

    たとえば、次の表を使用して、Okta、Microsoft AD FS、Entra ID などの一般的に使用される IdP のクレームをマッピングします。

    申請名 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 アプリケーションが組織認可サーバーを使用している場合は、Workforce Identity 連携プロバイダの作成時に groups を追加のスコープとして渡す必要があります。これにより、Okta は groups クレームを返します。詳細については、Okta との Workforce Identity 連携を構成するをご覧ください。

  6. IdP の OIDC アプリケーションに適切なグループとユーザーを割り当てます。

  7. OIDC Workforce Identity プール プロバイダを作成するときに使用する、IdP アプリケーションの次の認証情報を記録します。

    • 認可コードフロー: クライアント ID、発行元 URI、クライアント シークレット。
    • 暗黙的フロー: クライアント ID と発行者 URI。

Workforce Identity 連携を構成する

このセクションでは、前のセクションで作成した IdP SAML または OIDC アプリケーションを使用して Workforce Identity 連携を構成するために必要な具体的な手順のみ説明します。Workforce Identity プールの管理の詳細については、Workforce Identity プール プロバイダを管理するをご覧ください。

課金プロジェクトと割り当てプロジェクトを設定する

  1. Google SecOps にバインドされたプロジェクトで必要な権限を持つユーザーとして Google Cloud コンソールを開きます。このユーザーはすでに特定または作成してあります。始める前にをご覧ください。

  2. Cloud Shell セッションを開始する

  3. gcloud CLI を使用して実行されるオペレーションに課金され、割り当てられる Google Cloud プロジェクトを設定します。次の gcloud コマンドを例として使用します。

    gcloud config set billing/quota_project PROJECT_ID
    

    PROJECT_ID は、Google SecOps 用に Google Cloud プロジェクトを構成するで構成した Google SecOps にバインドされたプロジェクトのプロジェクト ID に置き換えます。プロジェクトを識別するフィールドの説明については、プロジェクトの作成と管理をご覧ください。

    割り当ての詳細については、次のドキュメントをご覧ください。

    エラーが発生した場合は、割り当てエラーのトラブルシューティングをご覧ください。

Workforce Identity プールを作成して構成する

Workforce Identity プールを構成すると、外部 ID プロバイダ(IdP)と統合するか、Google Workspace または Cloud Identity と統合できます。

コンソール

Workforce Identity プールを作成するには、次の操作を行います。

  1. Google Cloud コンソールで、[Workforce Identity プール] ページに移動します。

    [Workforce Identity プール] に移動

  2. Workforce Identity プールの組織を選択します。Workforce Identity プールは、組織内のすべてのプロジェクトとフォルダで使用できます。

  3. [プールを作成] をクリックして、次の操作を行います。

    1. [名前] フィールドに、プールの表示名を入力します。プール ID は、入力した名前から自動的に取得され、[名前] フィールドの下に表示されます。プール ID を更新するには、プール ID の横にある [編集] をクリックします。

    2. 省略可: [説明] にプールの説明を入力します。

  4. [次へ] をクリックします。

Workforce Identity プールのセッション継続時間は、デフォルトで 1 時間に設定されます。この期間によって、 Google Cloud アクセス トークン、Google Cloud Workforce Identity 連携コンソール、gcloud CLI ログイン セッションの有効期間が決まります。プールを更新して、15 分~ 12 時間のカスタム セッション継続時間を設定できます。

gcloud

  1. Workforce Identity プールを作成します。

    次の 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: Workforce Identity プール ID に定義した値。
    • ORGANIZATION_ID: 数値の組織 ID
    • WORKFORCE_POOL_DESCRIPTION: Workforce Identity プールの省略可能な説明。
    • WORKFORCE_POOL_DISPLAY_NAME: Workforce Identity プールの省略可能なユーザー フレンドリーな名前。
    • SESSION_DURATION: セッション継続時間のオプション値。s を付加した数値で表されます(例: 3600s)。この期間によって、 Google Cloudアクセス トークン、Google Cloud Workforce Identity 連携コンソール、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へのログインをサポートしない Workforce Identity プールを作成します。ログイン機能を有効にするには、シナリオごとに適切なフラグを使用する必要があります。

  2. Chronicle API を有効にするように求められたら、「Yes」と入力します。

Workforce Identity プール プロバイダを作成する

Workforce Identity プール プロバイダは、Google Cloud 組織と IdP との関係を記述します。認証プロトコルに一致するセクションを選択します。

SAML Workforce Identity プール プロバイダを作成する

コンソール

Workforce Identity プール プロバイダを構成するには、次の操作を行います。

  1. Google Cloud コンソールで、[Workforce Identity プール] ページに移動します。

    [Workforce Identity プール] に移動

  2. [Workforce Identity プール] テーブルで、プロバイダを作成するプールを選択します。

  3. [プロバイダ] セクションで [ プロバイダを追加] をクリックします。

  4. [プロバイダ ベンダーを選択] で、IdP を選択します。

    IdP がリストにない場合は、[汎用 ID プロバイダ] を選択します。

  5. [認証プロトコルを選択する] で、[SAML] を選択します。

  6. [プロバイダの作成] セクションで、次の操作を行います。

    1. [名前] にプロバイダの名前を入力します。

    2. 省略可: [説明] にプロバイダの説明を入力します。

    3. [IdP メタデータ ファイル(XML)] で、このガイドの前半で生成したメタデータ XML ファイルを選択します。

    4. [プロバイダを有効にする] がオンになっていることを確認します。

    5. [続行] をクリックします。

  7. [Share your provider information] セクションで、URL をコピーします。

    • 最初の URL(https://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID)を IdP のエンティティ ID として構成します。
    • 2 つ目の URL(https://auth.cloud.google/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID)は、Workforce Identity 連携トークンとマッピングの検証(IdP トークンのデバッグ機能を使用)に使用されます。IdP に、この URL と、IdP で SAML アプリケーションを構成するで構成した Google SecOps ACS ログイン URL(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 SIEM と Google SecOps SOAR を含む Google Security Operations でこの構成を行う場合は、Google SecOps SOAR に必要な次の属性をマッピングします。

      • attribute.first_name
      • attribute.last_name
      • attribute.user_email
      • google.groups
      • google.display_name
    2. 省略可: IdP として Microsoft Entra ID を選択した場合は、次の操作によってグループ数を増加できます。

      1. [追加属性を使用する] を選択します。
      2. [追加属性の発行元 URI] フィールドに、発行元 URL を入力します。
      3. [追加属性のクライアント ID] フィールドに、クライアント ID を入力します。
      4. [追加属性のクライアント シークレット] フィールドに、クライアント シークレットを入力します。
      5. [追加属性のタイプ] リストで、追加属性の属性タイプを選択します。
      6. [追加属性フィルタ] フィールドに、グループの Microsoft Graph API をクエリするときに使用されるフィルタ式を入力します。
    3. 省略可: 属性条件を追加するには、[条件を追加] をクリックし、属性条件を表す CEL 式を入力します。たとえば、ipaddr 属性を特定の IP 範囲に制限するには、条件 assertion.attributes.ipaddr.startsWith('98.11.12.') を設定します。この例の条件により、98.11.12. で始まる IP アドレスを持つユーザーだけが、この Workforce プロバイダを使用してログインできます。

    4. 詳細な監査ロギングを有効にするには、[詳細なロギング] で [属性値の監査ロギングを有効にする] 切り替えボタンをクリックします。

  10. プロバイダを作成するには、[送信] をクリックします。

gcloud

Workforce Identity プール プロバイダを構成するには:

  1. [More] > をクリックして、SAML アプリケーション メタデータ ファイルを Cloud Shell のホーム ディレクトリにアップロードします。ファイルをアップロードできるのはホーム ディレクトリに限られます。Cloud Shell とローカル ワークステーションの間でファイルを転送するその他のオプションについては、Cloud Shell からファイルとフォルダをアップロードおよびダウンロードするをご覧ください。

  2. Cloud Shell で SAML アプリケーション メタデータ XML ファイルをアップロードしたディレクトリ パスをメモします。このパスは次のステップで必要になります。

  3. Workforce Identity プール プロバイダを作成し、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: Workforce プロバイダ ID に定義した値。
    • WORKFORCE_POOL_ID: Workforce Identity プール ID に定義した値。
    • WORKFORCE_PROVIDER_DISPLAY_NAME: Workforce プロバイダのわかりやすい名前(省略可)。32 文字未満で指定してください。
    • WORKFORCE_PROVIDER_DESCRIPTION: Workforce プロバイダの説明(省略可)。
    • PATH_TO_METADATA_XML: Cloud Shell を使用してアップロードしたアプリケーション メタデータ XML ファイルの Cloud Shell ディレクトリの場所(例: /path/to/sso_metadata.xml)。
    • ATTRIBUTE_MAPPINGS: アサーション属性を Google Cloud 属性にマッピングする方法の定義。これらのマッピングの解釈には、Common Expression Language が使用されます。次に例を示します。
    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 SIEM と Google SecOps SOAR を含む Google Security Operations でこの構成を行う場合は、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 などがあります。Workforce Identity 連携の属性マッピングで、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 Workforce Identity プール プロバイダを作成する

Google Cloud コンソールまたは gcloud CLI を使用して OIDC Workforce Identity プール プロバイダを作成するには、次の操作を行います。

  1. OIDC Workforce プール プロバイダを作成するの手順に沿って、Workforce Identity プールにプロバイダを作成します。

  2. OIDC プロバイダを構成するときに、次の Google SecOps 設定を適用します。

    • リダイレクト URI: IdP で OIDC アプリケーションを構成するの説明に沿って、OIDC IdP アプリケーションに次の両方のリダイレクト URI が含まれていることを確認します。

      • Google SecOps ログイン リダイレクト URI(https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID)
      • Workforce Identity 連携の検証リダイレクト URI(https://auth.cloud.google/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID)
    • 属性マッピング: Common Expression Language(CEL)を使用して、OIDC クレームを Google Cloud 属性にマッピングします。Google SecOps RBAC が想定どおりに機能するように、少なくとも google.subject を assertion.sub に、google.groups を assertion.groups にマッピングします。

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

      Google Security Operations SIEM と Google SecOps SOAR を含む Google Security Operations を構成する場合は、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 があります。Workforce Identity 連携の属性マッピングで、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 に 1 つの発行元 URI がある場合は、属性条件を使用して、正しいテナントにアクセスが制限されるようにする必要があります。たとえば、特定のロールやメールドメインを持つユーザーにログインを制限できます。詳細については、マルチテナント ID プロバイダと連携する場合に属性条件を使用するをご覧ください。

  4. OIDC Workforce プロバイダを作成したら、IdP トークンをデバッグするを使用してトークンと属性マッピングを検証し、Google SecOps へのログインを有効にするロールを付与するに進み、このドキュメントの残りのセクションを完了することをおすすめします。

Google SecOps へのログインを有効にするためのロールを付与する

次の手順では、Workforce Identity プール内のグループとユーザーが Google SecOps にログインできるように、IAM を使用して特定のロールを付与する方法について説明します。先ほど作成した Google SecOps にバインドされた Google Cloud プロジェクトを使用して構成を行います。

コンソール

  1. Google Cloud コンソールで、[IAM] ページに移動します。

    [IAM] に移動

  2. Google SecOps にバインドされた Google Cloud プロジェクトを選択します。

  3. [プリンシパル別に表示] タブで、[ アクセスを許可] をクリックします。

  4. [プリンシパルの追加] セクションの [新しいプリンシパル] フィールドに、プリンシパル ID を入力します。

    次に例を示します。

    • 以前に作成した Workforce Identity プールと Workforce プロバイダを使用して管理されているすべての ID を追加するには、次のように入力します。

      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: Workforce Identity プール ID に定義した値。
    • GROUP_ID: マッピングされた google.groups クレーム内のグループ。このグループは IdP で作成する必要があります。
  5. [ロールを割り当てる] セクションで、該当する Chronicle API ロール(Chronicle API 閲覧者(roles/chronicle.viewer)など)を選択または検索します。

  6. [保存] をクリックします。

  7. ロールを付与するプリンシパルごとに手順 3 ~ 5 を繰り返します。

gcloud

  1. Google SecOps アプリケーションへのアクセス権を付与するユーザーまたはグループに Chronicle API 閲覧者(roles/chronicle.viewer)ロールを付与します。

    • 次の例では、以前に作成した Workforce Identity プールと Workforce プロバイダを使用して管理されている ID に、Chronicle API 閲覧者のロールを付与します。
    gcloud projects add-iam-policy-binding PROJECT_ID \
      --role roles/chronicle.viewer \
      --member "principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/*"
    

    次のように置き換えます。

    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 インスタンスへの SSO を構成する

サードパーティ IdP を Google SecOps と統合する最後のタスクは、SSO の構成です。この手順を完了すると、ユーザーは IdP 認証情報を使用して Google SecOps にログインできるようになります。

SSO を構成する手順は次のとおりです。

  1. Google Cloud コンソールで、[セキュリティ] > [Google SecOps] ページに移動します。
  2. [シングル サインオン] タブをクリックし、[Workforce Identity 連携] を選択します。
  3. 利用可能なプロバイダのリストから、Workforce Identity プール プロバイダを作成するで作成した Workforce Identity 連携プロバイダを選択します。
  4. 省略可: SSO 設定をテストするには、[SSO 設定をテスト] をクリックします。構成が成功すると、IdP のログイン画面にリダイレクトされます。
  5. [保存] をクリックします。

Workforce Identity 連携の構成を管理する

このセクションでは、プロバイダ設定を更新し、ユーザーのアクセスレベルが正しく構成されていることを確認する方法について説明します。

Google SecOps の機能アクセス制御を確認または構成する

google.groups 属性にマッピングされた属性またはグループを使用して Workforce Identity 連携を構成した場合、この情報は Google SecOps に渡され、Google SecOps 機能に RBAC を構成できます。

Google SecOps インスタンスに既存の RBAC 構成がある場合は、元の構成が想定どおりに動作することを確認します。

アクセス制御を構成していない場合は、IAM を使用して機能アクセス制御を構成するで、機能へのアクセスを制御する方法をご覧ください。

Workforce Identity 連携の構成を変更する

Workforce Identity プールまたは Workforce プロバイダを更新する必要がある場合は、構成の更新について Workforce Identity プール プロバイダの管理をご覧ください。

SAML 従業員プール プロバイダの作成の鍵管理セクションで、IdP 署名鍵を更新してから、最新のアプリケーション メタデータ XML ファイルで Workforce プロバイダ構成を更新する方法について説明しています。OIDC プロバイダについては、プロバイダを更新すると OIDC JWK を管理するをご覧ください。

コンソール

特定の Workforce プールを更新するには:

  1. [Workforce Identity プール] ページに移動します。

    [Workforce Identity プール] に移動

  2. テーブルでプールを選択します。

  3. プールのパラメータを更新します。

  4. [Save Pool] をクリックします。

プロバイダを更新するには:

  1. [Workforce Identity プール] ページに移動します。

    [Workforce Identity プール] に移動

  2. テーブルで、プロバイダを更新するプールを選択します。

  3. [プロバイダ] テーブルで、 [編集] をクリックします。

  4. プロバイダの詳細を更新します。

  5. 更新したプロバイダの詳細を保存するには、[保存] をクリックします。

gcloud

以下に、Workforce プロバイダの構成を更新する 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: Workforce プロバイダ ID に定義した値。
  • WORKFORCE_POOL_ID: Workforce Identity プール ID に定義した値。
  • WORKFORCE_PROVIDER_DISPLAY_NAME: Workforce プロバイダのユーザー フレンドリーな名前。値は 32 文字未満で指定してください。
  • WORKFORCE_PROVIDER_DESCRIPTION: Workforce プロバイダの説明。
  • 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

構成に関する問題のトラブルシューティング

このプロセス中にエラーが発生した場合は、Workforce Identity 連携のトラブルシューティングで一般的な問題の解決方法を確認してください。組織でファイアウォールまたはウェブ プロキシを使用している場合は、ネットワーク許可リストに、必要な認証ドメインと Workforce Identity 連携ドメイン(auth.backstory.chronicle.security、iam.googleapis.com、accounts.google.com、リージョン accounts.google.ccTLD ドメインなど)が含まれていることを確認します。詳細については、ネットワーク アクセスとドメインの許可リストをご覧ください。次のセクションでは、このドキュメントの手順で操作する際に発生する一般的な問題について説明します。

それでも問題が解決しない場合は、Google SecOps の担当者に連絡して、Chrome ネットワーク ログファイルをお知らせください。

コマンドが見つかりません

  • Workforce Identity プール プロバイダを作成して 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 のホーム ディレクトリにアップロードした場所であることを確認します。

The caller does not have permission

  • 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 のベース URL が正しいことを確認します。詳細については、IdP アプリケーションを構成するをご覧ください。

IdP トークンをデバッグする

Workforce Identity 連携の Debug IdP Token 機能を使用すると、ID プロバイダが正しい属性とクレームを渡していることを確認できます。これは、ログイン エラーや属性マッピング エラーを防ぐのに役立つため、ユーザーが Google SecOps にログインする前に強くおすすめします。

トークンをデバッグするには:

  1. Google Cloud コンソールで、[Workforce Identity 連携] に移動します。
  2. プールを選択してから、プロバイダを選択します。
  3. [Debug IdP Token] をクリックします。

この機能を使用して設定を検証する方法の詳細については、移行前の検証ガイドをご覧ください。

4 KB を超えるデバッグ JWT

Google SecOps へのログインで問題が発生した場合は、JSON ウェブトークン(JWT)が Google SecOps の 4 KB の上限を超えていないことを確認してください。「Authentication JWT larger than 4KB. このエラーを解決するには、IdP から送信されるグループ メンバーシップ データを減らしてください。」というエラー メッセージが表示された場合は、次のトラブルシューティングの手順を行います。

  1. トークンをデバッグする: Workforce Identity 連携内のプロバイダの詳細ページでトークンをデバッグできます([Workforce Identity 連携] > [Workforce プール] > [POOL_NAME] > [PROVIDER_NAME] に移動し、[IdP トークンをデバッグ] をクリックします)。この機能を使用するには、まず Google Cloud URL を ID プロバイダのリダイレクト URL に追加する必要があります。これは、SAML プロトコルと OIDC プロトコルの両方に適用されます。詳細については、Workforce Identity 連携のトラブルシューティングをご覧ください。
  2. グループ クレームをフィルタする: ID プロバイダが Google SecOps に関連しない多くのグループを送信する場合は、プロバイダ レベルでグループ クレームをフィルタします。Google SecOps に必要な最小限のグループセットのみを送信するように外部プロバイダを構成すると、JWT のサイズが小さくなり、認証エラーを回避できます。

    • 例(Microsoft Entra ID): Microsoft Entra グループ フィルタリングを使用すると、関連するグループの最小セットのみを送信できます。Entra エンタープライズ アプリケーションの [シングル サインオン] で、[グループ] クレームを編集してフィルタを適用し(接頭辞の一致など)、必要なグループのみが Google SecOps に送信されるようにします。詳細については、Microsoft Entra グループのフィルタリングをご覧ください。

次のステップ

このドキュメントの手順を完了したら、以下のことを行います。

さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。