Zum Hauptinhalt gehen

Gmail und andere Google-Dienste mit Xentral verbinden

  • Aktualisiert

Wichtig

Diese Methode zur Anbindung von Gmail funktioniert, wird von uns jedoch als veraltet angesehen. Wir empfehlen dir dein Gmail-Konto in Xentral NextGen, wie im folgenden Artikel beschrieben, anzubinden: Zusätzliche E-Mail-Konten anbinden.

Über Google APIs kannst du einige der Google-Dienste wie Gmail und Google Kalender mit Xentral verbinden. Dafür benötigst du ein gültiges Google-Konto und musst Xentral 20.1 oder höher verwenden. Der Vorgang besteht aus mehreren Schritten.

Ein neues Projekt in deinem Google-Konto anlegen

Dies ist der erste Schritt, um Google-Dienste mit Xentral zu verbinden. Projekte enthalten Einstellungen, Berechtigungen und weitere Metadaten, die zur Verbindung eines Google-Kontos mit Xentral notwendig sind.

  1. Melde dich in deinem Google-Konto an und öffne die Google Cloud Console im gleichen Browser.

  2. Klicke zuerst auf Projekt auswählen und anschließend auf Neues Projekt.

  3. Gib den Namen deines Projekts und deiner Organisation ein und klicke auf Erstellen.

    Das Projekt wird erstellt. Bitte beachte, dass dieser Prozess einige Minuten dauern kann. Die Erstellung des Projekts wird in den Benachrichtigungen bestätigt.

Gmail API aktivieren

Dies ist der zweite Schritt, um Google-Dienste mit Xentral zu verbinden.

  1. Wähle das Projekt, welches du gerade erstellt hast, indem du in den Benachrichtigungen auf PROJEKT AUSWÄHLEN klickst oder das Projekt Dropdown-Menü nutzt.

  2. Navigiere zu APIs und Dienste und klicke auf Aktivierte APIs und Dienste.

  3. Klicke auf + APIS UND DIENSTE AKTIVIEREN.

  4. Gib Gmail API in das Suchfeld ein. Alternativ kannst du auch nach unten scrollen und im Bereich Google Workspace die Gmail API auswählen.

  5. Öffne die Gmail API und klicke auf AKTIVIEREN.

    Die Gmail API ist aktiviert und kann nun genutzt werden.

Neuen Zustimmungsbildschirm anlegen

Dies ist der zweite Schritt, um Google-Dienste mit Xentral zu verbinden. Sobald du dein neues Projekt erstellt hast, musst du den OAuth-Zustimmungsbildschirm anlegen.

  1. Navigiere zu APIs und Dienste und wähle OAuth-Zustimmungsbildschirm.

  2. Wähle den bevorzugten Nutzertyp (intern) und klicke auf Erstellen.

  3. Gib im Bildschirm Anwendungsinformation die folgenden Informationen ein:

    1. Anwendungsname - Der Name der App, die um Zustimmung bittet

    2. Nutzersupport-E-Mail - Für Nutzer, die dich wegen Fragen zu ihrer Zustimmung kontaktieren möchten

    3. Anwendungslogo - Lade ein Bild auf den Zustimmungsbildschirm, das nicht größer als 1 MB ist, damit Nutzer die Anwendung besser erkennen können

  4. Gib unter Anwendungsdomain die folgenden Informationen ein:

    1. Startseite der Anwendung - Gib einen Link zu deiner Startseite an

    2. Link zur Datenschutzerklärung der Anwendung - Gib einen Link zu deiner öffentlichen Datenschutzerklärung an (optional)

    3. Link zu den Nutzungsbedingungen der Anwendung - Gib einen Link zu deinen öffentlichen Nutzungsbedingungen an (optional)

  5. Gib im Bereich Autorisierte Domains die Xentral-Domain an. Klicke auf +Domain hinzufügen und gib xentral.biz ein.

  6. Gib im Bereich Kontaktdaten des Entwicklers die E-Mail-Adresse an, die Google verwenden darf, um dich über Änderungen an deinem Projekt zu informieren.

  7. Klicke auf Speichern und Fortfahren.

  8. Im Bildschirm Bereiche kannst du Zugangsberechtigungen festlegen, die Nutzer autorisieren müssen, um deinem Projekt Zugriff auf spezifische private Nutzerdaten ihres Google-Kontos zu erlauben. Bereiche sind nicht verpflichtend. Klicke auf Speichern und Fortfahren, um auf den nächsten Bildschirm zu gelangen.

  9. Überprüfe deine eingegebenen Daten und klicke auf Zurück zum Dashboard, falls du keine Änderungen vornehmen möchtest.

Dies vervollständigt die Einrichtung deiner Google API und du kannst nun dein Gmail-Konto mit Xentral verbinden.

OAuth Client ID anlegen

Dies ist der dritte Schritt, um Google-Dienste mit Xentral zu verbinden. Dieser Schritt ist notwendig, um Xentral für OAuth-Server sichtbar zu machen.

  1. Logge dich in Xentral ein und navigiere zu Administration>System>Google API.

  2. Kopiere den Link aus dem Feld Redirect URI.

  3. Navigiere zu Google Cloud Console und öffne Anmeldedaten.

  4. Klicke auf Anmeldedaten erstellen und wähle OAuth-Client-ID.

  5. Wähle Webanwendung in der Anwendungstyp-Auswahlliste. Gib nun den Namen der App ein, zum Beispiel Xentral ERP.

  6. Klicke im Bereich Autorisierte Weiterleitungs-URIs auf URI hinzufügen. Füge hier den zuvor kopierten Link aus Xentral ein und klicke auf Erstellen.

  7. Die Dialogbox OAuth-Client erstellt erscheint und zeigt die Informationen Ihre Client-ID und Ihr Clientschlüssel an. Kopiere diese Zeichenfolge und füge sie in die entsprechenden Felder im Modul Google API in Xentral ein (Administration > System >Google API) .

    1. Kopiere die Zeichenfolge Ihre Client-ID aus der Google Cloud Console in das Feld Client ID in Xentral ein.

    2. Kopiere die Zeichenfolge Ihr Clientschlüssel aus der Google Cloud Console in das Feld Client Schlüssel in Xentral ein.

  8. Klicke auf Speichern.

  9. Klicke auf Ok, um die Dialogbox OAuth-Client erstellt in der Google Cloud Console zu schließen.

Dein Gmail-Konto an Xentral anbinden

Nun da du die API-Verbindung zwischen der Google Cloud und deiner Xentral-Instanz eingerichtet hast, musst du dein E-Mail-Konto in Xentral einrichten.

  1. Navigiere zu Administration > System > Benutzer und öffne das Konto des Administrators.

  2. Füge die E-Mail-Adresse im Bereich Bearbeiten Administrator in das Feld E-Mail ein und klicke auf Speichern.

  3. Navigiere zu Stammdaten > Adressen und öffne die Adresse des Administrators.

  4. Füge die gleiche E-Mail-Adresse, die du zuvor benutzt hast, im Bereich Kontaktdaten ein und klicke auf Speichern.

  5. Navigiere zu Administration > System > Email Accounts und klicke auf Neu, um einen neuen Eintrag anzulegen.

  6. Trage die folgenden Informationen ein:

    1. E-Mail-Adresse - die zuvor hinzugefügte E-Mail-Adresse

    2. Benutzername - optional

    3. Passwort - Passwort deines E-Mail-Kontos

    4. IMAP-Server - Der Standard IMAP-Server ist imap.gmail.com

    5. IMAP-Port - 993 und wähle IMAP für Google in der Auswahlliste.

  7. Gib im Bereich Einstellungen Senden SMTP (Optional) die folgenden Informationen ein:

    1. SMTP-Server: smtp.gmail.com

    2. SMTP-Port: 587

    3. SMTP-SSL: TLS

    4. SMTP-Authentifizierung: Google OAuth

    5. SMTP-DEBUG aktivieren: Setze hier ein Häkchen.

      Tipp

      Weitere Informationen zu den Gmail IMAP- und SMTP-Einstellungen findest du auf dieser Seite.

  8. Klicke auf Speichern.

  9. Nun musst du die E-Mail-Adresse autorisieren, um E-Mails in Xentral senden und empfangen zu können. Klicke auf das Profil-Symbol in der rechten oberen Ecke des Bildschirms und klicke dann auf Profil bearbeiten.

  10. Trage im Bereich Mein GoogleMail Konto deine E-Mail-Adresse ein und klicke auf Autorisieren.

  11. Der Zustimmungsbildschirm, den du zuvor angelegt hast, erscheint und du musst die Bedingungen akzeptieren.

  12. Klicke auf Test Email, um deine Einstellungen zu überprüfen.

Verwandte Beiträge

In unserer Academy findest du Videos zu fast allen Themen


Verwandte Community Beiträge