1. RARとは何か?
RAR(Rich Authorization Requests)は、OAuth 2.0で、アクセス権限の内容をより細かく指定するための拡張仕様(RFC 9396)です。
通常のOAuthでは scope を使って権限を要求しますが、RARでは「誰に、何を、どのような条件で実行するか」まで具体的に指定できます。
例えば、銀行アプリが送金APIを利用するケースを考えます。
通常のOAuthの場合
scope=payment:write
「送金を実行する権限」という大まかな要求になります。
RARを利用する場合
{
"type": "payment_initiation",
"creditor": "受取人A",
"amount": {
"currency": "JPY",
"value": "10000"
}
}
この例では、「受取人Aに1万円を送金する」という具体的な認可内容を指定しています。
※これは概念を説明するための簡略化した例で、実際の属性は利用するAPIの仕様によって異なります。
2. RARの動作の流れ
- クライアントが認可サーバーに
authorization_detailsというパラメーターで詳細な権限を要求する。 - 認可サーバーが要求内容を確認し、ユーザーに「受取人Aに1万円送金することを許可しますか?」と同意を求める。
- ユーザーが同意すると、認可サーバーが認められた条件に対応するアクセストークンを発行する。
- API側がアクセストークンと認可情報を確認し、許可された条件の範囲内で処理する。
重要なのは、RARで詳細な権限を要求するだけでなく、API側でもその条件を適切に検証する必要があることです。
参考資料
コメント