Lokalen Aktions-Hub für Aktionen einrichten, bei denen OAuth und Streaming verwendet werden

Wenn eine vom Kunden gehostete Looker-Instanz nicht mit dem von Looker gehosteten Action Hub kommunizieren kann, können Looker-Administratoren möglicherweise keine Aktionen aktivieren, die gestreamte Ergebnisse unterstützen oder OAuth verwenden. Außerdem kann es bei Looker-Nutzern beim Senden oder Planen von Daten an Aktionen, die gestreamte Ergebnisse unterstützen, zu in der Schwebe befindlichen Abfragen kommen. Außerdem können sie möglicherweise keine OAuth-Aktionen konfigurieren.

Damit Looker-Integrationen verwendet werden können, müssen der Looker Action Hub und die Looker-Instanz miteinander kommunizieren können. Administratoren von von Kunden gehosteten Instanzen, die sich über Lösungen informieren möchten, die für ihre Instanzarchitektur geeignet sind, finden auf der Dokumentationsseite Daten über einen Action Hub freigeben im Abschnitt Hinweise für von Kunden gehostete Instanzen entsprechende Empfehlungen.

Wenn für die Instanz ein SSL-Zertifikat verwendet wird, das von einer Zertifizierungsstelle ausgestellt wurde, die nicht in dieser Liste der Root-Zertifikate enthalten ist, können die OAuth- und Streamingaktionen möglicherweise nicht in einer vom Kunden gehosteten Looker-Instanz verwendet werden.

Eine Liste der Aktionen, die für die Unterstützung gestreamter Ergebnisse oder OAuth konfiguriert wurden, finden Sie in der Dokumentation auf der Seite Administratoreinstellungen – Aktionen in der Liste der integrierten Looker-Dienste.

Auf dieser Seite wird beschrieben, wie Sie einen lokalen Action Hub-Server starten, um Looker-Aktionen zu verwenden, die gestreamte Ergebnisse unterstützen oder Google OAuth verwenden. Sie können einen eigenen lokalen Action Hub-Server einrichten, indem Sie entweder einen Container oder eine virtuelle Maschine (VM) erstellen, auf der eine geklonte Kopie des Codes des Looker Action Hub-Repositorys gehostet wird. Führen Sie dann die folgenden Schritte aus, die in den folgenden Abschnitten ausführlicher beschrieben werden:

1. Erstellen Sie eine Container- oder VM-Einrichtung (virtuelle Maschine) für den Action Hub-Server.
2. Google OAuth-Anmeldedaten konfigurieren
3. Konfigurieren Sie den Google OAuth-Zustimmungsbildschirm.
4. Richten Sie die Umgebungsvariablen ein.
5. Erstelle einen API-Schlüssel.
6. Starten Sie den neuen Aktionshub.
7. Fügen Sie Ihrer Looker-Instanz den neuen Aktionshub hinzu.

Hinweis: Sie benötigen die Rolle Administrator, um auf alle Administratorseiten in Looker zugreifen zu können. Wenn Sie eine Berechtigung haben, die nur Teile des Bereichs Verwaltung aktiviert, z. B. manage_schedules oder manage_themes, aber nicht die Rolle „Administrator“, werden im Bereich Verwaltung möglicherweise nicht die in diesem Artikel beschriebenen Seiten angezeigt. Außerdem gewährt die Berechtigung see_admin Lesezugriff auf die meisten (aber nicht alle) Seiten im Admin-Bereich. Weitere Informationen finden Sie in der Beschreibung von see_admin.

Container- oder VM-Einrichtung für den Action Hub-Server erstellen

Ihre VM oder Ihr Container muss die folgenden Allokations- und Netzwerkanforderungen und -abhängigkeiten erfüllen:

• Empfohlene Speicherzuweisung
• Netzwerkanforderungen
• Erforderliche Abhängigkeiten

Empfohlene Arbeitsspeicherzuweisung

Looker empfiehlt, diesem Container oder dieser VM zwei CPU-/vCPU-Threads und mindestens 2 GB Arbeitsspeicher zuzuweisen. Wenn Sie eine intensive Nutzung Ihrer Aktionen erwarten, sollten Sie den Arbeitsspeicher auf mehr als 2 GB erhöhen.

Netzwerkanforderungen

Ihr Action-Hub muss entweder eine statische IP-Adresse oder eine Adresse haben, die über ein internes Domain Name System (DNS) aufgelöst werden kann.

Ihr Netzwerk muss die folgenden Kommunikationsanforderungen erfüllen:

• Die Looker-Instanz muss mit dem Action Hub kommunizieren können.
• Google Auth muss mit dem Action Hub kommunizieren können.
• Ein intern verbundener Browser muss den Action Hub erreichen können.
• Der Action Hub muss die Google Drive-Server erreichen können.

Erforderliche Abhängigkeiten

So klonen Sie das Looker-Actions-Repository in Ihre neu erstellte VM oder Ihren neu erstellten Container:

• Node 12.13 muss installiert sein.
• Führen Sie yarn install aus, um die erforderlichen Pakete zu installieren.

Nachdem Sie Ihre Umgebung eingerichtet haben, müssen Sie in der Google Cloud API Console Google OAuth-Anmeldedaten für Ihren Action Hub-Server erstellen.

Google OAuth-Anmeldedaten konfigurieren

So konfigurieren Sie Google OAuth-Anmeldedaten für Ihre Aktionen:

• OAuth-Anmeldedaten erstellen
• OAuth-Zustimmungsbildschirm konfigurieren

Google OAuth-Anmeldedaten erstellen

So erstellen Sie Ihre Google OAuth-Client-ID und Ihr Client-Secret:

1. Rufen Sie die Google Cloud-Seite Ressourcen verwalten auf und klicken Sie auf PROJEKT ERSTELLLEN, um ein neues Projekt zu erstellen.

   Weitere Informationen zum Erstellen eines Projekts finden Sie im Leitfaden Projekte erstellen und verwalten.

2. Wählen Sie das neue Projekt aus.
3. Rufen Sie in der linken Seitenleiste der Console die Seite APIs & Dienste > Anmeldedaten auf.
4. Klicken Sie auf Anmeldedaten erstellen.
5. Klicken Sie im Drop-down-Menü auf OAuth-Client-ID.
6. Möglicherweise müssen Sie einen OAuth-Zustimmungsbildschirm konfigurieren. Folgen Sie in diesem Fall der Anleitung im Abschnitt OAuth-Zustimmungsbildschirm konfigurieren weiter unten auf dieser Seite und fahren Sie dann mit Schritt 7 fort.
7. Wählen Sie als Anwendungstyp die Option Webanwendung aus.
8. Geben Sie im Feld Name den Namen Ihrer Anwendung ein.
9. Fügen Sie im Abschnitt Autorisierte JavaScript-Quellen die Adresse der Looker-Anwendungs-Root ein, die Sie intern verwenden.
10. Legen Sie die Autorisierten Weiterleitungs-URIs für die Google Drive- und Google Tabellen-Konsolen fest. Dabei ist ACTION_HUB_BASE_URL die Adresse Ihres Action Hubs:

                https://<ACTION_HUB_BASE_URL>/actions/google_sheets/oauth_redirect
                https://<ACTION_HUB_BASE_URL>/actions/google_drive/oauth_redirect
            

11. Klicken Sie auf die Schaltfläche Erstellen, um Ihre OAuth-Client-ID und das OAuth-Client-Secret zu generieren. Sie benötigen beides später.

OAuth-Zustimmungsbildschirm konfigurieren

Auf dieser Seite der Google API Console können Sie einen Einwilligungsbildschirm für alle Anwendungen in Ihrem Projekt konfigurieren. Über diesen können Nutzer Zugriff auf ihre Daten gewähren und einen Link zu allen rechtlichen oder datenschutzrechtlichen Dokumenten erhalten. Wenn Sie diesen Schritt bereits ausgeführt haben oder keinen Einwilligungsbildschirm konfigurieren müssen, überspringen Sie diesen Abschnitt und kehren Sie zum Terminalfenster zurück, um Ihre Umgebungsvariablen festzulegen. Weitere Informationen finden Sie weiter unten auf dieser Seite unter Umgebungsvariablen festlegen.

So konfigurieren Sie den Zustimmungsbildschirm:

1. Klicken Sie auf Zustimmungsbildschirm konfigurieren.
2. Wählen Sie aus, ob es sich um eine interne oder externe Anwendung handelt, und klicken Sie auf ERSTELLEN.
3. Geben Sie den Namen Ihrer Anwendung in das Feld App-Name ein.
4. Geben Sie unter E-Mail-Adresse des Nutzersupports eine E-Mail-Adresse ein, die auf dem OAuth-Zustimmungsbildschirm für den Nutzersupport angezeigt werden soll.
5. Optional können Sie für das App-Logo eine Bilddatei hochladen, die auf dem OAuth-Zustimmungsbildschirm verwendet werden soll.
6. Optional können Sie den Link zur Startseite Ihrer Anwendung eingeben. Diese sollte auf derselben Stammdomain wie Ihr Action-Hub gehostet werden.
7. Optional können Sie im Feld Link zur Datenschutzerklärung der Anwendung einen Link zur Datenschutzerklärung Ihrer App eingeben. Der Link muss auf derselben Stammdomain wie Ihr Action-Hub gehostet werden.
8. Optional können Sie im Feld Link zu den Nutzungsbedingungen der Anwendung einen Link zu den Nutzungsbedingungen Ihrer Anwendung eingeben. Der Link muss auf derselben Stammdomain wie Ihr Action-Hub gehostet werden.
9. Klicken Sie im Abschnitt Autorisierte Domains auf DOMAIN HINZUFÜGEN und geben Sie die Stammdomain ein, die Ihr Action-Hub verwendet.
10. Geben Sie im Feld Kontaktdaten des Entwicklers eine E-Mail-Adresse ein, unter der Sie für Google erreichbar sind.
11. Klicken Sie auf SPEICHERN UND WEITER.
12. Fügen Sie im Abschnitt Bereiche die Arten von Nutzerdaten hinzu, auf die Ihre Anwendung zugreifen muss. Dazu gehören E-Mail-Adresse, Profil, OpenID und https://mail.google.com. Da diese Liste vertrauliche Nutzerinformationen enthält, muss Google Ihren OAuth-Zustimmungsbildschirm überprüfen, bevor er veröffentlicht werden kann.
13. Klicken Sie auf SPEICHERN UND WEITER.
14. Optional können Sie im Bereich Testnutzer Nutzer hinzufügen, die vor der Bestätigung Zugriff auf den Action Hub haben sollen.
15. Klicken Sie auf SPEICHERN UND WEITER.
16. Klicken Sie auf ZUM DASHBOARD ZURÜCK.
17. Klicken Sie in der linken Seitenleiste auf Anmeldedaten, um zur Konfiguration Ihrer OAuth-Anmeldedaten zurückzukehren.

Wenn Sie den OAuth-Zustimmungsbildschirm konfiguriert haben und gerade dabei waren, Google OAuth-Anmeldeinformationen zu konfigurieren, kehren Sie zu Schritt 7 dieser Anleitung zurück und schließen Sie die Konfiguration der Anmeldeinformationen ab. Andernfalls können Sie zu Ihrem Terminalfenster zurückkehren, um die Umgebungsvariablen festzulegen.

Umgebungsvariablen festlegen

Legen Sie in Ihrer VM- oder Containerumgebung die folgenden Umgebungsvariablen fest:

    ACTION_HUB_LABEL=<your action hub label name>
        ACTION_HUB_SECRET=<some secret>
        ACTION_HUB_BASE_URL=<your action hub base address>
            # For example https://actions.company.com
            # DO NOT INCLUDE A TRAILING SLASH
        GOOGLE_SHEET_CLIENT_ID=<OAuth client ID>
        GOOGLE_SHEET_CLIENT_SECRET=<OAuth client secret>
        GOOGLE_DRIVE_CLIENT_ID=<OAuth client ID>
        GOOGLE_DRIVE_CLIENT_SECRET=<OAuth client secret>

Sie sollten sowohl für Google Drive als auch für Google Tabellen dieselbe OAuth client ID und OAuth client secret verwenden können. Es ist jedoch am besten, beide Google API-Tokens festzulegen.

Legen Sie auch den Verschlüsselungsschlüssel fest:

    CIPHER_MASTER="<hex aes-256 key>"

Dieser Schlüssel wird nicht für die langfristige Verschlüsselung verwendet, sondern nur zum Verschlüsseln von state während eines OAuth-Vorgangs. Das folgende Beispiel zeigt einen Hexadezimal-AES-256-Schlüssel:

    C4EFBBE2C364248419776459A00F2F4017CE77E29D9E8F64940687EA440A0CC9

API-Schlüssel generieren

Führen Sie diesen Befehl aus, um Ihren API-Schlüssel abzurufen:

y arn generate-api-key

Bewahren Sie den generierten Schlüssel für die spätere Verwendung bei der Einrichtung auf. Dieser Schlüssel wird basierend auf dem ACTION_HUB_SECRET generiert.

Lokalen Action Hub-Server starten

Führen Sie den folgenden Befehl aus, um den Action Hub zu starten:

yarn start

Looker-Instanz einen Action Hub hinzufügen

So fügen Sie Ihrer Looker-Instanz Ihren Action Hub hinzu:

1. Rufen Sie in Looker im Bereich Verwaltung die Seite Aktionen unter Plattform auf.
2. Scrollen Sie auf der Seite nach unten und klicken Sie auf die Schaltfläche Action Hub hinzufügen.
3. Geben Sie Ihre ACTION_HUB_BASE_URL ein und klicken Sie auf Action Hub hinzufügen. Ihr Aktionshub sollte unter einer neuen Überschrift mit seinem Namen und ACTION_HUB_BASE_URL angezeigt werden. Ihre Google Drive- und Google Tabellen-Aktionen sollten unter dieser Überschrift angezeigt werden.
4. Wenn die Verbindung fehlschlägt, geben Sie das zuvor generierte api-key in das Feld Autorisierungstoken ein und klicken Sie oben in der Überschrift des Action Hubs auf den Link Aktualisieren.
5. Aktivieren Sie Ihre Google Drive- und Google Tabellen-Aktionen und prüfen Sie, ob sie im Action Hub richtig konfiguriert sind.

Nächster Schritt

Im nächsten Schritt veröffentlichen Sie die Anwendung, die Sie in der Google API Console erstellt haben. Wenn Sie die App veröffentlichen möchten, rufen Sie den OAuth-Zustimmungsbildschirm auf und klicken Sie auf die Schaltfläche Zur Überprüfung einreichen. Die Veröffentlichung der App kann einige Zeit dauern und erfordert einige Überprüfungsschritte bei Google.