Authentifizierungsanforderungen für den Google Drive Connector in Jitterbit Studio

Einführung

Dies sind die Voraussetzungen für die Authentifizierung mit dem Google Drive Connector unter Verwendung entweder von Anmeldeinformationen eines 3-beinigen OAuth 2.0 (3LO) Clients oder eines privaten Schlüssels, 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 Drive API für das ausgewählte Projekt über die Google Drive 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 Drive-Berechtigungen ein:

   Berechtigung	Aktivität
   https://www.googleapis.com/auth/drive	Alle
   https://www.googleapis.com/auth/drive.file	Alle
   https://www.googleapis.com/auth/drive.metadata	Alle
   https://www.googleapis.com/auth/drive.metadata.readonly	Dateien auflisten
   https://www.googleapis.com/auth/drive.meet.readonly	Dateien auflisten
   https://www.googleapis.com/auth/drive.photos.readonly	Dateien auflisten
   https://www.googleapis.com/auth/drive.readonly	Datei abrufen, Dateien auflisten

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 Anmeldedatei zu generieren.

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

   Beispiel JSON-Anmeldedatei

   {
       "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 Anmeldedaten werden nun 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-Anmeldedatei, die beim Konfigurieren des Google Drive OAuth-Clients oben heruntergeladen wurde:

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

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

   Geltungsbereich	Aktivität
   https://www.googleapis.com/auth/drive	Alle
   https://www.googleapis.com/auth/drive.file	Alle
   https://www.googleapis.com/auth/drive.metadata	Alle
   https://www.googleapis.com/auth/drive.metadata.readonly	Dateien auflisten
   https://www.googleapis.com/auth/drive.meet.readonly	Dateien auflisten
   https://www.googleapis.com/auth/drive.photos.readonly	Dateien auflisten
   https://www.googleapis.com/auth/drive.readonly	Datei abrufen, Dateien auflisten

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

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

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

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

7. Gehen Sie zu Erweiterte Optionen. Im Tab Authentifizierungsanfrage erstellen Sie 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 Drive-Verbindung ausgewählt werden, wenn die Authentifizierungsoption OAuth 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 Drive-Connector verwendet werden soll:

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 Drive API für das ausgewählte Projekt über die Google Drive API-Marktplatzseite.

3. Navigieren Sie im Navigationsmenü 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 Drive-Connector):

   

   • Rolle: Wählen Sie im Menü Besitzer als Rolle 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.

https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive.metadata.readonly
https://www.googleapis.com/auth/drive.metadata
https://www.googleapis.com/auth/drive.meet.readonly
https://www.googleapis.com/auth/drive.photos.readonly

Dienstkonto-Anmeldeinformationen abrufen

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

1. Gehen Sie zur Seite Dienstkonten, klicken Sie im Menü Aktionen für das oben erstellte Dienstkonto oben und klicken Sie dann 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.