サポートされている外部プロバイダー
- Microsoft
- Box
- Slack
- GitHub
- カスタム ソーシャル接続
エンタープライズ
- Google Workspace
- Microsoft Azure AD (Entra ID)
- Connect
一般的なユースケース
- Web アプリケーションとして動作する AI エージェントが、Google Calendar での予定のスケジュール設定など、ユーザーに代わってタスクを実行するために外部 API を呼び出す。
- 内部サービスやバックエンドサービスが Token Vault にアクセスし、Auth0 のアクセストークンを外部プロバイダーのアクセストークンと交換して外部 API を呼び出す。
動作の仕組み
- Auth0 は OAuth 2.0 のスコープを使用してアクセストークンとリフレッシュトークンを取得し、ユーザーは要求された権限を明示的に承認します。
- Auth0 は接続された各アカウントのトークンを Token Vault に安全に保存します。各接続アカウントはユーザープロファイルにリンクされているため、アプリケーションはユーザーに接続の再承認を求めることなく、外部の API やサービスにアクセスできます。
- アプリケーションは、ユーザーの有効な Auth0 トークンを、そのユーザーに対して発行された外部プロバイダーのアクセストークンに交換するために Auth0 を呼び出します。詳細については、Supported token exchanges を参照してください。
- 外部プロバイダーのアクセストークンを使用して、アプリケーションはユーザーに代わって外部 API を呼び出すことができます。
サポートされているトークン交換
| トークン交換 | 説明 | クライアントアプリケーションの種類 |
|---|---|---|
| リフレッシュトークン交換 | Auth0 のリフレッシュトークンを外部プロバイダーのアクセストークンと交換します。 | ユーザーがアプリケーションを積極的に使用していないときでもユーザーセッションを維持し、外部 API にアクセスする必要がある Web、モバイル、ネイティブアプリケーションなど。 |
| アクセストークン交換 | Auth0 のアクセストークンを外部プロバイダーのアクセストークンと交換します。 | シングルページアプリケーション (SPA) など、他のサービスやアプリケーションから受け取ったアクセストークンを交換する必要がある API またはマイクロサービス。 |
| Privileged worker トークン交換 | 署名付き JWT Bearer トークンを外部プロバイダーのアクセストークンまたはリフレッシュトークンと交換します。 | サービス間 (M2M) フローにおけるバックエンドアプリケーションまたはサービスワーカー。 |
はじめに
| 参照するドキュメント | 学べる内容 |
|---|---|
| Connected Accounts for Token Vault | Token Vault の Connected Accounts の設定と使用方法。 |
| Refresh Token Exchange with Token Vault | アプリケーションが Token Vault のリフレッシュトークンエクスチェンジを利用して外部 API を呼び出す方法。 |
| Access Token Exchange with Token Vault | アプリケーションが Token Vault のアクセストークンエクスチェンジを利用して外部 API を呼び出す方法。 |
| Privileged Worker Token Exchange with Token Vault | アプリケーションが Token Vault の特権ワーカートークンエクスチェンジを利用して外部 API を呼び出す方法。 |
| Configure Token Vault | トークンエクスチェンジを含む Token Vault の設定方法。 |