Skip to main content
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 フローを使うべきですか？ を参照してください。

​
クエリパラメータ

​
string
必須
アクセス先のAPIを一意に識別するID。
​
string
アクセスしたい対象API (リソースサーバー) の識別子。Auth0テナントに登録されているAPI Identifierと一致している必要があります。テナントのResource Parameter Compatibility Profileがcompatibilityに設定されている場合は、audienceの代わりに使用します。
​
string
認可をリクエストするスコープ。スペース区切りで指定する必要があります。標準のOpenID Connect (OIDC) スコープ、カスタムクレーム、または対象APIでサポートされている任意のスコープをリクエストできます。Refresh Tokenを取得するには、offline_accessを含めてください。
​
string
必須
実行するOAuth 2.0フローをAuth0に示します。Authorization Code Grant Flowには’code’を使用します。
​
string
必須
アプリケーションのID。
​
string
ユーザーが認可を付与した後、Auth0がブラウザーをリダイレクトする先のURL。
​
string
アプリケーションが最初のリクエストに追加し、アプリケーションへリダイレクトする際にAuth0が含める不透明な値。この値は、CSRF攻撃を防ぐためにアプリケーションで使用する必要があります。
​
string
アプリケーション用に設定されたコネクションの名前。
​
string
サイレント認証を開始するには、‘prompt=none’を使用します。
​
string
ユーザーの認証時に使用する組織のID。指定しない場合、アプリケーションでDisplay Organization Promptが設定されていれば、認証時にユーザーが組織名を入力できます。
​
string
組織への招待のチケットID。組織にメンバーを招待する場合、ユーザーが招待を承諾した際に、アプリケーションは invitation と organization のキーと値のペアを引き渡して、招待承諾を処理する必要があります。
​
string
SHA-256ハッシュ関数を使用した、Proof-of-Possession公開鍵のJWK Thumbprint [RFC7638]。Demonstrating Proof-of-Possession (DPoP) を使用する場合にのみ指定します。

​
レスポンスメッセージ