Eine authentifizierte Verbindung zu Google ist erforderlich, um auf Gmail E-Mails, Dateien von Google Drive oder Kalender zuzugreifen. Dieser Leitfaden ist eine Anleitung zum Erstellen einer OAuth-Anwendungsverbindung, die auf Googles Schnittstelle im Jahr 2022 basiert.

Für eine erfolgreiche Verbindung zum Google-Authentifizierungsdienst müssen die folgenden Voraussetzungen erfüllt sein:

• Der i-net PDFC-Server muss mit HTTPS gesichert sein
• Der i-net PDFC-Server und der Browser-Client müssen in der Lage sein, https://accounts.google.com/ und https://oauth2.googleapis.com/ zu erreichen.
• Sie müssen berechtigt sein, einen API und Service Login unter https://console.cloud.google.com/ zu erstellen.
• Der OAuth-Zustimmungsbildschirm muss korrekt eingestellt und veröffentlicht sein.

Wird mit diesem Profil ein E-Mail-Abruf oder -Versand initiiert, sind die folgenden Voraussetzungen zu erfüllen:

• Der Server muss in der Lage sein die folgenden Domänen aufzurufen: smtp.gmail.com, imap.gmail.com

Der Zugriff auf Google-Kalender in den Kalendereinstellungen erfordert die Google Calendar API in demselben Google-Cloud-Projekt, das den OAuth-Client bereitstellt. Das Anlegen des OAuth-Clients und das Abschließen des Zustimmungsbildschirms reichen nicht aus.

• Öffnen Sie die Google Calendar API in der API-Bibliothek und wählen Sie das Projekt aus, das für den OAuth-Client verwendet wird.
• Klicken Sie auf Aktivieren.
• Sie können auch APIs & Dienste → Bibliothek öffnen, nach Google Calendar API suchen und die API dort aktivieren.

Wenn ein Benutzer einen Google-Kalender verbindet, fordert i-net PDFC den Scope https://www.googleapis.com/auth/calendar an. Dieser Zugriff muss auf dem OAuth-Zustimmungsbildschirm oder unter Data Access vorgesehen sein.

Nachdem Sie die API aktiviert haben, warten Sie kurz und verbinden Sie den Kalender in der Kalender-Anwendung erneut.

Hinweis: Der Kalender-Scope gilt als sensibel. Bei einem Benutzertyp External kann Google eine App-Verifizierung verlangen.

Sie werden jetzt ein GCP API- und Service-Login erstellen. Dieses Login wird die Authentifizierungsdaten für die OAuth-Verbindung bereitstellen, die wir zu i-net PDFC hinzufügen wollen.

• Gehen Sie zu https://console.cloud.google.com/apis/credentials und melden Sie sich an.
• Vergewissern Sie sich, dass Sie das entsprechende Projekt in der Titelleiste der Benutzeroberfläche ausgewählt haben, oder erstellen Sie ein neues Projekt.
• Klicken Sie im Menü auf Login erstellen und wählen Sie dann Oauth Client ID
• Wählen Sie Webanwendung als Anwendungstyp.
• Geben Sie einen Namen zur Beschreibung der Anwendung ein
• Fügen Sie eine Autorisierte Umleitungs-URL hinzu und geben Sie den Wert ein, der im Konfigurationsdialog des i-net PDFC-Servers, in dem Sie die neue Verbindung erstellen, als Weiterleitungs-URL angezeigt wird.
• Klicken Sie auf Erstellen.

Sie haben nun die Login-Anwendung erstellt. Ein Dialog mit den erforderlichen Informationen wird angezeigt und Sie können sie als JSON-Datei herunterladen.

• Kopieren Sie Ihre Client-ID in das Feld Client-ID des OAuth-Verbindungen Dialogs in der i-net PDFC Konfiguration.
• Kopieren Sie Ihre Client Key in das Feld Client Secret des OAuth-Verbindungen Dialogs in der i-net PDFC-Konfiguration

Hinweis: Das Client-Secret ist als Passwort zu betrachtet, also bewahren Sie es bitte an einem sicheren Ort auf.