Looker(Google Cloud コア)ユーザー認証に Workforce Identity 連携を使用する

Workforce Identity 連携を使用すると、外部 ID プロバイダ(IdP)を使用して、Looker(Google Cloud コア)インスタンスにユーザーとユーザー グループを認証できます。Workforce Identity 連携を使用すると、組織内のユーザーはシングル サインオン(SSO)を使用して Looker(Google Cloud コア)にアクセスできます。ユーザーごとに Google アカウント(Cloud Identity アカウントまたは Google Workspace アカウント)をプロビジョニングまたは同期する必要はありません。

Workforce Identity 連携は、OpenID Connect(OIDC)または SAML 2.0 を使用する外部 IdP(Microsoft Entra ID(旧称 Azure Active Directory)、Okta、Ping Identity など)をサポートしています。

Looker(Google Cloud コア)は、パブリック セキュア接続、プライベート接続、ハイブリッド接続を使用するインスタンスで Workforce Identity 連携をサポートしています。

Workforce Identity 連携と Looker(Google Cloud コア)の連携の仕組み

Looker(Google Cloud コア)インスタンスに Workforce Identity 連携を構成すると、次のプロセスが発生します。

  1. 認証: ユーザーが Looker(Google Cloud コア)インスタンスの URL に移動します。[ログインページをバイパスする] 設定が有効になっている場合、ユーザーは自動的に 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 コア)は、最初のログイン時にユーザー アカウントを作成し(ジャストインタイム プロビジョニング)、IdP から受け取ったクレームに基づいてグループからロールへのマッピングとユーザー属性を適用します。

始める前に

Looker(Google Cloud コア)の Workforce Identity 連携を構成する前に、次のロールと構成があることを確認してください。

必要な IAM のロール

Workforce Identity 連携を構成して Looker(Google Cloud コア)インスタンスを作成するには、次のロールが必要です。

必要な API

Google Cloud プロジェクトで次の API を有効にします。

ステップ 1: Workforce Identity プールとプロバイダを設定する

Workforce Identity プールとプロバイダは、プロジェクト レベルではなく、 Google Cloud組織レベルで作成されます。

Workforce Identity プールとプロバイダを設定する手順は次のとおりです。

  1. Workforce Identity 連携を構成するドキュメント ページの手順に沿って、Workforce Identity プールを作成します。
  2. OIDC または SAML 2.0 IdP の Workforce Identity プール プロバイダを作成します。
    • OIDC プロバイダについては、OIDC Workforce Identity 連携を構成するをご覧ください。
    • SAML プロバイダについては、SAML 2.0 Workforce Identity 連携を構成するをご覧ください。
    • プロバイダの作成時に、次の属性マッピングをすぐに定義します。
      • メール: IdP のメール クレームを google.email にマッピングします。このマッピングは、ユーザーの識別には必須です。このマッピングがない場合、認証は失敗します。
      • 氏名: IdP の名と姓のクレームを attribute.given_name(名)と attribute.family_name(姓)にマッピングします。これらのマッピングは、Looker ユーザー プロフィールを入力するために必要です。これらのマッピングがない場合、認証は失敗します。
  3. 必要に応じて、次の属性マッピングも構成します。

    • グループ: IdP のグループ クレーム(assertion.groups など)を google.groups にマッピングします。このマッピングは、グループ ミラーリングを有効にして、IdP グループを Looker ロールにマッピングする場合に必要です。OIDC プロバイダの場合、IdP で必要な場合は、プロバイダ構成でも groups スコープをリクエストするようにします(IdP 固有の要件については、Workforce Identity 連携を構成するをご覧ください)。
    • カスタム属性: カスタム IdP クレームを attribute.<attribute_name> にマッピングします。Looker(Google Cloud コア)でこれらのマッピングされた属性を使用して、データベース接続をパラメータ化し、行レベルのデータアクセス フィルタを適用できます。

拡張セッションの長さとバックグラウンド同期を設定する

中断のないブラウザ セッション、長時間実行されるスケジュール設定された配信、ユーザー API キー アクセス、コネクタ統合をサポートするには、次の手順を完了します。

  1. Google Cloud がバックグラウンドでユーザー属性とグループ メンバーシップを定期的に更新できるように、Workforce プール プロバイダでバックグラウンド属性の同期を構成します。
    • OIDC プロバイダの場合: offline_access スコープ(更新トークンを使用してユーザー属性とグループ メンバーシップを定期的に更新する)または SCIM 2.0 プロビジョニングを使用して、OIDC 認可コードフローを構成します。ユーザーが OIDC トークン サイズの上限を超える多数のグループに属している場合は、SCIM 2.0 プロビジョニングを構成して、グループ メンバーシップを Google Cloudに同期します。
    • SAML プロバイダの場合: Workforce プール プロバイダで SCIM 2.0 プロビジョニングを構成します。SAML アサーションは更新トークンをネイティブに提供しないため、オフラインのスケジュール配信とアラートを有効にするには SCIM 2.0 が必要です。
  2. Access Context Manager のクラウド バインディングを使用して、Workforce プールの拡張セッション長ポリシーを構成し、ポリシーを 90 日(7,776,000 秒)に設定します。

    このポリシーでは、最大セッション継続時間と更新トークンの有効期間を 90 日に設定します。拡張セッション継続時間ポリシーが構成されていないか、短い期間に設定されている場合、Workforce プールの更新トークンの有効期間が Looker のセッション継続時間の設定よりも優先されます。これにより、更新トークンの有効期限が切れると、ブラウザ セッション、オフライン スケジュール、ユーザー API キー、接続されたアプリケーションで再認証が必要になります。

ステップ 2: Workforce プリンシパルに IAM 権限を付与する

従業員ユーザーが Looker(Google Cloud コア)インスタンスにログインできるようにするには、Looker インスタンス ユーザー(roles/looker.instanceUser)または Looker 管理者(roles/looker.admin)の IAM ロールを従業員プリンシパルまたはグループに付与します。

次のプリンシパル ID を使用して、個々のユーザー、グループ全体、または Workforce プール内のすべてのプリンシパルにロールを付与できます。

  • 単一の Workforce ユーザー:

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

  • Workforce グループ:

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

  • Workforce プール内のすべてのプリンシパル:

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

IAM ロールの割り当ての詳細については、IAM を使用した Looker(Google Cloud コア)のアクセス制御のドキュメント ページをご覧ください。

ステップ 3: プライマリ認証方法として Workforce Identity 連携を選択する

Workforce Identity 連携は、新しい Looker(Google Cloud コア)インスタンスの作成時、または既存のインスタンスの編集時に、プライマリ認証方法として選択できます。

インスタンスの作成時

新しい Looker(Google Cloud コア)インスタンスを作成するときに、プライマリ認証方法として Workforce Identity 連携を選択できます。

Console

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

    Looker(Google Cloud コア)に移動

  2. [インスタンスを作成] をクリックします。
  3. パブリック セキュア接続、Private Service Connect 接続、またはプライベート サービス アクセス接続を使用するインスタンスの作成に関するドキュメントの説明に沿って、インスタンス名、リージョン、エディションの構成を完了します。
  4. [認証] セクションで、メインの認証方法として [Workforce Identity 連携(SAML / OIDC)] を選択します。
  5. [作成] をクリックします。

OAuth をセカンダリ認証方法として設定するには、インスタンスの作成後にインスタンス構成を編集します。

gcloud

--workforce-auth-enabled フラグを指定して gcloud looker instances create コマンドを使用し、Workforce Identity 連携をプライマリ認証方法として使用するインスタンスを作成します。

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 が必要です。--google-auth-enabled を指定せずに --workforce-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 コア)インスタンスがある場合は、インスタンス構成を編集して、Workforce Identity 連携をプライマリ認証方法として選択するか、OAuth をセカンダリ認証方法として設定できます。

Console

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

    Looker(Google Cloud コア)に移動

  2. 編集するインスタンスの名前をクリックします。
  3. インスタンスの [詳細] タブで、[編集] をクリックします。
  4. [認証] セクションで、メインの認証方法として [Workforce Identity 連携(SAML / OIDC)] を選択します。
  5. (省略可)OAuth をセカンダリ認証方法として許可するには、[セカンダリ OAuth を有効にする] を有効にします。
  6. [保存] をクリックします。

gcloud

--workforce-auth-enabled フラグを指定して gcloud looker instances update コマンドを使用し、Workforce Identity 連携をプライマリ認証方法として選択します。

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

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

  • INSTANCE_NAME: Looker(Google Cloud コア)インスタンスの名前。
  • PROJECT_ID: Looker(Google Cloud コア)インスタンスが配置されている Google Cloud プロジェクトの ID。
  • REGION: Looker(Google Cloud コア)インスタンスがホストされるリージョン。

--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 で Workforce Identity の設定を構成する

Looker(Google Cloud コア)インスタンスが作成されたら、管理者は Looker 管理パネルの [Workforce 認証] ページで、ユーザー属性マッピング、グループ ミラーリング、ログイン オプションを構成できます。

  1. 管理者の Looker ロールを持つアカウントで Looker(Google Cloud コア)インスタンスにログインします。
  2. ナビゲーション メニューで、[管理] > [認証] > [Workforce Identity] を選択します。
  3. 以降のセクションでの説明に沿って設定を構成します。

次の設定の詳細については、従業員認証ページのドキュメントをご覧ください。

ユーザー アカウントを統合する

[次を使用してユーザーを統合] フィールドで、ユーザーが Workforce Identity 連携を使用して初めてログインするときに、既存のユーザー アカウントを統合する認証システムを選択します。

統合がサポートされているシステムは次のとおりです。

  • Google
  • SAML
  • OIDC

ログインページをバイパスする

[ログインページをバイパスする] オプションは、認証されていないユーザーを企業の SSO ポータルに自動的にリダイレクトするかどうかを制御します。

  • 有効(デフォルト): ユーザーがインスタンス URL に移動すると、Looker ログインページが表示されずに、IdP ログイン画面に自動的にリダイレクトされます。
  • 無効: ユーザーに Looker のログインページが表示され、利用可能な認証オプションから選択できます。

[Save Configuration] をクリックして設定を適用します。

ユーザー属性のマッピング

IdP アサーションのクレームを Looker のユーザー属性にマッピングします。ユーザー属性は、データベース接続のパラメータ化や行レベルのセキュリティ フィルタの適用など、さまざまな用途に使用できます。

  • [属性のマッピング] セクションで、Google Workforce 属性を対応する Looker ユーザー属性にマッピングします(たとえば、attribute.department を Looker の department ユーザー属性にマッピングします)。

グループとロール

ユーザーロールは、グループ ミラーリングまたはデフォルトのロール割り当てによって管理できます。

  • IdP からのミラーグループ: この設定を有効にすると、Looker(Google Cloud コア)は、IdP トークン アサーションで渡されるグループをミラーリングする Looker グループを作成します。
    • [グループ マッピング] テーブルで、外部 IdP グループ名を Looker グループにマッピングし、適切な Looker ロール(閲覧者、ユーザー、デベロッパーなど)を割り当てます。
  • 新規ユーザーのデフォルトのロール: グループ ミラーリングが使用されていない場合、またはユーザーと一致しない場合は、新規ユーザーの初回ログイン時に付与されるデフォルトのロールを指定します。
  • デフォルトの新規ユーザー グループ: グループ ミラーリングが使用されていない場合、またはユーザーと一致しない場合は、新規ユーザーに割り当てるデフォルトのグループを指定します。

セッション管理とトークンの有効性

Looker(Google Cloud コア)のユーザー セッションとトークンは、Workforce Identity プール ポリシー(拡張セッション長ポリシーなど)に則って構成されたセッション継続時間と更新トークンの有効期間によって管理されます。

  • ブラウザ セッション: Looker のセッション継続時間の設定では、永続セッションを使用する場合、最大 30 日間のセッションがサポートされます。ただし、Workforce Identity プールの更新トークンの有効期間が Looker で構成されたセッション継続時間よりも短い場合は、Workforce Identity プールの更新トークンの有効期間が優先されます。更新トークンの有効期限が切れると、ユーザーは再度ログインする必要があります。拡張セッション期間ポリシーで、更新トークンの有効期間を 90 日に設定することをおすすめします。
  • スケジュール設定された配信とアラート(オフライン ジョブ): スケジュールのオーナーが有効な IdP トークンを持っている限り、バックグラウンド ジョブが実行されます。スケジュールまたはアラートの作成者が 90 日(または Workforce プールのセッション ポリシーで構成された期間)を超えてインスタンスにログインしない場合、オフライン セッションが期限切れになり、そのユーザーが所有するスケジュールされた配信またはアラートが一時停止されます。一時停止したスケジュールまたはアラートを再開するには、オーナーがインスタンスにログインするか、管理者がスケジュールのオーナー権限を割り当てる必要があります。
  • Looker OAuth サーバーとコネクタ: Looker OAuth サーバーを使用する統合(データポータル、コネクテッド シート、サードパーティ コネクタなど)では、30 日間の更新トークン(またはデータポータルの有効期限のない更新トークン)が使用されます。Workforce プールのセッション継続時間が 90 日未満に設定されている場合、セッション継続時間が終了すると、ユーザーは Looker で再認証が必要になることがあります。
  • ユーザー API キー: ユーザー API キーによって生成された API アクセス トークンは 1 時間有効で、アクティブなユーザー IdP セッションが必要です。ユーザーの IdP セッションが期限切れになると(90 日ごと、または Workforce プールのセッション継続時間に基づく)、ユーザーはインスタンスに再度ログインして API キーの使用を継続する必要があります。
  • サービス アカウント API キー: サービス アカウント API アクセス トークンは、Workforce プールのセッション ポリシーの影響を受けません。

次のステップ