Importer & Exporter des Utilisateurs

Auris fournit des outils d’import et d’export en bloc pour les données utilisateur. Importe des utilisateurs depuis des fichiers CSV ou JSON lors de la migration depuis un autre fournisseur d’identité, de l’intégration d’un nouveau département, ou du peuplement d’un environnement de staging. Exporte ta base de données d’utilisateurs pour la sauvegarde, les audits de conformité ou la migration vers un autre système.

Accède depuis Console → Paramètres → Importer / Exporter.

Importer des Utilisateurs

Le flux d’importation te guide à travers le chargement du fichier, la prévisualisation des données et le traitement. Les importations s’exécutent de manière asynchrone — tu peux naviguer ailleurs depuis la page et vérifier l’avancement ultérieurement.

Procédure d’Importation

Exigences de Format de Fichier

Format CSV

La première ligne doit être une ligne d’en-tête avec les noms des colonnes. Les valeurs contenant des virgules doivent être entre guillemets.

email,firstName,lastName,password,roles
[email protected],Alice,Dupont,MotDePasseSécurisé123,editor
[email protected],Bob,Martin,AutreMotDePasse456,"editor,viewer"
[email protected],Claire,Durand,,viewer

Dans l’exemple ci-dessus, Claire n’a pas de mot de passe — elle devra utiliser Mot de passe oublié ou Magic Link pour en définir un.

Format JSON

Le fichier doit contenir un tableau JSON d’objets utilisateur.

[
  {
    "email": "[email protected]",
    "firstName": "Alice",
    "lastName": "Dupont",
    "password": "MotDePasseSécurisé123",
    "roles": ["editor"]
  },
  {
    "email": "[email protected]",
    "firstName": "Bob",
    "lastName": "Martin",
    "password": "AutreMotDePasse456",
    "roles": ["editor", "viewer"]
  },
  {
    "email": "[email protected]",
    "firstName": "Claire",
    "lastName": "Durand",
    "roles": ["viewer"]
  }
]

Traitement de l’Importation

Après avoir cliqué sur Démarrer l’Importation, l’importation s’exécute de manière asynchrone. Chaque ligne est traitée en séquence :

1. L’e-mail est validé pour le format et l’unicité
2. Si un mot de passe est fourni, il est haché avec bcrypt
3. L’utilisateur est créé dans Prisma (base de données Auris)
4. L’utilisateur est créé dans Keycloak (backend d’authentification)
5. Si des rôles sont spécifiés, l’utilisateur est assigné à ces rôles
6. Le compteur de progression de l’importation s’incrémente

Historique des Importations

La section Importation affiche un tableau historique de tous les jobs d’importation :

États de l’Importation

Consulter les Détails des Erreurs

Clique sur n’importe quelle importation avec le statut Partielle ou Échouée pour voir les détails des erreurs par ligne :

Erreurs courantes par ligne :

Exporter des Utilisateurs

Exporte ta base de données d’utilisateurs dans un fichier CSV ou JSON pour la sauvegarde, la migration ou la conformité.

Procédure d’Exportation

Champs Exportés

L’exportation inclut les champs suivants pour chaque utilisateur :

Historique des Exportations

La section Exportation affiche un tableau historique de tous les jobs d’exportation. Les fichiers d’exportation sont automatiquement supprimés 24 heures après la génération.

Référence API

Les opérations d’import et d’export sont également disponibles via l’API REST.

Bonnes Pratiques

1. Teste d’abord avec un petit fichier. Avant d’importer 10 000 utilisateurs, essaie avec un fichier de 5 à 10 utilisateurs pour vérifier que le mappage des colonnes et les noms de rôles sont corrects.

2. Crée les rôles à l’avance. L’importation ne crée pas les rôles automatiquement. Les noms de rôles référencés dans le fichier d’importation doivent déjà exister dans Console → Rôles.

3. Utilise un formatage d’e-mail cohérent. Auris traite les adresses e-mail comme insensibles à la casse, mais la capitalisation originale est préservée.

4. Planifie les grandes importations pendant les heures de faible trafic. Chaque utilisateur importé déclenche un appel API Keycloak.

5. Conserve les fichiers d’exportation en sécurité. Même si les exportations ne contiennent pas de mots de passe, elles contiennent des adresses e-mail, des noms et des assignations de rôles. Traite les fichiers d’exportation comme des données sensibles.

Permissions

Guides Associés

• Gestion des Utilisateurs — Création et gestion des utilisateurs individuels dans la Console
• Utilisateurs & Rôles — Gestion des utilisateurs et rôles dans la Console
• Provisionnement SCIM — Provisionnement automatisé depuis des IdP d’entreprise comme alternative à l’import manuel