アイデンティティ・ドメインBearerトークン認証の設定
アイデンティティ・ドメインベアラー・トークン認証を使用してホストされたアプリケーションを起動するクライアントに対してOAuthアクセス・トークンを発行するように、OCI IAMアイデンティティ・ドメインで機密アプリケーションを構成します。
これらのステップは、アイデンティティ・ドメインベアラー・トークン認証を使用するホスト・アプリケーションに適用されます。ホストされたアプリケーションの認証を構成する場合は、アイデンティティ・ドメインのURL、スコープおよびオーディエンスを使用します。認証を参照してください。
次の例では、クライアント資格証明付与を使用してアクセス・トークンを取得します。サポートされている認証方法の概要は、「認証」を参照してください。アイデンティティ・ドメインの詳細は、アイデンティティ・ドメインのあるIAMを参照してください。
アイデンティティ・ドメイン・ブラウザのセッション認証については、アイデンティティ・ドメイン・ブラウザ・セッションを参照してください。このオプションでは、PKCEでOAuth 2.1認可コード・フローを使用し、ホストされたアプリケーション・サービスはブラウザ・ユーザーのかわりにアクセス・トークンを取得します。
ステップ1. アイデンティティ・ドメインの作成(オプション)
各OCIテナンシには、デフォルトのアイデンティティ・ドメインがあります。別のドメインを作成するには、アイデンティティ・ドメインの作成を参照してください。ステップの例:
- OCIコンソールにサインインしてください。
- ナビゲーション・メニューを開き、「アイデンティティおよびセキュリティ」を選択します。
- 「アイデンティティ」で、「ドメイン」を選択します。
- 「ドメインの作成」を選択します。
- ドメイン管理者など、必要な情報を指定します。
- 「作成」を選択し、ドメインがアクティブになるまで待機します。
ステップ2. アイデンティティ・ドメインでのアプリケーションの作成
ステップの例:
- 認証に使用するアイデンティティ・ドメインを開きます。デフォルト・ドメインまたは作成したドメインを使用できます。
- 「統合アプリケーション」タブを選択します。
- 「アプリケーションの追加」を選択します。
- 「機密アプリケーション」を選択し、「ワークフローの起動」を選択します。
- 「名前」および「説明」を指定し、残りのフィールドをデフォルトのままにして、「送信」を選択します。
ステップ3. OAuth設定の構成
ステップの例:
- 作成したアプリケーションを開きます。
- OAuth構成を選択し、「OAuth構成の編集」を選択します。
- 「このアプリケーションをリソース・サーバーとして今すぐ構成してください」を有効にします。
プライマリ・オーディエンスを指定します(例:
https://your_application.com/)。オーディエンスとは、どのAPIがアイデンティティ・サーバーによって生成された認証トークンを受け入れて検証できるかを意味します。この特定のケースでは、https://application.generativeai.ap-osaka-1.oci.oraclecloud.com/20251112/hostedApplications/などのデータ・プレーンAPI URLを入力できます。目標は、OAuthトークンを検証する受信者のアイデンティティを設定することです。任意の単語(my_agent_applicationなど)を使用できます。「スコープの追加」を選択し、スコープ名を定義します(たとえば、
read、write、invoke)。Scopeは、認証トークンによって付与される権限を意味します。アイデンティティ・ドメイン統合アプリケーションで複数のスコープを定義し、ホストされたアプリケーションでそれらのいずれかを使用して認証できます。 - 「このアプリケーションをクライアントとして今すぐで構成します」を有効にします
権限付与タイプとして「Client credentials」を選択します。
- 「送信」を選択します。
- から、「アクティブ化」を選択してアプリケーションをアクティブ化します。
アクティブ化後、アプリケーションの詳細ページに戻り、OAuth構成を選択します。次の値が表示されます。
- クライアントID
- クライアント・シークレット
- プライマリ・オーディエンス
- スコープ
アイデンティティ・ドメインのメイン・ページには、ドメインURLが表示されます。これらの値を安全に記録します。後でこれらを使用して、ホストされたアプリケーションにアクセスするためのアクセス・トークンを生成します。