ユーザーアカウントのリンク解除

Management API のユーザーアカウントのリンクを解除するエンドポイントを使用して、対象のユーザーアカウントから ID のリンクを解除し、再び個別のユーザーアカウントに戻す方法を学びます。

Auth0 Management API の ユーザーアカウントのリンクを解除する エンドポイント、または auth0.js ライブラリを使用すると、対象のユーザーアカウントからアイデンティティをリンク解除し、再び別個のユーザーアカウントとして扱えるようにできます。

リンク解除の結果は次のとおりです。

• セカンダリアカウントは、プライマリアカウントの identities 配列から削除されます。
• 新しいセカンダリユーザーアカウントが作成されます。
• セカンダリアカウントにはメタデータが設定されません。

セカンダリアイデンティティを完全に削除することが目的であれば、まずアカウントのリンクを解除してから、新しく作成されたセカンダリアカウントを削除する必要があります。

エンドポイントを呼び出す場所に応じて、次の 2 つの scope のいずれかを使用します。

• クライアント側コード では update:current_user_identities
• サーバーサイドコード では update:users

このエンドポイントでは、次のパラメーターを使用します。

Parameter	Type	Description
id	string	プライマリユーザーアカウントの ID (必須)
provider	string	リンクされたセカンダリアカウントのアイデンティティプロバイダー名 (例: google-oauth2)
user_id	string	リンクされたセカンダリアカウントの ID (例: ` の後ろの 123456789081523216417 の部分)

インスタンスに複数のプロバイダーのユーザーがいる場合は、プロバイダー名を指定するため、user_id string の前に [connection_name]| を含めることもできます (例: "user-id": "google-oauth2|123456789081523216417") 。

​

レスポンス例

[
  {
    "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": ""
    }
  }
]

​

プライマリアカウントの JWT を使用する

アカウントのリンクを解除するには、認可にプライマリアカウントの JWT を使用して、Management API の ユーザーアカウントのリンクを解除するエンドポイント を呼び出します:

​

update:users スコープを持つアクセストークンを使用する

2つ以上のユーザーアカウントのリンクを解除する必要がある場合は、update:users スコープを持つManagement API のアクセストークンを使用して、Management APIのユーザーアカウントのリンクを解除するエンドポイントを呼び出してください。

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

  // プライマリユーザーのアクセストークンをベアラートークンとして使用して、リンク解除対象のアカウントを特定します。
  // セカンダリユーザーのユーザーIDを使用して、プライマリアカウントからリンク解除するユーザーを特定します。

  $.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);
  });
}

​

サーバーサイドコードからアカウントのリンクを解除する

1. 各要素が個別のユーザーアカウントを表す、新しい ID の配列でセッション内のユーザーを更新します。

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. update:users スコープを持つ Management API のアクセストークン を使用して、Management API v2 の ユーザーアカウントのリンクを解除するエンドポイント を呼び出します。

​

詳細はこちら

• ユーザーアカウントをリンクする
• ユーザーアカウントのリンク: サーバーサイド実装
• ユーザー主導のアカウントのリンク: クライアントサイド実装