# grommunio 2026.06.2 Upgrade und technische Abnahme: Keycloak SSO, MFA, AutoDiscover und Mailflow

Source: https://forgeone.solutions/de/tech/grommunio-2026-06-2-upgrade-keycloak-sso-praxis
Language: de
Published: 2026-10-02
Updated: 2026-11-16

Praxisanleitung: grommunio 2026.06.1 auf 2026.06.2 aktualisieren, Keycloak SSO beachten und mit System-, Mail-, Discovery-, MFA-, Browser- und Client-Checks abnehmen.

## Einleitung

grommunio 2026.06.2 ist aus Betriebssicht nicht nur ein Paketupdate. Spannend wird das Release dort, wo bestehende Komponenten nach dem Upgrade wieder als zusammenhängende Plattform funktionieren müssen: Web, Files, Chat, Archive, Admin und die zentrale Anmeldung über grommunio Auth und Keycloak.

Dieser Beitrag ist deshalb als praktische Upgrade-Anleitung aufgebaut: Was vor dem Upgrade gesichert werden muss, wie der Lauf von 2026.06.1 auf 2026.06.2 nachvollziehbar dokumentiert wird, welche SSO-/Keycloak-Punkte nachgezogen werden mussten und welche Tests danach verpflichtend in die Abnahme gehören. Die Kernbotschaft ist einfach: Ein funktionierendes Paketupdate ist noch kein vollständig verifiziertes Plattform-Upgrade.

## Testumgebung und Annahmen

- Datum: 2. Oktober 2026.
- Umgebung: isolierte Test-Appliance mit grommunio 2026.06.1 als Ausgangspunkt.
- Upgrade-Pfad: grommunio 2026.06.1 auf grommunio 2026.06.2.
- Keine Produktion: Test-Host, Test-Domain und reproduzierbarer Ausgangszustand.
- Ziel: Upgrade, zentrale Keycloak-SSO-Flows und Betriebszustand so prüfen, dass daraus eine nutzbare Admin-Checkliste entsteht.

## Upgrade-Ablauf als Runbook

Der sichere Ablauf besteht aus drei Phasen: vor dem Upgrade den Zustand beweisbar festhalten, das Upgrade kontrolliert durchführen und danach nicht nur Dienste, sondern echte Benutzer- und Client-Flows prüfen.

1. Snapshot oder Backup prüfen und Wiederherstellungsweg kennen.
2. Paketstände, aktive Dienste, SSO-Baseline und zentrale Endpoints erfassen.
3. Offiziellen Upgrade-Pfad der eingesetzten Appliance-Version prüfen.
4. Upgrade durchführen und Ausgabe vollständig sichern.
5. Reboot-Empfehlung ernst nehmen und kontrolliert neu starten.
6. Nach dem Reboot systemctl --failed und zypper ps -s prüfen.
7. Files, Chat, Archive, Admin und Keycloak nicht nur als Dienst, sondern per Login-Flow prüfen.
8. Autodiscover, Autoconfig, SMTP, IMAP, DAV, ActiveSync und EWS zumindest endpoint-seitig kontrollieren.
9. Auffälligkeiten klar als PASS, FAIL, SKIPPED, NOT TESTED oder NOT APPLICABLE dokumentieren.

## Was beim Upgrade von 2026.06.1 auf 2026.06.2 besonders wichtig war

| Prüfpunkt | Warum wichtig |
| --- | --- |
| Files occ status | DB-Schema kann nach Paketupdate noch offen sein |
| Files OIDC Discovery | Server muss Keycloak-Zertifikat vertrauen |
| Files OIDC Callback | /files/index.php/apps/user\_oidc/... muss korrekt geroutet werden |
| Chat SSO Migration | bestehende Chat-Accounts brauchen SSO-Zuordnung |
| Archive/Admin Adapter | OIDC-Adapter müssen tatsächlich vorhanden sein |
| Admin preferred\_username | Keycloak-User muss zum grommunio Admin User passen |
| MFA Required Action | Admin darf erst nach TOTP/MFA ins Dashboard |
| Autodiscover/Autoconfig | Clients brauchen funktionierende Discovery |
| SMTP/IMAP | Web-Login allein beweist keinen Mailflow |
| Meet/Jitsi | HTTP 200 reicht nicht, Backend-Dienste müssen laufen |

## Vor dem Upgrade: Baseline schaffen

Ohne Baseline ist ein Upgrade-Test schnell wertlos. Wenn nachher etwas nicht funktioniert, muss klar sein, ob der Fehler neu ist oder vorher schon vorhanden war. Vor dem Upgrade sollten deshalb Paketstände, Dienste, relevante Endpoints und der vorhandene SSO-Zustand gesichert werden.

```bash
rpm -qa | sort | grep -E '^(grommunio|gromox)'
systemctl --failed
zypper ps -s
openssl s_client -connect mail.example.test:443 -servername mail.example.test -verify_return_error
curl --fail https://mail.example.test/web/
curl --fail https://mail.example.test/files/status.php
curl --fail https://mail.example.test/auth/realms/grommunio/.well-known/openid-configuration
```

## Upgrade auf 2026.06.2

Das eigentliche Paketupdate kann je nach Appliance-Stand und Herstellerempfehlung unterschiedlich dokumentiert sein. In der geprüften Umgebung war zusätzlich der Helper grommunio-update vorhanden, während die geprüfte Operations-Dokumentation Package Updates weiterhin über zypper ref und zypper up beschreibt. Für Runbooks gehört deshalb beides in die Prüfung: offizieller Upgrade-Pfad der eingesetzten Version und tatsächlich ausgeführte Befehle.

```bash
zypper --non-interactive --gpg-auto-import-keys ref
zypper --non-interactive --gpg-auto-import-keys up

# Nach dem Reboot:
zypper ps -s
systemctl --failed
```

Für eine produktive Anleitung ist der konkrete Befehl nicht der einzige relevante Punkt. Entscheidend ist, dass der gewählte Upgrade-Pfad zur Appliance-Version passt, dass die Ausgabe gesichert wird und dass danach eine fachliche Abnahme folgt. Ein Runbook sollte daher neben dem Paketbefehl immer auch die Tests unten enthalten.

```text
Paket                         Version nach dem Upgrade
grommunio-release             2026.06.2
grommunio-web                 5.1.20
grommunio-files               34.0.4
grommunio-keycloak            26.7.4
grommunio-auth                0.2.37
gromox                        3.11.136
grommunio-admin-api           1.21.23
grommunio-chat-v10            10.5.8
grommunio-archive             1.4.9
```

## Wie vollständig haben wir die Appliance getestet?

Der finale Abnahmelauf wurde produktionsnah aufgebaut: nicht nur 127.0.0.1, sondern der echte Lab-FQDN mail.example.test mit SNI, Hostname-Prüfung und explizit vertrautem Lab-Zertifikat. Der Report trennt echte PASS-Ergebnisse klar von nicht getesteten oder nicht anwendbaren Bereichen.

Für Partner und Kunden ist daraus ein Runbook ableitbar: erst Baseline, dann Upgrade-Pfad prüfen, dann Update ausführen, danach System Health, Files, Keycloak/OIDC, Browser-SSO, Mailflow, Autodiscover, Autoconfig, DAV, EWS und EAS prüfen. Clients wie Thunderbird, Outlook oder ActiveSync bleiben nur dann PASS, wenn sie wirklich mit frischem Profil oder kontrolliertem Testclient durchlaufen wurden.

## Technische Abnahme

Die Ergebniskontrolle folgt dem einheitlichen grommunio-Format. PASS bedeutet, dass der konkrete Prüfpunkt aktiv ausgeführt und belegt wurde. FAIL, SKIPPED und NOT TESTED bleiben bewusst sichtbar, damit aus einem Paketupdate keine Scheinsicherheit wird.

| Prüfbereich | Prüfung | Ergebnis |
| --- | --- | --- |
| System Health | Failed Units, Reboot-State und zentrale Dienste prüfen | PASS |
| Upgrade Evidence | Paketstand und tatsächlichen zypper-Lauf dokumentieren | PASS |
| TLS | FQDN, SNI und Zertifikatsprüfung mit vertrauter Lab-CA prüfen | PASS |
| OIDC Discovery | Realm-Metadaten mit issuer, auth, token und JWKS prüfen | PASS |
| Web SSO | Keycloak-Login bis zur grommunio Web UI durchführen | PASS |
| Files SSO | occ status, serverseitige OIDC Discovery und UI-Login prüfen | PASS |
| Chat SSO | SSO-Login bis zur Kanalansicht verifizieren | PASS |
| Archive SSO | Unauthentifizierten Einstieg bis zum Keycloak-OIDC-Redirect prüfen | PASS |
| Admin SSO/MFA | preferred\_username Mapping, TOTP und Dashboard prüfen | PASS |
| Cross-App SSO | Verhalten im gemeinsamen Browser-Kontext messen | PASS |
| Autodiscover | V1 und V2 für EWS, ActiveSync und AutoDiscoverV1 prüfen | PASS |
| Autoconfig | Thunderbird XML mit IMAP/SMTP-Informationen abrufen | PASS |
| SMTP/IMAP | Submission, STARTTLS, AUTH, Zustellung und IMAP-Fetch prüfen | PASS |
| DAV/EWS | DAV PROPFIND 207 und EWS GetFolder 200 prüfen | PASS |
| EAS Endpoint | ActiveSync URL, Discovery und erwartete Auth-Challenge prüfen | PASS |
| EAS Client Sync | Kontrollierten ActiveSync-Client mit Provisioning, FolderSync und initialem Sync ausführen | PASS WITH CONDITIONS |
| EAS Endgerät | Echtes iOS-/Android-Gerät mit Kunden-Policy und Push-Verhalten prüfen | NOT TESTED |
| Meet | Webroute und Jitsi-Backend-Dienste getrennt prüfen | PASS |
| Thunderbird GUI | Frisches IMAP/SMTP-Profil, Screenshots, SMTP mit Attachment und IMAP-Zustellnachweis | PASS WITH CONDITIONS |

## Pflichttests nach dem Upgrade

Die folgende Liste ist der eigentliche Abnahmekern. Ein grommunio-Upgrade sollte erst dann als abgeschlossen gelten, wenn diese Punkte entweder bestanden oder bewusst als nicht getestet dokumentiert sind.

- System: Paketstand, failed Units, Reboot-State, zentrale Dienste.
- Identity: Keycloak Realm, OIDC Discovery, Clients, Redirect URIs, Callback-Verhalten.
- MFA: Required Actions, TOTP-Setup, Admin-Zugriff erst nach MFA.
- Web: Login, Reload, Mailbox sichtbar, keine Auth-Fehler.
- Files: occ status, needsDbUpgrade false, serverseitige OIDC Discovery, Files UI.
- Chat: SSO-Login, Benutzerzuordnung, Kanalansicht.
- Archive: SSO-Login, Suchoberfläche, keine OIDC-Fehler.
- Admin: SSO Button, preferred\_username Mapping, Rolle, Dashboard.
- Mail: SMTP Submission, STARTTLS, AUTH, IMAP-Zustellung.
- Discovery: Autodiscover und Autoconfig für Clients.
- Protokolle: DAV per PROPFIND, EWS per echter SOAP-Anfrage, ActiveSync mindestens mit erwarteter Auth-Challenge und anschließend mit echtem Client, falls produktiv genutzt.
- Meet: Webroute und Jitsi-Backend-Dienste getrennt prüfen.
- Negative Tests: falsches Passwort darf keine Anwendungssession erzeugen.
- Logout/Session: lokaler Logout und Keycloak-Session-Verhalten getrennt betrachten.

## Was bedeutet PASS in diesem Test?

Bei Browser-SSO bedeutet PASS nicht einfach HTTP 200. Ein Flow wurde erst dann als erfolgreich gewertet, wenn die Anwendung aufgerufen wurde, der Redirect zum richtigen Identity Provider führte, die Authentifizierung funktionierte, erforderliche MFA-Schritte abgeschlossen wurden, der OIDC-Callback zurückkam, eine Anwendungssession entstand und ein eindeutiges authentifiziertes UI-Element sichtbar war.

Für native Protokolle ist PASS enger definiert: SMTP/IMAP wurde als Mailflow mit Zustellung geprüft, DAV mit authentifiziertem PROPFIND und EWS mit einer echten SOAP-GetFolder-Anfrage auf die Inbox. ActiveSync wurde zusätzlich mit einem kontrollierten Testclient für Provisioning, FolderSync und initialen Sync geprüft. Ein echtes iOS- oder Android-Gerät mit Kunden-Policy und Push-Verhalten bleibt ein separater Pflichtschritt, wenn genau diese Endgeräte produktiv genutzt werden.

## Client- und MFA-Matrix

Zentrale Browser-Anmeldung und native Clients müssen getrennt bewertet werden. Keycloak, OIDC und MFA sichern die Web- und Browser-Flows. IMAP, SMTP, DAV, EWS und ActiveSync können je nach Client und Konfiguration andere Authentifizierungswege verwenden. Deshalb darf ein erfolgreicher Browser-MFA-Test nicht automatisch als Thunderbird-, Outlook- oder Mobile-Sync-Abnahme gewertet werden.

| Client/Protokoll | Discovery | Authentifizierung | MFA-Einordnung | Abnahmestatus |
| --- | --- | --- | --- | --- |
| Web, Files, Chat, Archive, Admin | OIDC Redirects und Callbacks | Keycloak/OIDC | Browser-MFA geprüft, Admin bis Dashboard | PASS |
| Thunderbird AutoConfig | Mozilla AutoConfig XML | frisches Thunderbird-Profil zusätzlich geprüft | Browser-MFA nicht anwendbar | PASS für Discovery |
| Thunderbird IMAP/SMTP | AutoConfig-Daten plus frisches Profil | Native Mail-Authentifizierung | nicht durch Browser-MFA belegt | PASS WITH CONDITIONS |
| IMAP/SMTP | aus AutoConfig ableitbar | Native Mail-Authentifizierung | nicht durch Browser-MFA belegt | PASS für Mailflow |
| CalDAV/CardDAV | Well-known Redirects zu /dav | DAV Basic/Auth im Test | nicht durch Browser-MFA belegt | PARTIAL |
| EWS | AutoDiscover V1/V2 | SOAP GetFolder mit Mailbox-Zugriff | Modern Auth/MFA nicht belegt | PASS für EWS-Endpoint |
| ActiveSync | AutoDiscover V2 ActiveSync | Provisioning, FolderSync und initialer Sync mit kontrolliertem Client | Browser-MFA nicht anwendbar | PASS WITH CONDITIONS |
| iOS/Android EAS | kundenspezifisches Gerätesetup | nicht ausgeführt | Push/Policy separat testen | NOT TESTED |
| Outlook/MAPI | nicht ausgeführt | nicht ausgeführt | nicht bewertet | NOT TESTED |

## Thunderbird und echte Endgeräte als letzter Abnahmeschritt

Für Kunden, die Thunderbird produktiv einsetzen, endet die Abnahme nicht beim XML. Der Clientpfad wurde deshalb mit Thunderbird 156.0 und frischem Profil erneut geprüft: IMAP/SMTP-Konto, Inbox, SMTP Submission mit Attachment und Zustellnachweis per IMAP. Die vertiefte Native-Clients-Abnahme ist als eigener Folgebeitrag dokumentiert: /de/tech/grommunio-native-clients-keycloak-sso-2026.

Bewusst nicht als vollständiger Thunderbird-PASS gewertet sind Kalender- und Kontakte-CRUD über CalDAV/CardDAV sowie ein vollständiger EWS-GUI-Pfad. Diese Punkte gehören in eigene Clienttests, wenn sie beim Kunden produktiv relevant sind.

Für ActiveSync wurde der Schritt nachgezogen: Ein kontrollierter EAS-Testclient hat Connectivity, Provisioning, FolderSync mit 14 Ordnern und einen initialen Sync über 11 Collections erfolgreich durchgeführt. Das ist ein belastbarer Server- und Protokollnachweis. Was es nicht ersetzt, ist ein kundenspezifischer iOS- oder Android-Test mit echten Policies, Push-Verhalten, Geräteverwaltung und Benutzerabläufen.

## Erster Stolperstein: Files auf HTTP 503

Nach dem Paketupdate war grommunio Files zunächst nicht vollständig betriebsbereit. Die Anwendung antwortete mit HTTP 503, obwohl das Paketupdate selbst erfolgreich war. Die Ursache war kein globaler Plattformausfall, sondern ein ausstehendes Datenbank-Upgrade von Files.

```bash
sudo -u grofiles php -d memory_limit=1024M /usr/share/grommunio-files/occ upgrade
```

Das ist eine wichtige Betriebserkenntnis: Ein erfolgreiches Paketupdate bedeutet nicht automatisch, dass alle datenbankgestützten Komponenten bereits auf dem neuen Schema laufen. Files sollte nach einem Upgrade aktiv mit occ status, Logs und einem echten Login geprüft werden.

## Zentrale Authentifizierung mit grommunio Auth und Keycloak

Die stärkere Zentralisierung der Anmeldung ist der eigentliche Schwerpunkt dieses Tests. grommunio Auth stellt die Keycloak-Integration bereit, die einzelnen Anwendungen verwenden eigene OIDC-Clients beziehungsweise Adapter, und Keycloak wird zur zentralen Stelle für Login, Required Actions und MFA.

```text
Keycloak
                         |
                    grommunio Auth
                         |
         +---------------+----------------+
         |               |                |
         v               v                v
        Web            Files            Admin
         |               |                |
         +-------+-------+-------+--------+
                 |               |
                 v               v
                Chat           Archive
```

Meet wird bewusst getrennt betrachtet: Die Webroute /meet/ antwortete im finalen Endpoint-Test mit HTTP 200, und die relevanten Dienste jitsi-jicofo, jitsi-videobridge und prosody waren aktiv. Für eine Kundenfreigabe sollte zusätzlich ein echter Zwei-Browser- oder Zwei-Client-Raumtest erfolgen, weil ein erreichbares Frontend allein noch keine Medienpfad-Abnahme ist.

## Welche SSO-Flows tatsächlich funktioniert haben

```text
Komponente       Ergebnis        Besonderheit
Web              erfolgreich     Keycloak-Login bis in die Weboberfläche
Files            erfolgreich     DB-Upgrade, TLS-Vertrauen und Callback geprüft
Chat             erfolgreich     bestehende Accounts auf SSO migriert
Archive          erfolgreich     Adapter-Konfiguration nachgezogen
Admin            erfolgreich     preferred_username-Mapping plus MFA bis Dashboard
```

## SSO-Login-Belege pro Modul

Für die Abnahme reicht es nicht, am Ende nur ein Dashboard zu zeigen. Pro Modul muss sichtbar sein, wie der SSO-Einstieg funktioniert: direkte Weiterleitung zu Keycloak oder lokale Login-Seite mit Keycloak-Schaltfläche. Die folgenden Screenshots zeigen genau diesen Einstiegspunkt je Anwendung.

[![grommunio Web leitet für SSO direkt zur Keycloak Login-Maske](https://forgeone.solutions/media/grommunio-2026-06-2-web-sso-keycloak-login.png)](https://forgeone.solutions/media/grommunio-2026-06-2-web-sso-keycloak-login.png)

Screenshot: Web: Der unauthentifizierte Zugriff führt direkt zur Keycloak Login-Maske.

[![grommunio Files Login mit Schaltfläche für grommunio Keycloak](https://forgeone.solutions/media/grommunio-2026-06-2-files-sso-login.png)](https://forgeone.solutions/media/grommunio-2026-06-2-files-sso-login.png)

Screenshot: Files: Die lokale Login-Seite bietet den Einstieg über grommunio Keycloak.

[![grommunio Files nach Klick auf Keycloak SSO in der Keycloak Login-Maske](https://forgeone.solutions/media/grommunio-2026-06-2-files-sso-keycloak-login.png)](https://forgeone.solutions/media/grommunio-2026-06-2-files-sso-keycloak-login.png)

Screenshot: Files: Nach Klick auf grommunio Keycloak wird die zentrale Keycloak Login-Maske geöffnet.

[![grommunio Chat Login mit Keycloak-Schaltfläche](https://forgeone.solutions/media/grommunio-2026-06-2-chat-sso-login.png)](https://forgeone.solutions/media/grommunio-2026-06-2-chat-sso-login.png)

Screenshot: Chat: Die Login-Seite zeigt den Keycloak-Einstieg neben dem lokalen Login.

[![grommunio Chat nach Klick auf Keycloak SSO in der Keycloak Login-Maske](https://forgeone.solutions/media/grommunio-2026-06-2-chat-sso-keycloak-login.png)](https://forgeone.solutions/media/grommunio-2026-06-2-chat-sso-keycloak-login.png)

Screenshot: Chat: Nach Auswahl von Keycloak landet der Browser im zentralen Realm.

[![grommunio Archive leitet für SSO direkt zur Keycloak Login-Maske](https://forgeone.solutions/media/grommunio-2026-06-2-archive-sso-keycloak-login.png)](https://forgeone.solutions/media/grommunio-2026-06-2-archive-sso-keycloak-login.png)

Screenshot: Archive: Der unauthentifizierte Zugriff führt zur Keycloak Login-Maske.

[![grommunio Web nach erfolgreichem Keycloak Login im Upgrade-Lab](https://forgeone.solutions/media/grommunio-2026-06-2-web-authenticated.png)](https://forgeone.solutions/media/grommunio-2026-06-2-web-authenticated.png)

Screenshot: grommunio Web ist nach dem Keycloak-Login mit einer Test-Mailbox erreichbar.

[![grommunio Files nach erfolgreichem Keycloak Login mit synthetischen Lab-Dateien](https://forgeone.solutions/media/grommunio-2026-06-2-files-authenticated.png)](https://forgeone.solutions/media/grommunio-2026-06-2-files-authenticated.png)

Screenshot: grommunio Files lädt nach OIDC-Callback und abgeschlossenem Files-Datenbankupgrade.

[![grommunio Chat nach erfolgreichem Keycloak Login mit synthetischem Lab-Kanal](https://forgeone.solutions/media/grommunio-2026-06-2-chat-authenticated.png)](https://forgeone.solutions/media/grommunio-2026-06-2-chat-authenticated.png)

Screenshot: grommunio Chat erreicht nach SSO eine angemeldete Kanalansicht.

[![grommunio Admin Login mit Single-Sign-on-Schaltfläche im Upgrade-Lab](https://forgeone.solutions/media/grommunio-2026-06-2-upgrade-sso-admin-login.png)](https://forgeone.solutions/media/grommunio-2026-06-2-upgrade-sso-admin-login.png)

Screenshot: Der Admin-Login bietet nach dem Upgrade den SSO-Einstieg an.

[![Keycloak Login nach dem SSO-Redirect aus grommunio Admin](https://forgeone.solutions/media/grommunio-2026-06-2-upgrade-sso-keycloak-login.png)](https://forgeone.solutions/media/grommunio-2026-06-2-upgrade-sso-keycloak-login.png)

Screenshot: Nach dem Klick auf SSO landet der Browser bei Keycloak im grommunio-Realm.

[![grommunio Admin Dashboard nach erfolgreichem Keycloak SSO und MFA-Setup](https://forgeone.solutions/media/grommunio-2026-06-2-upgrade-sso-admin-dashboard.png)](https://forgeone.solutions/media/grommunio-2026-06-2-upgrade-sso-admin-dashboard.png)

Screenshot: Nach Authentifizierung und MFA-Setup ist das grommunio Admin Dashboard erreichbar.

## Chat: bestehende Accounts auf SSO umstellen

Bei bestehenden Installationen ist Chat besonders wichtig, weil vorhandene Accounts nicht automatisch bedeuten, dass der neue Login-Pfad schon sauber verwendet wird. Bestehende Chat-Accounts sollten deshalb gezielt auf SSO geprüft und bei Bedarf migriert werden.

```bash
grommunio-admin chat sso enable
```

Danach gehören Chat-Dienst, Login-Button und Kanalansicht in die Abnahme.

## Archive und Admin: fehlende Adapter nachziehen

In bestehenden Umgebungen sollte nach dem Upgrade geprüft werden, ob die Adapter-Konfigurationen für Archive und Admin tatsächlich vorhanden sind. Falls sie fehlen oder nicht zum Realm passen, müssen sie gezielt nachgezogen werden. Das ist kein pauschaler Fehler von grommunio Auth, sondern ein sinnvoller Kontrollpunkt für Upgrades.

```bash
/usr/share/grommunio-auth/setup-grommunio-auth-clients.sh archive admin
```

Wichtig ist die Unterscheidung: Was stellt der Hersteller bereit, was sollte automatisch passieren, und was ist in einer konkreten Umgebung tatsächlich passiert? Genau diese Trennung macht einen Upgrade-Test verwertbar.

## Files: TLS und OIDC Discovery

Files benötigt die OpenID-Provider-Metadaten nicht nur im Browser, sondern auch serverseitig. Wenn interne oder selbstsignierte Zertifikate verwendet werden, müssen OS Trust Store und Files-Umgebung diese CA kennen.

In einer sauber aufgebauten produktiven PKI sollte dieser Sonderfall normalerweise nicht auftreten. Die Architekturlektion bleibt trotzdem wichtig: OIDC ist nicht nur Browser-Kommunikation, sondern betrifft auch serverseitige Discovery und TLS-Vertrauen.

## Stolperstein: OIDC Callback und PATH\_INFO

Der Files-OIDC-Callback unter /files/index.php/apps/user\_oidc/... ist ein guter Kandidat für Upgrade-Probleme, wenn nginx, PHP-FPM oder Rewrite-Regeln angepasst wurden. Statt eine komplette Nginx-Konfiguration zu veröffentlichen, ist die Prüfliste wichtiger.

- Kommt der Browser nach Keycloak wirklich auf die erwartete Callback-URL zurück?
- Wird index.php als Script erkannt und der Rest als PATH\_INFO übergeben?
- Sieht PHP-FPM denselben Pfad wie Nginx?
- Gibt es 403, 404 oder 500 im Callback statt einer Anwendungssession?
- Sind Nginx-Errorlog, PHP-FPM-Log und Files-Log zum gleichen Zeitpunkt geprüft?

## Admin SSO: Identity Mapping ist wichtiger als das Passwort

Ein besonders wichtiger Befund betrifft grommunio Admin. Die Admin API löst den OIDC-Claim preferred\_username gegen die grommunio Admin User Datenbank auf. Ein lokales Admin-Passwort allein macht daher noch keinen funktionierenden SSO-Login.

```text
Keycloak
   |
   | preferred_username
   v
grommunio Admin API
   |
   | User lookup
   v
grommunio Admin Database
```

- Welche föderierte Identität bekommt Adminzugang?
- Welcher Username wird als preferred\_username übertragen?
- Gibt es dazu einen passenden grommunio Admin User?
- Welche Rolle besitzt dieser User?
- Soll der lokale admin-Account überhaupt für SSO verwendet werden?
- Welche MFA-Policy gilt für Admin-Zugänge?

## MFA bis zum Dashboard getestet

Der Admin-Test war kein oberflächlicher Button-Test. Der Browser wurde von Admin zu Keycloak geleitet, Keycloak erzwang die Required Action für TOTP, das MFA-Setup wurde abgeschlossen, und erst danach kam der Browser zurück ins Admin Dashboard. Genau so soll ein sicherer Flow aussehen.

1. Admin SSO auswählen.
2. Redirect zu Keycloak.
3. Authentifizierung durchführen.
4. TOTP-Setup als Required Action abschließen.
5. MFA verifizieren.
6. Zurück ins grommunio Admin Dashboard.

## Warum Browser-SSO wirklich geprüft werden muss

Ein HTTP 200 sagt wenig darüber aus, ob ein Identity Flow funktioniert. SSO besteht aus Redirects, Cookies, OIDC-Callbacks, Anwendungssessions, MFA-Required-Actions und UI-Zuständen. Deshalb sollte die Abnahme immer als echter Browserablauf durchgeführt werden.

```text
Application
    ↓
Redirect
    ↓
Keycloak
    ↓
Authentication
    ↓
MFA / Required Actions
    ↓
OIDC Callback
    ↓
Application Session
    ↓
Authenticated UI
```

Für eine belastbare Abnahme sollte der Browserlauf protokolliert werden: aufgerufene Anwendung, Redirect-Ziel, Callback, sichtbarer Login-Zustand und Fehler aus Browser-Konsole oder Serverlogs. So bleibt nachvollziehbar, ob Web, Files, Chat, Archive und Admin wirklich über SSO funktionieren.

## Eine Anmeldung, mehrere Anwendungen

SSO bedeutet nicht zwingend, dass eine Anwendung ohne jeden Redirect sofort eine eigene Session besitzt. In der Praxis kann der Ablauf weiterhin über Keycloak laufen, aber die bestehende Identity-Session wird wiederverwendet. Genau dieses Verhalten wurde zusätzlich in einem gemeinsamen Browser-Kontext gemessen.

```text
Wechsel im selben Browser-Kontext       Beobachtung
Web Login                                erfolgreich als alice@example.test
Web -> Archive                           transparente Keycloak-Session wiederverwendet
Web -> Files                             Files zeigte den eigenen Login/SSO-Einstieg
Web -> Chat                              Chat zeigte den eigenen Login/SSO-Einstieg
Web -> Admin                             nicht im selben User-Kontext getestet
```

[![Cross-App-SSO: Files zeigt im direkten Einstieg den eigenen Login mit Keycloak-Schaltfläche](https://forgeone.solutions/media/grommunio-2026-06-2-cross-app-files-entry.png)](https://forgeone.solutions/media/grommunio-2026-06-2-cross-app-files-entry.png)

Screenshot: Cross-App-Test: Files zeigte beim direkten Einstieg weiterhin den eigenen Login mit Keycloak-Schaltfläche.

Das ist kein Widerspruch zu SSO, sondern eine wichtige Abnahme-Erkenntnis: Manche Anwendungen starten den OIDC-Flow transparent, andere erwarten zuerst den expliziten SSO-Einstieg innerhalb der Anwendung.

## Autodiscover gehört zur Abnahme

Eine Groupware-Plattform besteht nicht nur aus Weboberflächen. Nach dem Upgrade wurden deshalb auch Autodiscover, Mozilla Autoconfig und zentrale Protokollpfade geprüft. Autodiscover V1 und V2 lieferten verwertbare Antworten, Autoconfig lieferte XML mit IMAP- und SMTP-Informationen, DAV antwortete authentifiziert mit 207 Multi-Status, EWS beantwortete eine SOAP-GetFolder-Anfrage auf die Inbox mit HTTP 200, und ActiveSync wurde bis Provisioning, FolderSync und initialem Sync geprüft.

## Mailflow und Protokolle

Zusätzlich wurde SMTP Submission mit STARTTLS, Authentifizierung und lokaler Zustellung in eine Test-Mailbox geprüft. Per IMAPS wurde kontrolliert, dass die Nachricht in der Inbox angekommen ist. Webmail-Versand, Reply und Sent Items bleiben eigene Browser-Tests; ActiveSync-FolderSync wurde mit kontrolliertem Client geprüft, echte Mobilgeräte bleiben bei produktiver Nutzung ein eigener Abnahmeschritt.

## Finaler Health Check

- Keine fehlgeschlagenen systemd Units.
- zypper ps -s meldete keinen notwendigen Reboot mehr.
- Keycloak aktiv.
- Admin API aktiv.
- Nginx aktiv.
- PHP-FPM aktiv.
- MariaDB aktiv.
- Redis aktiv.
- Gromox aktiv.
- Chat aktiv.
- Archive aktiv.
- Meet-Webroute erreichbar, jitsi-jicofo, jitsi-videobridge und prosody aktiv.

## Upgrade-Checkliste

1. Vor dem Upgrade Paketstände, Services, Endpoints und SSO-Baseline sichern.
2. Offiziellen Upgrade-Pfad der eingesetzten Appliance-Version prüfen; zusätzlich kontrollieren, ob grommunio-update vorhanden ist und welche Paketbefehle die Herstellerdokumentation für genau diese Version beschreibt.
3. Paketupgrade durchführen und Reboot-Anforderung ernst nehmen.
4. Nach dem Reboot zypper ps -s und systemctl --failed prüfen.
5. Files mit occ status prüfen und nötigenfalls occ upgrade ausführen.
6. Chat-Accounts auf SSO migrieren, wenn bestehende Accounts vorhanden sind.
7. grommunio-auth-Adapter für alle relevanten Anwendungen prüfen.
8. TLS-Vertrauen für serverseitige OIDC-Discovery prüfen.
9. OIDC-Callbacks im Browser und in Logs prüfen.
10. Admin-Identity-Mapping über preferred\_username bewusst festlegen.
11. MFA für Admin-Zugänge bis zum Dashboard testen.
12. Browser-Smoke-Test für Web, Files, Chat, Archive und Admin dokumentieren.
13. Native Protokolle mit realem FQDN, gültiger Trust Chain und synthetischen Testdaten prüfen.
14. Desktop- und Mobil-Clients nur dann als PASS werten, wenn ein frisches Profil beziehungsweise ein echter Testclient eingerichtet wurde.

## Partner-Runbook: Reihenfolge für eigene Umgebungen

Wer den Beitrag als Vorlage für Kundenumgebungen nutzt, sollte die Schritte in dieser Reihenfolge ausführen. Die Werte aus dem Lab wie mail.example.test sind Platzhalter und müssen durch den echten FQDN, die echte Maildomain und die produktive oder interne CA ersetzt werden.

| Phase | Schritt | Warum |
| --- | --- | --- |
| 1 | Wartungsfenster, Backup und Rollback prüfen | Ohne Rückweg ist ein Upgrade kein kontrollierter Betriebsvorgang. |
| 2 | Paketstand, Dienste, Files-Status, OIDC und Discovery vor dem Upgrade sichern | Nur so ist später klar, was neu kaputt ist und was vorher schon abwich. |
| 3 | Offiziellen Upgrade-Pfad der konkreten Appliance-Version prüfen | grommunio-update, Admin UI oder Zypper dürfen nicht aus Gewohnheit gewählt werden. |
| 4 | Upgrade ausführen und Ausgabe vollständig speichern | Fehler dürfen nicht im Terminalscroll verloren gehen. |
| 5 | Reboot-Bedarf und failed Units prüfen | Ein grüner Paketlauf ersetzt keinen System-Health-Check. |
| 6 | Files mit occ status und gegebenenfalls occ upgrade prüfen | Schema-Migrationen können nach Paketupdates offen bleiben. |
| 7 | Keycloak/OIDC, Clients, Redirect URIs und MFA prüfen | SSO-Probleme zeigen sich oft erst beim Callback. |
| 8 | Browser-Apps einzeln testen: Web, Files, Chat, Archive, Admin, Meet | Jede Anwendung hat eigene Session- und Callback-Pfade. |
| 9 | Mailflow testen: SMTP Submission, IMAPS, Zustellung, Attachment | Groupware ist erst brauchbar, wenn echte Mailpfade funktionieren. |
| 10 | Discovery testen: AutoDiscover V1/V2, AutoConfig, DAV | Clients hängen an diesen Endpoints, nicht nur an Weboberflächen. |
| 11 | Native Protokolle testen: DAV PROPFIND, EWS SOAP, EAS Client falls genutzt | HTTP 200 allein ist kein Client-Nachweis. |
| 12 | Desktop- und Mobilclients mit frischem Profil testen | Thunderbird, Outlook und EAS dürfen nur mit echter Client-Evidence PASS werden. |

## FAQ

### Reicht zypper up als Upgrade-Test?

Nein. zypper prüft Pakete, aber nicht, ob Files-Datenbankmigration, OIDC-Discovery, Callback, MFA und Anwendungssessions funktionieren.

### Sollte man grommunio-update verwenden?

Auf der getesteten Appliance ist grommunio-update vorhanden und bietet check, update und upgrade an. Gleichzeitig beschreibt die aktuell geprüfte grommunio Operations-Dokumentation Package Updates über zypper ref und zypper up. Für Runbooks heißt das: nicht raten, sondern pro Version die Herstellerdokumentation und das installierte Werkzeug prüfen.

### War MFA ein Fehler im Admin-Login?

Nein. Wenn Keycloak eine TOTP-Required-Action erzwingt, ist das erwartetes Security-Verhalten. Wichtig ist, den Flow bis zum abgeschlossenen MFA-Setup und zurück ins Admin Dashboard zu testen.

### Muss jeder diese manuellen Schritte ausführen?

Nicht pauschal. Der Artikel trennt Herstellerverhalten, erwartete Automatisierung, mögliche Nacharbeiten in bestehenden Umgebungen und umgebungsspezifische Sonderfälle. Genau deshalb sollten Upgrades vor Produktion reproduzierbar getestet werden.

## Fazit

Ein Upgrade auf grommunio 2026.06.2 ist erst nach vollständiger technischer Abnahme wirklich aussagekräftig. Entscheidend sind nicht nur Pakete und Dienste, sondern DB-Migrationen, Identity-Konfiguration, TLS-Vertrauen, Callback-Verhalten, MFA und echte Browser-Flows.

Für produktive Umgebungen ist genau das der Unterschied zwischen einem Update und einem belastbaren Plattform-Upgrade.

### grommunio-Upgrades reproduzierbar testen

ForgeOne unterstützt bei grommunio-Upgrades, zentralem SSO, Keycloak, MFA, Migration, Betrieb, Monitoring und dokumentierten Abnahmetests.

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

## Titelbild

[![grommunio Admin Login mit Single-Sign-on-Schaltfläche im Upgrade-Lab](https://forgeone.solutions/media/grommunio-2026-06-2-upgrade-sso-admin-login.png)](https://forgeone.solutions/media/grommunio-2026-06-2-upgrade-sso-admin-login.png)

## Autor

Mathias Rumbold

## Kategorie

- [grommunio & Groupware](https://forgeone.solutions/de/tech/grommunio-2026-06-2-upgrade-keycloak-sso-praxis?category=grommunio-groupware)

## Tags

- [grommunio](https://forgeone.solutions/de/tech/grommunio-2026-06-2-upgrade-keycloak-sso-praxis?tags=grommunio)
- [grommunio Auth](https://forgeone.solutions/de/tech/grommunio-2026-06-2-upgrade-keycloak-sso-praxis?tags=grommunio-auth)
- [Keycloak](https://forgeone.solutions/de/tech/grommunio-2026-06-2-upgrade-keycloak-sso-praxis?tags=keycloak)
- [SSO](https://forgeone.solutions/de/tech/grommunio-2026-06-2-upgrade-keycloak-sso-praxis?tags=sso)
- [MFA](https://forgeone.solutions/de/tech/grommunio-2026-06-2-upgrade-keycloak-sso-praxis?tags=mfa)
- [OpenID Connect](https://forgeone.solutions/de/tech/grommunio-2026-06-2-upgrade-keycloak-sso-praxis?tags=openid-connect)
- [Upgrade](https://forgeone.solutions/de/tech/grommunio-2026-06-2-upgrade-keycloak-sso-praxis?tags=upgrade)
- [Groupware](https://forgeone.solutions/de/tech/grommunio-2026-06-2-upgrade-keycloak-sso-praxis?tags=groupware)

## grommunio-Upgrade sauber abnehmen

ForgeOne unterstützt bei Upgrade-Planung, Keycloak-SSO, MFA, AutoDiscover, Mailflow und technischer Abnahme.

[grommunio-Upgrade besprechen](https://forgeone.solutions/de/produkte/grommunio)

## grommunio 2026 Schritt für Schritt

Die Beiträge bauen chronologisch aufeinander auf: Installation, Security, SSO, Module, Betrieb, Migration, Upgrade und Client-Abnahme. Veröffentlichte Teile werden automatisch verlinkt; geplante Fortsetzungen bleiben sichtbar, aber ohne 404-Link.

1. [grommunio 2026.06.1 installieren: Vom ISO zur lauffähigen Groupware](https://forgeone.solutions/de/tech/grommunio-2026-installieren)
2. [grommunio-antispam mit Rspamd: Spamfilterung, Lernen und Betrieb Schritt für Schritt](https://forgeone.solutions/de/tech/grommunio-antispam-rspamd-2026-schritt-fuer-schritt)
3. [grommunio-auth mit Keycloak: SSO und zentrale Anmeldung Schritt für Schritt](https://forgeone.solutions/de/tech/grommunio-auth-keycloak-2026-schritt-fuer-schritt)
4. [grommunio Meet 2026 ohne Keycloak einrichten und optional mit SSO erweitern](https://forgeone.solutions/de/tech/grommunio-meet-2026-schritt-fuer-schritt)
5. [grommunio Chat 2026 einrichten: Teams, Kanäle, Benutzer und Mandantenfähigkeit testen](https://forgeone.solutions/de/tech/grommunio-chat-2026-schritt-fuer-schritt)
6. [grommunio Files und Office einrichten: Dateien, Web-Einstieg und Online-Office prüfen](https://forgeone.solutions/de/tech/grommunio-files-office-2026-schritt-fuer-schritt)
7. [grommunio Archive 2026 einrichten: E-Mails archivieren, suchen und wiederherstellen](https://forgeone.solutions/de/tech/grommunio-archive-2026-schritt-fuer-schritt)
8. [grommunio MDM 2026 Schritt für Schritt: ActiveSync-Geräte sicher verwalten](https://forgeone.solutions/de/tech/grommunio-mdm-2026-schritt-fuer-schritt)
9. [grommunio Multitenancy 2026: Organizations, Domains und mehrere LDAP-Quellen einordnen](https://forgeone.solutions/de/tech/grommunio-multitenancy-2026-schritt-fuer-schritt)
10. [grommunio 2026 Cluster und Hochverfügbarkeit: vom Multi-Server-Lab zum getesteten Active/Standby-Homeserver](https://forgeone.solutions/de/tech/grommunio-cluster-ha-2026-schritt-fuer-schritt)
11. [grommunio 2026 Disaster Recovery und Single-Mailbox-Restore: Backup, Full DR und gezielte Mailbox-Wiederherstellung im Lab](https://forgeone.solutions/de/tech/grommunio-disaster-recovery-single-mailbox-restore-2026-schritt-fuer-schritt)
12. [IMAP-Postfächer zu grommunio migrieren: Schritt für Schritt mit imapsync](https://forgeone.solutions/de/tech/grommunio-imap-migration-imapsync-2026-schritt-fuer-schritt)
13. [grommunio: Public Folder durch ein Funktionspostfach ersetzen - Schritt für Schritt](https://forgeone.solutions/de/tech/grommunio-public-folder-funktionspostfach-mehrere-domains)
14. [grommunio Web 5.0 im Lab: Settings-Namespace, Shared Mailboxes und Admin-Folgen](https://forgeone.solutions/de/tech/grommunio-web-5-0-im-lab)
15. [grommunio 2026.06.2 Upgrade und technische Abnahme: Keycloak SSO, MFA, AutoDiscover und Mailflow (aktueller Teil)](https://forgeone.solutions/de/tech/grommunio-2026-06-2-upgrade-keycloak-sso-praxis)
16. [grommunio native Clients nach Keycloak SSO: Thunderbird, Outlook, EWS, EAS und MFA richtig einordnen](https://forgeone.solutions/de/tech/grommunio-native-clients-keycloak-sso-2026)
17. grommunio Monitoring und Alerting im Betrieb
18. grommunio Security Hardening in der Praxis
19. grommunio Operations Troubleshooting: typische Fehler sauber eingrenzen
