Microsoft Entra SSO 認証を構成する

ヒント

推奨事項: サポートされているプロコード宣言型エージェントとプラグイン シナリオ用の Work IQ 開発ツール から始めます。 WIQD クイックスタートを参照してください。 Toolkit ベースの手順は、それらを必要とする既存のプロジェクトおよびワークフローで引き続き使用できます。 ツールを選択する前に 、機能とターゲット エクスペリエンスのサポート を確認します。WIQD はカスタム エンジン エージェントを対象としません。

Microsoft Entra シングル サインオン (SSO) 認証を使用すると、ユーザーは既存の Microsoft Entra ID 資格情報を使用して認証できます。 この統合により、アクセス管理が簡素化され、追加の資格情報を必要とせずに、モデル コンテキスト プロトコル (MCP) サーバーまたは API への安全な接続が保証されます。 MCP サーバーまたは API では、Entra ID を使用してアクセスを制御する必要があります。

この記事では、既定のチュートリアルとして MCP プラグインを使用します。 明記されていない限り、OpenAPI ドキュメントからビルドされた API プラグインにも同じ手順が適用されます。

Entra SSO 認証を 4 つの手順で構成します: MCP サーバーを保護するための Entra アプリの登録、認証構成の作成、Entra アプリの登録の更新、API への新しいトークン対象ユーザーの追加。

ステップ 1: Entra アプリを登録して MCP サーバーを保護する

MCP サーバーまたは API は、Entra アプリの登録によって保護されている必要があります。 まだアプリをお持ちでない場合は、Microsoft Entra 管理センターにアプリを登録します。 アプリの クライアント ID をメモします。 これは、手順 2 で認証構成を作成するときに指定します。

手順 2: Entra SSO 認証構成を作成する

Entra SSO 認証は、認証構成 (auth config) に依存します。これは、Microsoft 365 Copilot が MCP プラグインのトークンを取得するために使用する Microsoft Enterprise トークン ストアに保存されているレコードです。 サポートされているプロコード プロジェクト用の WIQD から開始します。 ツールキット、開発者スキル、Teams 開発者ポータルの手順は、引き続き代替として使用できます。

どのように作成しても、認証構成には認証 構成 ID と アプリケーション ID URI があります。 アプリケーション ID URI は、 手順 3 と 手順 4 で使用します。

重要

認証構成の作成方法にかかわらず、 手順 3 と 手順 4 を完了する必要があります。

MCP アクションの場合は、手順 1 の --mcp-server-url、--mcp-auth-type entra-sso、--mcp-client-id を Entra アプリのクライアント ID に設定して wiqd agent add action を使用します。 OpenAPI アクションの場合は、 --openapi-auth-identity-provider microsoft-entra と --openapi-auth-client-id を使用します。 その他の必要な操作オプションについては、 WIQD アクション コマンド ガイダンス を参照してください。

既存のプラグイン マニフェストの場合は、--plugin-manifest、--auth-name、--auth-type microsoft-entra で wiqd agent add auth を使用します。 そのコマンドについて文書化された ID プロバイダー オプション ( --oauth-client-id を含む) を指定します。 プロジェクトのプロビジョニング ワークフローを完了し、認証構成の アプリケーション ID URI を取得して、手順 3 と手順 4 に進みます。

Microsoft 365 Agents Toolkit を使用する

Microsoft 365 Agents Toolkit で MCP プラグインを使用してエージェントを構築すると、MCP サーバー プラグインを追加すると、ツールキットから認証の種類の入力を求められます。 [Microsoft Entra SSO] を選択し、手順 1 の Entra アプリのクライアント ID を指定します。 Agents Toolkit は、Enterprise トークン ストアに認証構成を作成し、認証構成 ID を生成し、プラグイン マニフェストの ランタイム認証オブジェクト を自動的に更新します。

宣言型エージェント開発者スキルを使用する

宣言型エージェント開発者スキル (declarative-agent-developer) は、宣言型エージェントの構築に必要な知識をパッケージ化した Microsoft Work IQ のエージェント スキルです。 自分でコマンドを実行したり、マニフェストを編集したりする代わりに、必要な内容を自然言語で Copilot または GitHub CLI に記述します。 このスキルは、宣言型エージェントのスキャフォールディング、MCP プラグインの追加、認証構成の処理を自動的に行います。 このスキルは MCP プラグインのみをサポートします。 Entra SSO を使用する MCP サーバーを追加すると、スキルはエンタープライズ トークン ストアに認証構成を作成し、手動の手順なしでプラグイン マニフェストを更新します。

ヒント

宣言型エージェント開発者スキルの使用に関するビデオ チュートリアルについては、「 宣言型エージェント開発者スキルを使用して宣言型エージェントを構築する」を参照してください。

Teams 開発者ポータルを使用する

エージェント ツールキットまたは宣言型エージェント開発者スキルを使用する場合、Teams 開発者ポータルへの登録はオプションです。 これは、認証設定を手動で作成する場合、またはより一般的には、エージェントツールキットまたはスキルがすでに作成した認証設定を管理する場合に使用します。 ポータルでは、認証構成を特定の Teams アプリまたは Microsoft 365 organization に制限し、その他のプロパティを変更できます。

  1. Teams 開発者ポータルを開きます。 [ツール] -[>Microsoft Entra SSO クライアント ID 登録] を選択します。

  2. 既存の登録がない場合は、[ クライアント ID の登録] を選択します。 既存の登録がある場合は、 新しいクライアント登録 を選択します。

  3. 次のフィールドに入力します。

    • 登録名: 登録のフレンドリ名。
    • ベース URL: API のベース URL。 この値は、MCP ベースのプラグイン用のプラグイン マニフェスト内の MCP サーバー仕様オブジェクトの url プロパティ内の URL、または API プラグイン用の OpenAPI ドキュメントの servers 配列内のエントリに対応する必要があります。
    • 組織による使用を制限する: API エンドポイントにアクセスするためにアプリにアクセスできる Microsoft 365 organizationを選択します。
    • アプリによる使用を制限する: 最終的なアプリ ID がわからない場合は、[ 任意の Teams アプリ ] を選択します。 アプリを公開した後、この登録を公開済みのアプリ ID にバインドします。
    • クライアント ID: Entra に登録されているアプリのクライアント ID。
    • スコープ: プラグインが Entra に要求するアクセス許可。 OAuth 2.0 と同様に、Entra アプリと API に必要なスコープ値を使用します。
  4. [保存] を選択します。

  5. 登録を完了すると、認証構成が作成され、認証構成 ID (現在 Teams 開発者ポータルでは Microsoft Entra SSO 登録 ID とラベル付けされています) とアプリケーション ID URI が生成されます。

プラグイン マニフェストに認証構成 ID を追加する

Teams 開発者ポータルで認証構成を手動で作成する場合は、ランタイム認証オブジェクトの type プロパティを OAuthPluginVault に設定し、reference_idを認証構成 ID に設定します。 エージェント ツールキットと宣言型エージェント開発者スキルは、これを行います。

"auth": {
  "type": "OAuthPluginVault",
  "reference_id": "auth config ID"
},

ステップ 3: Entra アプリの登録を更新する

手順 2 で認証構成をどのように作成したかに関係なく、次の手順を実行します。

  1. Microsoft Entra 管理センターを開きます。 MCP サーバーまたは API をセキュリティで保護する Entra アプリ登録を、SSO 登録のアプリケーション ID URI で更新します。 アプリ登録にマップ済みの既存のアプリケーション ID URI がある場合は、マニフェスト エディターを使用して、 identifierUris セクションに別の URI を追加します。

    "identifierUris": [
      "<<URI1>>",
      "<<URI2>>"
    ]
    

    注

    Entra 管理センターの UI を使用して複数の URI を追加することはできません。 UI には、リスト内の最初の URI のみが表示されます。 複数の URI を追加しても、UI での表示が異なる場合でも、既存の URI とスコープには影響しません。

  2. [管理] の下の [認証] を選択します。 Web プラットフォームのリダイレクト URI にhttps://teams.microsoft.com/api/platform/v1.0/oAuthConsentRedirectを追加します。

  3. [管理] で [API の公開] を選択します。 [ クライアント アプリケーションの追加] を選択し、Microsoft Enterprise トークン ストアのクライアント ID ab3be6b7-f5df-413d-ac2d-abf1e3fd9c0bを追加します。

手順 4: 新しいトークン対象ユーザーを API に追加する

MCP サーバーまたは API を更新して、新しい識別子 URI をトークン対象ユーザーとして使用できるようにします。 MCP サーバーまたは API がクライアント アプリケーション ID を検証する場合は、Microsoft Enterprise トークン ストアのクライアント ID (ab3be6b7-f5df-413d-ac2d-abf1e3fd9c0b) が許可されたクライアント アプリケーションとして追加されていることを確認します。

ヒント

MCP サーバーまたは API が代理フローを使用して、ユーザーに同意を与える必要がある別の Web API にアクセスする場合は、401 Unauthorized エラーを返して、エージェントがユーザーに同意を付与するためにサインインするように求めます。