OAuth-Client und ‑Anmeldedaten für eine Looker (Google Cloud Core)-Instanz erstellen

Auf dieser Dokumentationsseite wird erläutert, wie Sie Ihren OAuth-Client einrichten und OAuth-Anmeldedaten während der Instanzerstellung manuell mit Ihrer Instanz verknüpfen.

Wann OAuth-Anmeldedaten erstellt werden sollten

In den meisten Fällen erstellt und weist Looker (Google Cloud Core) standardmäßig automatisch von Looker verwaltete OAuth-Anmeldedaten zu. Sie müssen nur in bestimmten Szenarien einen OAuth-Client erstellen und benutzerdefinierte OAuth-Anmeldedaten manuell verknüpfen, je nach Netzwerkverbindungstyp und Authentifizierungskonfiguration Ihrer Instanz:

  • Private oder hybride Verbindungen mit Google OAuth: Die manuelle OAuth-Einrichtung ist erforderlich, wenn Google OAuth (entweder als primäre oder sekundäre Authentifizierung) mit privaten oder hybriden Verbindungen verwendet wird.
  • Öffentliche Verbindungen mit Google OAuth: Wenn Sie die Instanz in derGoogle Cloud Console erstellen, ist keine manuelle OAuth-Einrichtung erforderlich, da Looker (Google Cloud Core) standardmäßig automatisch von Looker verwaltete Anmeldedaten zuweist. Sie können jedoch optional benutzerdefinierte Anmeldedaten konfigurieren. Wenn Sie die Instanz mit der Google Cloud CLI erstellen, müssen Sie OAuth-Anmeldedaten angeben.
  • Nur Mitarbeiteridentitätsföderation: Wenn Sie die Mitarbeiteridentitätsföderation ohne sekundäres Google OAuth verwenden, ist die manuelle OAuth-Einrichtung für keinen Netzwerkverbindungstyp erforderlich.
  • Benutzerdefinierte Domains: Wenn Sie eine benutzerdefinierte Domain für eine Instanz konfigurieren, die öffentliche sichere Verbindungen und Google OAuth verwendet, sind benutzerdefinierte OAuth-Anmeldedaten erforderlich. Diese werden im Rahmen der Erstellung der benutzerdefinierten Domain konfiguriert.

In der folgenden Tabelle wird zusammengefasst, wann eine manuelle Einrichtung von OAuth-Anmeldedaten erforderlich ist:

Primäre Authentifizierung Sekundäre Authentifizierung Art der Netzwerkverbindung Manuelle OAuth-Einrichtung
Google OAuth Keine Öffentliche verschlüsselte Verbindungen Nicht erforderlich, wenn Sie die Google Cloud Console verwenden, da Looker (Google Cloud Core) automatisch von Looker verwaltete Anmeldedaten zuweist. Erforderlich, wenn Sie die gcloud CLI verwenden.
Private Verbindungen oder Hybridverbindungen Erforderlich. Folgen Sie dazu der Anleitung auf dieser Seite.
Mitarbeiteridentitätsföderation Keine Öffentliche Verbindungen Nicht erforderlich.
Mitarbeiteridentitätsföderation Google OAuth Öffentliche verschlüsselte Verbindungen Optional, wenn Sie die Google Cloud Console verwenden. Standardmäßig verwendet Looker (Google Cloud Core) von Looker verwaltete Anmeldedaten. Sie können jedoch auch benutzerdefinierte Anmeldedaten angeben. Erforderlich, wenn Sie die gcloud CLI verwenden.

Erforderliche Rollen

Wenn Sie die Google Cloud Console zum Erstellen und Bearbeiten von OAuth-Anmeldedaten verwenden möchten, benötigen Sie die folgenden Berechtigungen. (Wenn Sie die Liste der Berechtigungen ausblenden möchten, minimieren Sie den Abschnitt Erforderliche Berechtigungen.)

Erforderliche Berechtigungen

  • clientauthconfig.*
    • clientauthconfig.brands.create
    • clientauthconfig.brands.delete
    • clientauthconfig.brands.get
    • clientauthconfig.brands.list
    • clientauthconfig.brands.update
    • clientauthconfig.clients.create
    • clientauthconfig.clients.createSecret
    • clientauthconfig.clients.delete
    • clientauthconfig.clients.get
    • clientauthconfig.clients.getWithSecret
    • clientauthconfig.clients.list
    • clientauthconfig.clients.listWithSecrets
    • clientauthconfig.clients.undelete
    • clientauthconfig.clients.update
  • oauthconfig.*
    • oauthconfig.clientpolicy.get
    • oauthconfig.testusers.get
    • oauthconfig.testusers.update
    • oauthconfig.verification.get
    • oauthconfig.verification.submit
    • oauthconfig.verification.update

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten. Weitere Informationen zum Zuweisen von Rollen finden Sie in der IAM-Dokumentation (Identity and Access Management) auf der Seite Zugriff auf Projekte, Ordner und Organisationen verwalten.

Vor dem Erstellen einer Looker (Google Cloud Core)-Instanz

Bevor Sie eine Looker (Google Cloud Core)-Instanz erstellen, führen Sie die Schritte aus, die in den folgenden Abschnitten beschrieben werden:

OAuth-Client-ID und ‑Clientschlüssel generieren

Erstellen Sie zuerst einen OAuth-Client und generieren Sie die Client-ID und den Clientschlüssel für diesen Client. Sie benötigen diese Werte während der Instanzerstellung, wenn Sie benutzerdefinierte OAuth-Anmeldedaten konfigurieren, z. B. für private oder hybride Verbindungen mit Google OAuth, oder wenn die Google-Authentifizierung über die gcloud CLI aktiviert ist.

Sie können den OAuth-Client in einem beliebigen Google Cloud -Projekt einrichten. Es muss nicht dasselbe Projekt wie die Looker (Google Cloud Core)-Instanz sein. Die Looker (Google Cloud Core) API muss jedoch in diesem Projekt aktiviert sein.

So erstellen Sie den Client und seine Anmeldedaten:

  1. Rufen Sie das Projekt auf, in dem Sie den OAuth-Client erstellen möchten.
  2. Rufen Sie APIs & Dienste > Anmeldedaten auf.
  3. Klicken Sie auf der Seite Anmeldedaten auf Anmeldedaten erstellen.
  4. Wählen Sie im Drop-down-Menü die Option OAuth-Client-ID aus.
  5. Wählen Sie im Drop-down-Menü Anwendungstyp die Option Webanwendung aus.
  6. Geben Sie im Feld Name einen Namen für den OAuth-Client ein.
  7. Sie müssen in den Abschnitten Autorisierte JavaScript-Quellen oder Autorisierte Weiterleitungs-URIs keine URIs hinzufügen.
  8. Klicken Sie auf Erstellen.

Nachdem Sie auf Erstellen geklickt haben, wird das Fenster OAuth-Client erstellt angezeigt. In diesem Fenster werden die Client-ID und der Clientschlüssel angezeigt, die für Ihren OAuth-Client erstellt wurden. Wenn Sie benutzerdefinierte OAuth-Anmeldedaten konfigurieren, geben Sie diese Werte ein, wenn Sie Ihre Looker (Google Cloud Core)-Instanz für öffentliche sichere Verbindungen, Private Service Connect oder Zugriff auf private Dienste erstellen.

Optional können Sie auf JSON herunterladen klicken, um die Anmeldedaten in einer JSON-Datei herunterzuladen. Klicken Sie auf OK, um das Fenster zu schließen.

Als Nächstes können Sie den Zustimmungsbildschirm konfigurieren. Der Zustimmungsbildschirm wird einem Nutzer der Looker (Google Cloud Core)-Instanz bei der ersten Anmeldung und immer dann angezeigt, wenn seine Autorisierung abläuft oder vom Nutzer widerrufen wird.

Folgen Sie der Anleitung auf der Dokumentationsseite OAuth-Zustimmungsbildschirm konfigurieren und Bereiche auswählen. Konfigurieren Sie die folgenden Einstellungen wie beschrieben:

  • Im Abschnitt Branding unter Autorisierte Domains muss die Domain mit der Domain der Looker (Google Cloud Core)-Instanz übereinstimmen, die die OAuth-Anmeldedaten verwendet. Wenn Sie eine benutzerdefinierte Domain für Ihre Looker (Google Cloud Core)-Instanz erstellen möchten und die Domain kennen, die Sie ihr zuweisen möchten, können Sie sie jetzt eingeben. Andernfalls können Sie dieses Feld leer lassen. Es wird automatisch ausgefüllt, wenn Sie nach dem Erstellen der Looker (Google Cloud Core)-Instanz den autorisierten Weiterleitungs-URI hinzufügen.

  • Wählen Sie im Bereich Zielgruppe unter Nutzertyp eine der folgenden Optionen aus:

Während der Erstellung der Looker (Google Cloud Core)-Instanz

Für einige Instanzen sind benutzerdefinierte OAuth-Anmeldedaten erforderlich, z. B. Instanzen mit privaten oder Hybridverbindungen und Google OAuth oder Instanzen, die Sie mit der gcloud CLI erstellen, während die Google-Authentifizierung aktiviert ist. Geben Sie für diese Instanzen während der Einrichtung die OAuth-Client-ID und den Clientschlüssel ein. Wählen Sie Ihren OAuth-Client in der Google Cloud -Konsole aus, um diese Werte zu finden.

Geben Sie die Anmeldedaten je nach Verbindungstyp und Erstellungsmethode so ein:

Nachdem Sie eine Looker (Google Cloud Core)-Instanz erstellt haben

Folgen Sie der Anleitung, um die Konfiguration abzuschließen. Wenn Sie einen autorisierten Weiterleitungs-URI hinzufügen, wird er Ihrem OAuth-Zustimmungsbildschirm als autorisierte Domain hinzugefügt.

Autorisierten Weiterleitungs-URI zum OAuth-Client hinzufügen

Falls noch nicht geschehen, führen Sie die folgenden Schritte aus, um die URL der neu erstellten Looker-Instanz (Google Cloud Core) in den OAuth-Client einzugeben.

  1. Nachdem Sie eine Looker-Instanz (Google Cloud Core) erstellt haben, suchen Sie die URL für die Instanz und kopieren Sie sie. Sie finden die URL auf der Seite Instanzen.

  2. Rufen Sie in der Google Cloud Console APIs und Dienste > Anmeldedaten auf.

  3. Klicken Sie unter der Überschrift OAuth 2.0-Client-IDs auf den Namen des von Ihnen erstellten Clients.

  4. Klicken Sie im Abschnitt Autorisierte Weiterleitungs-URIs auf URI hinzufügen.

  5. Fügen Sie die URL der Looker-Instanz (Google Cloud Core) in das Feld URIs ein. Fügen Sie /oauth2callback am Ende der URL hinzu. Beispiel: https://uuid.looker.app/oauth2callback.

    Wenn Sie die OAuth-Autorisierung für BigQuery einrichten möchten, können Sie auch einen zweiten Weiterleitungs-URI hinzufügen, der auf die URL der Looker-Instanz (Google Cloud Core) verweist, gefolgt von /external_oauth/redirect am Ende der URL. Beispiel: https://uuid.looker.app/external_oauth/redirect.

  6. Klicken Sie auf Speichern.

Es kann fünf Minuten bis mehrere Stunden dauern, bis die Aktualisierung wirksam wird.

Nutzer verwalten

Nachdem der OAuth-Client konfiguriert und die Looker (Google Cloud Core)-Instanz erstellt wurde, können Sie sich mit OAuth in der Instanz anmelden. Anschließend können Sie die Authentifizierungsmethode für Ihre Instanz auswählen.

Wenn Sie OAuth als primäre Authentifizierungsmethode verwenden, führen Sie die Schritte auf der Dokumentationsseite Google OAuth für die Looker (Google Cloud Core)-Nutzerauthentifizierung verwenden aus, um die OAuth-Einrichtung für die Nutzerauthentifizierung abzuschließen.

Sobald Ihre Authentifizierungsmethode eingerichtet ist, können Sie Nutzer über Ihren Identitätsanbieter hinzufügen oder entfernen und in Looker verwalten.

Typ der OAuth-Anmeldedaten für Ihre Instanz ansehen

OAuth-Anmeldedaten werden nicht direkt auf der Seite „Instanzkonfiguration“ der Google Cloud Console aufgeführt. Klicken Sie auf der Seite mit der Instanzkonfiguration auf Bearbeiten, um den Abschnitt OAuth-Anmeldedaten für die Anwendung aufzurufen.

Wenn die OAuth-Anmeldedaten auf Von Looker verwaltet festgelegt sind, weist Looker (Google Cloud Core) Ihrer Instanz während der Instanzerstellung von Looker verwaltete OAuth-Anmeldedaten zu. Die Client-ID und der Clientschlüssel werden nicht angezeigt.

Wenn die OAuth-Anmeldedaten auf Manuell festgelegt sind, wurden Ihrer Instanz entweder während oder nach der Instanzerstellung manuelle OAuth-Anmeldedaten hinzugefügt. Die Client-ID und der Clientschlüssel werden nicht angezeigt. Stattdessen werden im Abschnitt ****-Platzhalter angezeigt.

OAuth-Client für eine Looker (Google Cloud Core)-Instanz bearbeiten

Wenn Sie möchten, können Sie OAuth-Anmeldedaten für Ihre Looker (Google Cloud Core)-Instanz hinzufügen, bearbeiten oder ändern. Gehen Sie dazu so vor:

  1. Richten Sie den neuen Client oder die neuen Anmeldedaten ein.
  2. Klicken Sie in der Google Cloud Console auf der Seite Instanzen auf den Namen einer Instanz, um die Seite DETAILS zu öffnen.
  3. Klicken Sie auf der Seite DETAILS auf Bearbeiten.
  4. Rufen Sie auf der Seite Looker (Google Cloud Core)-Instanz bearbeiten den Abschnitt OAuth-Anmeldedaten für die Anwendung auf und wählen Sie Manuell aus, falls diese Option nicht bereits ausgewählt ist.
  5. Geben Sie die neuen Werte in die Felder OAuth-Client-ID und OAuth-Clientschlüssel ein.
  6. Klicken Sie auf Speichern.

Wenn die Anmeldedaten Ihrer OAuth-Anwendung auf Von Looker verwaltet festgelegt sind, können Sie keine Anmeldedaten hinzufügen oder bearbeiten. Wechseln Sie zur Einstellung Manuell für Anmeldedaten, um sie zu bearbeiten oder hinzuzufügen.

Nächste Schritte