mailcow-dockerized-docs/docs/troubleshooting/debug-admin_login_sogo.de.md
2023-01-09 15:44:30 +01:00

2,8 KiB

Dies ist eine experimentelle Funktion, die es Admins und DomÀnenadmins erlaubt, sich direkt als Mailbox-Benutzer bei SOGo anzumelden, ohne das Passwort des Benutzers zu kennen. Dazu wird ein zusÀtzlicher Link zu SOGo in der Mailbox-Liste (mailcow UI) angezeigt.

Auch mehrere gleichzeitige Admin-Logins auf verschiedene PostfÀcher sind mit dieser Funktion möglich.

Aktivieren der Funktion

Die Funktion ist standardmĂ€ĂŸig deaktiviert. Es kann in der mailcow.conf durch Setzen aktiviert werden:

ALLOW_ADMIN_EMAIL_LOGIN=y

und die betroffenen Container neu erstellen mit

=== "docker compose (Plugin)"

``` bash
docker compose up -d
```

=== "docker-compose (Standalone)"

``` bash
docker-compose up -d
```

Nachteile bei Aktivierung

  • Jeder SOGo-Seiten-Load und jede Active-Sync-Anfrage verursacht eine zusĂ€tzliche AusfĂŒhrung eines internen PHP-Skripts. Dies kann die Ladezeiten von SOGo / EAS beeintrĂ€chtigen. In den meisten FĂ€llen sollte dies nicht spĂŒrbar sein, aber Sie sollten es im Hinterkopf behalten, wenn Sie Performance-Probleme haben.
  • SOGo zeigt keinen Logout-Link fĂŒr Admin-Logins an, um sich normal anzumelden, muss man sich von der mailcow UI abmelden, so dass die PHP-Sitzung zerstört wird.
  • Das Abonnieren des Kalenders oder Adressbuchs eines anderen Nutzers, wĂ€hrend man als Admin eingeloggt ist, funktioniert nicht. Ebenso wenig funktioniert das Einladen anderer Nutzer zu Kalender-Events. Die Seite wird neu geladen, wenn diese Dinge versucht werden.

Technische Details

Die Option SOGoTrustProxyAuthentication ist auf YES gesetzt, so dass SOGo dem x-webobjects-remote-user-Header vertraut.

Dovecot erhĂ€lt ein zufĂ€lliges Master-Passwort, das fĂŒr alle Mailboxen gĂŒltig ist, wenn es vom SOGo-Container verwendet wird.

Ein Klick auf den SOGo-Button in der Mailbox-Liste öffnet die Datei sogo-auth.php, die Berechtigungen prĂŒft, Session-Variablen setzt und auf die SOGo-Mailbox umleitet.

Jede SOGo, CardDAV, CalDAV und EAS http-Anfrage verursacht einen zusÀtzlichen, nginx-internen auth_request-Aufruf an sogo-auth.php mit folgendem Verhalten:

  • Wenn ein basic_auth-Header vorhanden ist, wird das Skript die Anmeldedaten anstelle von SOGo validieren und die folgenden Header bereitstellen: x-webobjects-remote-user, Authorization und x-webobjects-auth-type.

  • Wenn kein basic_auth-Header vorhanden ist, wird das Skript nach einer aktiven Mailcow-Admin-Sitzung fĂŒr den angeforderten E-Mail-Benutzer suchen und die gleichen Header bereitstellen, aber mit dem Dovecot-Master-Passwort, das im Authorization-Header verwendet wird.

  • Wenn beides fehlschlĂ€gt, werden die Header leer gesetzt, was SOGo dazu bringt, seine Standard-Authentifizierungsmethoden zu verwenden.

Alle diese Optionen/Verhaltensweisen sind deaktiviert, wenn die Option ALLOW_ADMIN_EMAIL_LOGIN in der Konfiguration nicht aktiviert ist.