Delegated Administration: Filter Hook - Auth0 Docs

デフォルトでは、Delegated Admin - User ロールを持つユーザーには、Auth0 アカウントに関連付けられたすべてのユーザーが表示されます。ただし、Filter Hook を使用して、ユーザーに表示されるデータを絞り込むことができます。

Hook の仕様

ctx: コンテキストオブジェクト。
callback(error, query): エラー、またはユーザーの絞り込みに使用する lucene クエリを返すためのコールバック。拡張機能はこのクエリを、の Get Users エンドポイントに送信します。

lucene クエリの詳細については、User Search Query Syntax を参照してください。

使用例

Kelly が Finance 部門を管理している場合、表示されるのは同じ Finance 部門に属するユーザーだけであるべきです。この場合、現在のユーザーは Kelly で、その所属部門は Finance 部門なので、現在のユーザーの部門に基づいてユーザーを絞り込みます。

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

  // IT部門はすべてのユーザーを閲覧できる。
  if (department === 'IT') {
    return callback();
  }

  // Luceneクエリを返す。
  return callback(null, 'app_metadata.department:"' + department + '"');
}

検索エンジンのオーバーライド

レスポンスで使用する検索エンジンを指定することで、既定の検索エンジンをオーバーライドできます。

// luceneクエリを返す。
return callback(null, { query: 'app_metadata.department:"' + department + '"', searchEngine: 'v2' });

注意

絞り込みに使用するタームには、シングルクォート、ダブルクォート、その他の特殊文字 (+ や - など) を使用しないでください。Lucene クエリで問題が発生する可能性があります。 OR、NOT、AND などの演算子を複数使用する場合は、どの演算子がどこに適用されるかを明確にするため、それらの検索パラメーターを丸括弧 [()] で囲んでください。この Hook を設定しない場合、検索ではすべてのユーザーが返されます。

詳しくはこちら