Mit der Mitarbeiteridentitätsföderation können Sie einen externen Identitätsanbieter (Identity Provider, IdP) verwenden, um Nutzer und Nutzergruppen in einer Looker (Google Cloud Core)-Instanz zu authentifizieren. Mit der Mitarbeiteridentitätsföderation können Nutzer in Ihrer Organisation über die Einmalanmeldung (SSO) auf Looker (Google Cloud Core) zugreifen, ohne dass Sie für jeden Nutzer Google-Konten (Cloud Identity- oder Google Workspace-Konten) bereitstellen oder synchronisieren müssen.
Die Mitarbeiteridentitätsföderation unterstützt externe IdPs, die OpenID Connect (OIDC) oder SAML 2.0 verwenden, z. B. Microsoft Entra ID (früher Azure Active Directory), Okta, Ping Identity und andere.
Looker (Google Cloud Core) unterstützt die Mitarbeiteridentitätsföderation auf Instanzen, die öffentliche sichere Verbindungen, private Verbindungen oder Hybridverbindungen verwenden.
Funktionsweise der Mitarbeiteridentitätsföderation mit Looker (Google Cloud Core)
Wenn Sie die Mitarbeiteridentitätsföderation für eine Looker (Google Cloud Core)-Instanz konfigurieren, geschieht Folgendes:
- Authentifizierung: Ein Nutzer ruft die URL Ihrer Looker (Google Cloud Core)-Instanz auf. Wenn die Einstellung Anmeldeseite umgehen aktiviert ist, wird der Nutzer automatisch zum Anmeldeportal von Google Cloud (
https://auth.cloud.google/authorize) weitergeleitet, das den Nutzer zur Authentifizierung an Ihren externen IdP weiterleitet. - Tokenaustausch: Nachdem sich der Nutzer bei Ihrem IdP authentifiziert hat, gibt Ihr IdP eine Authentifizierungsassertion an den Google Cloud Security Token Service (STS) zurück. Der STS tauscht die Assertion gegen ein föderiertes Zugriffstoken und ein ID-Token aus.
- Autorisierung: Looker (Google Cloud Core) prüft, ob das föderierte Hauptkonto die erforderliche IAM-Berechtigung (Identity and Access Management) (
looker.instances.login) für die Instanz hat. - Bereitstellung und Rollenzuweisung: Looker (Google Cloud Core) erstellt das Nutzerkonto bei der ersten Anmeldung (Just-In-Time-Bereitstellung) und wendet Zuordnungen von Gruppen zu Rollen sowie Nutzerattribute an, die auf den Ansprüchen basieren, die es von Ihrem IdP erhält.
Hinweis
Bevor Sie die Mitarbeiteridentitätsföderation für Looker (Google Cloud Core) konfigurieren, müssen Sie die folgenden Rollen und Konfigurationen haben:
Erforderliche IAM-Rollen
Zum Konfigurieren der Mitarbeiteridentitätsföderation und zum Erstellen von Looker (Google Cloud Core)-Instanzen benötigen Sie die folgenden Rollen:
- IAM-Personalpool-Administrator (
roles/iam.workforcePoolAdmin): Erforderlich für die Organisation Google Cloud , um Personalpools und Anbieter zu erstellen und zu verwalten. - Looker-Administrator (
roles/looker.admin): Erforderlich für das Google Cloud-Projekt, um Looker (Google Cloud Core)-Instanzen zu erstellen und zu verwalten. - Projekt-IAM-Administrator (
roles/resourcemanager.projectIamAdmin): Erforderlich für das Projekt Google Cloud , um IAM-Rollen an Hauptkonten der Belegschaft zu gewähren.
Erforderliche APIs
Aktivieren Sie die folgenden APIs in Ihrem Google Cloud -Projekt:
Identity and Access Management API (
iam.googleapis.com)Security Token Service API (
sts.googleapis.com)Cloud Resource Manager API (
cloudresourcemanager.googleapis.com)Looker (Google Cloud Core) API (
looker.googleapis.com)
Schritt 1: Workforce Identity-Pool und -Anbieter einrichten
Workforce Identity-Pools und -Anbieter werden auf der Organisationsebene von Google Cloudund nicht auf Projektebene erstellt.
Führen Sie die folgenden Schritte aus, um einen Workforce Identity-Pool und einen Anbieter einzurichten:
- Erstellen Sie einen Workforce Identity-Pool. Folgen Sie dazu der Anleitung auf der Dokumentationsseite Mitarbeiteridentitätsföderation konfigurieren.
- Erstellen Sie einen Workforce Identity-Poolanbieter für Ihren OIDC- oder SAML 2.0-IdP:
- Informationen zu OIDC-Anbietern finden Sie unter OIDC-Mitarbeiteridentitätsföderation konfigurieren.
- Informationen zu SAML-Anbietern finden Sie unter SAML 2.0-Mitarbeiteridentitätsföderation konfigurieren.
- Definieren Sie die folgenden Attributzuordnungen direkt beim Erstellen des Anbieters:
- E-Mail: Ordnen Sie die E-Mail-Anforderung Ihres IdP
google.emailzu. Diese Zuordnung ist für die Nutzeridentifikation erforderlich. Wenn sie fehlt, schlägt die Authentifizierung fehl. - Vor- und Nachname: Ordnen Sie die Ansprüche für Vor- und Nachname Ihres IdP
attribute.given_name(Vorname) undattribute.family_name(Nachname) zu. Diese Zuordnungen sind erforderlich, um Looker-Nutzerprofile zu füllen. Wenn diese Zuordnungen fehlen, schlägt die Authentifizierung fehl.
- E-Mail: Ordnen Sie die E-Mail-Anforderung Ihres IdP
Optional können Sie auch die folgenden Attributzuordnungen konfigurieren:
- Gruppen: Ordnen Sie den Gruppenanspruch Ihres IdP (z. B.
assertion.groups)google.groupszu. Diese Zuordnung ist erforderlich, wenn Sie die Gruppenspiegelung aktivieren und IdP-Gruppen Looker-Rollen zuordnen möchten. Achten Sie bei OIDC-Anbietern darauf, dass in Ihrer Anbieterkonfiguration auch der Bereichgroupsangefordert wird, wenn Ihr IdP dies erfordert. Informationen zu IdP-spezifischen Anforderungen finden Sie unter Mitarbeiteridentitätsföderation konfigurieren. - Benutzerdefinierte Attribute: Ordnen Sie benutzerdefinierte IdP-Anforderungen
attribute.<attribute_name>zu. Sie können diese zugeordneten Attribute in Looker (Google Cloud Core) verwenden, um Datenbankverbindungen zu parametrisieren und Datenzugriffsfilter auf Zeilenebene anzuwenden.
- Gruppen: Ordnen Sie den Gruppenanspruch Ihres IdP (z. B.
Länge der erweiterten Sitzung und Hintergrundsynchronisierung konfigurieren
Führen Sie die folgenden Schritte aus, um unterbrechungsfreie Browsersitzungen, lang andauernde geplante Lieferungen, den Zugriff auf Nutzer-API-Schlüssel und Connector-Integrationen zu unterstützen:
- Konfigurieren Sie die Hintergrundsynchronisierung von Attributen bei Ihrem Anbieter von Personalpools, damit Google Cloud Nutzerattribute und Gruppenmitgliedschaften regelmäßig im Hintergrund aktualisiert werden können:
- Für OIDC-Anbieter: Konfigurieren Sie entweder den OIDC-Autorisierungscode-Vorgang mit dem Bereich
offline_access(der Aktualisierungstokens verwendet, um Nutzerattribute und Gruppenmitgliedschaften regelmäßig zu aktualisieren) oder die SCIM 2.0-Bereitstellung. Wenn Nutzer zu einer großen Anzahl von Gruppen gehören, die die Größenbeschränkungen für OIDC-Tokens überschreiten, konfigurieren Sie die SCIM 2.0-Bereitstellung, um Gruppenmitgliedschaften mit Google Cloudzu synchronisieren. - Für SAML-Anbieter: Konfigurieren Sie die SCIM 2.0-Bereitstellung bei Ihrem Personalpool-Anbieter. Da SAML-Assertions keine nativen Aktualisierungstokens bereitstellen, ist SCIM 2.0 erforderlich, um geplante Lieferungen und Benachrichtigungen offline zu ermöglichen.
- Für OIDC-Anbieter: Konfigurieren Sie entweder den OIDC-Autorisierungscode-Vorgang mit dem Bereich
Konfigurieren Sie für Ihren Workforce-Pool eine Richtlinie für eine verlängerte Sitzungsdauer mithilfe von Access Context Manager-Cloud-Bindungen und legen Sie die Richtlinie auf 90 Tage (7.776.000 Sekunden) fest.
Mit dieser Richtlinie werden die maximale Sitzungsdauer und die Gültigkeit des Aktualisierungstokens auf 90 Tage festgelegt. Wenn keine Richtlinie für die verlängerte Sitzungsdauer konfiguriert ist oder sie auf eine kürzere Dauer festgelegt ist, hat die Gültigkeit des Aktualisierungstokens für den Mitarbeiterpool Vorrang vor den Einstellungen für die Sitzungsdauer von Looker. Das bedeutet, dass für Browsersitzungen, Offline-Zeitpläne, Nutzer-API-Schlüssel und verbundene Anwendungen eine erneute Authentifizierung erforderlich ist, wenn das Aktualisierungstoken abläuft.
Schritt 2: IAM-Berechtigungen für Workforce-Hauptkonten gewähren
Damit sich Workforce-Nutzer in Ihrer Looker (Google Cloud Core)-Instanz anmelden können, weisen Sie Ihren Workforce-Hauptkonten oder -Gruppen die IAM-Rolle „Looker-Instanznutzer“ (roles/looker.instanceUser) oder „Looker-Administrator“ (roles/looker.admin) zu.
Sie können einzelnen Nutzern, ganzen Gruppen oder allen Hauptkonten in einem Workforce-Pool Rollen zuweisen. Verwenden Sie dazu die folgenden Hauptkonto-Kennungen:
Einzelner Workforce-Nutzer:
principal://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/subject/SUBJECT_ID
Personalpool:
principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/group/GROUP_ID
Alle Hauptkonten in einem Workforce-Pool:
principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/*
Weitere Informationen zum Zuweisen von IAM-Rollen finden Sie auf der Dokumentationsseite Zugriffssteuerung mit IAM für Looker (Google Cloud Core).
Schritt 3: Mitarbeiteridentitätsföderation als primäre Authentifizierungsmethode auswählen
Sie können die Mitarbeiteridentitätsföderation als primäre Authentifizierungsmethode auswählen, wenn Sie eine neue Looker (Google Cloud Core)-Instanz erstellen oder eine vorhandene Instanz bearbeiten.
Während der Instanzerstellung
Wenn Sie eine neue Looker (Google Cloud Core)-Instanz erstellen, können Sie die Mitarbeiteridentitätsföderation als primäre Authentifizierungsmethode auswählen:
Console
- Rufen Sie in der Google Cloud Console die Seite Looker (Google Cloud Core) auf.
- Klicken Sie auf INSTANZ ERSTELLEN.
- Konfigurieren Sie den Instanznamen, die Region und die Edition, wie in der Dokumentation zum Erstellen von Instanzen beschrieben, die öffentliche sichere Verbindungen, Private Service Connect-Verbindungen oder Verbindungen für den Zugriff auf private Dienste verwenden.
- Wählen Sie im Abschnitt Authentifizierung die Option Mitarbeiteridentitätsföderation (SAML/OIDC) als primäre Authentifizierungsmethode aus.
- Klicken Sie auf Erstellen.
Wenn Sie OAuth als sekundäre Authentifizierungsmethode festlegen möchten, bearbeiten Sie die Instanzkonfiguration, nachdem die Instanz erstellt wurde.
gcloud
Verwenden Sie den Befehl gcloud looker instances create mit dem Flag --workforce-auth-enabled, um eine Instanz zu erstellen, die die Mitarbeiteridentitätsföderation als primäre Authentifizierungsmethode verwendet:
gcloud looker instances create INSTANCE_NAME \ --project=PROJECT_ID \ --region=REGION \ --edition=EDITION \ --workforce-auth-enabled \ --async
Ersetzen Sie Folgendes:
INSTANCE_NAME: ein Name für Ihre Looker (Google Cloud Core)-Instanz. Er ist nicht mit der Instanz-URL verknüpft.PROJECT_ID: die ID des Google Cloud -Projekts, in dem Sie die Looker (Google Cloud Core)-Instanz erstellen.REGION: die Region, in der Ihre Looker-Instanz (Google Cloud Core) gehostet wird. Die verfügbaren Regionen sind auf der Seite Looker-Standorte (Google Cloud Core) aufgeführt.EDITION: die Version der Instanz. Eine Liste der verfügbaren Werte finden Sie unter Looker (Google Cloud Core)-Instanz mit öffentlichen sicheren Verbindungen erstellen.
In der Google Cloud CLI ist die Google-Authentifizierung standardmäßig aktiviert, wenn Sie keine Authentifizierungs-Flags angeben. Wenn die Google-Authentifizierung aktiviert ist, erfordert gcloud looker instances create --oauth-client-id und --oauth-client-secret. Wenn Sie --workforce-auth-enabled ohne --google-auth-enabled angeben, wird die Google-Authentifizierung auf der Instanz deaktiviert und Sie müssen keine OAuth-Anmeldedaten angeben.
Wenn Sie beim Erstellen der Instanz auch OAuth als sekundäre Authentifizierungsmethode zulassen möchten, fügen Sie die Flags --google-auth-enabled, --oauth-client-id und --oauth-client-secret hinzu:
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
Ersetzen Sie OAUTH_CLIENT_ID und OAUTH_CLIENT_SECRET durch die Client-ID und den Clientschlüssel Ihres OAuth-Clients.
Sie können dem Befehl weitere Flags hinzufügen, um andere Instanzeinstellungen wie Wartungsfenster und Release-Versionen anzuwenden oder private Netzwerke zu konfigurieren:
- Informationen zu öffentlichen sicheren Verbindungen finden Sie unter Looker (Google Cloud Core)-Instanz mit öffentlichen sicheren Verbindungen erstellen.
- Informationen zu Private Service Connect finden Sie unter Private Service Connect-Instanz erstellen.
- Informationen zum Zugriff auf private Dienste finden Sie unter Instanz für private Verbindungen (Zugriff auf private Dienste) erstellen.
Beim Bearbeiten einer vorhandenen Instanz
Wenn Sie eine vorhandene Looker (Google Cloud Core)-Instanz haben, können Sie die Instanzkonfiguration bearbeiten, um die Mitarbeiteridentitätsföderation als primäre Authentifizierungsmethode auszuwählen oder OAuth als sekundäre Authentifizierungsmethode festzulegen:
Console
- Rufen Sie in der Google Cloud Console die Seite Looker (Google Cloud Core) auf.
- Klicken Sie auf den Namen der Instanz, die Sie bearbeiten möchten.
- Klicken Sie auf dem Tab Details der Instanz auf Bearbeiten.
- Wählen Sie im Abschnitt Authentifizierung die Option Mitarbeiteridentitätsföderation (SAML/OIDC) als primäre Authentifizierungsmethode aus.
- (Optional) Wenn Sie OAuth als sekundäre Authentifizierungsmethode zulassen möchten, aktivieren Sie die Option Sekundäres OAuth aktivieren.
- Klicken Sie auf Speichern.
gcloud
Verwenden Sie den Befehl gcloud looker instances update mit dem Flag --workforce-auth-enabled, um die Mitarbeiteridentitätsföderation als primäre Authentifizierungsmethode auszuwählen:
gcloud looker instances update INSTANCE_NAME \ --project=PROJECT_ID \ --region=REGION \ --workforce-auth-enabled \ --no-google-auth-enabled \ --async
Ersetzen Sie Folgendes:
INSTANCE_NAME: der Name Ihrer Looker-Instanz (Google Cloud Core).PROJECT_ID: die ID des Google Cloud -Projekts, in dem sich die Looker-Instanz (Google Cloud Core) befindet.REGION: die Region, in der Ihre Looker-Instanz (Google Cloud Core) gehostet wird.
Mit dem Flag --no-google-auth-enabled wird die Google-Authentifizierung auf der Instanz deaktiviert. Wenn Sie OAuth als sekundäre Authentifizierungsmethode beibehalten möchten, ersetzen Sie das Flag --no-google-auth-enabled durch das Flag --google-auth-enabled. Wenn die Instanz noch keinen OAuth-Client hat, fügen Sie auch die Flags --oauth-client-id=OAUTH_CLIENT_ID und --oauth-client-secret=OAUTH_CLIENT_SECRET hinzu.
Schritt 4: Workforce Identity-Einstellungen in Looker konfigurieren
Nachdem Ihre Looker-Instanz (Google Cloud Core) erstellt wurde, kann ein Administrator auf der Seite Workforce-Authentifizierung im Looker-Admin-Bereich Nutzerattributzuordnungen, Gruppenspiegelung und Anmeldeoptionen konfigurieren.
- Melden Sie sich in Ihrer Looker (Google Cloud Core)-Instanz mit einem Konto an, das die Looker-Rolle Admin hat.
- Wählen Sie im Navigationsmenü Verwaltung > Authentifizierung > Workforce Identity aus.
- Konfigurieren Sie die in den folgenden Abschnitten beschriebenen Einstellungen.
Weitere Informationen zu den folgenden Einstellungen finden Sie in der Dokumentation auf der Seite Mitarbeiterauthentifizierung.
Nutzerkonten zusammenführen
Wählen Sie im Feld Nutzer zusammenführen mit die Authentifizierungssysteme aus, aus denen vorhandene Nutzerkonten zusammengeführt werden sollen, wenn sich ein Nutzer zum ersten Mal mit der Mitarbeiteridentitätsföderation anmeldet.
Folgende Systeme werden für die Zusammenführung unterstützt:
- SAML
- OIDC
Anmeldeseite umgehen
Mit der Option Anmeldeseite umgehen wird festgelegt, ob nicht authentifizierte Nutzer automatisch an Ihr SSO-Portal für Unternehmen weitergeleitet werden:
- Aktiviert (Standard): Wenn Nutzer die URL Ihrer Instanz aufrufen, werden sie automatisch zum Anmeldebildschirm Ihres IdP weitergeleitet, ohne die Looker-Anmeldeseite zu sehen.
- Deaktiviert: Nutzer sehen die Looker-Anmeldeseite und können zwischen den verfügbaren Authentifizierungsoptionen wählen.
Klicken Sie auf Konfiguration speichern, um die Einstellungen zu übernehmen.
Zuordnung von Nutzerattributen
Ordnen Sie Anforderungen aus Ihrer IdP-Assertion Nutzerattributen in Looker zu. Benutzerattribute können für viele Zwecke verwendet werden, z. B. zum Parametrisieren von Datenbankverbindungen und zum Anwenden von Sicherheitsfiltern auf Zeilenebene.
- Ordnen Sie im Abschnitt Attributzuordnung Google-Mitarbeiterattribute den entsprechenden Looker-Nutzerattributen zu (z. B.
attribute.departmenteinemdepartment-Nutzerattribut in Looker).
Gruppen und Rollen
Sie können Nutzerrollen über die Gruppenspiegelung oder Standardrollenzuweisungen verwalten:
- Gruppen vom IdP spiegeln: Wenn diese Einstellung aktiviert ist, erstellt Looker (Google Cloud Core) Looker-Gruppen, die Gruppen spiegeln, die in der IdP-Token-Assertion übergeben werden.
- Ordnen Sie in der Tabelle Gruppenzuordnung externe IdP-Gruppennamen Looker-Gruppen zu und weisen Sie entsprechende Looker-Rollen zu (z. B. Betrachter, Nutzer oder Entwickler).
- Standardrolle für neue Nutzer: Wenn die Gruppenspiegelung nicht verwendet wird oder nicht mit einem Nutzer übereinstimmt, geben Sie die Standardrolle an, die neuen Nutzern bei der ersten Anmeldung zugewiesen werden soll.
- Standardgruppe für neue Nutzer: Wenn die Gruppenspiegelung nicht verwendet wird oder nicht mit einem Nutzer übereinstimmt, geben Sie die Standardgruppe an, die neuen Nutzern zugewiesen werden soll.
Sitzungsverwaltung und Tokengültigkeit
Nutzersitzungen und Tokens in Looker (Google Cloud Core) unterliegen der Sitzungsdauer und der Gültigkeit des Aktualisierungstokens, die in der Richtlinie für Ihren Workforce Identity-Pool konfiguriert sind (z. B. eine Richtlinie für eine verlängerte Sitzungsdauer):
- Browsersitzungen: Die Einstellungen für die Sitzungsdauer in Looker unterstützen Sitzungen von bis zu 30 Tagen, wenn persistente Sitzungen verwendet werden. Die Gültigkeit des Aktualisierungstokens des Workforce Identity-Pools hat jedoch Vorrang, wenn sie kürzer ist als die in Looker konfigurierte Sitzungsdauer. Wenn das Aktualisierungstoken abläuft, muss sich der Nutzer noch einmal anmelden. Wir empfehlen, in der Richtlinie für die verlängerte Sitzungsdauer eine Gültigkeit des Aktualisierungstokens von 90 Tagen festzulegen.
- Geplante Lieferungen und Benachrichtigungen (Offlinejobs): Hintergrundjobs werden so lange ausgeführt, wie der Inhaber des Zeitplans ein aktives IdP-Token hat. Wenn sich der Ersteller eines Zeitplans oder einer Benachrichtigung länger als 90 Tage (oder die in der Sitzungsrichtlinie für den Workforce-Pool konfigurierte Dauer) nicht bei der Instanz anmeldet, läuft seine Offlinesitzung ab und geplante Lieferungen oder Benachrichtigungen, die diesem Nutzer gehören, werden pausiert. Wenn Sie pausierte Zeitpläne oder Benachrichtigungen fortsetzen möchten, muss sich der Inhaber in der Instanz anmelden oder ein Administrator muss die Inhaberschaft des Zeitplans zuweisen.
- Looker-OAuth-Server und -Connectors: Integrationen, die den Looker-OAuth-Server verwenden (z. B. Data Studio, verbundene Tabellenblätter und Connectors von Drittanbietern), verwenden ein 30-tägiges Aktualisierungstoken (oder ein nicht ablaufendes Aktualisierungstoken in Data Studio). Wenn die Sitzungsdauer des Personalpools auf weniger als 90 Tage festgelegt ist, müssen sich Nutzer möglicherweise noch einmal bei Looker authentifizieren, wenn die Sitzungsdauer abläuft.
- Nutzer-API-Schlüssel: API-Zugriffstokens, die von Nutzer-API-Schlüsseln generiert werden, sind eine Stunde lang gültig und erfordern eine aktive IdP-Sitzung des Nutzers. Wenn die IdP-Sitzung des Nutzers abläuft (alle 90 Tage oder basierend auf der Sitzungsdauer des Workforce-Pools), muss sich der Nutzer noch einmal bei der Instanz anmelden, um seine API-Schlüssel weiterhin verwenden zu können.
- Dienstkonto-API-Schlüssel: Dienstkonto-API-Zugriffstokens sind von Sitzungsrichtlinien für Personalpools nicht betroffen.
Nächste Schritte
- Nutzer in Looker (Google Cloud Core) verwalten
- Zugriffssteuerung für Looker (Google Cloud Core) mit IAM
- Wartungsrichtlinien für eine Looker (Google Cloud Core)-Instanz verwalten