Sdílet prostřednictvím


Napodobení oznámení Centra pro správu Teams pro konektory Microsoft Graphu

Konektory Microsoft Graphu umožňují přenést obsah organizace do Microsoftu 365. Pomocí konektorů Microsoft Graphu můžete obsah najít z jednoho místa bez ohledu na to, kam ho ukládáte. Navíc poskytuje Microsoft Copilot pro Microsoft 365 přístup k obsahu, aby vám mohl pomoct získat relevantnější odpovědi.

Při nasazování konektorů Graphu ve vaší organizaci byste měli zvážit jejich zabalení jako aplikace Microsoft Teams. Tímto způsobem se nasadí do Centra pro správu Teams, ze kterého je můžou správci ovládat známým způsobem. Pokud chcete zabalit konektor Graphu jako aplikaci Teams, musíte ho rozšířit o rozhraní API, které obdrží webhook z Centra pro správu Teams.

Dev Proxy umožňuje otestovat, jak konektor Microsoft Graph zpracovává oznámení z Centra pro správu Teams. Oznámení můžete napodobení povolit a zakázat konektor Graphu a zkontrolovat, jestli konektor správně zpracovává. Pomocí Dev Proxy můžete ověřit konfiguraci koncového bodu konektoru: od ověření tokenu až po spuštění počátečního příjmu obsahu. Dev Proxy umožňuje otestovat konektor místně bez jeho nasazení do Centra pro správu Teams.

Než začnete

Než začnete napodobovat oznámení Centra pro správu Teams, proveďte následující kroky.

Stažení oznámení Centra pro správu Teams pro přednastavení dev proxy konektorů Microsoft Graphu

Začněte tím, že si stáhnete předvolbu dev proxy pro simulaci oznámení Centra pro správu Teams pro konektory Microsoft Graphu. Na příkazovém řádku spusťte následující příkaz:

devproxy preset get microsoft-graph-connector-notification

Dev Proxy stáhne předvolbu a uloží ji do složky předvoleb v instalačním adresáři Dev Proxy.

Konfigurace přednastavení pro odeslání oznámení do rozhraní API

V editoru ~appFolder/presets/microsoft-graph-connector-notification/graph-connector-notification-enabled.json kódu otevřete soubor, kde ~appFolder odkazuje na instalační složku Dev Proxy. request.url Aktualizujte vlastnost adresou URL vašeho rozhraní API, která obdrží oznámení z Centra pro správu Teams.

{
  "$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
  }
}

Postupujte stejně jako u graph-connector-notification-disabled.json souboru.

Konfigurace ID tenanta a aplikace Entra pro konektor Microsoft Graphu

Dev Proxy simuluje ověření tokenu z oznámení Centra pro správu Teams a vystavení přístupového tokenu pro Microsoft Graph pro váš konektor. Dev Proxy používá simulované ID tenanta Microsoftu 365 a aplikaci Entra. Pokud chcete zachycovat požadavky z konektoru Graphu, aktualizujte ID tenanta na fa15d692-e9c7-4460-a743-29f29522229 ID aplikace Entra na 00001111-aaaa-2222-bbbb-3333cccc4444. Pokud chcete použít vlastní ID, aktualizujte hodnoty ve všech přednastavených souborech.

Napodobení oznámení Centra pro správu Teams pro povolení konektoru Microsoft Graphu

Spusťte rozhraní API, které obdrží oznámení z Centra pro správu Teams. Zajistěte, aby proxy své požadavky prostřednictvím dev proxy serveru.

Potom na příkazovém řádku spusťte Dev Proxy s přednastavením pro simulaci oznámení Centra pro správu Teams pro povolení konektoru Microsoft Graphu.

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

Po spuštění dev Proxy stisknutím klávesy w simulujte webhook z Centra pro správu Teams pro povolení konektoru Microsoft Graphu. Dev Proxy odešle oznámení do vašeho rozhraní API, které by ho mělo zpracovat, jako by přišlo z Centra pro správu Teams.

Snímek obrazovky s rozdělením příkazového řádku do dvou Top: Dev Proxy vydávající simulované oznámení. Dole: Konektor Microsoft Graphu, který ho přijímá.

Až budete chtít vývojový proxy server zastavit, stiskněte ctrl +c.

Napodobení oznámení Centra pro správu Teams pro zakázání konektoru Microsoft Graphu

V editoru ~appFolder/presets/microsoft-graph-connector-notification/devproxyrc.json kódu otevřete soubor, kde ~appFolder odkazuje na instalační složku Dev Proxy. Vyhledejte instanci GraphConnectorNotificationPlugin pro povolené oznámení a změňte enabled vlastnost na false. Vyhledejte instanci GraphConnectorNotificationPlugin pro zakázané oznámení a změňte enabled vlastnost na true. Konfigurační soubor by měl vypadat nějak takto:

{
  "$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
}

Uložte provedené změny.

Při testování oznámení o povolení konektoru Microsoft Graphu postupujte stejně, jak je popsáno výše.

Až budete chtít vývojový proxy server zastavit, stiskněte ctrl +c.

Další krok

Přečtěte si další informace o GraphConnectorNotificationPlugin.

Více informací