Benutzerimport & -export

Auris bietet Massenimport- und -exportwerkzeuge für Benutzerdaten. Importiere Benutzer aus CSV- oder JSON-Dateien bei der Migration von einem anderen Identitätsanbieter, dem Onboarding einer neuen Abteilung oder dem Befüllen einer Staging-Umgebung. Exportiere deine Benutzerdatenbank für Backups, Compliance-Audits oder die Migration zu einem anderen System.

Zugriff über Konsole → Einstellungen → Import / Export.

Benutzer importieren

Der Importfluss führt dich durch Datei-Upload, Datenvorschau und Verarbeitung. Importe laufen asynchron — du kannst die Seite verlassen und den Fortschritt später überprüfen.

Import-Walkthrough

Dateiformatanforderungen

CSV-Format

Die erste Zeile muss eine Kopfzeile mit Spaltennamen sein. Werte mit Kommas müssen in Anführungszeichen gesetzt werden. Mehrwertige Felder (wie Rollen) sollten in Anführungszeichen gesetzt und kommagetrennt innerhalb der Anführungszeichen sein.

email,firstName,lastName,password,roles
[email protected],Alice,Smith,SecureP@ss123,editor
[email protected],Bob,Jones,AnotherP@ss456,"editor,viewer"
[email protected],Carol,Williams,,viewer

Im obigen Beispiel hat Carol kein Passwort — sie muss “Passwort vergessen” oder Magic Link verwenden, um eines zu setzen.

JSON-Format

Die Datei muss ein JSON-Array von Benutzerobjekten enthalten. Jedes Objekt folgt derselben Feldstruktur wie die CSV-Spalten.

[
  {
    "email": "[email protected]",
    "firstName": "Alice",
    "lastName": "Smith",
    "password": "SecureP@ss123",
    "roles": ["editor"]
  },
  {
    "email": "[email protected]",
    "firstName": "Bob",
    "lastName": "Jones",
    "password": "AnotherP@ss456",
    "roles": ["editor", "viewer"]
  },
  {
    "email": "[email protected]",
    "firstName": "Carol",
    "lastName": "Williams",
    "roles": ["viewer"]
  }
]

Importverarbeitung

Nach dem Klicken auf “Import starten” läuft der Import asynchron. Jede Zeile wird sequenziell verarbeitet:

1. Die E-Mail wird auf Format und Eindeutigkeit validiert
2. Wenn ein Passwort angegeben ist, wird es mit bcrypt gehasht
3. Der Benutzer wird in Prisma (Auris-Datenbank) erstellt
4. Der Benutzer wird in Keycloak (Authentifizierungs-Backend) erstellt
5. Wenn Rollen angegeben sind, wird der Benutzer diesen Rollen zugewiesen
6. Der Importfortschrittszähler erhöht sich

Importhistorie

Der Import-Bereich zeigt eine Historientabelle aller Importjobs:

Importstatus

Fehlerdetails anzeigen

Klicke auf einen Import mit dem Status Teilweise oder Fehlgeschlagen, um zeilenspezifische Fehlerdetails anzuzeigen:

Häufige zeilenspezifische Fehler:

Benutzer exportieren

Exportiere deine Benutzerdatenbank in eine CSV- oder JSON-Datei für Backup, Migration oder Compliance-Zwecke.

Export-Walkthrough

Exportierte Felder

Der Export enthält die folgenden Felder für jeden Benutzer:

Exporthistorie

Der Export-Bereich zeigt eine Historientabelle aller Exportjobs:

Exportdateien werden 24 Stunden nach der Generierung automatisch gelöscht. Wenn du die Datei nach Ablauf benötigst, führe einen neuen Export aus.

API-Referenz

Import- und Exportoperationen sind auch über die REST-API für Automatisierung und CI/CD-Pipelines verfügbar.

Best Practices

1. Zuerst mit einer kleinen Datei testen. Bevor du 10.000 Benutzer importierst, versuche eine Datei mit 5-10 Benutzern, um zu überprüfen, ob deine Spaltenzuordnung und Rollennamen korrekt sind.

2. Rollen vorab erstellen. Der Import erstellt keine Rollen spontan. Alle in der Importdatei referenzierten Rollennamen müssen bereits in Konsole → Rollen existieren.

3. Konsistente E-Mail-Formatierung verwenden. Auris behandelt E-Mail-Adressen als Groß-/Kleinschreibung-unempfindlich, aber die ursprüngliche Schreibweise wird beibehalten. Vermeide das Mischen von [email protected] und [email protected] in derselben Datei.

4. Große Importe außerhalb der Stoßzeiten planen. Jeder importierte Benutzer löst einen Keycloak-API-Aufruf aus. Für Importe mit Tausenden von Benutzern erzeugt dies eine erhebliche Last auf Keycloak.

5. Exportdateien sicher aufbewahren. Obwohl Exporte keine Passwörter enthalten, enthalten sie E-Mail-Adressen, Namen und Rollenzuweisungen. Behandle Exportdateien als sensible Daten.

Berechtigungen

Zugehörige Anleitungen

• Benutzer verwalten — Einzelne Benutzer in der Konsole erstellen und verwalten
• Benutzerimport & -export Anleitung — Detaillierte Entwickleranleitung mit Skript-Beispielen
• Benutzer & Rollen — Benutzer- und Rollenverwaltung in der Konsole
• SCIM-Provisionierung — Automatisierte Provisionierung von Enterprise-IdPs als Alternative zum manuellen Import