Google OAuth für die Nutzerauthentifizierung in Looker (Google Cloud Core) verwenden

Sie können Google OAuth in Kombination mit Identity and Access Management (IAM) verwenden, um Nutzer in Ihrer Looker (Google Cloud Core)-Instanz zu authentifizieren. In Looker (Google Cloud Core) werden Nutzer über das OAuth 2.0-Protokoll authentifiziert. Es werden alle kompatiblen OAuth 2.0-Clients unterstützt. Wenn eine andere Methode die primäre Form der Authentifizierung ist, dient Google OAuth als Standard-Backup-Authentifizierungsmethode.

Authentifizierung und Autorisierung mit OAuth und IAM

In Kombination mit OAuth bieten IAM-Rollen für Looker (Google Cloud Core) die folgenden Authentifizierungs- und Autorisierungsstufen für alle Looker (Google Cloud Core)-Instanzen in einem bestimmten Google Cloud -Projekt. Weisen Sie jedem Ihrer Hauptkonten eine der folgenden IAM-Rollen zu, je nachdem, welche Zugriffsebene Sie ihnen gewähren möchten:

IAM-Rolle Authentifizierung Autorisierung
Looker Instance User (roles/looker.instanceUser)

Kann sich in Looker (Google Cloud Core)-Instanzen anmelden

Bei der ersten Anmeldung in Looker (Google Cloud Core) wird die Standard-Looker-Rolle zugewiesen, die unter Rollen für neue Nutzer festgelegt ist.

In der Google Cloud -Konsole kann nicht auf Looker (Google Cloud Core)-Ressourcen zugegriffen werden.

Looker-Betrachter (roles/looker.viewer) Kann sich in Looker (Google Cloud Core)-Instanzen anmelden Bei der ersten Anmeldung in Looker (Google Cloud Core) wird die Standard-Looker-Rolle zugewiesen, die unter Rollen für neue Nutzer festgelegt ist.

Kann die Liste der Looker (Google Cloud Core)-Instanzen und Instanzdetails in der Google Cloud Console ansehen
Looker-Administrator (roles/looker.admin) Kann sich in Looker (Google Cloud Core)-Instanzen anmelden Bei der ersten Anmeldung in Looker (Google Cloud Core) wird die Standard-Looker-Rolle zugewiesen, die unter Rollen für neue Nutzer festgelegt ist.

Diese Rolle wird bei jeder Anmeldung bei Looker (Google Cloud Core) mit primärem OAuth oder Backup-OAuth und bei jedem Aufruf der Looker API durch den Nutzer überprüft. Sie gewährt auch die Rolle Administrator über IAM innerhalb der Instanz. Sie können auch eine benutzerdefinierte Rolle mit der Berechtigung looker.instances.update verwenden.

Die Rolle „Admin über IAM“ enthält alle Berechtigungen und Funktionen der Looker-Rolle Admin. Diese Rolle kann innerhalb der Looker (Google Cloud Core)-Instanz nicht entfernt oder neu zugewiesen werden. Wenn Sie die Administratorrolle über die IAM-Rolle entfernen möchten, weisen Sie dem Hauptkonto eine andere IAM-Rolle als „Looker-Administrator“ (roles/looker.admin) zu. Änderungen an IAM-Rollen werden automatisch mit der Looker (Google Cloud Core)-Instanz synchronisiert, auch wenn sich der Nutzer nach der Änderung mit einem Drittanbieter-Identitätsanbieter anmeldet. Weitere Informationen finden Sie im Abschnitt Looker-Rolle „Admin“ im Vergleich zur Looker-Rolle „Admin“ über IAM.

Solange das OAuth-Aktualisierungstoken eines Nutzers gültig ist, wird die Rolle des Nutzers in Looker (Google Cloud Core) als „Admin über IAM“ angezeigt, auch wenn sich dieser Nutzer später mit einem Drittanbieter-Identitätsanbieter anmeldet. Wenn das OAuth-Aktualisierungstoken abläuft oder widerrufen wird, muss sich der Nutzer noch einmal über OAuth in der Instanz anmelden, um die Rolle „Administrator über IAM“ wiederzuerlangen.

Kann alle Verwaltungsaufgaben für Looker (Google Cloud Core) in der Google Cloud Console ausführen

Außerdem können sich Nutzerkonten mit der Rolle owner für ein Projekt in allen Looker (Google Cloud Core)-Instanzen in diesem Projekt anmelden und diese verwalten. Diesen Nutzern werden die Looker-Rollen Admin und Admin via IAM zugewiesen.

Wenn die vordefinierten Rollen nicht die gewünschten Berechtigungen bieten, können Sie auch eigene benutzerdefinierte Rollen erstellen.

Wenn Sie Nutzern in der Google Cloud Console umfassende Berechtigungen gewähren möchten, ohne ihnen die IAM-Rolle „Admin via IAM Looker“ zuzuweisen, erstellen Sie eine benutzerdefinierte IAM-Rolle, die die erforderlichen Berechtigungen enthält, aber die Berechtigung looker.instances.update ausschließt.

Looker (Google Cloud Core)-Konten werden bei der ersten Anmeldung bei einer Looker (Google Cloud Core)-Instanz erstellt.

Looker-Rolle „Admin“ im Vergleich zur Looker-Rolle „Admin“ über IAM

In einer Looker (Google Cloud Core)-Instanz gibt es zwei Rollen, die den Berechtigungssatz für Administratoren verwenden und dieselben Administratorberechtigungen innerhalb der Instanz gewähren. In der folgenden Tabelle sind die Ähnlichkeiten und Unterschiede zwischen den beiden Rollen zusammengefasst.

Attribut Looker-Administratorrolle Admin über IAM-Looker-Rolle
Zuverlässige Quelle Von einem anderen Administrator in der Looker (Google Cloud Core)-Instanz gewährt Direkt mit der IAM-Rolle „Looker Admin“ verknüpft
Können innerhalb einer Looker (Google Cloud Core)-Instanz hinzugefügt oder entfernt werden? Ja Nein
Kann mit IAM hinzugefügt oder entfernt werden? Nein Ja
Berechtigungen in Looker (Google Cloud Core) Alle Berechtigungen Alle Berechtigungen
Berechtigungen in der Google Cloud Console Keine Vollständiger Zugriff auf alle Looker (Google Cloud Core)-Ressourcen
Rollenvalidierung Kontinuierlich innerhalb der Looker (Google Cloud Core)-Instanz Bei jeder Anmeldung bei der Looker (Google Cloud Core)-Instanz und bei jedem Looker API-Aufruf.

Es kann einige Minuten dauern, bis Änderungen an einer Rolle mit IAM übernommen werden.
Umfang Einzelne Looker (Google Cloud Core)-Instanz Alle Looker (Google Cloud Core)-Instanzen in einem Google Cloud -Projekt

Ein Nutzer kann sowohl die Looker-Rolle „Admin“ als auch die Looker-Rolle „Admin via IAM“ haben. Wenn Sie also Administratorberechtigungen widerrufen möchten, müssen Sie sowohl die IAM-Rolle als auch die Administratorrolle in der Looker (Google Cloud Core)-Instanz entfernen. Wenn Sie die IAM-Berechtigungen eines Nutzers beibehalten, aber seine Rolle „Admin über IAM“ in Looker (Google Cloud Core) entfernen möchten (z. B. wenn Sie Nutzer zu einem externen Identitätsanbieter migrieren), lesen Sie den Abschnitt Rolle „Admin über IAM“ entfernen.

OAuth in der Looker (Google Cloud Core)-Instanz konfigurieren

In der Looker (Google Cloud Core)-Instanz können Sie auf der Seite Google-Authentifizierung im Abschnitt Authentifizierung des Menüs Admin einige Google OAuth-Einstellungen konfigurieren. Sie benötigen die Looker-Rolle Admin.

Nutzerkonten zusammenführen

Geben Sie im Feld Nutzer zusammenführen mit die Methode an, mit der eine erstmalige OAuth-Anmeldung mit einem bestehenden Nutzerkonto zusammengeführt werden soll. Wenn sich ein Nutzer zum ersten Mal über OAuth anmeldet, wird mit dieser Option eine Verbindung zu seinem bestehenden Konto hergestellt, indem das Konto mit einer übereinstimmenden E‑Mail-Adresse gesucht wird. Wenn für den Nutzer kein Konto vorhanden ist, wird ein neues Nutzerkonto erstellt.

Sie können Nutzer aus den folgenden Systemen zusammenführen:

  • SAML
  • OIDC

Wenn Sie mehr als ein System verwenden, können Sie in diesem Feld mehrere Systeme angeben, nach denen zusammengeführt werden soll. Looker (Google Cloud Core) sucht nach Nutzern aus den aufgeführten Systemen in der Reihenfolge, in der die Systeme angegeben sind. Wenn Sie beispielsweise zuerst einige Nutzer mit OIDC erstellt und später SAML verwendet haben, sucht Looker (Google Cloud Core) beim ersten Anmeldeversuch eines Nutzers mit OAuth zuerst nach dem Nutzer mit OIDC. Wenn keine Übereinstimmung für den Nutzer mit OIDC gefunden wird, sucht Looker (Google Cloud Core) nach dem Nutzer mit SAML.

Wenn Sie nicht möchten, dass Looker (Google Cloud Core) Nutzer zusammenführt, lassen Sie dieses Feld leer.

Migration zwischen OIDC-Identitätsanbietern

Wenn Sie von einem OIDC-Identitätsanbieter zu einem anderen migrieren (z. B. von PingFederate zu Okta), gilt die Option zum Zusammenführen von Konten, die unter Nutzerkonten zusammenführen beschrieben wird, nicht. Die Zusammenführung ist nur möglich, wenn Sie zwischen verschiedenen Authentifizierungstypen wechseln, z. B. von SAML zu OIDC.

Looker (Google Cloud Core) verwendet die sub-Anforderung aus der OIDC-Nutzlast, um das Nutzerattribut oidc_user_id zu füllen, das OIDC-Nutzerkonten eindeutig identifiziert. Damit Looker (Google Cloud Core) während einer OIDC-Migration keine doppelten Nutzerkonten generiert, konfigurieren Sie Ihren neuen OIDC-Identitätsanbieter so, dass die in der OIDC-Nutzlast gesendete sub-Anforderung mit der oidc_user_id übereinstimmt, die von Ihrem vorherigen Anbieter festgelegt wurde. Die sub-Anforderung sollte beispielsweise die E-Mail-Adresse des Nutzers anstelle einer neu generierten UUID enthalten.

Wenn es nicht möglich ist, identische sub-Ansprüche beim neuen Identitätsanbieter beizubehalten, werden neue Nutzerkonten erstellt. In diesem Szenario können Sie die Looker API verwenden, um favorisierte Inhalte abzurufen und Zeitpläne von den vorherigen Benutzerkonten den neuen Benutzerkonten zuzuweisen, bevor Sie die vorherigen Konten löschen.

Google-Gruppen spiegeln

Wenn Sie Google Groups verwalten, kann Looker (Google Cloud Core) Looker-Gruppen erstellen, die die Mitgliedschaft Ihrer Google Groups widerspiegeln. Das bedeutet, dass Sie Nutzer nicht direkt in Looker (Google Cloud Core) einrichten müssen, sondern den Nutzerzugriff über die Mitgliedschaft in den Google-Gruppen verwalten können. Darüber hinaus können Looker-Gruppen verwendet werden, um Gruppenmitgliedern Rollen zuzuweisen, Zugriffssteuerungen für Inhalte festzulegen, den Zugriff auf Funktionen und Daten zu steuern und Nutzerattribute zuzuweisen.

Damit die Gruppenspiegelung ordnungsgemäß funktioniert, benötigen Nutzer die Berechtigung VIEW_MEMBERSHIP, mit der sie die Mitgliedschaft der Google-Gruppen sehen können, zu denen sie gehören. Wenn Sie diese Berechtigung in den Einstellungen der Google Groups-Benutzeroberfläche erteilen möchten, legen Sie für das Feld Wer darf die Mitgliederliste sehen? die Option Gruppenmitglieder fest.

Looker (Google Cloud Core) wendet die gespiegelten Looker-Gruppen (und alle zugehörigen Rollen und Zugriffsrechte) an, wenn sich Nutzer in der Looker (Google Cloud Core)-Instanz anmelden. Änderungen an Gruppenmitgliedschaften in Google Groups werden bei der nächsten Anmeldung des jeweiligen Nutzers aktualisiert.

Die Looker-Rolle Admin via IAM, die Nutzern mit der Rolle Looker Admin im IAM-System automatisch zugewiesen wird, überschreibt die Gruppenspiegelung. Nutzern mit der Rolle Looker-Administrator im IAM-System wird automatisch die Rolle Administrator über IAM in Looker (Google Cloud Core) zugewiesen, unabhängig davon, in welchen Gruppen sie Mitglied sind. Außerdem werden diese Nutzer gespiegelten Gruppen zugewiesen und erhalten Rollen und Zugriff über den standardmäßigen Spiegelungsprozess.

Wir empfehlen, die Gruppenspiegelung nur für die primäre Authentifizierungsmethode für Looker (Google Cloud Core) zu aktivieren. Wenn Sie OAuth als Backup-Authentifizierungsmethode verwenden, aktivieren Sie die Gruppenspiegelung für OAuth nicht. Wenn Sie die Gruppenspiegelung sowohl für die primäre als auch für die sekundäre Authentifizierungsmethode aktivieren, gilt Folgendes:

  • Wenn ein Nutzer zusammengeführte Identitäten hat, wird die primäre Authentifizierungsmethode unabhängig von der tatsächlich für die Anmeldung verwendeten Authentifizierungsmethode gespiegelt.
  • Wenn ein Nutzer keine zusammengeführten Identitäten hat, wird bei der Gruppenspiegelung die Authentifizierungsmethode verwendet, die für die Anmeldung verwendet wurde.

Schritte zum Aktivieren gespiegelter Gruppen

So aktivieren Sie die Gruppenspiegelung:

  1. Aktivieren Sie in der Google Cloud Console die Cloud Identity API im Google Cloud -Projekt, das Ihren OAuth-Client enthält. Sie benötigen die IAM-Rolle Service Usage-Administrator (roles/serviceusage.serviceUsageAdmin), um APIs zu aktivieren.

    API aktivieren

  2. Aktualisieren Sie in der Google Cloud Console den Zustimmungsbildschirm des OAuth-Clients, um den https://www.googleapis.com/auth/cloud-identity.groups.readonly-Bereich hinzuzufügen. Sie benötigen die IAM-Berechtigung clientauthconfig.clients.update, um Bereiche hinzuzufügen. Führen Sie die folgenden Schritte aus, um den Zustimmungsbildschirm zu aktualisieren:

    • Rufen Sie den OAuth-Client auf.
    • Wählen Sie die Seite Datenzugriff aus.
    • Klicken Sie auf den Button Bereiche hinzufügen oder entfernen. Dadurch wird der Bereich Ausgewählte Bereiche aktualisieren geöffnet.
    • Suchen Sie den Bereich https://www.googleapis.com/auth/cloud-identity.groups.readonly und klicken Sie das Kästchen daneben an.
    • Klicken Sie auf den Button Aktualisieren, um den Bereich hinzuzufügen.
    • Schließen Sie den Bereich und klicken Sie auf der Seite Datenzugriff auf Speichern, um den Bereich zu speichern.

  3. Aktivieren Sie in der Looker-Instanz (Google Cloud Core) auf der Seite Google-Authentifizierung die Option Google-Gruppen spiegeln. Diese Einstellung ist standardmäßig deaktiviert. Füllen Sie die folgenden Felder aus:

    • Geben Sie im Feld Looker-Gruppenname einen Namen für die Looker-Gruppe ein. Dieser Name wird in Looker (Google Cloud Core) auf der Seite Gruppen angezeigt.
    • Geben Sie im Feld Google Group ID (Google Groups-ID) den Namen oder die E-Mail-Adresse der Google-Gruppe ein, die Sie spiegeln möchten.
    • Geben Sie im Feld Rolle die Looker-Rolle oder -Rollen ein, die Sie den Mitgliedern dieser Gruppe zuweisen möchten.

Looker (Google Cloud Core) erstellt für jede Google-Gruppe, die auf der Seite Google-Authentifizierung hinzugefügt wird, eine Looker-Gruppe. Sie können diese Looker-Gruppen in Looker (Google Cloud Core) auf der Seite Gruppen aufrufen.

Gespiegelte Gruppen bearbeiten

Wenn Sie Änderungen an einer Google Groups-Mitgliedschaft vornehmen, werden diese Änderungen automatisch an die Mitgliedschaft der gespiegelten Looker-Gruppe weitergegeben und bei der nächsten Anmeldung des jeweiligen Nutzers validiert.

Wenn Sie die Felder Benutzerdefinierter Name oder Rolle bearbeiten, die einer Gruppe auf der Seite Google-Authentifizierung zugewiesen sind, ändert sich dadurch die Darstellung des Namens der gespiegelten Looker-Gruppe auf der Seite Gruppen von Looker (Google Cloud Core) oder die der Gruppe zugewiesenen Rollen. Die Gruppenmitglieder ändern sich jedoch nicht.

Wenn Sie den Namen oder die E-Mail-Adresse im Feld Google-Gruppen-ID auf der Seite Google-Authentifizierung in die ID einer neuen Google-Gruppe ändern, werden die Mitglieder der gespiegelten Looker-Gruppe in die Mitglieder der neuen Google-Gruppe geändert. Der Gruppenname und die Rollen, die auf der Seite Google-Authentifizierung definiert sind, bleiben jedoch erhalten.

Alle Änderungen, die an einer gespiegelten Gruppe vorgenommen werden, werden auf die Nutzer dieser Gruppe angewendet, wenn sie sich das nächste Mal in Looker (Google Cloud Core) anmelden.

Gespiegelte Gruppen deaktivieren

Wenn Sie Ihre Google-Gruppen nicht mehr in Looker (Google Cloud Core) spiegeln möchten, deaktivieren Sie die Option Google-Gruppen spiegeln auf der Seite Google-Authentifizierung der Looker (Google Cloud Core)-Instanz. Wenn Sie die Option deaktivieren, hat das folgende Auswirkungen:

  • Alle gespiegelten Google-Gruppen ohne Nutzer werden sofort gelöscht.
  • Alle gespiegelten Google-Gruppen, die Nutzer enthalten, werden als verwaist markiert. Wenn sich innerhalb von 31 Tagen keine Nutzer dieser Gruppe anmelden, wird die Gruppe gelöscht. Nutzer können verwaisten Google-Gruppen nicht mehr hinzugefügt oder daraus entfernt werden.

Erweiterte Rollenverwaltung

Wenn die Option Google Groups spiegeln aktiviert ist, werden auf der Seite Google-Authentifizierung die Einstellungen für die Erweiterte Rollenverwaltung angezeigt. Die Optionen in diesem Abschnitt bestimmen, wie flexibel Looker-Administratoren beim Konfigurieren von Looker-Gruppen und -Nutzern sind, die von Google gespiegelt wurden.

Wenn die Konfiguration Ihrer Looker-Gruppen und -Nutzer genau mit der Konfiguration Ihrer Google-Gruppen übereinstimmen soll, aktivieren Sie alle Optionen für die erweiterte Rollenverwaltung. Wenn alle Optionen aktiviert sind, können Looker-Administratoren die Mitgliedschaften in gespiegelten Gruppen nicht ändern und Nutzern nur über Google-Gruppen Rollen zuweisen.

Wenn Sie mehr Flexibilität beim Anpassen Ihrer Gruppen in Looker (Google Cloud Core) wünschen, deaktivieren Sie diese Optionen. Ihre Looker-Gruppen (Google Cloud Core) spiegeln weiterhin Ihre Google Groups-Konfiguration wider. Sie können jedoch zusätzliche Gruppen- und Nutzerverwaltungsaufgaben in Looker (Google Cloud Core) ausführen, z. B. Google-Nutzer zu Looker-Gruppen hinzufügen oder Google-Nutzern direkt Looker-Rollen zuweisen.

Für Looker (Google Cloud Core)-Instanzen sind diese Optionen standardmäßig deaktiviert.

Der Abschnitt Erweiterte Rollenverwaltung enthält die folgenden Optionen:

  • Verhindern, dass einzelne Google-Nutzer direkte Rollen erhalten: Wenn Sie diese Option aktivieren, können Looker-Administratoren Google-Nutzern keine Looker-Rollen direkt zuweisen. Google-Nutzer erhalten Rollen nur über ihre Gruppenmitgliedschaften. Wenn Google-Nutzer Mitglied in integrierten (nicht gespiegelten) Looker-Gruppen sein dürfen, können sie ihre Rollen weiterhin sowohl von gespiegelten Google-Gruppen als auch von integrierten Looker-Gruppen übernehmen. Bei allen Google-Nutzern, denen zuvor direkt Rollen zugewiesen wurden, werden diese Rollen bei der nächsten Anmeldung entfernt.

    Wenn diese Option deaktiviert ist, können Looker-Administratoren Google-Nutzern in der Looker (Google Cloud Core)-Instanz direkt Looker-Rollen zuweisen.

  • Direkte Mitgliedschaft in nicht von Google verwalteten Gruppen verhindern: Mit dieser Option wird verhindert, dass Looker-Administratoren Mitglieder gespiegelter Gruppen direkt zu integrierten Looker-Gruppen hinzufügen, die nicht Teil der Konfiguration der gespiegelten Gruppe auf der Seite Google-Authentifizierung sind.

    Wenn diese Option ausgewählt ist, werden alle Google-Nutzer, die zuvor integrierten Looker-Gruppen zugewiesen waren, bei der nächsten Anmeldung aus diesen Gruppen entfernt.

    Wenn diese Option deaktiviert ist, können Looker-Administratoren Google-Nutzer direkt zu integrierten Looker-Gruppen hinzufügen.

  • Übernahme von Rollen aus nicht von Google verwalteten Gruppen verhindern: Mit dieser Option wird verhindert, dass Mitglieder gespiegelter Gruppen Rollen von integrierten Looker-Gruppen übernehmen. Wenn gespiegelte Google-Gruppen Mitglieder von integrierten Looker-Gruppen sein dürfen, können Google-Nutzer Mitglied in integrierten Looker-Gruppen bleiben. Alle Google-Nutzer, die zuvor Rollen von einer integrierten Looker-Gruppe übernommen haben, verlieren diese Rollen bei der nächsten Anmeldung.

    Wenn diese Option deaktiviert ist, erben gespiegelte Gruppen oder Google-Nutzer, die als Mitglieder einer integrierten Looker-Gruppe hinzugefügt werden, die Rollen, die der integrierten Looker-Gruppe zugewiesen sind.

  • Auth Requires Role (Authentifizierung erfordert Rolle): Wenn diese Option aktiviert ist, muss Google-Nutzern eine Looker-Rolle zugewiesen sein. Google-Nutzer, denen keine Rolle zugewiesen ist, können sich überhaupt nicht in Looker (Google Cloud Core) anmelden.

    Wenn diese Option deaktiviert ist, können sich Google-Nutzer bei Looker (Google Cloud Core) authentifizieren, auch wenn ihnen keine Rolle zugewiesen ist. Ein Nutzer ohne zugewiesene Rolle kann in Looker (Google Cloud Core) keine Daten sehen oder Aktionen ausführen, sich aber in Looker (Google Cloud Core) anmelden.

Standard-Looker-Rolle festlegen

Wenn die Option Google-Gruppen spiegeln deaktiviert ist, wird die Einstellung Rollen für neue Nutzer auf der Seite Google-Authentifizierung angezeigt. Mit dieser Einstellung können Sie die standardmäßige Looker-Rolle festlegen, die Nutzerkonten mit der IAM-Rolle „Looker-Instanznutzer“ (roles/looker.instanceUser) oder der IAM-Rolle „Looker-Betrachter“ (roles/looker.viewer) bei der ersten Anmeldung in einer Looker (Google Cloud Core)-Instanz zugewiesen wird. So legen Sie eine Standardrolle fest:

  1. Rufen Sie im Menü Verwaltung im Bereich Authentifizierung die Seite Google-Authentifizierung auf.
  2. Wählen Sie in der Einstellung Rollen für neue Nutzer die Rolle aus, die Sie allen neuen Nutzern standardmäßig zuweisen möchten. Die Einstellung enthält eine Liste aller Standardrollen und benutzerdefinierten Rollen in der Looker (Google Cloud Core)-Instanz.

Administratorrollen können keine Standardrollen sein. Nutzerkonten mit der IAM-Rolle „Looker Admin“ (roles/looker.admin) erhalten bei der ersten Anmeldung zusätzlich zu der in der Einstellung Rollen für neue Nutzer ausgewählten Rolle die Looker-Rolle Admin über IAM.

Wenn Sie die Einstellung Google Groups spiegeln aktivieren, nachdem Sie die Einstellung Rollen für neue Nutzer angepasst haben, werden die Rollen, die Nutzern über die Einstellung Rollen für neue Nutzer zugewiesen wurden, bei der nächsten Anmeldung entfernt und durch die Rollen ersetzt, die über die Einstellung Google Groups spiegeln zugewiesen wurden.

Nutzerauthentifizierung testen

Klicken Sie auf den Button Test Google Authentication (Google-Authentifizierung testen), um Ihre Einstellungen zu testen. Tests werden an den OAuth-Server von Google weitergeleitet und öffnen einen Browsertab. Auf dem Tab werden die folgenden Informationen angezeigt:

  • Ob Looker (Google Cloud Core) mit dem Server kommunizieren und die Validierung durchführen konnte.
  • Die Nutzerinformationen, die Looker (Google Cloud Core) vom Server erhält. Sie müssen prüfen, ob der Server die richtigen Ergebnisse zurückgibt.
  • Ein Trace, der zeigt, wie die Informationen gefunden wurden. Verwenden Sie den Trace zur Fehlerbehebung, wenn die Informationen falsch sind. Wenn Sie weitere Informationen benötigen, können Sie die XML-Rohdatei des Servers lesen.
  • Sowohl die decodierte als auch die Rohversion des empfangenen ID-Tokens. Diese können verwendet werden, um Nutzerdetails sowie die Google-Konfiguration zu bestätigen.

Speichern und Einstellungen anwenden

Wenn Sie alle Informationen eingegeben haben und alle Tests erfolgreich waren, setzen Sie ein Häkchen bei Ich habe die obige Konfiguration bestätigt und möchte sie global anwenden und klicken Sie auf Senden, um die Änderungen zu speichern.

Nutzer zu einer Looker (Google Cloud Core)-Instanz hinzufügen

Nachdem eine Looker (Google Cloud Core)-Instanz erstellt wurde, können Nutzer über IAM hinzugefügt werden. So fügen Sie Nutzer hinzu:

  1. Sie benötigen die Rolle Project IAM Admin oder eine andere Rolle, mit der Sie den IAM-Zugriff verwalten können.
  2. Rufen Sie das Google Cloud Console-Projekt auf, in dem sich die Looker (Google Cloud Core)-Instanz befindet.

  3. Rufen Sie in der Google Cloud Console den Bereich IAM & Verwaltung > IAM auf.

  4. Wählen Sie Zugriff gewähren aus.

  5. Fügen Sie im Abschnitt Hauptkonten hinzufügen eines oder mehrere der folgenden Elemente hinzu:

    • E‑Mail-Adresse des Google-Kontos
    • Eine Google-Gruppe
    • Eine Google Workspace-Domain
  6. Wählen Sie im Abschnitt Rollen zuweisen eine der vordefinierten IAM-Rollen für Looker (Google Cloud Core) oder eine benutzerdefinierte Rolle aus, die Sie hinzugefügt haben.

  7. Klicken Sie auf Speichern.

  8. Teilen Sie neuen Looker (Google Cloud Core)-Nutzern mit, dass ihnen Zugriff gewährt wurde, und leiten Sie sie zur URL der Instanz weiter. Dort können sie sich in der Instanz anmelden, woraufhin ihre Konten erstellt werden. Es werden keine automatisierten Mitteilungen gesendet.

Wenn Sie die IAM-Rolle eines Nutzers ändern, wird die IAM-Rolle innerhalb weniger Minuten an die Looker (Google Cloud Core)-Instanz weitergegeben. Wenn ein Looker-Nutzerkonto vorhanden ist, bleibt die Looker-Rolle dieses Nutzers unverändert.

Alle Nutzer müssen über die zuvor beschriebenen IAM-Schritte bereitgestellt werden. Es gibt jedoch eine Ausnahme: Sie können in der Looker (Google Cloud Core)-Instanz Dienstkonten nur für die Looker API erstellen.

Mit OAuth in Looker (Google Cloud Core) anmelden

Wenn sich Nutzer zum ersten Mal anmelden, werden sie aufgefordert, sich mit ihrem Google-Konto anzumelden. Jeder Nutzer sollte dasselbe Konto verwenden, das der Looker-Administrator im Feld Hauptkonten hinzufügen angegeben hat, als er ihm Zugriff gewährt hat. Nutzer sehen den OAuth-Zustimmungsbildschirm, der beim Erstellen des OAuth-Clients konfiguriert wurde. Nachdem Nutzer dem Zustimmungsbildschirm zugestimmt haben, werden ihre Konten in der Looker-Instanz (Google Cloud Core) erstellt und sie werden angemeldet.

Danach werden Nutzer automatisch in Looker (Google Cloud Core) angemeldet, es sei denn, ihre Autorisierung läuft ab oder wird vom Nutzer widerrufen. In diesen Fällen wird Nutzern der OAuth-Zustimmungsbildschirm noch einmal angezeigt und sie werden um ihre Einwilligung zur Autorisierung gebeten.

Einigen Nutzern können API-Anmeldedaten zugewiesen werden, um ein API-Zugriffstoken abzurufen. Wenn die Autorisierung für diese Nutzer abläuft oder widerrufen wird, funktionieren ihre API-Anmeldedaten nicht mehr. Aktuelle API-Zugriffstokens funktionieren dann ebenfalls nicht mehr. Um das Problem zu beheben, muss der Nutzer seine Anmeldedaten neu autorisieren, indem er sich für jede betroffene Looker (Google Cloud Core)-Instanz wieder in der Looker (Google Cloud Core)-Benutzeroberfläche anmeldet. Alternativ können Sie reine API-Dienstkonten verwenden, um einen Fehler bei der Autorisierung von Anmeldedaten für API-Zugriffstokens zu vermeiden.

OAuth-Zugriff auf Looker (Google Cloud Core) entfernen

Wenn Sie eine Rolle haben, mit der Sie den IAM-Zugriff verwalten können, können Sie den Zugriff auf eine Looker (Google Cloud Core)-Instanz entfernen, indem Sie die IAM-Rolle widerrufen, die den Zugriff gewährt hat. Wenn Sie die IAM-Rolle eines Nutzerkontos entfernen, wird diese Änderung innerhalb weniger Minuten auf die Looker (Google Cloud Core)-Instanz übertragen. Der Nutzer kann sich nicht mehr bei der Instanz authentifizieren. Das Nutzerkonto wird auf der Seite Nutzer jedoch weiterhin als aktiv angezeigt. Wenn Sie das Nutzerkonto von der Seite Nutzer entfernen möchten, löschen Sie den Nutzer in der Looker-Instanz (Google Cloud Core).

Entfernen der Rolle „Admin via IAM“

Looker weist die Looker-Rolle „Admin über IAM“ automatisch einem Nutzer zu, der die IAM-Berechtigung looker.instances.update hat und sich mit Google OAuth in der Instanz angemeldet hat. Dadurch wird das systemstandardmäßige Nutzerattribut google_user_id ausgefüllt. Nutzer, die sich ausschließlich über einen externen Identitätsanbieter (z. B. SAML oder OIDC) authentifizieren, erhalten die Rolle „Admin via IAM“ nicht.

Da google_user_id ein systemstandardmäßiges Nutzerattribut ist, können Looker-Administratoren es in der Looker (Google Cloud Core)-Benutzeroberfläche nicht manuell bearbeiten oder löschen. Wenn Ihre Organisation Nutzer von Google OAuth zu einem externen Identitätsanbieter (z. B. SAML oder OIDC) migriert, behalten Nutzer, die sich neu anmelden, ihr google_user_id-Attribut und die Rolle „Administrator über IAM“.

Wenn Sie die Verknüpfung mit Google OAuth aufheben und die Rolle „Administrator über IAM“ für einen Nutzer entfernen möchten, den Sie auf einen Drittanbieter-IdP umstellen, während seine IAM-Berechtigungen beibehalten werden, führen Sie die folgenden Schritte aus:

  1. Löschen Sie das Nutzerkonto in der Looker (Google Cloud Core)-Benutzeroberfläche auf der Seite Nutzer.
  2. Widerrufen Sie in der Google Cloud Console vorübergehend die IAM-Rolle des Nutzers für das Projekt.
  3. Lassen Sie den Nutzer sich mit Ihrem externen Identitätsanbieter (SAML oder OIDC) in der Looker (Google Cloud Core)-Instanz anmelden. Dabei wird ein neues Drittanbieter-Nutzerkonto ohne google_user_id-Verknüpfung erstellt.
  4. Nachdem das neue Looker-Nutzerkonto erstellt wurde, weisen Sie dem Nutzer in der Google Cloud Console die erforderliche IAM-Rolle wieder zu.

OAuth als Backup-Authentifizierungsmethode verwenden

Wenn Sie eine andere Authentifizierungsmethode verwenden, z. B. Workforce Identity-Föderation, SAML oder OpenID Connect (OIDC), können Sie Google OAuth als sekundäre oder Sicherungsauthentifizierungsmethode konfigurieren. Durch diese Konfiguration wird sichergestellt, dass sich Nutzer und Administratoren weiterhin mit Google-Konten authentifizieren können, wenn sie nicht auf den primären Identitätsanbieter zugreifen können.

OAuth als Backup für SAML oder OIDC einrichten

OAuth ist die Backup-Authentifizierungsmethode, wenn SAML oder OIDC die primäre Authentifizierungsmethode ist.

Wenn Sie OAuth als Sicherungsmethode einrichten möchten, gewähren Sie jedem Looker (Google Cloud Core)-Nutzer die entsprechende IAM-Rolle, um sich in der Instanz anzumelden.

OAuth als sekundäre Methode für die Workforce Identity-Föderation einrichten

OAuth kann optional als sekundäre Authentifizierungsmethode für die Mitarbeiteridentitätsföderation eingerichtet werden. Wenn Sie OAuth als sekundäre Authentifizierungsmethode einrichten möchten, bearbeiten Sie die Instanz, um die Einstellung Sekundäres OAuth aktivieren zu aktivieren.

Mit OAuth anmelden

Nachdem die Sicherungsmethode eingerichtet wurde, können Nutzer so darauf zugreifen:

  1. Wählen Sie auf der Anmeldeseite Mit Google authentifizieren aus.
  2. Es wird ein Dialogfeld zur Bestätigung der Google-Authentifizierung angezeigt. Wählen Sie im Dialogfeld Bestätigen aus.

Nutzer können sich dann mit ihren Google-Konten anmelden. Bei der ersten Anmeldung mit OAuth werden sie aufgefordert, den OAuth-Zustimmungsbildschirm zu akzeptieren, der bei der Erstellung der Instanz eingerichtet wurde.

Nächste Schritte