CodamAIDocs
Themafertig

Die Zustände einer Registrierung

Von INITIATED bis COMPLETED: jeder Zustand, jeder Übergang, und woher EXPIRED und FAILED kommen.

Ausprägungen
INITIATEDPENDING_VERIFICATIONVERIFIEDPENDING_APPROVALAPPROVEDREJECTEDPROVISIONINGCOMPLETEDFAILEDEXPIRED

Worum es geht

Jede Registrierung ist in CIAS ein eigener Datensatz mit einem Zustand. Der Zustand sagt, wo der Vorgang gerade steht: Wartet er auf den Klick in der Mail? Auf eine Freigabe? Ist er fertig?

Das Zustandsdiagramm

stateDiagram-v2
    direction LR
    [*] --> PENDING_VERIFICATION: Anfrage angenommen,<br/>Mail mit Link verschickt
    PENDING_VERIFICATION --> VERIFIED: Link geklickt<br/>oder Admin bestätigt
    VERIFIED --> PENDING_APPROVAL: Freigabe nötig
    VERIFIED --> PROVISIONING: keine Freigabe nötig
    PENDING_APPROVAL --> APPROVED: genehmigt
    APPROVED --> PROVISIONING
    PROVISIONING --> COMPLETED: alles bereitgestellt
    PROVISIONING --> FAILED: Fehler
    FAILED --> PROVISIONING: retry
    PENDING_VERIFICATION --> EXPIRED: verfallen, ersetzt<br/>oder verworfen
    PENDING_APPROVAL --> EXPIRED: verfallen, ersetzt<br/>oder verworfen
    FAILED --> EXPIRED: verworfen
    PENDING_VERIFICATION --> REJECTED: abgelehnt
    PENDING_APPROVAL --> REJECTED: abgelehnt
    COMPLETED --> [*]
    REJECTED --> [*]
    EXPIRED --> [*]

Ablehnen geht aus jedem Zustand, der noch nicht zu Ende ist. Im Bild sind nur die beiden häufigsten Wege eingezeichnet.

Jeder Zustand

ZustandBedeutungWie es weitergeht
INITIATEDDie Anfrage wird gerade verarbeitet. Dieser Zustand besteht nur kurz im Speicher; gespeichert wird die Registrierung schon als PENDING_VERIFICATION.sofort weiter
PENDING_VERIFICATIONDie Mail mit dem Link ist verschickt. CIAS wartet auf den Klick.Klick, Admin bestätigt, verfällt, wird ersetzt, verworfen oder abgelehnt
VERIFIEDDie Adresse ist bestätigt.sofort weiter zur Freigabe oder zur Bereitstellung
PENDING_APPROVALEin Plattform-Administrator muss zustimmen.genehmigen, ablehnen, verfällt, verwerfen
APPROVEDgenehmigtsofort weiter zur Bereitstellung
PROVISIONINGCIAS schaltet das Konto frei, ordnet den Mandanten zu, vergibt Rollen.COMPLETED oder FAILED
COMPLETEDfertig. Die Person kann sich anmelden.Endzustand
FAILEDDie Bereitstellung ist gescheitert.ein Administrator wiederholt sie (retry) oder verwirft den Vorgang
REJECTEDabgelehntEndzustand
EXPIREDverfallen, durch einen neueren Versuch ersetzt oder verworfenEndzustand

Wer welchen Übergang auslöst

Auslöser der Übergänge

Wann: Sie klickt den Link in der Mail.

POST /cias/registration/verify bringt den Vorgang von PENDING_VERIFICATION nach VERIFIED. Danach geht es ohne weiteres Zutun weiter: zur Freigabe, wenn der Ablauf eine verlangt, sonst direkt in die Bereitstellung.

Ergebnis: Siehe E-Mail bestätigen.

Wann: Über die Endpunkte unter /cias/admin/registrations/{id}/…

activate bestätigt die Adresse von Hand, approve genehmigt, reject lehnt ab, retry wiederholt eine gescheiterte Bereitstellung, discard verwirft den Vorgang.

Ergebnis: Siehe Freigabe durch einen Administrator.

Wann: Dieselbe Adresse registriert sich noch einmal.

Alle offenen Vorgänge dieser Adresse, die noch auf den Klick oder die Freigabe warten, gehen nach EXPIRED. Nur der neueste Link gilt.

Ergebnis: Siehe Die E-Mail ist das Konto.

Wann: Wenn die Installation das Aufräumen eingeschaltet hat.

Ein regelmäßiger Lauf setzt Vorgänge, die zu lange warten, auf EXPIRED.

Ergebnis: Siehe Abgebrochene Registrierungen aufräumen.

Weiter

Quellen im Code und in der Wissensdatenbank
  • CIAS/cias-registration – RegistrationState, Registration (awaitVerification, verify, confirmManually, awaitApproval, approve, reject, startProvisioning, complete, fail, expire)
  • CIAS/cias-registration – RegistrationService (register, verify, approve, reject, retry, activate, provision, supersedeOpenAttempts), RegistrationMaintenanceService (sweep, discard)
  • CIAS/cias-registration/docs/adr – ADR-011, ADR-012
Suchen