Google

Konfigurieren Sie Google als OAuth-Anbieter, damit sich Benutzer mit ihrem Google Konto bei Zammad anmelden können.

Eine Google-App registrieren

  1. Legen Sie ein neues Projekt an, wenn Sie noch keins haben. Folgen Sie dazu diesem Link: https://console.cloud.google.com/projectcreate

  2. Prüfen Sie, ob Sie sich bereits in Ihrem Projekt befinden. Wenn nicht, wechseln Sie dorthin.

  3. Gehen Sie zu APIs & Services > OAuth consent screen. Sofern noch nicht konfiguriert, sollten Sie eine Schaltfläche Get started sehen. Befolgen Sie die Schritte und geben Sie die angeforderten Informationen ein.

    • App name: Ein beliebiger passender Name. Das sieht der Benutzer, wenn er versucht, sich über Google anzumelden.

    • User support email: Wählen Sie hier eine verfügbare E-Mail-Adresse aus.

    • Audience: Wählen Sie intern oder extern, je nach Anwendungsfall.

    • Contact Information: Geben Sie eine E-Mail Adresse an, die über Änderungen in Ihrem Projekt informiert werden soll.

  4. Gehen Sie zu APIs & Services > Credentials. Fügen Sie eine Konfiguration hinzu, indem Sie auf das Dropdown-Menü Create credentials klicken. Wählen Sie OAuth client ID und geben Sie die folgenden Informationen ein. Ersetzen Sie zammad_host durch den FQDN Ihres Zammads. Sie finden den Redirect-URI auch in der Google OAuth-Konfiguration von Zammad.

    • Application type: Web application

    • Name: Ein beliebiger passender Name für Ihren Anwendungsfall, z.B. Zammad.

    • Authorized JavaScript origins: https://zammad_host/

    • Authorized redirect URIs: https://zammad_host/auth/google_oauth2/callback

    Screenshot zeigt den Abschnitt mit den OAuth-Zugangsdaten in der Google-Console

  5. Nachdem Sie die Informationen hinzugefügt haben, klicken Sie auf Create. Daraufhin wird ein Dialogfeld geöffnet, in dem Sie wichtige Informationen sehen können. Achten Sie darauf, diesen Dialog geöffnet zu lassen und/oder die Client ID und das Client secret zu kopieren.

Screenshot zeigt Client-ID- und Client-Secret-Dialog

Authentifizierung in Zammad konfigurieren

Nachdem Sie die Zugangsdaten erstellt haben, gehen Sie zu Ihrer Zammad-Installation und navigieren Sie zu Einstellungen > Sicherheit > Anwendungen von Drittanbietern > Anmeldung über Google. Geben Sie hier Ihre Client ID und Ihr Client secret ein, aktivieren Sie das Feature per Schalter und klicken Sie auf Übermitteln.

Screenshot zeigt die Google OAuth-Konfiguration in Zammad

Nach dem Absenden können sich die Benutzer mit ihrem Google Konto anmelden.