リソースアプリを構成する
リソースアプリを構成し、アプリとAIエージェントの間にリソース接続を作成できるようにします。
注: Federation Broker Modeを使用するアプリの場合、トークン交換の失敗を避けるために、SAMLアサーションはOktaユーザーの名前ID(${user.login})またはユーザーID(${user.id})と一致する必要があります。
リソースアプリには、次のアクセス方式を構成できるマシン割り当て(Machine Assignments)タブがあります。
- Cross-app access(XAA)(推奨):AIエージェントがユーザーに同意を求めることなくアプリに接続できます。
- ブローカー経由の同意(Brokered Consent):管理者が構成した資格情報を使用してAIエージェントをアプリに接続してから、ユーザーに同意を求めます。
注:
リソースアプリに500を超えるスコープがある場合、マシン割り当て(Machine Assignments) タブからそれらのスコープを表示または編集することはできません。クライアントアプリがスコープをサポートしていない場合、アプリはクライアントの権限を継承します。Oktaで継承されたスコープを表示または編集することはできません。
開始する前の確認事項
- アプリを管理するための権限を持つ管理者ロールがあること。
- サードパーティアプリプロバイダーでクライアントアプリが登録されている。「一般的なリソースアプリの前提条件」を参照してください。
- orgにリソースアプリが統合されている。「既存のアプリ統合を追加する」を参照してください。
手順
-
Admin Consoleで、に移動します。
- リソースアプリを検索して選択します。
- マシン割り当て(Machine Assignments)タブに移動します。
- 呼び出し元(Callers)タイルを選択します。
- このアクセス方法を構成するには、Cross-app access(XAA)を選択します。
- Cross App Accessを通じてアプリへのアクセスを付与するには、有効化(Enable)を選択します。
- 次のフィールドに情報を入力します。
- リソースURL(Resource URL):このアプリのリソースサーバーのベースURL。
- 発行者URL(Issuer URL):アプリの認可サーバーのベースURL。OktaはこのURLを使用してトークン検証リクエストを検出します。
- オーディエンス/テナントID(Audience/tenant ID):リソースを保護する認可サーバーの一意の識別子またはオーディエンスクレーム。
- 保存(Save)をクリックします。
- このアクセス方法を構成するには、ブローカー経由の同意(Brokered Consent)を選択します。
- セキュリティトークンサービスでアプリへのアクセスを付与するには、有効化(Enable)を選択します。
- リソースサーバーコネクターで登録したクライアントアプリのクライアントID(Client ID)とクライアントシークレット(Client secret)を入力します。
- クライアントアプリがスコープをサポートしている場合は、スコープ(Scopes)フィールドが表示されます。リソースアプリに付与するスコープを追加します。
- 保存(Save)をクリックします。
- 保存(Save)をクリックします。
- 任意。編集(Edit)ボタンを使って構成を変更します。 注:
後でブローカー経由の同意スコープを変更する場合、そのAIエージェントを伴うアクティブなセッション内にいるユーザーは、再認証して同意する必要があります。その後、AIエージェントはユーザーに代わって以後のアクションを実行できます。