Authentifizierungsanforderungen für den Google Sheets-Connector in Jitterbit Studio

Einführung

Dies sind die Voraussetzungen für die Authentifizierung mit dem Google Sheets-Connector unter Verwendung entweder von Anmeldeinformationen für einen 3-beinigen OAuth 2.0 (3LO) oder einem privaten Schlüssel, der mit einem Google Cloud Dienstkonto verknüpft ist.

3-beinige OAuth 2.0 (3LO)

Befolgen Sie diese Schritte, um einen 3-beinigen OAuth 2.0 (3LO) Client zu konfigurieren:

1. Erstellen Sie im Google Cloud Console ein Google Cloud-Projekt oder wählen Sie ein bestehendes Projekt für die Authentifizierung aus.

2. Aktivieren Sie die Google Sheets API für das ausgewählte Projekt über die Google Sheets API-Marktplatzseite.

3. Konfigurieren Sie den OAuth-Zustimmungsbildschirm für das ausgewählte Projekt. Geben Sie im Schritt Datenzugriff > Berechtigungen hinzufügen oder entfernen diese Google Sheets-Berechtigungen ein:

   Berechtigung	Aktivität
   https://www.googleapis.com/auth/spreadsheets	Alle
   https://www.googleapis.com/auth/spreadsheets.readonly	Abrufen

4. Navigieren Sie zu APIs & Dienste > Anmeldedaten und klicken Sie auf Anmeldedaten erstellen > OAuth-Client-ID, um die Konfigurationsseite OAuth-Client-ID erstellen zu öffnen:

   1. Wählen Sie Webanwendung für Anwendungstyp.

   2. Geben Sie einen beliebigen Namen für Name ein.

   3. Fügen Sie eine der folgenden URLs (je nach Region Ihrer Organisation) zur Liste der autorisierten Umleitungs-URIs hinzu:

      Region	URL
      APAC	https://apps.apac-southeast.jitterbit.com/design-studio/api/v1/oauth/authcode
      EMEA	https://apps.emea-west.jitterbit.com/design-studio/api/v1/oauth/authcode
      NA	https://apps.na-east.jitterbit.com/design-studio/api/v1/oauth/authcode

5. Klicken Sie auf Erstellen, um den OAuth-Client und die zugehörige Anmeldeinformationsdatei zu generieren.

6. Nach Abschluss erscheint ein Dialogfeld OAuth-Client erstellt. Klicken Sie auf JSON herunterladen, um die JSON-Anmeldeinformationsdatei mit der Client-ID und dem Client-Geheimnis für die spätere Verwendung herunterzuladen:

   Beispiel JSON-Anmeldeinformationsdatei

   {
       "web": {
           "client_id": "...",
           "project_id": "my-project-123456",
           "auth_uri": "https://accounts.google.com/o/oauth2/auth",
           "token_uri": "https://oauth2.googleapis.com/token",
           "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
           "client_secret": "...",
           "redirect_uris": [
               "https://apps.my-region.jitterbit.com/design-studio/api/v1/oauth/authcode"
           ]
       }
   }
   

7. Klicken Sie auf OK, um das Dialogfeld zu schließen. Die neu generierte Anmeldeinformation wird jetzt unter OAuth 2.0-Client-IDs angezeigt.

Konfigurieren Sie eine App-Registrierung in der Management-Konsole

Befolgen Sie diese Schritte, um die erforderlichen Werte für eine private Anwendung in der Management-Konsole App-Registrierung zu konfigurieren:

1. Sammeln Sie die erforderlichen Informationen aus der JSON-Anmeldeinformationsdatei, die beim Konfigurieren des Google Sheets OAuth-Clients oben heruntergeladen wurde:

   • Client-ID (client_id)
   • Client-Geheimnis (client_secret)
   • Autorisierungs-URL (auth_uri)
   • URL für Zugriffstoken und URL für Aktualisierungstoken (token_uri)

2. Geben Sie in der Konfiguration der App-Registrierung diese Google Sheets-Bereiche ein:

   Umfang	Aktivität
   https://www.googleapis.com/auth/spreadsheets	Alle
   https://www.googleapis.com/auth/spreadsheets.readonly	Abrufen

3. Setzen Sie die Client-ID der App auf den client_id-Wert in Ihrer Anmeldeinformationsdatei.

4. Setzen Sie das Client-Geheimnis der App auf den client_secret-Wert in Ihrer Anmeldeinformationsdatei.

5. Setzen Sie die Authentifizierungs-URL der App auf den auth_uri-Wert in Ihrer Anmeldeinformationsdatei. Zum Beispiel https://accounts.google.com/o/oauth2/auth.

6. Setzen Sie die Zugriffstoken-URL und die Aktualisierungstoken-URL der App auf den token_uri-Wert in Ihrer Anmeldeinformationsdatei. Zum Beispiel https://oauth2.googleapis.com/token.

7. Gehen Sie zu Erweiterte Optionen. Erstellen Sie im Tab für Authentifizierungsanfragen diese Schlüssel-Wert-Paare unter Parameter:

   Schlüssel	Wert	Senden in
   response_type	code	Anforderungs-URL
   access_type	offline	Anforderungs-URL

Sobald die private Anwendung auf der Seite App-Registrierungen registriert ist, kann sie im Menü OAuth-Anwendung in der Google Sheets-Verbindung ausgewählt werden, wenn die OAuth-Authentifizierungsoption verwendet wird.

Authentifizierung mit privatem Schlüssel über ein Dienstkonto

Befolgen Sie diese Schritte, um ein Dienstkonto zu erstellen und Rollen zuzuweisen, um Zugriff auf das Google Cloud-Projekt zu gewähren, das mit dem Google Sheets-Connector verwendet werden soll:

1. Erstellen Sie in der Google Cloud Console ein Google Cloud-Projekt oder wählen Sie ein vorhandenes Projekt für die Authentifizierung aus.

2. Aktivieren Sie die Google Sheets API für das ausgewählte Projekt über die Google Sheets API-Marktplatzseite.

3. Im Navigationsmenü navigieren Sie zu IAM & Admin > Dienstkonten.

4. Klicken Sie auf Dienstkonto erstellen, das sich oben auf der Seite befindet.

5. Geben Sie die Details des Dienstkontos ein:

   

   • Name des Dienstkontos: Geben Sie einen beliebigen String für den Namen des Dienstkontos ein.

   • Dienstkonto-ID: Dieses Feld wird automatisch ausgefüllt, um mit dem Namen des Dienstkontos übereinzustimmen, und kann bei Bedarf bearbeitet werden.

   • Beschreibung des Dienstkontos: Geben Sie eine Beschreibung für das Dienstkonto ein.

6. Klicken Sie auf Erstellen und Fortfahren.

7. Weisen Sie eine Rolle zu, um den Zugriff auf das Projekt zu ermöglichen (erforderlich für eine erfolgreiche Verbindung im Google Sheets-Connector):

   

   • Rolle: Wählen Sie im Menü Projekt > Eigentümer aus und klicken Sie dann auf Fortfahren.

8. Optional können Sie bestimmten Benutzern Zugriff auf das Dienstkonto gewähren:

   

9. Klicken Sie auf Fertig.

Dienstkonto-Anmeldeinformationen abrufen

Befolgen Sie diese Schritte, um die für die Verbindungs-Konfiguration erforderlichen Anmeldeinformationen zu erhalten:

1. Klicken Sie auf der Seite Dienstkonten im Menü Aktionen für das oben erstellte Dienstkonto oben auf Schlüssel verwalten.

2. Klicken Sie auf Schlüssel hinzufügen > Neuen Schlüssel erstellen, wählen Sie JSON als Schlüsseltyp aus und klicken Sie dann auf Erstellen, um die JSON-Datei auf Ihren Computer herunterzuladen:

   

3. Öffnen Sie die heruntergeladene JSON-Datei in einem Texteditor und behalten Sie die Werte von project_id, client_email und private_key für die Verwendung während der Verbindungs-Konfiguration.