Agent 365 CLIカスタムクライアントアプリ登録

Agent 365 CLIでエージェントIDの設計図を認証および管理するには、Microsoft Entra IDテナントにカスタムクライアントアプリの登録が必要です。

この記事では、プロセスを4つの主要な手順に分けて説明します。

アプリケーションの登録
リダイレクト URI を設定
アプリケーション (クライアント) ID のコピー
API 権限の構成管理者権限が必要
wids ロールのクレームを追加する

問題が発生した場合はトラブルシューティングセクションをご参照ください。

必要条件

始める前に、Microsoft Entra 管理センターにアクセスできること、また必要に応じて同意を与えるための必要な管理者ロールのいずれかを持っていることを確認してください。

アプリを登録するには

デフォルトでは、テナント内の任意のユーザーが Microsoft Entra 管理センターでアプリケーションを登録できます。ただし、テナント管理者はこの機能を制限することができます。アプリを登録できない場合は、管理者に連絡してください。

4. API 権限の構成には、これらの管理者ロールのいずれかが必要です。

アプリケーション管理者: 推奨 - アプリ登録管理および同意付与が可能です
Cloud Application Administrator: アプリの登録管理と同意付与が可能です
グローバル管理者: すべての権限を持っていますが必須ではありません

ヒント

管理者アクセスがない場合手順1〜3を完了した後、テナント管理者に手順4を依頼してください。テナント管理者に、手順3で取得したアプリケーション（クライアント）IDとAPI権限の設定セクションへのリンクを提供してください。

ヒント

グローバル管理者は手動登録をスキップできます。 a365 setup requirements を実行し、Agent 365 CLI アプリがテナントに見つからない場合は、CLI が自動的に作成を促し、管理者の同意を付与します。プロンプトで C と入力すると、一つの手順でアプリを作成できます。自動パスを使用する場合、このセクションの手順をスキップできます。

1. アプリケーションの登録

これらの手順は、アプリ登録を作成するための完全な手順をまとめたものです。

Microsoft Entra 管理センター に移動する
アプリの登録 を選択する
[新しい登録] を選択します
次を入力します。
- 名前: アプリに意味のある名前を入力しましょう（例: my-agent-app）。アプリユーザーにはこの名前が表示されますが、いつでも変更できます。同じ名前で複数のアプリ登録を行うことができます。
  
  ヒント
  
  構成不要の a365 setup all --agent-name フローを使用する場合は、アプリ名を正確に Agent 365 CLI にしてください。 CLI はこの既知の表示名でクライアントアプリを自動的に検索するため、クライアント ID を設定ファイルに記載する必要はありません。
- サポートされているアカウントの種類: この組織のディレクトリ内のアカウントのみ (シングルテナント)
- リダイレクト URI: [パブリッククライアント/ネイティブ (モバイル & デスクトップ)] を選択し、http://localhost:8400/ と入力します
登録を選択します。

CLIは合計3つのリダイレクトURIを必要とします。 CLIはa365 setup requirementsを実行すると、不足しているリダイレクトURIを自動的に追加します。

URI	目的
`http://localhost:8400/`	Microsoft Authentication Library (MSAL): インタラクティブなブラウザー認証
`http://localhost`	Microsoft Graph PowerShell SDK `Connect-MgGraph`
`ms-appx-web://Microsoft.AAD.BrokerPlugin/{client-id}`	Web アカウントマネージャー (WAM) の使用

詳しくは「CLIが自動設定する内容」を参照してください。

2. リダイレクト URI を設定する

概要にアクセスし、アプリケーション (クライアント) ID の値をコピーしてください。
認証 (プレビュー) に移動してから リダイレクト URI の追加 を選択します。
[モバイルおよびデスクトップアプリケーション] を選択し、値を ms-appx-web://Microsoft.AAD.BrokerPlugin/{client-id} に設定します。ここで、{client-id} はコピーしたアプリケーション (クライアント ID) の値です。
構成を選択して値を追加してください。

3. アプリケーション (クライアント) ID のコピー

アプリの概要ページから、アプリケーション (クライアント) ID（GUID形式）をコピーしてください。この値は、a365 setup allを実行する時やa365.config.jsonを手動で作成する時に使用します。

ヒント

この値をオブジェクト ID と混同しないでください。必要なのはアプリケーション (クライアント) IDです。

アプリ名を Agent 365 CLI にしていれば、a365 setup all --agent-name を使用する際、この手順を飛ばすことができます。 CLIは表示名でクライアントIDを自動的に解決します。

4. API アクセス許可の構成

重要

この手順には管理者権限が必要です。管理者権限を持たない開発者の場合、手順 3 で取得したアプリケーション（クライアント）ID をテナント管理者に送信し、管理者にこの手順を完了してもらってください。

紙幣

2025年12月時点で、AgentIdentityBlueprint.*、AgentInstance.*、AgentIdentity.*の権限はベータ API であり、Microsoft Entra 管理センターでは表示されない場合があります。これらの権限がテナントで一般利用可能になった場合、すべての権限に対してオプションAを使用できます。

適切な方法を選択します。

オプションA: ベータ権限が見える場合は、すべての権限をMicrosoft Entra 管理センターで設定する
オプションB: Microsoft Graph APIを使ってすべての権限を追加する（ベータ権限が表示されていない場合に推奨）

オプションA: Microsoft Entra 管理センター（標準方法）

ベータ権限がテナントに表示されている場合は、この方法を使用してください。

アプリの登録で、API アクセス許可 に移動します。
[アクセス許可の追加]>[Microsoft Graph]>[委任されたアクセス許可] の順に選択します。

重要

委任されたアクセス許可を使用する必要があります（アプリケーションアクセス許可ではありません）。このCLIは対話的に認証を行います。つまり、あなたがサインインし、CLIがあなたの代理として操作を実行します。詳細については、「権限の種類が間違っています」を参照してください。

次の7つの権限を一つずつ追加してください：

Permission	目的
`AgentIdentityBlueprint.ReadWrite.All`	ブループリントの作成、クライアントシークレットの管理、継承可能なアクセス許可、フェデレーション ID 資格情報、および削除（ベータ版 API）
`AgentIdentityBlueprintPrincipal.Create`	エージェントブループリントサービスプリンシパル（ベータ版 API）の作成
`AgentIdentity.Read.All`	べき等チェックとエージェント ID サービスプリンシパル参照 (ベータ API)
`AgentIdentity.DeleteRestore.All`	クリーンアップ中にエージェントアイデンティティサービスプリンシパルを削除する（ベータAPI）
`AgentRegistration.ReadWrite.All`	すべてのエージェント登録の読み取りと書き込み
`Application.Read.All`	アプリIDによるサービスプリンシパルの検索（Directory.Read.Allのより限定的な代替）
`User.Read`	ブループリント所有者およびスポンサー割り当てのためにサインインユーザーのプロフィールを読み取る

紙幣

AgentRegistration.ReadWrite.Allはエージェントセットアップに必須です。 CLIバリデーターはこの権限を明示的にチェックします。アプリ登録時にその情報が記載されている必要があり、管理者の承認を得ている必要があります。

権限ごと：

検索ボックスに権限名（例：AgentIdentityBlueprint.ReadWrite.All）を入力してください。
権限の横にあるチェックボックスを選択してください。
アクセス許可の追加を選択します。
7つすべての権限に対して繰り返してください。

[テナント] に管理者の同意を付与する を選択します。
- なぜこれが必要なのか。エージェントアイデンティティ設計図は、複数のユーザーやアプリケーションが参照できるテナント全体のリソースです。テナント全体の同意がない場合、CLIの認証が失敗します。
- 失敗した場合どうなるか アプリケーション管理者、クラウドアプリケーション管理者、またはグローバル管理者のロールが必要です。テナント管理者にサポートを依頼してください。
すべての権限が状態の下で緑色のチェックマークが表示されていることを確認してください。

ベータ権限（AgentIdentityBlueprint.*）が表示されない場合は、オプション Bに進んでください。

オプションB：Microsoft Graph API（ベータ権限用）

Microsoft Entra 管理センターでAgentIdentityBlueprint.*権限が表示されない場合は、この方法を使ってください。

警告

このAPIメソッドを使用した場合は、その後でMicrosoft Entra 管理センターの「管理者同意を付与する」ボタンを押さないでください。 API メソッドを使用すると、管理者の同意が自動的に付与されます。また、Microsoft Entra 管理センターのボタンを使用すると、ベータ版の権限が削除されます。詳細については、「ベータ権限が表示されなくなる」を参照してください。

Graph エクスプローラーを開きます。
管理者アカウント（Application Administrator または Cloud Application Administrator）でサインインしてください。
Graph APIを使用して管理者の同意を付与してください。この手順を完了するには、以下が必要です。
- サービスプリンシパル ID。 SP_OBJECT_ID 変数値が必要です。
- Graph リソース ID。 GRAPH_RESOURCE_ID 変数値が必要です。
- oAuth2PermissionGrant リソースタイプと SP_OBJECT_ID および GRAPH_RESOURCE_ID 変数値を使用して、委任されたアクセス許可を作成（または更新）します。

以下のセクションの情報を参照して、これらの手順を完了してください。

サービスプリンシパル ID の取得

サービスプリンシパルは、テナント内のアプリのアイデンティティです。 API を介して権限を付与するには、まずこれが必要です。

グラフエクスプローラーのメソッドを GET に設定し、このURLを使用してください。 <YOUR_CLIENT_APP_ID> を「手順 3: アプリケーション (クライアント) ID のコピー」で取得した実際のアプリケーションクライアント ID に置き換えてください。
```
https://graph.microsoft.com/v1.0/servicePrincipals?$filter=appId eq '<YOUR_CLIENT_APP_ID>'&$select=id
```
[クエリの実行] を選択します。
- クエリが成功した場合、返される値がSP_OBJECT_IDです。
- クエリが権限エラーで失敗した場合は、権限の修正タブを選択し、必要な権限に同意してから、クエリを実行を再度選択してください。返される値はユーザーの SP_OBJECT_ID です。
- クエリが空の結果（"value": []）を返した場合は、以下の手順でサービスプリンシパルを作成します。
  1. メソッドを POST に設定し、次のURLを使用してください:
```
https://graph.microsoft.com/v1.0/servicePrincipals
```
    リクエスト本文（YOUR_CLIENT_APP_ID を実際のアプリケーションクライアントIDに置き換えてください）:
```
{
   "appId": "YOUR_CLIENT_APP_ID"
}
```
  2. [クエリの実行] を選択します。 201 Created応答が返ってきます。返される id 値はユーザーの SP_OBJECT_ID です。

GraphリソースIDを取得してください

グラフエクスプローラーのメソッドを GET に設定し、このURLを使用します。

https://graph.microsoft.com/v1.0/servicePrincipals?$filter=appId eq '00000003-0000-0000-c000-000000000000'&$select=id

[クエリの実行] を選択します。
- クエリが成功したら、id値をコピーします。この値はユーザーの GRAPH_RESOURCE_ID です。
- クエリが権限エラーで失敗した場合は、権限の修正タブを選択し、必要な権限に同意してから、クエリを実行を再度選択してください。 id の値をコピーします。この値はユーザーの GRAPH_RESOURCE_ID です。

委任されたアクセス許可の作成

このAPI呼び出しは、Microsoft Entra 管理センターで表示されないベータ権限を含む7つの権限すべてに対してテナント全体の管理者同意を与えます。

グラフエクスプローラーのメソッドを POST に設定し、このURLとリクエストボディを使用します。

https://graph.microsoft.com/v1.0/oauth2PermissionGrants

要求本文:

{
"clientId": "<SP_OBJECT_ID>",
"consentType": "AllPrincipals",
"principalId": null,
"resourceId": "<GRAPH_RESOURCE_ID>",
"scope": "AgentIdentityBlueprint.ReadWrite.All AgentIdentityBlueprintPrincipal.Create AgentIdentity.Read.All AgentIdentity.DeleteRestore.All AgentRegistration.ReadWrite.All Application.Read.All User.Read"
}

[クエリの実行] を選択します。
- 応答が 201 Created の場合: 成功を示します応答内のscopeフィールドには、7つすべての権限名が表示されます。以上で完了です。
- クエリが権限エラーで失敗した場合は、権限の修正タブを選択し、必要な権限に同意してから、クエリを実行を再度選択してください。
- エラー Request_MultipleObjectsWithSameKeyValue: 既に権限が付与されています。もしかすると、以前に誰かが権限を追加したのかもしれません。以下の「委任されたアクセス許可の更新」を参照してください。

警告

consentType: "AllPrincipals" リクエストの POST には既にテナント全体における管理者の同意が付与されています。 この API メソッドを使用した後は、Microsoft Entra 管理センターで「管理者の同意を付与」を選択しないでください。これは、Microsoft Entra 管理センターがベータ権限を認識できず、API で付与された同意を見える権限のみで上書きしてしまうため、ベータ権限が削除されてしまうからです。

委任されたアクセス許可の更新

委任権限を作成する手順を実施して Request_MultipleObjectsWithSameKeyValue エラーが発生した場合は、以下の手順で委任権限を更新してください。

グラフエクスプローラーのメソッドを GET に設定し、このURLを使用します。

https://graph.microsoft.com/v1.0/oauth2PermissionGrants?$filter=clientId eq 'SP_OBJECT_ID_FROM_ABOVE'

[クエリの実行] を選択します。応答から id の値をコピーします。この値は YOUR_GRANT_ID です。

グラフエクスプローラーのメソッドを PATCH に設定し、このURLを YOUR_GRANT_IDで使用してください。

https://graph.microsoft.com/v1.0/oauth2PermissionGrants/<YOUR_GRANT_ID>

要求本文:

{
   "scope": "AgentIdentityBlueprint.ReadWrite.All AgentIdentityBlueprintPrincipal.Create AgentIdentity.Read.All AgentIdentity.DeleteRestore.All AgentRegistration.ReadWrite.All Application.Read.All User.Read"
}

[クエリの実行] を選択します。 scope フィールドには、7 個すべてのアクセス許可を持つ 200 OK の応答が表示されます。

5. wids ロールのクレームを追加する

Agent 365 CLIは、アクセストークンから直接Entraディレクトリのロール割り当てを読み取り、管理者権限があるかどうかを判断します。これには、アプリ登録で発行されるアクセストークンに wids クレームを追加する必要があります。

このクレームがない場合、CLI はあなたのロールを検出できず、管理者権限が必要な各手順で、たとえあなたが管理者であっても PowerShell の手順が表示されるようになります。この手順を完了すると正しい動作になります。

アプリ登録内でトークン構成に移動してください。
[省略可能な要求を追加] を選択します。
トークンタイプとして [アクセス] を選択してください。
クレーム一覧で、widsの横にあるチェックボックスを選択してください。
Add を選択します。

クレームを有効にするために Microsoft Graph profile のアクセス許可をオンにするように求められた場合は、[はい、追加します] を選択します。

紙幣

wids クレームには、サインインしているユーザーに直接割り当てられている Entra ディレクトリロールのロールテンプレート GUID が格納されています。 CLIはこれらのGUIDを使用し、追加のMicrosoft Graph API呼び出しなしでグローバル管理者およびエージェントID管理者ロールを検出します。

制限:widsは直接割り当てられたロールのみを反映します。テナントがロール割り当て可能なセキュリティグループを通じてディレクトリロールを割り当てている場合、CLIはグループベースのロール割り当てを検出できない場合があります。直接ロール割り当ては、エージェント ID 開発者と管理者ロールの両方における標準的なパターンです。

セキュリティのベストプラクティス

アプリ登録のセキュリティと法令遵守を維持するために、これらのガイドラインを確認してください。

推奨されること:

アプリをシングルテナントとして登録してください。
必要な委任されたアクセス許可のみを付与してください。
アクセス許可を定期的に監査してください。
不要になったアプリは削除してください。

推奨されないこと:

アプリケーションのアクセス許可を取得します。委任されたものだけを使用してください。
クライアント ID を公開してください。
不要な権限を付与しないでください。
アプリは他の目的で使ってください。

CLI が自動構成するもの

a365 setup requirements を実行すると、CLI がアプリの登録を検証し、必要に応じて変更を加える場合があります。変更を適用する前に、CLIは概要を表示し、確認を求めます。

WARNING: The CLI needs to make the following changes to your app registration (<app-id>):

  - Add redirect URI(s): http://localhost
  - Enable 'Allow public client flows' (isFallbackPublicClient = true)

Do you want to proceed? (y/N):

確認プロンプトをスキップする場合（例えば、CI環境など）、--yes フラグを使用します。

a365 setup requirements --yes

以下の表は、CLIが行う可能性のある各変更について記載しています。

変更	理由
リダイレクト URI `http://localhost` を追加する	Microsoft Graph PowerShell SDK では、ブラウザー認証のためにこの URI が必要です。これがなければ、OAuth2の付与操作は必要な委任権限を欠いたトークンにフォールバックし、403で失敗します。
リダイレクト URI `http://localhost:8400/` を追加する	MSAL では、対話型ブラウザー認証にこの URI が必要です。
リダイレクト URI `ms-appx-web://Microsoft.AAD.BrokerPlugin/{id}` を追加する	Windows OS の認証ブローカーである Web Account Manager (WAM) に必要です。 Acquiring Device Bound Tokensについて詳しくはこちらをご覧ください。
[パブリッククライアントフローを許可する] を有効にする	macOS、Linux、Linux 用 Windows サブシステム (WSL)、ヘッドレス環境におけるデバイスコード認証のフォールバックとして、および Windows における条件付きアクセスポリシーのフォールバックとして必要となります。
不足しているアクセス許可をアプリ登録に追加する	CLI の更新後、新たに必要となるアクセス許可に合わせてアプリの登録情報を同期させます。
管理者の同意権限を延長する	既存の OAuth2 アクセス許可付与を拡張し、新たにプロビジョニングされたアクセス許可もすべて含めるようにします。

プロンプトを拒否した場合、CLIはアプリ登録を変更しません。 CLIが正常に動作するために変更が必要な場合は、Microsoft Entra 管理センターで手動で設定するか、--yesで再実行してください。

次の手順

カスタムクライアントアプリを登録した後、Agent 365 CLIを使ってAgent 365のセットアップを完了してください。

Agent 365 の開発を始める

トラブルシューティング

このセクションでは、カスタムクライアントアプリの登録に関するエラーのトラブルシューティング方法について説明します。

ヒント

Agent 365 トラブルシューティングガイドは、一般的なトラブルシューティングの推奨事項、ベストプラクティス、およびAgent 365開発ライフサイクルの各部分に関するトラブルシューティングコンテンツへのリンクを含んでいます。

CLI 検証が構成中に失敗する

現象:a365 setup または a365 setup requirements の実行が失敗すると、カスタムクライアントアプリに関する検証エラーが発生します。

解決策: このチェックリストを使ってアプリ登録が正しいか確認してください。

# Run requirements validation to see validation messages
a365 setup requirements

期待結果: CLIでCustom client app validation successfulが表示される。

期待された結果が得られない場合は、以下のチェックをすべて確認してください。

オン	検証方法	修正
✅ 正しいIDを使いました	アプリケーション（クライアント）ID（オブジェクトIDではありません）をコピーしました	Microsoft Entra 管理センターのアプリ概要に移動する
✅ 委任されたアクセス許可	API アクセス許可におけるアクセス許可表示タイプ: 委任	誤ったアクセス許可タイプを参照
✅ すべての権限追加済み	以下にリストされているすべての権限をご確認ください	手順 4 をもう一度進めてください
✅ 管理者の同意を付与済み	すべてステータス欄に緑のチェックマークが表示されます	管理者の同意が誤って付与された場合についてはこちらをご覧ください

必須の委任されたアクセス許可:

AgentIdentityBlueprint.ReadWrite.All [ベータ]
AgentIdentityBlueprintPrincipal.Create [ベータ]
AgentIdentity.Read.All [ベータ]
AgentIdentity.DeleteRestore.All [ベータ]
AgentRegistration.ReadWrite.All
Application.Read.All
User.Read

症状: 権限を追加しても検証が失敗します。

根本原因: 管理者の同意が付与されていない、または誤って付与されています。

解決策:Microsoft Entra 管理センターのアプリ登録時に API権限 に行き [Your Tenant]に管理者同意を付与を選択します。すべての権限が状態の下で緑色のチェックマークが表示されていることを確認してください。

症状: a365 setup all「委任されたアプリケーション同意を正常に確保しました」と表示されますが、その後すぐにブループリント作成時に失敗します:

Admin consent has not been granted for this application.
Share this URL with an Application Administrator or Global Administrator to grant consent:
  https://login.microsoftonline.com/<tenant-id>/v2.0/adminconsent?client_id=<client-app-id>

原因: テナントはすでにカスタムクライアントアプリのoauth2PermissionGrantレコードを持っています（以前の部分的なセットアップ実行や、他のスコープに対するMicrosoft Entra 管理センターでの「管理者の同意を付与」操作によるもの）が、そのレコードに必要なスコープ（AgentIdentityBlueprint.ReadWrite.All）が欠けています。 CLI は、必要なスコープが不足していることを検出し、管理者が同意を完了できるよう同意 URL を提示します。

解決策:

エラー出力に表示された同意URLをアプリケーション管理者またはグローバル管理者と共有してください。 URL は次のようになります。

https://login.microsoftonline.com/<tenant-id>/v2.0/adminconsent?client_id=<client-app-id>

管理者によって同意が付与されたら、a365 setup all --agent-name <name>を再実行してください。

管理者権限があれば、ブラウザでURLを直接開いて同意を付与することができます。

誤ったアクセス許可タイプ

症状: CLIが認証エラーやアクセス拒否エラーで失敗します。

根本原因: アプリケーション権限を追加したため、委任されたアクセス許可が設定されていません。

この表は、各種権限の種類を説明しています。

アクセス許可の種類	使用すべきとき	Agent 365 CLI による使い方
委任 (「範囲」)	ユーザーが対話的にサインインする	Agent 365 CLIはこれを使用します - あなたがサインインすると、CLIがあなたの権限で動作します
アプリケーション (「ロール」)	サービスはユーザーなしで実行される	利用不可 - バックグラウンドサービス／デーモン専用

なぜ委任権限なのか？

インタラクティブにサインインします（ブラウザ認証）
CLIはあなたとして操作を行います（監査記録にはあなたのIDが記録されます）
よりセキュア - ご自身の権限の範囲内で制限されます
説明責任とコンプライアンスが担保されます

解決策:

Microsoft Entra 管理センター>アプリの登録> ユーザーのアプリ >API アクセス許可 に移動します
アプリケーションのアクセス許可をすべて削除します。これらのアクセス許可は、[種類] 列に [アプリケーション] として表示されます。
[委任] アクセス許可と同じアクセス許可を追加します。
管理者の同意をもう一度付与します。

症状: オプションB: Microsoft Graph API（ベータ権限用）を使用してベータ権限を追加しましたが、Microsoft Entra 管理センターで管理者の同意を選択すると、追加した権限が消失します。

根本原因: Microsoft Entra 管理センターの UI 上ではベータ権限が表示されていません。 [管理者の同意を付与] を選択すると、ポータルは表示されている権限のみに同意を付与し、APIで付与された同意を上書きします。

なぜこれが発生するのか：

Microsoft Graph API（オプションB）を利用して、ベータ権限を含む7つの権限すべてを追加します。
この API 呼び出しでは、consentType: "AllPrincipals"既にテナント全体に対する管理者権限が付与されています。
Microsoft Entra 管理センターに行くと、ポータルでベータ権限が表示されないため、一部の権限しか見えません。
必要だと考えて [管理者の同意を付与] を選択します。
Microsoft Entra 管理センターでは、API による同意内容が、表示されている権限のみに上書きされます。
ベータ権限は削除されてしまいました。

解決策:

API メソッドの後に Microsoft Entra 管理センターの管理者同意を使用しない: API メソッドは既に管理者同意を付与しています。
もし誤ってベータ権限を削除した場合は、オプションB手順3（Graph APIを使って管理者の同意を与える）を再度実行して復旧してください。 Request_MultipleObjectsWithSameKeyValue エラーが発生した場合は、委任権限の更新の手順に従ってください。
7 つのアクセス許可すべてがリストされているか確認するには、POST または PATCH レスポンスの scope フィールドを確認します。

バリデーション時にアプリが見つからない

症状： CLIが Application not found または Invalid client ID のエラーを報告します。

解決策:

アプリケーション (クライアント) IDをGUID形式でコピーしたことを確認してください。オブジェクト IDではありません。
- Microsoft Entra 管理センター>アプリの登録>アプリ>概要に移動します
- アプリケーション（クライアント）ID の値をコピーします
- フォーマットは xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx である必要があります

テナントにアプリが存在しているか確認してください:

# Sign in to the correct tenant
az login

# List your app registrations
az ad app list --display-name "<The display name of your app>"

Microsoft Entra IDでアプリケーションを登録する方法を確認してください。

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-07-30

Agent 365 CLIカスタムクライアントアプリ登録

必要条件

アプリを登録するには

アクセス許可の追加と同意の付与

1. アプリケーションの登録

2. リダイレクト URI を設定する

3. アプリケーション (クライアント) ID のコピー

4. API アクセス許可の構成

オプションA: Microsoft Entra 管理センター（標準方法）

オプションB：Microsoft Graph API（ベータ権限用）

サービス プリンシパル ID の取得

GraphリソースIDを取得してください

委任されたアクセス許可の作成

委任されたアクセス許可の更新

5. wids ロールのクレームを追加する

セキュリティのベスト プラクティス

CLI が自動構成するもの

次の手順

トラブルシューティング​​

CLI 検証が構成中に失敗する

管理者の同意が誤って付与されました

「管理者の同意が付与されていません」と表示され、ブループリント作成が失敗します

誤ったアクセス許可タイプ

Microsoft Entra 管理センターで管理者の同意を行うと、ベータ権限が表示されなくなります

バリデーション時にアプリが見つからない

フィードバック

その他のリソース

サービスプリンシパル ID の取得

セキュリティのベストプラクティス

トラブルシューティング