Gmail mithilfe von Google OAuth mit Odoo verbinden¶

Odoo ist mit Googles OAuth für Gmail kompatibel. Um sichere E-Mails von einer benutzerdefinierten Domain zu senden, müssen Sie lediglich einige Einstellungen auf Googles Workspace-Plattform und im Backend der Odoo-Datenbank konfigurieren. Diese Konfiguration funktioniert entweder mit einer persönlichen E-Mail-Adresse oder einer Adresse, die von einer benutzerdefinierten Domain erstellt wurde.

In Google einrichten¶

Neues Projekt erstellen¶

Um loszulegen, gehen Sie zur Google API Console. Melden Sie sich mit Ihrem Google-Workspace-Konto an, wenn Sie eines haben, andernfalls melden Sie sich mit Ihrem persönlichen Gmail-Konto an (dieses sollte mit der E-Mail-Adresse übereinstimmen, die Sie in Odoo konfigurieren möchten).

Klicken Sie dann auf Projekt erstellen, das sich ganz rechts auf dem OAuth-Zustimmungsbildschirm befindet. Wenn für dieses Konto bereits ein Projekt erstellt wurde, finden Sie die Option Neues Projekt oben rechts unter dem Drop-down-Menü Projekt auswählen.

Benennen Sie auf dem Bildschirm Neues Projekt den Projektnamen in Odoo um und suchen Sie nach dem Speicherort. Legen Sie den Speicherort als *Organisation von Google Workspace` fest. Wenn Sie ein persönliches Gmail-Konto verwenden, lassen Sie Organisation als Keine Organisation stehen.

Klicken Sie auf Erstellen, um den Schritt abzuschließen.

OAuth-Zustimmungsbildschirm¶

Wenn die Seite nicht zu den Optionen Benutzertyp weiterleitet, klicken Sie im linken Menü auf OAuth-Zustimmungsbildschirm.

Wählen Sie unter den Benutzertyp-Optionen den entsprechenden Benutzertyp und klicken Sie dann erneut auf Erstellen, was Sie schließlich zur Seite App-Registrierung bearbeiten führt.

App-Registrierung bearbeiten¶

Als nächstes werden wir die App-Registrierung des Projekts konfigurieren.

Im Schritt OAuth-Zustimmungsbildschirm geben Sie im Abschnitt App-Informationen in das Feld App-Name den Eintrag Odoo ein. Wählen Sie im Feld Benutzersupport die E-Mail-Adresse der Organisation aus.

Als nächstes klicken Sie unter App-Domain ‣ Autorisierte Domains auf Domain hinzufügen und geben odoo.com ein.

Danach geben Sie unter dem Abschnitt Kontaktinformationen des Entwicklers die E-Mail-Adresse der Organisation ein. Google verwendet diese E-Mail-Adresse, um die Organisation über alle Änderungen an Ihrem Projekt zu informieren.

Klicken Sie dann auf die Schaltfläche Speichern und weiter. Überspringen Sie dann die Seite Bereiche, indem Sie nach unten scrollen und auf Speichern und Weiter klicken.

Wenn Sie im Testmodus (Extern) fortfahren, fügen Sie als Nächstes die E-Mail-Adressen hinzu, die unter dem Schritt Testbenutzer konfiguriert wurden, indem Sie auf Benutzer hinzufügen und dann auf die Schaltfläche Speichern und Fortfahren klicken. Es erscheint eine Zusammenfassung der App-Registrierung.

Scrollen Sie schlussendlich nach unten und klicken Sie auf Zurück zum Dashboard, um die Einrichtung des Projekts abzuschließen.

Anmededaten erstellen¶

Jetzt, wo das Projekt eingerichtet ist, sollten Sie Anmeldedaten erstellen, die die Client-ID und das Client-Geheimnis enthalten. Klicken Sie zunächst auf Anmeldedaten im Menü der linken Seitenleiste.

Klicken Sie auf Anmeldedaten erstellen im oberen Menü und wählen Sie OAuth-Client-ID aus dem Drop-down-Menü aus.

• Wählen Sie unter Anwendungstyp aus dem Drop-down-Menü Webanwendung.

• Geben Sie im Feld Name Odoo ein.

• Klicken Sie unter dem Etikett Autorisierte Umleitungs-URIs auf die Schaltfläche URI HINZUFÜGEN, und geben Sie dann https://yourdbname.odoo.com/google_gmail/confirm in das Feld URIs 1 ein. Achten Sie darauf, dass Sie den Teil yourdbname der URL durch den tatsächlichen Namen der Odoo-Datenbank ersetzen.

• Klicken Sie dann auf Erstellen, um eine OAuth-Client-ID und Client-Geheimnis zu erzeugen. Kopieren Sie schließlich jeden generierten Wert für die spätere Verwendung bei der Konfiguration in Odoo und navigieren Sie dann zur Odoo-Datenbank.

Einrichtung in Odoo¶

Google-Anmeldedaten eingeben¶

Öffnen Sie zunächst die Odoo-Datenbank und navigieren Sie zum Modul Apps. Entfernen Sie dann den Filter Apps aus der Suchleiste und geben Sie Google ein. Danach installieren Sie das Modul mit dem Namen Google Gmail.

Als nächstes navigieren Sie zu Einstellungen ‣ Allgemeine Einstellungen und vergewissern sich unter dem Abschnitt Dialog, dass das Kontrollkästchen für Benutzerdefinierte E-Mail-Server oder Externe E-Mail-Server aktiviert ist. Dadurch wird eine neue Option für Gmail-Anmeldedaten oder Einen Gmail-Server verwenden eingefügt. Kopieren Sie dann die entsprechenden Werte und fügen Sie sie in die Felder Client-ID und Client-Geheimnis ein und Speichern die Einstellungen.

Postausgangsserver konfigurieren¶

Um das externe Gmail-Konto zu konfigurieren, kehren Sie zum Anfang der Einstellung Benutzerdefinierte E-Mail-Server zurück und klicken dann auf den Link Postausgangsserver.

Klicken Sie dann auf Neu oder Erstellen, um einen neuen E-Mail-Server zu erstellen, und geben Sie den Name, die Beschreibung und den Benutzernamen der E-Mail (falls erforderlich) ein.

Klicken Sie dann auf Gmail-OAuth-Authentifizierung oder Gmail (unter dem Abschnitt Authentifizieren mit oder Verbindung). Klicken Sie schließlich auf Verbinden Sie Ihr Gmail-Konto.

Ein neues Fenster mit der Bezeichnung Google öffnet sich, um den Autorisierungsprozess abzuschließen. Wählen Sie die entsprechende E-Mail-Adresse, die in Odoo konfiguriert ist.

Wenn es sich bei der E-Mail-Adresse um ein persönliches Konto handelt, erscheint ein zusätzlicher Schritt. Klicken Sie auf Fortfahren, um die Überprüfung zuzulassen und das Gmail-Konto mit Odoo zu verbinden.

Erlauben Sie dann Odoo den Zugriff auf das Google-Konto, indem Sie auf Fortfahren oder Zulassen klicken. Danach navigiert die Seite zurück zum neu konfigurierten Postausgangsserver in Odoo. Durch die Konfiguration wird das Token automatisch in Odoo geladen und ein Stichwort mit der Aufschrift Gmail-Token gültig erscheint in grün.

Klicken Sie schließlich auf Verbindung testen. Es sollte eine Bestätigungsmeldung erscheinen. Die Odoo-Datenbank kann nun mit Hilfe der OAuth-Authentifizierung sichere E-Mails über Google versenden.

FAQ für Google OAuth¶

Produktions- VS Test-Veröffentlichungsstatus¶

Wenn Sie Produktion als Veröffentlichungsstatus (anstelle von Test) wählen, wird die folgende Warnmeldung angezeigt:

Um diese Warnung zu korrigieren, navigieren Sie zur Google-API-Plattform. Wenn der Veröffentlichungsstatus auf In Produktion steht, klicken Sie auf Zurück zu Test, um das Problem zu beheben.

Keine Testbenutzer hinzugefügt¶

Wenn dem OAuth-Zustimmungsbildschirm keine Testbenutzer hinzugefügt werden, wird ein Fehler 403 Zugriff verweigert angezeigt.

Um diesen Fehler zu beheben, kehren Sie zum OAuth-Zustimmungsbildschirm unter APIs & Services zurück und fügen Sie der App Testbenutzer hinzu. Fügen Sie die E-Mail hinzu, die Sie in Odoo konfigurieren.

Gmail-Modul nicht aktualisiert¶

Wenn das Google-Gmail-Modul in Odoo nicht auf die neueste Version aktualisiert wurde, wird eine Verboten-Fehlermeldung angezeigt.

Um diesen Fehler zu beheben, gehen Sie zum Modul Apps und löschen Sie die Suchbegriffe. Suchen Sie dann nach Gmail oder Google und aktualisieren Sie das Modul Google Gmail. Klicken Sie schließlich auf die drei Punkte oben rechts im Modul und wählen Sie Upgrade.

Anwendungstyp¶

Bei der Erstellung der Anmeldedaten (OAuth-Client-ID und Client-Geheimnis) erscheint ein Autorisierungsfehler, wenn Desktop-App für den Anwendungstyp ausgewählt ist.

Um diesen Fehler zu beheben, löschen Sie die bereits erstellten Anmeldedaten und erstellen Sie neue Anmeldedaten, indem Sie Webanwendung als Anwendungstyp auswählen. Klicken Sie dann unter Autorisierte Umleitungs-URIs auf URI HINZUFÜGEN und geben Sie https://yourdbname.odoo.com/google_gmail/confirm in das Feld ein. Achten Sie darauf, dass Sie yourdbname in der URL durch den Namen der Odoo-Datenbank ersetzen.