Skip to main content
POST
TOTP-Einrichtung starten

Authorizations

Authorization
string
header
required

Access-Token aus POST /auth/login (E-Mail und Passwort), gesendet als Authorization: Bearer <token>.

Das Token ist zeitlich begrenzt gültig. Mit dem refresh_token aus derselben Antwort holt POST /auth/token/refresh ein neues Token-Paar, ohne das Passwort erneut zu senden; POST /auth/token/invalidate macht den Refresh-Token beim Abmelden ungültig.

Ist für das Konto ein zweiter Faktor aktiv oder vorgeschrieben, liefert der Login statt des Token-Paars mfaRequired: true bzw. mfaEnrollmentRequired: true und ein kurzlebiges preAuthToken. Mit diesem Token (ebenfalls als Bearer) wird der zweite Faktor über POST /auth/2fa/verify bestätigt; erst danach gibt es das volle Token-Paar.

Response

User resource created

The e-mail address is unique platform-wide (case-insensitive). This is enforced by a functional unique index on LOWER(email) created in migrations/Version20260706130000.php. Doctrine ORM 2.x cannot map expression indexes, so it lives as raw SQL there instead of as an #[ORM\UniqueConstraint].

secret
string

Base32-Geheimnis für die manuelle Eingabe

otpauthUri
string
Example:

"otpauth://totp/..."

qrCode
string

QR-Code als SVG-Data-URI (direkt in [Image blocked: No description] verwendbar)

expiresAt
string

Ohne Bestätigung bis dahin verfällt die Einrichtung