次の方法で共有

Microsoft Graph コネクタのモック Teams 管理センター通知

  • [アーティクル]

Microsoft Graph コネクタを使用すると、組織のコンテンツを Microsoft 365 に取り込みます。 Microsoft Graph コネクタを使用すると、保存場所に関係なく、コンテンツを 1 か所から検索できます。 さらに、Microsoft Copilot for Microsoft 365 はコンテンツにアクセスできるため、より関連性の高い回答を得ることができます。

組織内に Graph コネクタを展開する場合は、アプリとしてパッケージ化することを検討Microsoft Teams必要があります。 こうすることで、管理者が使い慣れた方法で管理できる Teams 管理センターに展開されます。 Graph コネクタを Teams アプリとしてパッケージ化するには、Teams 管理センターから Webhook を受け取る API で拡張する必要があります。

開発プロキシを使用すると、Microsoft Graph コネクタが Teams 管理センターからの通知を処理する方法をテストできます。 Graph コネクタを有効または無効にするための通知をモックし、コネクタが正しく処理するかどうかを確認できます。 開発プロキシを使用すると、トークンの検証から初期コンテンツ インジェストの実行まで、コネクタのエンド ツー エンドの構成を検証できます。 開発プロキシを使用すると、コネクタを Teams 管理センターに展開せずにローカルでテストできます。

開始する前に

Teams 管理センターの通知のモック作成を開始する前に、次の手順を実行します。

Microsoft Graph コネクタ開発プロキシ プリセットの Teams 管理センター通知をダウンロードする

まず、Microsoft Graph コネクタの Teams 管理センター通知をシミュレートするためのデベロッパー プロキシ プリセットをダウンロードします。 コマンドプロンプトで、次のコマンドを実行します。

devproxy preset get microsoft-graph-connector-notification

Dev Proxy によってプリセットがダウンロードされ、dev Proxy インストール ディレクトリの presets フォルダーに保存されます。

API に通知を送信するようにプリセットを構成する

コード エディターで、 ~appFolder/presets/microsoft-graph-connector-notification/graph-connector-notification-enabled.json ファイルを開きます。ここで、 ~appFolder は開発プロキシのインストール フォルダーを参照します。 request.url プロパティを、Teams 管理センターから通知を受け取る API の URL で更新します。

{
  "$schema": "https://raw.githubusercontent.com/microsoft/dev-proxy/main/schemas/v0.16.0/mockrequestplugin.schema.json",
  "request": {
    "url": "http://localhost:3000/api/notification",
    "method": "POST",
    // [...] trimmed for brevity
  }
}

graph-connector-notification-disabled.json ファイルと同じ手順に従います。

Microsoft Graph コネクタのテナント ID と Entra アプリを構成する

開発プロキシは、Teams 管理センター通知からのトークンの検証と、コネクタ用の Microsoft Graph のアクセス トークンの発行をシミュレートします。 開発プロキシでは、シミュレートされた Microsoft 365 テナント ID と Entra アプリが使用されます。 Graph コネクタからの要求をインターセプトするには、テナント ID を fa15d692-e9c7-4460-a743-29f29522229 に更新し、Entra アプリ ID を 00001111-aaaa-2222-bbbb-3333cccc4444 に更新します。 独自の ID を使用する場合は、すべてのプリセット ファイルの値を更新します。

Microsoft Graph コネクタを有効にするために Teams 管理センターの通知をモックする

Teams 管理センターから通知を受け取る API を起動します。 必ず、Dev Proxy を介して要求をプロキシします。

次に、コマンド プロンプトで、Microsoft Graph コネクタを有効にするための Teams 管理センター通知をシミュレートするためのプリセットで開発プロキシを起動します。

devproxy --config-file "~appFolder/presets/microsoft-graph-connector-notification/devproxyrc.json"

開発プロキシが起動したら、 w キーを押して、Microsoft Graph コネクタを有効にするために Teams 管理センターから Webhook をシミュレートします。 デベロッパー プロキシは API に通知を送信します。この通知は、Teams 管理センターから送信されたかのように処理する必要があります。

コマンド プロンプトが 2 つに分割されたスクリーンショット。上: シミュレートされた通知を発行する開発プロキシ。下: それを受け取る Microsoft Graph コネクタ。

準備ができたら、開発プロキシを停止するには、 Ctrl+c キーを押します。

Microsoft Graph コネクタを無効にするための Teams 管理センターの通知をモックする

コード エディターで、 ~appFolder/presets/microsoft-graph-connector-notification/devproxyrc.json ファイルを開きます。ここで、 ~appFolder は開発プロキシのインストール フォルダーを参照します。 有効な通知の GraphConnectorNotificationPlugin のインスタンスを見つけて、 enabled プロパティを falseに変更します。 無効な通知の GraphConnectorNotificationPlugin のインスタンスを見つけて、 enabled プロパティを true に変更します。 構成ファイルは次のようになります。

{
  "$schema": "https://raw.githubusercontent.com/microsoft/dev-proxy/main/schemas/v0.16.0/rc.schema.json",
  "plugins": [
    {
      "name": "GraphConnectorGuidancePlugin",
      "enabled": true,
      "pluginPath": "~appFolder/plugins/dev-proxy-plugins.dll"
    },
    {
      "name": "GraphConnectorNotificationPlugin",
      "enabled": false,
      "pluginPath": "~appFolder/plugins/dev-proxy-plugins.dll",
      "configSection": "graphConnectorNotificationEnabled"
    },
    {
      "name": "GraphConnectorNotificationPlugin",
      "enabled": true,
      "pluginPath": "~appFolder/plugins/dev-proxy-plugins.dll",
      "configSection": "graphConnectorNotificationDisabled"
    },
    // [...] trimmed for brevity
  ]
  // [...] trimmed for brevity
}

変更を保存。

Microsoft Graph コネクタを有効にするための通知をテストするときは、前述と同じ手順に従います。

準備ができたら、開発プロキシを停止するには、 Ctrl+c キーを押します。

次のステップ

GraphConnectorNotificationPlugin の詳細を確認します。

GraphConnectorNotificationPlugin

詳細