Zum Inhalt springen

E-Mail und Anmeldung

Operatoren finden Tenants, Users und Settings unter Platform in der Seitenleiste.

Settings → Email: SMTP-Server, Absender und Send test mail. E-Mail wird für Einladungen und «Passwort vergessen» verwendet.

Das Panel versucht alle Adressen des SMTP-Servers (IPv4 und IPv6) gleichzeitig. Antwortet keine, nennt der Test die Adressen, die er versucht hat.

Alle können ein Passwort mit Zwei-Faktor-Authentisierung (eine Authenticator-App, mit Wiederherstellungscodes) und Passkeys verwenden. Anmeldeversuche sind begrenzt.

Settings → Sign-in fügt Discord und OpenID-Connect-Provider hinzu (Authentik, Keycloak, Google, Entra ID …). Änderungen gelten sofort, ohne Neustart. Jeder Provider zeigt die Callback-URL, die du beim Provider einträgst: https://<panel>/signin-<Name>.

Konten werden nie über die E-Mail-Adresse zugeordnet: Ein Provider muss auf der Kontoseite verknüpft werden, während man angemeldet ist, ausser die offene Registrierung ist eingeschaltet.

Create accounts on first sign-in (pro Provider): für ein Firmen-Login, das alle nutzen dürfen. Die erste Anmeldung legt ein Konto an, auf Wunsch gleich in einem Tenant mit einer Rolle. Eine E-Mail-Adresse, zu der es schon ein Konto gibt, wird abgelehnt, mit dem Hinweis, den Provider stattdessen zu verknüpfen; ein Provider, der keine E-Mail-Adresse mitteilt, kann keine Konten anlegen.

Provider lassen sich auch in deploy/panel.env setzen (Kopie von panel.env.example); beliebig viele, nummeriert ab 0:

Terminal-Fenster
Auth__Providers__0__Name=authentik
Auth__Providers__0__Type=oidc
Auth__Providers__0__DisplayName=Authentik
Auth__Providers__0__Authority=https://auth.example.com/application/o/server-panel/
Auth__Providers__0__ClientId=…
Auth__Providers__0__ClientSecret=…
Auth__Providers__0__CreateAccounts=true # optional, with …__DefaultTenantId and …__DefaultRole
Auth__Providers__1__Name=discord
Auth__Providers__1__Type=discord
Auth__Providers__1__DisplayName=Discord
Auth__Providers__1__ClientId=…
Auth__Providers__1__ClientSecret=…

Jeder braucht einen eindeutigen Name. Ein ungültiger Eintrag hält das Panel beim Start an, mit einer Meldung, die das Feld nennt. Provider aus der Umgebung werden im Admin-Bereich angezeigt, lassen sich aber nur dort ändern.

Settings → General legt fest, ob Leute durch die Anmeldung bei einem Provider ein Konto anlegen dürfen (offene Registrierung) und ob sie Tenants anlegen dürfen.

Users (Operatoren):

  • jemanden per Einladung hinzufügen, oder mit einem Passwort, das du setzt
  • Name und Operator-Status ändern
  • sperren oder entsperren
  • Zwei-Faktor zurücksetzen (Handy verloren)
  • einen Link zum Zurücksetzen des Passworts erstellen (per E-Mail verschickt und dir angezeigt)
  • die E-Mail-Adresse ändern (sofort, ohne Bestätigungsmail)
  • löschen

Ihre eigene E-Mail-Adresse ändern Leute auf der Kontoseite; die neue gilt, sobald sie den Link öffnen, der an sie geschickt wird. Dafür muss E-Mail eingerichtet sein. Dort können sie auch ihre Daten herunterladen und ihr Konto löschen (Datenschutz).

Einladungen: Eine E-Mail-Adresse ohne Konto hinzuzufügen (auf der Seite Members eines Tenants oder als Benutzer) erstellt einen einmaligen Link, gültig für 7 Tage. Die Person wählt Namen und Passwort oder meldet sich bei einem Provider an und landet mit der gewählten Rolle im Tenant. Ohne eingerichtete E-Mail zeigt das Panel dir den Link zum Weitergeben.

Tenants (Operatoren): anlegen (der Owner wird eingeladen, falls er noch kein Konto hat), umbenennen, löschen (nur ohne Server).