Einen Mandanten anlegen und bereitstellen

Worum es geht

Einen Mandanten anlegen heißt zweierlei: einen Datensatz in CIAS schreiben und die Datenbank des Mandanten einrichten. Das eine liegt in der Datenbank von CIAS, das andere in der Persistenz von CDMS. Eine gemeinsame Transaktion über beide gibt es nicht. Das zweite kann also scheitern, nachdem das erste gelungen ist.

CIAS löst das, indem es jeden Schritt einzeln festhält. Scheitert etwas, bleibt ein Mandant zurück, der erkennbar kaputt ist und repariert werden kann, statt einer, der als angelegt gilt und nichts bedient.

Wer anlegen darf

Es gibt drei Wege, und alle enden in derselben Methode von CIAS:

Warum ein Mandanten-Administrator nicht darf: Mandanten anlegen, sperren oder schließen ist genau das, was Kunden voneinander trennt. Dürfte ein Kunde das, könnte er die anderen erreichen.

Der Ablauf

sequenceDiagram
    participant A as Admin
    participant C as CIAS
    participant DB as CIAS-Datenbank
    participant P as Persistenz (CDMS)
    A->>C: POST /cias/admin/tenants {key: nordbau, type: DYNAMIC}
    C->>DB: Transaktion 1: Schlüssel frei? speichern als PENDING / IN_PROGRESS
    C->>P: einrichten (außerhalb jeder Transaktion)
    P->>P: Datenbank nordbau anlegen, Schema migrieren
    P-->>C: fertig
    C->>DB: Transaktion 2: PROVISIONED, ACTIVE
    C-->>A: 200 mit dem Mandanten

Drei Gründe für diese Form:

1. Absicht zuerst speichern. Stürzt der Prozess danach ab, ist wenigstens etwas da, das man wiedererkennt: ein Mandant in IN_PROGRESS mit Startzeit.
2. Einrichten ohne offene Transaktion. Eine Datenbank anzulegen und zu migrieren kann dauern. Liefe das in einer Transaktion, hielte CIAS so lange eine Datenbankverbindung und ihre Sperren fest.
3. Ergebnis danach speichern, Erfolg wie Misserfolg, jeweils in einer eigenen kurzen Transaktion.

Was „einrichten“ heißt

Was bei der Einrichtung passiert, hängt davon ab, was im selben Prozess läuft:

Die Einrichtung darf beliebig oft laufen: Eine vorhandene Datenbank wird nicht noch einmal angelegt, und die Migration spielt nur fehlende Änderungen ein. Ein zweiter Versuch nach einem halben Fehlschlag wiederholt also Arbeit, statt etwas doppelt anzulegen.

Was dabei schiefgehen kann

Der Abgleich ist ein Zeitgeber, der liegengebliebene Rollouts findet. Eingestellt wird er über codamai.cias.tenancy.reconciliation.enabled, .interval (Standard 15 Minuten) und .deadline (Standard 30 Minuten). Im eigenständigen CIAS ist er eingeschaltet.

Die Frist ist mit Absicht großzügig. Wäre sie kürzer als die längste echte Einrichtung, würde der Abgleich einen noch laufenden Rollout aufgeben. Dieser Rollout könnte dann seinen Erfolg nicht mehr eintragen, denn CIAS nimmt „fertig“ nur für einen Rollout in IN_PROGRESS an. Zurück bliebe eine fertige Datenbank hinter einem Mandanten in FAILED. Das behebt ein Neuversuch, aber es ist unnötige Arbeit.

Was bei einem dynamischen Mandanten mit der Organisation passiert

Einen Mandanten zu speichern und später mit seiner Organisation zu verbinden, ist so möglich. Ob ein Token den Mandanten nennt, hängt am Alias der Organisation, nicht an diesem Feld, siehe Den Mandanten einer Anfrage bestimmen.

Anfrage und Antwort

POST /cias/admin/tenants
Authorization: Bearer <Token eines Plattform-Administrators>
{
  "key": "nordbau",
  "type": "DYNAMIC",
  "displayName": "Nordbau GmbH",
  "externalOrganizationId": "b7e0…"
}

HTTP 200
{
  "id": "0f6c…",
  "key": "nordbau",
  "displayName": "Nordbau GmbH",
  "type": "DYNAMIC",
  "status": "ACTIVE",
  "provisioningState": "PROVISIONED",
  "externalOrganizationId": "b7e0…",
  "validFrom": null,
  "validUntil": null,
  "createdAt": "2026-09-22T09:14:03.120Z",
  "updatedAt": "2026-09-22T09:14:04.480Z"
}

displayName darf fehlen, dann steht dort der Schlüssel. Ein Gültigkeitsfenster gehört nicht zum Anlegen, es wird danach gesetzt, siehe Mandanten sperren, schließen, Gültigkeit.

Fallen

Weiter

• Der Mandantenschlüssel
• Der Lebenslauf eines Mandanten
• Wie die Registrierung einen Mandanten gründet: Woher der Mandant kommt
• Beide Module zusammen: Ein neuer Mandant, Ende zu Ende