Delegated Administration: Write Hook

Delegated Administration ExtensionでWrite Hookを使用する方法を学びます。

ユーザーの作成または更新時に実行されるWrite Hookを使うと、次のようなことができます。

• ユーザーのパスワードを変更する
• ユーザーのメールアドレスを変更する
• ユーザーのプロファイルを更新する

また、Write Hookを使って、新しく作成されたユーザーにデフォルト値を自動的に設定することもできます。たとえば、自分が割り当てられているのと同じグループ、部門、またはベンダーに、ユーザーを自動的に割り当てたい場合があります。

Auth0では、ユーザーの作成はデータベース接続でのみサポートされています。

​

Hook の仕様

• ctx: コンテキストオブジェクト。

  • request.originalUser: 現在のユーザーの値。payload には新しいフィールドのセットが入ります。メソッドが update の場合にのみ使用できます。

  • payload: ペイロードオブジェクト

    • memberships: ユーザー作成時に UI で選択されたメンバーシップの配列。
    • email: ユーザーのメールアドレス。
    • password: ユーザーのパスワード。
    • connection: データベース接続の名前。
    • app_metadata: 変更対象の Custom Field が app_metadata に保存される場合に含まれるデータ。
    • user_metadata: 変更対象の Custom Field が user_metadata に保存される場合に含まれるデータ。

  • userFields: ユーザーフィールドの配列 (設定クエリで指定されている場合)

  • method: create 呼び出しの結果として呼び出されたか、update 呼び出しの結果として呼び出されたかに応じて、create または update のいずれかです。

• callback(error, user): エラーと、Management API に送信するユーザーオブジェクトを返せるコールバックです。

userFields の詳細については、Delegated Administration: 設定クエリ Hook を参照してください。

​

使用例

Kelly は財務部門を管理しています。Kelly がユーザーを作成する際、作成されたユーザーは財務部門のメンバーとして割り当てられる必要があります。

function(ctx, callback) {
  var newProfile = {
    email: ctx.payload.email,
    password: ctx.payload.password,
    connection: ctx.payload.connection,
    user_metadata: ctx.payload.user_metadata,
    app_metadata: {
      department: ctx.payload.memberships && ctx.payload.memberships[0],
      ...ctx.payload.app_metadata
    }
  };

  if (!ctx.payload.memberships || ctx.payload.memberships.length === 0) {
    return callback(new Error('The user must be created within a department.'));
  }

  // 現在のユーザーのメタデータから部署を取得します。
  var currentDepartment = ctx.request.user.app_metadata && ctx.request.user.app_metadata.department;
  if (!currentDepartment || !currentDepartment.length) {
    return callback(new Error('The current user is not part of any department.'));
  }

  // IT部署に所属していない場合、自分の部署内でのみユーザーを作成できます。
  // ITはすべての部署でユーザーを作成できます。
  if (currentDepartment !== 'IT' && ctx.payload.memberships[0] !== currentDepartment) {
    return callback(new Error('You can only create users within your own department.'));
  }

  if (ctx.method === 'update') {
    // 更新の場合、送信が必要なフィールドのみを設定します
    Object.keys(newProfile).forEach(function(key) {
      if (newProfile[key] === ctx.request.originalUser[key]) delete newProfile[key];
    });
  }

  // これがAPI v2に送信されるペイロードです。API v2でのユーザー作成方法を自由に制御できます。
  return callback(null, newProfile);
}

​

詳しくはこちら

• Delegated Administration: アクセス Hook
• Delegated Administration: フィルター Hook
• Delegated Administration: メンバーシップクエリ Hook
• Delegated Administration: 設定クエリ Hook