# grommunio-auth - Zentrale Authentifizierung mit Keycloak und bestehendem SSO

Source: https://forgeone.solutions/de/tech/grommunio-auth-zentrale-authentifizierung-mit-keycloak-und-bestehendem-sso
Language: de
Published: 2026-05-02
Updated: 2026-11-17

Integration von grommunio in bestehende SSO-Umgebungen. Mit grommunio-auth wird die Plattform um eine Authentifizierungsschicht erweitert.

## Ziel dieser Anleitung

Dieser Beitrag macht grommunio-Plattform als praktisches Betriebsthema greifbar: Du erkennst den Nutzen, die wichtigsten Entscheidungen und die Prüfpunkte, die vor produktiver Nutzung stimmen müssen.

## Aktueller Stand: grommunio-auth mit Keycloak 2026

Dieser Beitrag bleibt als älterer Kontext erhalten. Für aktuelle zentrale Anmeldung in einer grommunio-Collaboration-Plattform inklusive korrekter URLs, Keycloak-Pfaden, MFA und Login-Test nutzt du die neue Anleitung.

[Aktuelle Auth-Anleitung öffnen](https://forgeone.solutions/de/tech/grommunio-auth-keycloak-2026-schritt-fuer-schritt)

## Voraussetzungen

Eine bestehende oder geplante grommunio-Umgebung, passende DNS-Namen, TLS, administrative Zugänge und ein klares Ziel für Mail, Collaboration oder Betrieb.

## **Integration von grommunio in bestehende SSO-Umgebungen**

## **1. Einleitung**

Mit grommunio-auth wird die Plattform um eine Authentifizierungsschicht erweitert, die auf Keycloak basiert und moderne Standards wie OpenID Connect unterstützt. Damit ist grommunio grundsätzlich in der Lage, selbst als Identity Provider zu fungieren. In der Praxis ist dieser Ansatz jedoch selten sinnvoll.

In produktiven Umgebungen sollte Authentifizierung nicht an einzelne Anwendungen gebunden sein. Benutzer, Passwörter, Multi-Faktor-Authentifizierung und Sicherheitsrichtlinien gehören in eine zentrale Instanz. Genau hier setzt die Integration in eine bestehende SSO-Umgebung an. Statt Identitäten mehrfach zu pflegen, wird grommunio an einen vorhandenen Identity Provider angebunden und nutzt diesen für die gesamte Authentifizierung.

Dieser Ansatz reduziert nicht nur den administrativen Aufwand, sondern sorgt auch für konsistente Sicherheitsmechanismen über alle Systeme hinweg. Grommunio-auth ist ab der Basic Lizenz inkludiert.

## **2. Zielarchitektur**

Die Integration basiert auf einem klassischen Identity-Broker-Modell. Der in grommunio integrierte Keycloak übernimmt dabei nicht mehr die Rolle des führenden Identity Providers, sondern fungiert als Vermittler.

Authentifizierungsanfragen werden von grommunio-auth an den zentralen Identity Provider weitergeleitet. Dort erfolgt die eigentliche Anmeldung inklusive Passwortprüfung und optionaler Multi-Faktor-Authentifizierung. Nach erfolgreichem Login wird der Benutzer wieder an grommunio zurückgegeben und erhält Zugriff auf die Anwendung.

Diese Architektur hat den Vorteil, dass sämtliche sicherheitsrelevanten Prozesse zentral gesteuert werden können, während grommunio ausschließlich als Service Provider agiert.

## **3. Best Practice: Anbindung an einen bestehenden Identity Provider**

Auch wenn es technisch möglich ist, grommunio-auth eigenständig zu betreiben, empfiehlt sich dieser Ansatz in den wenigsten Fällen. Eine isolierte Authentifizierung führt zwangsläufig zu doppelter Benutzerpflege, separaten Passwort-Richtlinien und einer zusätzlichen Verwaltung von 2FA-Mechanismen.

Gerade in Umgebungen mit mehreren Diensten entsteht dadurch schnell eine fragmentierte Identity-Landschaft. Änderungen an Benutzerkonten müssen mehrfach durchgeführt werden, Sicherheitsrichtlinien sind nicht einheitlich und das Risiko von Inkonsistenzen steigt.

Best Practice ist daher klar: grommunio wird an einen bestehenden Identity Provider angebunden und nutzt diesen als zentrale Instanz für Authentifizierung und Autorisierung. In vielen Umgebungen ist dies bereits ein vorhandener Keycloak, kann aber ebenso ein anderer OIDC-kompatibler Anbieter sein.

## **4. Installation von grommunio-auth**

Die Installation von grommunio-auth erfolgt auf der Appliance über folgenden CLI-Befehl:

```bash
zypper install grommunio-auth
```

Nach der Paketinstallation kann die Konfiguration von grommunio-auth beginnen:

```bash
/usr/share/grommunio-auth/setup-grommunio-auth.sh
```

Die Installation der Komponente ist ebenso unkompliziert wie die Appliance-Installation. Sofern nicht anders konfiguriert, verwendet grommunio-auth die lokale MariaDB-Instanz der Appliance.

[![grommunio-auth-install 1](https://forgeone.solutions/media/grommunio-auth-install-01.webp)](https://forgeone.solutions/media/grommunio-auth-install-01.webp)

Im nächsten Schritt wird der Fully Qualified Domain Name (FQDN) konfiguriert. Tragen Sie hier den Namen ein, unter dem auch Webmail erreichbar ist, zum Beispiel mail.example.test. grommunio-auth ist anschließend unter [https://mail.example.test/auth/](https://mail.example.test/auth/) erreichbar. Der interne Hostname ist hier ungeeignet, weil er von außen in der Regel nicht bekannt ist.

[![grommunio-auth-install 2](https://forgeone.solutions/media/grommunio-auth-install-02.webp)](https://forgeone.solutions/media/grommunio-auth-install-02.webp)

[![grommunio-auth-install 3](https://forgeone.solutions/media/grommunio-auth-install-03.webp)](https://forgeone.solutions/media/grommunio-auth-install-03.webp)

[![grommunio-auth-install 4](https://forgeone.solutions/media/grommunio-auth-install-04.webp)](https://forgeone.solutions/media/grommunio-auth-install-04.webp)

[![grommunio-auth-install 5](https://forgeone.solutions/media/grommunio-auth-install-05.webp)](https://forgeone.solutions/media/grommunio-auth-install-05.webp)

[![grommunio-auth-install 6](https://forgeone.solutions/media/grommunio-auth-install-06.webp)](https://forgeone.solutions/media/grommunio-auth-install-06.webp)

Anschließend kann das Passwort für den Master-Realm in grommunio-auth gesetzt werden. Wird kein Passwort vergeben, zeigt die Installation am Ende ein generiertes Passwort an.

[![grommunio-auth-install 7](https://forgeone.solutions/media/grommunio-auth-install-07.webp)](https://forgeone.solutions/media/grommunio-auth-install-07.webp)

Der Zugriff auf den Master-Realm sollte auf vertrauenswürdige IP-Subnetze beschränkt werden. Die Freigaben lassen sich später jederzeit unter /etc/grommunio-common/nginx/auth\_allow.conf bearbeiten.

[![grommunio-auth-install 8](https://forgeone.solutions/media/grommunio-auth-install-08.webp)](https://forgeone.solutions/media/grommunio-auth-install-08.webp)

[![grommunio-auth-install 9](https://forgeone.solutions/media/grommunio-auth-install-09.webp)](https://forgeone.solutions/media/grommunio-auth-install-09.webp)

Wenn die Einrichtung bis hierhin fehlerfrei abgeschlossen wurde, erscheint beim Aufruf von grommunio Web der folgende Anmeldeweg: [https://mail.example.test/web](https://mail.example.test/web) Die Anfrage wird direkt an grommunio-auth weitergeleitet.

[![grommunio-auth-install 9](https://forgeone.solutions/media/grommunio-auth-install-9.webp)](https://forgeone.solutions/media/grommunio-auth-install-9.webp)

In kleinen Umgebungen ist die Installation damit abgeschlossen. grommunio-auth greift auf die Benutzer in der grommunio-Datenbank zu, die im Admin-Interface angelegt oder per LDAP synchronisiert wurden. Die folgenden Schritte behandeln die direkte Integration in einen bestehenden Identity Provider (IdP), etwa einen zentralen Keycloak, in dem Benutzer bereits Multi-Faktor-Authentifizierung wie TOTP oder Passkeys verwenden.

Tippfehler oder nachträgliche Änderungen lassen sich in der grommunio-auth-Konfiguration unter /etc/grommunio-keycloak/ korrigieren.

Die folgenden Dateien findet man in dem Ordner:
/etc/grommunio-keycloak/keycloak.conf

```bash
# SPDX-License-Identifier: AGPL-3.0-or-later
# SPDX-FileCopyrightText: 2023 grommunio GmbH

db=mariadb
proxy=edge
http-port=9080
http-relative-path=/auth
http-host=localhost
http-enabled=true
db-username=grommunio_keycloak
db-password=[REDACTED]
db-url-database=grommunio_keycloak
db-url-host=localhost
hostname=mail.example.test
hostname-strict=false
hostname-strict-https=false
proxy-headers=xforwarded
```

/etc/grommunio-keycloak/grommunio.properties

```bash
# SPDX-License-Identifier: AGPL-3.0-or-later
# SPDX-FileCopyrightText: 2023 grommunio GmbH

grommunio.db-kind=org.mariadb.jdbc.Driver
grommunio.jdbc-url=jdbc:mariadb://localhost:3306/grommunio
grommunio.username=groauth
grommunio.password=Asjhdshdsya7GAGDSsytgasans
```

Ebenso beim Hostnamen unter /etc/gromox/keycloak.json:

```json
{
  "realm" : "grommunio",
  "auth-server-url" : "https://mail.example.test/auth/",
  "ssl-required" : "external",
  "resource" : "grommunio",
  "verify-token-audience" : true,
  "credentials" : {
    "secret": "[REDACTED]"
  },
  "confidential-port" : 0,
  "policy-enforcer" : {
    "credentials" : { }
  }
}
```

Danach einmal den grommunio-auth durchstarten:

```bash
systemctl restart grommunio-keycloak
```

## **5. Konfiguration im zentralen Identity Provider**

Für die Integration wird im zentralen Identity Provider ein neuer Client für grommunio angelegt. Dieser Client stellt die Vertrauensbeziehung zwischen beiden Systemen her.

Entscheidend ist hierbei die korrekte Definition der Redirect URI. Diese gibt an, wohin der Identity Provider den Benutzer nach erfolgreicher Authentifizierung zurückleiten darf. Sie muss exakt dem Broker-Endpunkt des grommunio-Keycloaks entsprechen.

Ein typisches Beispiel sieht wie folgt aus:

https://mail.example.test/auth/realms/grommunio/broker/<alias>/endpoint

[![grommunio-auth-install 10](https://forgeone.solutions/media/grommunio-auth-install-10.webp)](https://forgeone.solutions/media/grommunio-auth-install-10.webp)

Bereits kleine Abweichungen führen hier zu Fehlern, weshalb dieser Punkt besonders sorgfältig umgesetzt werden sollte. Nach der Erstellung des Clients wird zusätzlich ein Secret generiert, das später im grommunio-Keycloak hinterlegt wird.

[![grommunio-auth-install 11](https://forgeone.solutions/media/grommunio-auth-install-11.webp)](https://forgeone.solutions/media/grommunio-auth-install-11.webp)

[![grommunio-auth-install 12](https://forgeone.solutions/media/grommunio-auth-install-12.webp)](https://forgeone.solutions/media/grommunio-auth-install-12.webp)

[![grommunio-auth-install 13](https://forgeone.solutions/media/grommunio-auth-install-13.webp)](https://forgeone.solutions/media/grommunio-auth-install-13.webp)

[![grommunio-auth-install 14](https://forgeone.solutions/media/grommunio-auth-install-14.webp)](https://forgeone.solutions/media/grommunio-auth-install-14.webp)

## **6. Einrichtung des Identity Providers im grommunio-Keycloak**

Auf der grommunio-Seite wird anschließend ein neuer Identity Provider konfiguriert. Dieser verweist auf den zentralen Keycloak und nutzt dessen OpenID-Connect-Discovery-Mechanismus, um die notwendigen Endpunkte automatisch zu übernehmen.

[![grommunio-auth-install 15](https://forgeone.solutions/media/grommunio-auth-install-15.webp)](https://forgeone.solutions/media/grommunio-auth-install-15.webp)

[![grommunio-auth-install 16](https://forgeone.solutions/media/grommunio-auth-install-16.webp)](https://forgeone.solutions/media/grommunio-auth-install-16.webp)

Neben Client-ID und Secret ist vor allem die Wahl des Alias relevant. Dieser wird intern für den Broker verwendet und muss konsistent in allen weiteren Konfigurationen verwendet werden.

In der Praxis haben sich Einstellungen wie ein erzwungener Synchronisationsmodus sowie das Vertrauen in die vom Identity Provider gelieferten E-Mail-Adressen bewährt. Dadurch wird sichergestellt, dass Benutzerattribute bei jedem Login aktualisiert werden und keine unnötigen Rückfragen im Login-Prozess entstehen.

## **7. Erzwingen von SSO und Entfernen des lokalen Logins**

Nach der erfolgreichen Anbindung ist der nächste Schritt, den lokalen Login vollständig zu deaktivieren. Standardmäßig erlaubt Keycloak weiterhin die Anmeldung über lokale Benutzerkonten, was in einem SSO-Szenario nicht gewünscht ist.

Dies wird über den sogenannten Browser Flow gesteuert. Hier wird der Login-Prozess so angepasst, dass Anfragen unmittelbar an den konfigurierten Identity Provider weitergeleitet werden. Der zentrale Baustein ist dabei der „Identity Provider Redirector“, der als verpflichtender Schritt definiert wird.

[![grommunio-auth-install 17](https://forgeone.solutions/media/grommunio-auth-install-17.webp)](https://forgeone.solutions/media/grommunio-auth-install-17.webp)

[![grommunio-auth-install 19](https://forgeone.solutions/media/grommunio-auth-install-19.webp)](https://forgeone.solutions/media/grommunio-auth-install-19.webp)

Sobald dieser korrekt konfiguriert ist, erfolgt kein lokaler Login mehr. Stattdessen wird jeder Zugriff direkt an den zentralen Identity Provider delegiert. Für den Benutzer entsteht damit ein konsistentes Login-Verhalten über alle angebundenen Systeme hinweg.

Ergänzend wird unter `/etc/grommunio-common/nginx/locations.d/grommunio-auth.conf` anzulegen mit dem Inhalt:

```nginx
location ~ ^/auth/realms/grommunio/broker/[^/]+/endpoint/logout_response$ {
    return 302 $scheme://$host/web/;
}
```

Diese Konfiguration sorgt dafür, dass Benutzer beim Abmelden über einen externen Broker nicht am lokalen Logout-Bildschirm von grommunio-auth verbleiben. Ohne diese Einstellung kann eine erneute Anmeldung in den Kontoeinstellungen von grommunio-auth statt in der grommunio-Webanwendung enden.

## **8. Typische Fehler und Stolpersteine**

In der Praxis treten bei der Integration immer wieder ähnliche Fehlerbilder auf. Häufig liegt die Ursache in einer fehlerhaften Redirect URI oder einem nicht korrekt konfigurierten Browser Flow. In solchen Fällen wird entweder kein Redirect durchgeführt oder der Login bricht mit generischen Fehlermeldungen ab.

Ein weiterer häufiger Punkt ist die Benutzerzuordnung. grommunio erwartet, dass Benutzer im Backend existieren und korrekt gemappt werden. Stimmen die Attribute aus dem Identity Provider nicht mit den lokalen Benutzerdaten überein, kann der Zugriff trotz erfolgreicher Authentifizierung scheitern.

Auch der direkte Zugriff auf Keycloak-Endpunkte führt oft zu Verwirrung, da Benutzer dann in der Account-Konsole landen, statt im Webmail-Interface. Entscheidend ist hier, dass der Einstieg immer über die eigentliche Anwendung erfolgt.

## **9. Fazit**

Die Integration von grommunio in eine bestehende SSO-Umgebung ist kein optionales Feature, sondern der empfohlene Betriebsmodus für produktive Systeme. Sie reduziert Komplexität, vermeidet redundante Konfigurationen und sorgt für eine klare Trennung zwischen Anwendung und Identitätsverwaltung.

Wer bereits eine zentrale Identity-Lösung im Einsatz hat, sollte diese konsequent auch für grommunio nutzen. Das Ergebnis ist eine deutlich stabilere und wartungsärmere Umgebung mit einheitlichen Sicherheitsstandards.

## **10. Forecast**

Im nächsten Beitrag geht es um ein ebenso zentrales Thema im Betrieb eines Mailservers: Spamfiltering. Dabei betrachten wir grommunio-antispam und rspamd im Detail und zeigen, wie sich Zustellbarkeit, Reputation und Filterqualität gezielt verbessern lassen.

## Betrieb und Validierung

Prüfe nach jedem Schritt Dienste, Webzugriff, Anmeldung, Logs und die betroffenen Integrationen. Für produktive Umgebungen gehören Backup, Monitoring, Updates und dokumentierte Rollback-Schritte fest dazu.

## Produktionscheckliste

- Ziel, Scope und Verantwortlichkeiten sind dokumentiert.
- DNS, TLS, Netzwerk, Accounts und Berechtigungen sind geprüft.
- Installation oder Änderung wurde mit UI- und CLI-Signalen validiert.
- Backup, Monitoring, Updates und Rollback sind vor produktiver Nutzung geklärt.
- Lizenzen, Supportwege und Professional Services sind für den Betrieb eingeplant.

## Quellen und weiterführende Dokumentation

Für produktive Umsetzung zählen zusätzlich immer die aktuelle Herstellerdokumentation, Release Notes, Sicherheitsmeldungen und die eigenen Betriebsstandards. Dieser Beitrag fasst die praktische ForgeOne-Einordnung zusammen und ersetzt keine projektspezifische Planung.

### grommunio-Plattform mit ForgeOne besprechen

ForgeOne unterstützt bei Planung, Architektur, Installation, Migration, Betrieb, Support und Lizenzen für Open-Source- und Enterprise-Linux-Plattformen.

- [Projekt besprechen](https://forgeone.solutions/de/kontakt)

## Titelbild

[![grommunio Web-Login als Kartenmotiv für zentrale Anmeldung mit Keycloak und MFA.](https://forgeone.solutions/media/grommunio-auth-2026-card.png)](https://forgeone.solutions/media/grommunio-auth-2026-card.png)

## Autor

Mathias Rumbold

## Kategorie

- [grommunio & Groupware](https://forgeone.solutions/de/tech/grommunio-auth-zentrale-authentifizierung-mit-keycloak-und-bestehendem-sso?category=grommunio-groupware)

## Tags

- [grommunio](https://forgeone.solutions/de/tech/grommunio-auth-zentrale-authentifizierung-mit-keycloak-und-bestehendem-sso?tags=grommunio)
- [openSUSE](https://forgeone.solutions/de/tech/grommunio-auth-zentrale-authentifizierung-mit-keycloak-und-bestehendem-sso?tags=opensuse)
- [Groupware](https://forgeone.solutions/de/tech/grommunio-auth-zentrale-authentifizierung-mit-keycloak-und-bestehendem-sso?tags=groupware)
- [SUSE](https://forgeone.solutions/de/tech/grommunio-auth-zentrale-authentifizierung-mit-keycloak-und-bestehendem-sso?tags=suse)
- [Open Source](https://forgeone.solutions/de/tech/grommunio-auth-zentrale-authentifizierung-mit-keycloak-und-bestehendem-sso?tags=open-source)
- [grommunio Auth](https://forgeone.solutions/de/tech/grommunio-auth-zentrale-authentifizierung-mit-keycloak-und-bestehendem-sso?tags=grommunio-auth)
- [Keycloak](https://forgeone.solutions/de/tech/grommunio-auth-zentrale-authentifizierung-mit-keycloak-und-bestehendem-sso?tags=keycloak)
- [Europäische Open-Source Lösungen](https://forgeone.solutions/de/tech/grommunio-auth-zentrale-authentifizierung-mit-keycloak-und-bestehendem-sso?tags=european-open-source-solutions)
- [Selbst-Hosten](https://forgeone.solutions/de/tech/grommunio-auth-zentrale-authentifizierung-mit-keycloak-und-bestehendem-sso?tags=self-hosted)
- [Digitale Souveränität](https://forgeone.solutions/de/tech/grommunio-auth-zentrale-authentifizierung-mit-keycloak-und-bestehendem-sso?tags=digital-sovereignity)

## Weiterführende Inhalte

- [grommunio](https://forgeone.solutions/de/produkte/grommunio)
- [Security & Identity](https://forgeone.solutions/de/security-identity)
- [Installation von grommunio – Aufbau einer eigenen Groupware-Plattform](https://forgeone.solutions/de/tech/installation-von-grommunio-aufbau-einer-eigenen-groupware-plattform)
- [grommunio-antispam – effiziente Spamfilterung mit zentraler Verwaltung und lernenden Mechanismen](https://forgeone.solutions/de/tech/grommunio-antispam-effiziente-spamfilterung-mit-zentraler-verwaltung-und-lernenden-mechanismen)
