ユーザーアカウントのリンク: サーバーサイド実装

サンプルシナリオを使って、サーバーサイドコードにより従来型の Web アプリケーションでユーザーアカウントをリンクする方法を説明します。

Auth0 は、さまざまなアイデンティティプロバイダーのユーザーアカウントのリンクをサポートしています。サーバーサイドコードを使用すれば、従来型の Web アプリケーションでアカウントをリンクできます。この方法では、処理を進める前にユーザーに確認し、許可を得ます。コードはユーザーを認証し、メールアドレスを使ってユーザーを検索して特定します。その後、アプリケーションはユーザーに対象アカウントの資格情報で認証するよう求め、アカウントのリンクを促し、最後にそれらのアカウントをリンクします。

このサンプルアプリケーションの完全なソースコードは、GitHub で確認できます。

1. ユーザーをアプリケーションにログインさせます。
   

   ユーザーは Universal Login を使用してアプリケーションにログインします。詳しくは、Auth0 Management API の audience (audience=https://{yourDomain}/api/v2/) 向けの token を要求する Regular Web App Quickstart をご覧ください。

2. 同じメールアドレスのユーザーを検索します。
   

   ユーザープロファイルと、同じ確認済みメールアドレスを持つユーザーの一覧を取得できます。

   router.get("/", async (req, res) => {
     const { sub, email_verified } = req.openid.user;
     //user_metadataとapp_metadataプロパティを含むユーザープロファイルを取得する
     try {
       let getUsersWithSameVerifiedEmail = [];
       const getUserProfile = auth0Client.getUser(sub);
       if (email_verified)
         // アカウントリンクはメール確認済みの場合のみ提供される
         getUsersWithSameVerifiedEmail = auth0Client.getUsersWithSameVerifiedEmail(
           req.openid.user
         );
   
       const [user, suggestedUsers] = await Promise.all([
         getUserProfile,
         getUsersWithSameVerifiedEmail,
       ]);
   
       const flashError = clear(req);
       res.render("user", {
         user,
         suggestedUsers,
         wrongAccountError: flashError && flashError === Errors.WrongAccount,
       });
     } catch (err) {
       debug("GET /user[s] failed: %o", err);
       res.render("error", err);
     }
   });
   

   同じメールアドレスに紐づくすべてのユーザーレコードの一覧を取得するには、アプリケーションから read:users スコープを持つ Management API Access Token を使用して、Auth0 Management API の Get Users By Email エンドポイント を呼び出します。

   const request = require('request');
   class Auth0Client {
   ...
   async getUsersWithSameVerifiedEmail({ sub, email }) {
     return await this.request({
       url: `${process.env.ISSUER_BASE_URL}/api/v2/users-by-email?email=${email}`,
     });
   }
   

3. ユーザーにアカウントのリンクを求めます。

   1. Auth0 が一致するメールアドレスを持つレコードを1件以上返した場合、ユーザーにはその一覧とともに、アカウントのリンクを促す次のメッセージが表示されます。

   2. ユーザーが特定のアカウントをリンクしたい場合は、該当するアカウントの横にある Link をクリックできます。

      

4. ユーザーがリンクをクリックすると、アプリケーションはユーザーに対象アカウントでの認証を求め、その後アカウントリンクを行います。

   セカンダリアカウントのuser_metadataを保持して統合するには、APIエンドポイントを呼び出す前に、そのuser_metadataを取得し、プライマリアカウントのメタデータにマージする必要があります。アカウントをリンクすると、セカンダリアカウントのメタデータは破棄されます。

   アカウント リンクを開始する際には、どのIDをプライマリアカウントにし、どのIDをセカンダリアカウントにするかを選択できます。この選択は、プライマリプロファイルに保持したい属性セットによって決まります。

   次のコードスニペットは、メタデータを検証してマージする方法を示しています：

   async function accountLink(req, res, next) {
   const {
     linking: { targetUserId },
   } = req.appSession;
   const { sub: authenticatedTargetUserId } = req.openidTokens.claims();
   if (authenticatedTargetUserId !== targetUserId) {
     debug(
       "Skipping account linking as the authenticated user(%s)  is different than target linking user (%s)",
       authenticatedTargetUserId,
       targetUserId
     );
     set(req, Errors.WrongAccount);
     return next();
   }
   
   debug(
     "User %s succesfully authenticated. Account linking with %s... ",
     authenticatedTargetUserId,
     targetUserId
   );
   const { id_token: targetIdToken } = req.openidTokens;
   const { sub: primaryUserId } = req.appSession.claims;
   
   try {
     await mergeMetadata(primaryUserId, authenticatedTargetUserId);
     await auth0Client.linkAccounts(primaryUserId, targetIdToken);
     debug("Accounts linked.");
   } catch (err) {
     debug("Linking failed %o", err);
   } finally {
     next();
   }
   }
   

5. あなたのアプリケーションは、update:users スコープを持つ Management API アクセストークン を使用して、Auth0 Management API の Link a User Account エンドポイント を呼び出します。

​

メタデータのマージ例

次の例では、API V2 向け Node.js Auth0 SDK を使用して、セカンダリアカウントの user_metadata と app_metadata がプライマリアカウントにどのように明示的にマージされるかを示します。

/*
 * セカンダリユーザーの user_metadata と app_metadata をプライマリユーザーに再帰的にマージします。
 * プライマリユーザーのデータが優先されます。
 * 配列フィールドは結合されます。
 */
async function mergeMetadata(primaryUserId, secondaryUserId) {
  // 両方のユーザーをメタデータとともに読み込みます。
  const [primaryUser, secondaryUser] = await Promise.all(
    [primaryUserId, secondaryUserId].map((uid) => auth0Client.getUser(uid))
  );

  const customizerCallback = function (objectValue, sourceValue) {
    if (_.isArray(objectValue)) {
      return sourceValue.concat(objectValue);
    }
  };
  const mergedUserMetadata = _.merge(
    {},
    secondaryUser.user_metadata,
    primaryUser.user_metadata,
    customizerCallback
  );
  const mergedAppMetadata = _.merge(
    {},
    secondaryUser.app_metadata,
    primaryUser.app_metadata,
    customizerCallback
  );
  await auth0Client.updateUser(primaryUserId, {
    user_metadata: mergedUserMetadata,
    app_metadata: mergedAppMetadata,
  });
}