title: “アプリケーションを認可する” description: “OAuth 2.0の認可コードフローを開始し、ユーザーの同意と認可コードを取得します。” ---”
エンドポイント
GET /authorize
OAuth 2.0の認可フローを開始するには、まずユーザーを認可URLにリダイレクトする必要があります。
認可エンドポイント
この呼び出しの目的は、API (audience で指定) を呼び出し、ユーザーに代わって特定の操作 (scope で指定) を実行することについて、ユーザーの同意を得ることです。Auth0 は、以前に同意が付与されていない限り、ユーザーを認証して同意を取得します。scope の値を変更すると、Auth0 はあらためて同意を求めます。
ユーザーの認可が必要な OAuth 2.0 フローは次のとおりです。
* 認可コードフロー
* Proof Key for Code Exchange (PKCE) を使用する認可コードフロー
* インプリシットフロー
Resource Owner Password Grant と Client Credentials Flow では、ユーザーの認可が関与しないため、このエンドポイントは使用されません。代わりに、POST /oauth/token エンドポイントを直接呼び出してアクセストークンを取得します。
実装する OAuth 2.0 フローに応じて、パラメータは若干異なります。どのフローが自分のケースに最も適しているかを判断するには、どの OAuth 2.0 フローを使うべきですか? を参照してください。
クエリパラメータ
アクセスしたい対象API (リソースサーバー) の識別子。Auth0テナントに登録されているAPI Identifierと一致している必要があります。テナントのResource Parameter Compatibility Profileが
compatibilityに設定されている場合は、audienceの代わりに使用します。認可をリクエストするスコープ。スペース区切りで指定する必要があります。標準のOpenID Connect (OIDC) スコープ、カスタムクレーム、または対象APIでサポートされている任意のスコープをリクエストできます。Refresh Tokenを取得するには、
offline_accessを含めてください。アプリケーションが最初のリクエストに追加し、アプリケーションへリダイレクトする際にAuth0が含める不透明な値。この値は、CSRF攻撃を防ぐためにアプリケーションで使用する必要があります。
サイレント認証を開始するには、‘prompt=none’を使用します。
組織への招待のチケットID。組織にメンバーを招待する場合、ユーザーが招待を承諾した際に、アプリケーションは invitation と organization のキーと値のペアを引き渡して、招待承諾を処理する必要があります。
SHA-256ハッシュ関数を使用した、Proof-of-Possession公開鍵のJWK Thumbprint [RFC7638]。Demonstrating Proof-of-Possession (DPoP) を使用する場合にのみ指定します。