> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Découvrez l’extension User Import/Export, qui vous permet d’importer et d’exporter des utilisateurs depuis ou vers toute base de données configurée dans votre compte.

# Extension User Import / Export

<Warning>
  L’**extension User Import/Export** deviendra **obsolète** en septembre 2025. Vous pouvez dès maintenant accéder aux mêmes fonctionnalités [directement dans l’Auth0 Management Dashboard](/fr-CA/docs/manage-users/user-migration/bulk-user-import-export).
</Warning>

L’**extension User Import / Export** vous permet de :

* Importer en bloc les utilisateurs existants de votre base de données dans Auth0
* Rechercher et exporter certains ou tous vos utilisateurs de base de données Auth0

Pour obtenir la liste des champs du profil utilisateur pouvant être importés et exportés, consultez [Attributs du profil utilisateur](/fr-CA/docs/manage-users/user-accounts/user-profiles/user-profile-structure).

Vous devez être administrateur du Auth0 Dashboard pour utiliser cette extension.

<div id="install-the-extension">
  ## Installer l’extension
</div>

Pour installer cette extension, accédez à [Auth0 Dashboard > Extensions](https://manage.auth0.com/#/extensions), puis sélectionnez **User Import / Export**.

L’extension ne nécessite aucune configuration supplémentaire avant l’installation. Pour continuer, sélectionnez **Install** dans la fenêtre contextuelle d’information.

<div id="use-the-extension">
  ## Utiliser l’extension
</div>

Après avoir installé l’extension, vous la verrez dans la liste de vos extensions installées. Cliquez sur **Import / Export Extension** pour la lancer.

La première fois que vous lancerez l’extension, vous devrez l’autoriser à accéder à votre compte Auth0 pour les activités indiquées.

<Frame>
  <img src="https://mintcdn.com/translations/MV7tE-x71x8RWRES/docs/images/cdy7uua7fh8z/5CCKmxUv1HN5nDj9jL8qel/d7f02ccf3f4be166b00bbf217e14144f/Screen_Shot_2021-05-18_at_9.11.01_PM.png?fit=max&auto=format&n=MV7tE-x71x8RWRES&q=85&s=9feeabf8574f1f75ab3d2f35db7c60f8" alt="Auth0 Dashboard Extensions : autoriser l’extension d’importation/exportation des utilisateurs" width="730" height="1254" data-path="docs/images/cdy7uua7fh8z/5CCKmxUv1HN5nDj9jL8qel/d7f02ccf3f4be166b00bbf217e14144f/Screen_Shot_2021-05-18_at_9.11.01_PM.png" />
</Frame>

Cliquez sur la **coche** pour continuer.

Il existe deux façons d’utiliser cette extension :

* Importer en bloc les utilisateurs existants de votre base de données dans Auth0
* Rechercher et exporter certains ou tous les utilisateurs de votre base de données Auth0

Ces deux cas d’utilisation sont expliqués plus en détail ci-dessous.

<div id="import-users">
  ### Importer des utilisateurs
</div>

Par défaut, chaque fois que vous ouvrez l’extension, l’écran **Importation d’utilisateurs** s’affiche (si vous êtes sur l’écran d’exportation, vous pouvez revenir à cet écran en cliquant sur **Importer** dans la barre de navigation de gauche).

Pour importer vos utilisateurs, glissez-déposez un fichier JSON valide ([schéma et exemples ici](/fr-CA/docs/manage-users/user-migration/bulk-user-import-database-schema-and-examples)) dans la zone indiquant **Déposez votre fichier ici ou cliquez pour le sélectionner**. Vous pouvez aussi cliquer sur cette zone pour parcourir vos fichiers et sélectionner le fichier JSON approprié. Le fichier JSON doit contenir la liste des utilisateurs que vous prévoyez importer.

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  Si vous utilisez un fichier d’exportation provenant d’un locataire Auth0, vous devez convertir le fichier exporté de `ndjson` en [JSON](/fr-CA/docs/manage-users/user-migration/bulk-user-exports#json-compatible-format). Pour conserver les mêmes ID d’utilisateur, vous devez supprimer le `préfixe auth0|` de tous les ID d’utilisateur importés.

  Le processus d’importation ajoute automatiquement le `préfixe auth0|` aux ID d’utilisateur importés. Si vous ne supprimez pas le préfixe `auth0|` avant l’importation, les ID d’utilisateur seront renvoyés sous la forme `auth0|auth0|...`
</Callout>

Sélectionnez la connexion de base de données dans laquelle vos utilisateurs seront importés. Assurez-vous que la connexion choisie a été activée pour au moins une application.

Cliquez sur **Commencer l’importation des utilisateurs** pour lancer le processus d’importation.

Une fois l’opération terminée, le message **Terminé** suivant s’affiche.

<Frame>
  <img src="https://mintcdn.com/translations/c0RQ9V0YAcT0-8l5/docs/images/cdy7uua7fh8z/7hyE3DWBJuFuAulAAnZlfN/23303644d4c706f4c0937bd363bf6699/import-complete.png?fit=max&auto=format&n=c0RQ9V0YAcT0-8l5&q=85&s=1f53d4c3b145b809ab2dfd1280d085cd" alt="Auth0 Dashboard Extensions Users Import Export Importation terminée" width="673" height="293" data-path="docs/images/cdy7uua7fh8z/7hyE3DWBJuFuAulAAnZlfN/23303644d4c706f4c0937bd363bf6699/import-complete.png" />
</Frame>

Une fois vos utilisateurs importés, vous pouvez les gérer individuellement dans [Auth0 Dashboard > Gestion des utilisateurs > Utilisateurs](https://manage.auth0.com/#/users).

<div id="export-users">
  ### Exporter des utilisateurs
</div>

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  Auth0 utilise le format ndjson en raison de la taille importante des fichiers d’exportation. Avant de pouvoir importer des utilisateurs, vous devrez convertir le format **ndjson** en **json** à l’aide de la bibliothèque de votre choix (comme [jq](https://stedolan.github.io/jq/)). Lorsque vous exportez des utilisateurs qui seront importés plus tard, les noms des champs utilisateur doivent être laissés par défaut et ne pas être mappés à un nom de colonne.
</Callout>

Pour exporter vos utilisateurs Auth0 existants associés à des connexions de base de données, sélectionnez **Export**.

<Frame>
  <img src="https://mintcdn.com/translations/6GE5Z24GDCZehiJ9/docs/images/cdy7uua7fh8z/5wUhbGMjVQKIE9vx2SBIA3/a952aee6cc6027234631334c7174c4a8/export-users.png?fit=max&auto=format&n=6GE5Z24GDCZehiJ9&q=85&s=d338c8aeb8a66a4ff7413cd9ea077abe" alt="Page Export Users de Dashboard Extensions Users Import Export" width="1504" height="908" data-path="docs/images/cdy7uua7fh8z/5wUhbGMjVQKIE9vx2SBIA3/a952aee6cc6027234631334c7174c4a8/export-users.png" />
</Frame>

Sous **User Fields**, vous pouvez choisir quels attributs ou expressions utilisateur doivent être inclus dans l’exportation. L’attribut utilisateur peut être une valeur statique comme `user.user_metadata.name`, ou une expression JavaScript comme `user.user_metadata.name || user.name`. Les expressions seront évaluées au moment de l’exportation. La valeur **column name** détermine comment la valeur sera représentée dans l’exportation.

Vous pouvez cliquer sur le bouton **Add Default Fields** pour sélectionner automatiquement les champs par défaut et renseigner leurs noms de colonne (c’est aussi un bon moyen de visualiser comment les paramètres/expressions s’afficheront).

Vous pouvez supprimer les attributs/expressions inutiles en cliquant sur l’icône de **corbeille** associée.

Sous **Settings**, vous pouvez :

* Configurer l’affichage de vos utilisateurs exportés en fournissant un **User Attribute** selon lequel les utilisateurs doivent être triés (ainsi qu’en indiquant si le tri doit être en ordre croissant ou décroissant)
* Choisir votre **Export Format** ; vous pouvez choisir entre les fichiers JSON et CSV

  <Frame>
    <img src="https://mintcdn.com/translations/eVsQcTnbClN-oB7d/docs/images/cdy7uua7fh8z/1HVpo1IevSRJbFvwrEKkzf/761fa914f6c33cdee147e07b2c43f7c7/settings.png?fit=max&auto=format&n=eVsQcTnbClN-oB7d&q=85&s=d276b0dac9146902a43fa98ebcb79c02" alt="Dashboard Extensions Users Import Export Settings Export Format" width="684" height="472" data-path="docs/images/cdy7uua7fh8z/1HVpo1IevSRJbFvwrEKkzf/761fa914f6c33cdee147e07b2c43f7c7/settings.png" />
  </Frame>

Lorsque vous êtes prêt, cliquez sur **Export X Users** (où `X` correspond au nombre d’utilisateurs que vous exportez).

Vous pouvez télécharger le fichier contenant vos utilisateurs une fois l’exportation terminée; vous devrez peut-être utiliser un outil d’extraction tiers si vous utilisez Windows 10 ou une version antérieure.

<div id="update-users">
  ## Mettre à jour les utilisateurs
</div>

Le <Tooltip tip="Management API : un produit permettant aux clients d’effectuer des tâches administratives." cta="Voir le glossaire" href="/fr-CA/docs/glossary?term=Management+API">Management API</Tooltip> d’Auth0 permet de mettre à jour en lot les profils d’utilisateur dans `user_metadata` et `app_metadata` à l’aide de l’extension User Import/Export.

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  Auth0 ne prend actuellement pas en charge l’importation en lot pour Passwordless. Utilisez [Auth0 Management API](https://auth0.com/docs/api/management/v2#!/Users/patch_users_by_id) pour mettre à jour les utilisateurs individuellement.
</Callout>

### Exporter les utilisateurs

À l’aide du [processus d’exportation ci-dessus](/fr-CA/docs/customize/extensions/user-import-export-extension#export-users), créez un fichier d’exportation complet contenant tous les attributs de vos utilisateurs.

Choisissez le format JSON pour l’exportation.

Téléchargez le fichier contenant vos utilisateurs une fois l’exportation terminée.

<div id="update-your-configuration">
  ### Mettez à jour votre configuration
</div>

Faites une **copie** du fichier JSON que vous avez téléchargé à l’étape précédente.

<Warning>
  Ce processus peut entraîner une perte de données. Créez une sauvegarde de votre base de données des utilisateurs en cas de corruption des données.
</Warning>

Ouvrez la copie du fichier JSON dans un éditeur de texte. Votre schéma d’utilisateur devrait ressembler à celui ci-dessous :

```json lines expandable theme={null}
[
   {
      "Id":"auth0|626737a9813c000069daf462",
      "Nickname":"testuser1",
      "Name":"testuser1@auth0.com",
      "email":"testuser1@auth0.com",
      "Connection":"Username-Password-Authentication",
      "Created At":"2022-04-26T00:07:05.098Z",
      "Updated At":"2022-07-06T14:54:19.214Z"
   },
   {
      "Id":"auth0|62d1a1853bdcf11ff5dca672",
      "Nickname":"testuser2",
      "Name":"testuser2@auth0.com",
      "email":"testuser2@auth0.com",
      "Connection":"Username-Password-Authentication",
      "Created At":"2022-07-15T17:19:01.531Z",
      "Updated At":"2022-07-15T17:19:01.532Z"
   },
   {
      "Id":"auth0|62d1a1a524f32a4185c9ce23",
      "Nickname":"testuser3",
      "Name":"testuser3@auth0.com",
      "email":"testuser3@auth0.com",
      "Connection":"Username-Password-Authentication",
      "Created At":"2022-07-15T17:19:33.484Z",
      "Updated At":"2022-07-15T17:19:33.484Z"
   }
]
```

Ne modifiez pas l’adresse courriel de l’utilisateur, car elle sert de clé de recherche pour les utilisateurs dans la base de données.

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  L’Id doit avoir un `connection|id` unique. Si le même Id d’utilisateur existe dans plusieurs connexions, votre mise à jour échouera.
</Callout>

Pour ajouter un attribut, créez un nouveau champ dans chaque schéma utilisateur et attribuez-lui une valeur. Dans l’exemple ci-dessous, l’attribut "Nom de famille" a la valeur "Smith", avec une virgule après la valeur du nouvel attribut.

Vous pouvez aussi ajouter l’attribut `email_verified` à plusieurs utilisateurs et définir sa valeur sur `true`.

```json lines theme={null}
{
   "Id":"auth0|626737a9813c000069daf462",
   "Nickname":"testuser1",
   "Family Name":"Smith",
   "Name":"testuser1@auth0.com",
   "email":"testuser1@auth0.com",
   "email_verified":true,
   "Connection":"Username-Password-Authentication",
   "Created At":"2022-04-26T00:07:05.098Z",
   "Updated At":"2022-07-06T14:54:19.214Z"
}
```

Enregistrez les modifications apportées à votre fichier d’utilisateur.

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  Ce processus ne permet pas de bloquer plusieurs utilisateurs. Vous devez bloquer les utilisateurs individuellement dans l’Auth0 Dashboard ou au moyen de l’[Auth0 Management API](https://auth0.com/docs/api/management/v2#!/Users/patch_users_by_id).
</Callout>

<div id="import-updated-user-profile-data">
  ### Importer des données de profil utilisateur mises à jour
</div>

Le point de terminaison `users-import` vous permet de téléverser votre fichier de profils utilisateur mis à jour et de mettre à jour plusieurs utilisateurs en une seule tâche. Accédez au [point de terminaison de création d’une tâche d’importation d’utilisateurs](https://auth0.com/docs/api/management/v2/#!/Jobs/post_users_imports).

Ajoutez votre fichier d’utilisateurs au paramètre users, puis ajoutez l’ID de la connexion à la base de données que vous souhaitez mettre à jour.

La valeur upsert doit être `true` pour mettre à jour les renseignements des utilisateurs existants.
Pour appliquer vos mises à jour, sélectionnez **Try** ou utilisez Postman pour importer les utilisateurs.

Utilisez le `job_id` pour vérifier l’état à l’aide du point de terminaison `jobs` [endpoint](https://auth0.com/docs/api/management/v2/#!/Jobs/get_jobs_by_id).