Ab Juni 2024 beginnt Google schrittweise sogenannte Less Secure Apps von der Verwendung der Google Dienste auszuschließen. Weitere Informationen zur Umstellung seitens Google findest du hier. weclapp befindet sich aktuell im Verifizierungsprozess, um Nutzern Google OAuth 2.0 anbieten und eine einfachere Verknüpfung mit Google Diensten ermöglichen zu können. Bis die Verifizierung abgeschlossen ist, nutze bitte die nachfolgende Anleitung um deinen Google Account mit weclapp verknüpfen zu können.
Ein neues Projekt in deinem Google Konto anlegen und konfigurieren
Projekt anlegen
Um dein Google-Konto in weclapp einzubinden musst du zuerst eine neues Projekt anlegen. Gehe dazu bitte wie folgt vor:
- Melde dich in deinem Google-Account an und öffne die Google Cloud Console.
- Wähle im Dropdown oben links “Projekt auswählen”
- Wähle im sich öffnenden Fenster “Neues Projekt”
- Wähle einen Namen für dein Projekt und für deine Organisation und bestätige den Vorgang mit dem Button “Erstellen”
Sobald du dein Projekt erfolgreich angelegt hast, kannst du mit dem nächsten Schritt fortfahren.
Benötigte APIs aktivieren
In diesem Schritt musst du die APIs der Dienste aktivieren, die an weclapp angebunden werden sollen.
- Wähle im Dropdown oben links auf der Startseite der Google Cloud Console dein eben erstelltes Projekt
- Öffne die Sidebar und navigiere zu “APIs und Dienste” > “Aktivierte APIs und Dienste”
- Wähle auf der Seite “+ APIs und Dienste aktivieren”
- In der API-Bibliothek kannst du die folgenden APIs aktivieren
- Gmail API: Zum Verwalten der Mails deines Google-Accounts
- Google Calendar API: Zum Verwalten des Kalenders deines Google-Accounts
- Google People API: Zum Verwalten der Kontakte deines Google-Accounts
Nachdem du alle gewünschten APIs aktiviert hast, kanns du mit der Erstellung des OAuth Zustimmungsbildschirms fortfahren.
OAuth Zustimmungsbildschirm erstellen
In diesem Schritt erstellst und konfigurierst du den Zustimmungsbildschirm für dein Google Konto.
- Öffne die Sidebar und navigiere zu “APIs und Dienste” > “OAuth-Zustimmungsbildschirm”
- Im Abschnitt “User Type” gibt es nun zwei Möglichkeiten. Wähle den entsprechenden Typ und klicke auf “Erstellen”
- Intern: Für Google Workspace Konten
- Extern: Für persönliche Google Konten
- Vergib auf der folgenden Seite jetzt diese Daten und bestätige mit “Speichern und fortfahren”
-
- Anwendungsname: Der Name der App, die Zugriff erhalten soll (bspw. “weclapp”)
- Nutzersupport-E-Mail: Für Nutzer, die wegen Rückfragen zur Zustimmung Kontakt aufnehmen wollen. Hier kannst du deine eigene E-Mail auswählen
- Kontaktdaten des Entwicklers: Gib hier eine E-Mail Adresse an, über die Google dich über Änderungen am Projekt informieren kann
- Auf der folgenden Seite klickst du auf “Bereiche hinzufügen oder entfernen” und wählst dann die gewünschten Bereiche. Bestätige dann wieder mit “Speichern und fortfahren”.
- Immer benötigt: https://www.googleapis.com/auth/userinfo.email
- E-Mail: https://mail.google.com/
- Kalender: https://www.googleapis.com/auth/calendar
- Kontakte: https://www.googleapis.com/auth/contacts
- Im Bereich “Testnutzer” legst du nun die Mailadressen der Nutzer an und bestätigst mit “Speichern und fortfahren”. Private und Workspace Konten unterscheiden sich dabei wie folgt:
- Privates Konto: Trage die Mailadresse des aktuell angemeldeten Benutzers ein
- Workspace Konto: Trage die Mailadressen aller Nutzer ein, die in weclapp angebunden werden sollen
Client-ID und Clientschlüssel erstellen
Zuletzt erstellst du die Client-ID und den Clientschlüssel, die du für die Anbindung an weclapp benötigst
- Navigiere in der Sidebar zu “APIs und Dienste” > “Anmeldedaten” und klicke auf “+ Anmeldedaten erstellen” und wähle “OAuth-Client-ID”
- Wähle als Anwendungstyp “Webanwendung”
- Den Namen kannst du beliebig vergeben
- Unter “autorisierte Weiterleitungs-URLs” gibst du bitte “https://portal.weclapp.com/webapp/resource/rest/redirect/state” an, damit du nach der Einrichtung wieder zu deinem weclapp-System zurückgeleitet wirst
- Schließe dann den Vorgang mit “Erstellen” ab.
- Jetzt öffnet sich ein Fenster mit der eben erstellten Client-ID und dem Clientschlüssel. Diese Daten benötigst du im nächsten Schritt zur Einbindung des Accounts in weclapp
Dein Google-Konto ist jetzt fertig eingerichtet. Die weiteren Schritte musst du in deinem weclapp-System durchführen
Google Konto in weclapp anbinden
weclapp Cloud
Wenn du weclapp Cloud Kunde bist, kannst du deine E-Mail Konten direkt in der Webanwendung einrichten. Gehe dabei wie folgt vor:
- Rufe in deinem System “Meine Einstellungen” auf und füge im Abschnitt “E-Mail-Einstellungen” ein neues Konto hinzu oder rufe globale Einstellungen > Grundeinstellungen > System-E-Mail-Konten auf, wenn du ein System-E-Mail-Konto einrichten willst
- Wähle als Account-Typ “Google”
- Bitte trage die folgenden Daten ein:
- E-Mail-Adresse: Die Mailadresse des Accounts, den du einbinden willst
- Client-ID: Die Client-ID des dazugehörigen Google Kontos
- Clientschlüssel: Den Clientschlüssel des Google Kontos
- Jetzt kannst du noch weitere Optionen wählen, bspw. ob du auch Kalender und Kontakte synchronisieren möchtest
- Test mit einem Klick auf “Testen” ob die Einbindung erfolgreich war und bestätige dann mit “Speichern” oder “Speichern und schließen”
- Dein Google Konto ist jetzt fertig eingerichtet und kann verwendet werden
weclappON
Falls du weclappON Kunde bist, müssen die Client-ID und der Clientschlüssel in der weclappON-Instanz konfiguriert werden. Die Konfiguration erfolgt in der Datei docker-compose.yml (die sich normalerweise in /opt/weclapp befindet). Bearbeite diese Datei und füge die folgenden beiden Zeilen zur Umgebung des App-Dienstes hinzu (ersetze die Punkte durch die Client-ID und den Clientschlüssel des Google Accounts):
- WPP_googleClientId=... - WPP_googleClientSecret=...
Nachdem diese Zeilen hinzugefügt wurden, sollte die Datei docker-compose.yml wie folgt aussehen:
version: '2' services: db: ... app: image: docker.weclapp.com/weclapp:latest container_name: weclapp_app restart: unless-stopped environment: - WECLAPP_MAX_HEAP=1024M - WPP_googleClientId=... - WPP_googleClientSecret=... links: ...
Nach der Aktualisierung von docker-compose.yml müssen die Container einmal aktualisiert/neugestartet werden: Führe wie gewohnt “docker-compose up -d” aus.
Im Anschluss können deine Google-Konten in deiner weclappON-Instanz verbunden werden.
