Dissocier des comptes d’utilisateur

Découvrez comment utiliser le point de terminaison Unlink a User Account de la Management API pour dissocier une identité du compte d’utilisateur cible et en faire de nouveau un compte d’utilisateur distinct.

Utilisez le point de terminaison Auth0 Management API Unlink a User Account ou la bibliothèque Auth0.js pour dissocier une identité du compte d’utilisateur cible et en faire de nouveau un compte d’utilisateur distinct.

Le résultat du processus de dissociation est le suivant :

• Le compte secondaire est retiré du tableau identities du compte principal.
• Un nouveau compte d’utilisateur secondaire est créé.
• Le compte secondaire n’aura aucune métadonnée.

Si votre objectif est de supprimer complètement l’identité secondaire, vous devez d’abord dissocier les comptes, puis supprimer le compte secondaire nouvellement créé.

Selon l’endroit à partir duquel vous appelez le point de terminaison, utilisez l’une de ces deux portées :

• update:current_user_identities à partir de code côté client
• update:users à partir de code côté serveur

Le point de terminaison utilise les paramètres suivants :

Paramètre	Type	Description
id	string	ID du compte d’utilisateur principal (obligatoire)
provider	string	nom du fournisseur d’identité du compte secondaire lié (p. ex. google-oauth2)
user_id	string	ID du compte secondaire lié (p. ex. la partie 123456789081523216417 après le `

Si votre instance comporte des utilisateurs provenant de plusieurs fournisseurs, vous pouvez aussi inclure [connection_name]| avant la chaîne user_id pour nommer le fournisseur (par exemple, "user-id": "google-oauth2|123456789081523216417").

​

Exemple de réponse

[
  {
    "connection": "Initial-Connection",
    "user_id": "5457edea1b8f22891a000004",
    "provider": "auth0",
    "isSocial": false,
    "access_token": "",
    "profileData": {
      "email": "",
      "email_verified": false,
      "name": "",
      "username": "johndoe",
      "given_name": "",
      "phone_number": "",
      "phone_verified": false,
      "family_name": ""
    }
  }
]

​

Utilisez le JWT du compte principal

Pour dissocier des comptes, envoyez une requête au point de terminaison Unlink a User Account de la Management API en utilisant le JWT du compte principal pour l’autorisation :

​

Utiliser un jeton d’accès avec la portée update:users

Si vous devez dissocier au moins deux comptes d’utilisateur, effectuez une requête vers le point de terminaison Unlink a User Account de la Management API à l’aide d’un jeton d’accès de la Management API doté de la portée update:users.

function unlinkAccount(secondaryProvider, secondaryUserId) {
  var primaryUserId = localStorage.getItem('user_id');
  var primaryAccessToken = localStorage.getItem('access_token');

  // Utilise le jeton d'accès de l'utilisateur principal comme bearer token pour identifier le compte
  // dont le compte sera dissocié, ainsi que l'identifiant de l'utilisateur secondaire, pour identifier
  // l'utilisateur qui sera dissocié du compte principal.

  $.ajax({
    type: 'DELETE',
    url: 'https://' + AUTH0_DOMAIN +'/api/v2/users/' + primaryUserId +
         '/identities/' + secondaryProvider + '/' + secondaryUserId,
    headers: {
      'Authorization': 'Bearer ' + primaryAccessToken
    }
  }).then(function(identities){
    alert('unlinked!');
    showLinkedAccounts(identities);
  }).fail(function(jqXHR){
    alert('Error unlinking Accounts: ' + jqXHR.status + ' ' + jqXHR.responseText);
  });
}

​

Dissocier des comptes dans le code côté serveur

1. Mettez à jour l’utilisateur de la session avec le nouveau tableau d’identités (chacune représentant un compte d’utilisateur distinct).

const ensureLoggedIn = require('connect-ensure-login').ensureLoggedIn();
const Auth0Client = require('../Auth0Client');
const express = require('express');
const router = express.Router();
...
router.post('/unlink-accounts/:targetUserProvider/:targetUserId',ensureLoggedIn, (req,res,next) => {
  Auth0Client.unlinkAccounts(req.user.id, req.params.targetUserProvider, req.params.targetUserId)
  .then( identities => {
    req.user.identities = req.user._json.identities = identities;
    res.send(identities);
  })
  .catch( err => {
    console.log('Error unlinking accounts!',err);
    next(err);
  });
});

1. Envoyez une requête au point de terminaison Unlink a User Account de la Management API v2 en utilisant un jeton d’accès de la Management API doté de la portée update:users.

​

En savoir plus

• Lier des comptes d’utilisateurs
• Liaison de comptes d’utilisateur : mise en œuvre côté serveur
• Liaison de comptes initiée par l’utilisateur : mise en œuvre côté client