Lerne, wie du mit OAuth2 Gmail für den Nachrichtenversand einrichtest
Die IROIN® Influencer Marketing Suite lässt sich mit Gmail über eine OAuth2-Anwendung in der Google Cloud Console integrieren, um deinen Nachrichtenversand zu optimieren. Mit dieser Schritt-für-Schritt-Anleitung kannst du die Integration problemlos umsetzen, sodass du E-Mails direkt über IROIN® versenden kannst. Du benötigst Zugriff auf die Google Cloud Console und musst sicherstellen, dass du die notwendigen Berechtigungen hast.
Projekt und OAuth-Zustimmung in der Google Cloud Console anlegen
1.) Öffne die Google Cloud Console und erstelle ein neues Projekt, indem du auf „Projekt erstellen“ klickst. Je nachdem, ob du bereits ein Projekt erstellt hast oder nicht, kann der Text anders aussehen, aber das Dropdown-Menü sollte vorhanden sein. Gib dem Projekt einen Namen, zum Beispiel „IROIN Gmail Integration“, und speichere es.
2.) Gehe dann zu „APIs und Dienste“ und klicke anschließend auf „Apps und Dienste aktivieren“.
3.) Wähle das eben erstellte Projekt aus, dann gehe zu „Gmail API“ im Bereich „Google Workspace“.
4.) Klicke hier auf „Aktivieren“ und gehe nun in der seitlichen Navigation auf „OAuth-Zustimmungsbildschirm“.
5.) Nun müssen wir entscheiden, welcher Art von Benutzern wir Zugang gewähren wollen. In diesem Abschnitt wählen wir „Intern“, sodass nur Konten aus unserer Organisation verwendet werden können. „Extern“ bedeutet, dass auch Konten von außerhalb der Organisation Zugriff hätten.
Aber Vorsicht: Wenn wir diese App tatsächlich öffentlich machen, würde das ein monatelanges Sicherheitsaudit und enorme Kosten bedeuten.
6.) Fülle die erforderlichen Felder aus, wie App-Name - wir nehmen einfach den Projektnamen - sowie die E-Mail-Adressen für Support und Entwickler, und speichere die Einstellungen.
7.) Als Nächstes können wir die gewünschten Bereiche auswählen. Dies ist etwas knifflig, da der benötigte Bereich nicht immer aufgeführt ist und nicht über die Suche gefunden werden kann. Wir müssen ihn also manuell hinzufügen. Der genaue Bereich, den wir hinzufügen müssen, ist „https://mail.google.com/“ (ohne Anführungszeichen).
8.) Nun, da wir den fehlenden Bereich hinzugefügt haben, können wir ihn auswählen.
Der von uns verwendete Bereich ermöglicht uns den Zugriff auf IMAP und SMTP sowie auf das öffentliche Benutzerprofil - nicht mehr und nicht weniger.
9.) Nachdem wir uns vergewissert haben, dass die Tabelle der Gmail-Bereiche den gewünschten Bereich enthält, können wir speichern und fortfahren.
Nachdem unsere Anwendung nun konfiguriert ist, müssen wir die Anmeldedaten für IROIN® erstellen.
Anmeldeinformationen erstellen und Client-ID & Client Secret erhalten
1.) Wähle im Menü auf der linken Seite unter APIs & Dienste die Option “Anmeldedaten”.
Die Liste der Anmeldeinformationen ist zunächst leer, daher müssen wir einige erstellen, indem wir auf die Schaltfläche „Anmeldeinformationen erstellen“ klicken und dann „OAuth-Client-ID“ aus der Dropdown-Liste auswählen.
2.) Wähle als Anwendungstyp „Webanwendung“ aus.
3.) Wir müssen auch einige URIs bereitstellen. Der erste ist der Anwendungs-URI ohne Pfadangabe. Der Standardwert für IROIN® ist die Domain Ihrer Instanz (im Beispiel https://iroin.ims.iroin.io).
Als nächstes folgt die Oauth-Umleitungs-URL. Sobald der Nutzer sein Einverständnis gegeben hat, leitet Google den Nutzer mit den entsprechenden Token auf diese URL um, so dass sie auf die OAuth-Verarbeitungsseite auf IROIN® verweisen muss. Im Grunde handelt es sich um die App-URI + „/silent-oauth.html“, z. B. „https://iroin.ims.iroin.io/silent-oauth.html“.
4.) Klicke auf die Schaltfläche „Erstellen“ und überprüfe auf der Seite „Anmeldeinformationen“ den Abschnitt „OAuth 2.0 Client IDs“. Dort sollten die soeben erstellten Anmeldeinformationen aufgeführt sein. Klicke auf die Schaltfläche „Download“ und schon haben wir unsere Anmeldeinformationen!
Konfiguration in der IROIN® Suite und Verbindung testen
1.) Wechsle nun in deine IROIN®-Instanz und klicke auf „Einstellungen → Messaging → Apps“.
2.) Du befindest dich jetzt in der Konfiguration von IROIN®. Klicke auf „App hinzufügen“, um die eben erstellte Gmail-App mit unserer Software zu verbinden.
3.) Als Nächstes kannst du die Gmail-Anmeldedaten nehmen und sie auf der App-Konfigurationsseite hinzufügen. Klicke abschließend auf „Speichern“.
Das war's dann auch schon!