Auth0 設定（モバイルアプリ + API）

​

API を作成する

• Name: API の表示名です。機能には影響しません。
• Identifier: API の一意の識別子です。URL を使用することをおすすめしますが、公開されている URL である必要はありません。Auth0 がこの API を呼び出すことはありません。この値は後から変更できません。
• 署名アルゴリズム: トークンの署名に使用するアルゴリズムです。指定できる値は HS256 と RS256 です。RS256 を選択すると、トークンはテナントの秘密鍵で署名されます。署名アルゴリズムの詳細については、Signing Algorithms を参照してください。

​

署名アルゴリズム

• RS256 は非対称アルゴリズムです。つまり、公開鍵と秘密鍵 (シークレット) の 2 つの鍵があります。Auth0 は署名の生成に使用する秘密鍵を保持し、JWT の利用者は署名の検証に使用する公開鍵を保持します。
• HS256 は対称アルゴリズムです。つまり、2者間で共有されるシークレット鍵が 1 つだけあります。同じ鍵が署名の生成と検証の両方に使用されます。そのため、鍵の機密性を保つには特に注意が必要です。

• RS256 では、秘密鍵の保持者 (Auth0) のみがトークンに署名でき、公開鍵を使えば誰でもそのトークンが有効かどうかを確認できます。
• HS256 では、秘密鍵が漏えいした場合、新しいシークレットを使って API を再デプロイする必要があります。RS256 では、複数のオーディエンスに対して有効なトークンを要求できます。
• RS256 では、新しいシークレットを使って API を再デプロイしなくても、鍵のローテーションを実装できます。

​

権限を設定する

​

アプリケーションを作成する

​

Authorization Extension を設定する

​

権限を定義する

​

ロールを定義する

​

ユーザーをロールに割り当てる

​

Authorization Extension の設定

​

トークンのスコープを検証する Rule を作成する

function (user, context, callback) {
  if (context.clientName !== 'Timesheets SPA') {
    return callback(null, user, context);
  }

  var permissions = user.permissions || [];
  var requestedScopes = context.request.body.scope || context.request.query.scope;
  var filteredScopes = requestedScopes.split(' ').filter( function(x) {
    return x.indexOf(':') < 0;
  });
  Array.prototype.push.apply(filteredScopes, permissions);
  context.accessToken.scope = filteredScopes.join(' ');

  callback(null, user, context);
}