Napodobení oznámení Teams Správa Center pro konektory Microsoft Graphu

Článek
04/09/2024

Konektory Microsoft Graphu umožňují přenést obsah organizace do Microsoftu 365. Pomocí konektorů Microsoft Graphu můžete najít svůj obsah z jednoho místa, bez ohledu na to, kam ho uložíte. Navíc poskytuje Microsoft Copilot pro Microsoft 365 přístup k obsahu, aby vám pomohl 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 Teams Správa Center, odkud je správci můžou ovládat známým způsobem. Pokud chcete konektor Graphu zabalit jako aplikaci Teams, musíte ho rozšířit o rozhraní API, které obdrží webhook z Teams Správa Center.

Dev Proxy umožňuje otestovat, jak konektor Microsoft Graph zpracovává oznámení z teams Správa Center. Oznámení o povolení a zakázání konektoru Graph můžete napodobení napodobení a zkontrolovat, jestli ho váš konektor zpracovává správně. Pomocí vývojového proxy serveru můžete ověřit konfiguraci 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ě, aniž byste ho nasadí do Teams Správa Center.

Než začnete

Než začnete napodobovat oznámení teams Správa Center, proveďte následující kroky.

Stáhněte si oznámení Centra Správa Teams pro předvolbu dev proxy pro konektory Microsoft Graphu

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

devproxy preset get microsoft-graph-connector-notification

Proxy pro vývojáře stáhne předvolbu a uloží ji do složky presets v instalačním adresáři dev proxy.

Nakonfigurujte předvolbu tak, aby se oznámení odesílala do vašeho rozhraní API.

V editoru kódu otevřete ~appFolder/presets/microsoft-graph-connector-notification/graph-connector-notification-enabled.json soubor , který ~appFolder odkazuje na instalační složku dev proxy. request.url Aktualizujte vlastnost adresou URL vašeho rozhraní API, které obdrží oznámení z Teams Správa Center.

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

Stejný postup použijte i pro graph-connector-notification-disabled.json soubor.

Konfigurace ID tenanta a aplikace Entra pro konektor Microsoft Graphu

Dev Proxy simuluje ověření tokenu z oznámení Teams Správa Center a vydání 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 a ID aplikace Entra na ef1da9d4-ff77-4c3e-a005-840c3f830745. Pokud chcete použít vlastní ID, aktualizujte hodnoty ve všech přednastavených souborech.

Napodobení oznámení Centra Správa Teams o povolení konektoru Microsoft Graphu

Spusťte rozhraní API, které obdrží oznámení z Centra Správa Teams. Ujistěte se, že své požadavky proxy používá prostřednictvím dev proxy.

V dalším kroku na příkazovém řádku spusťte dev Proxy s předvolbou pro simulaci oznámení Centra Správa Teams pro povolení konektoru Microsoft Graphu.

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

Po spuštění vývojového proxy serveru stiskněte w a simulujte webhook z teams Správa Center pro povolení konektoru Microsoft Graphu. Dev Proxy odešle oznámení do vašeho rozhraní API, které by ho mělo zpracovat, jako kdyby přišlo z Teams Správa Center.

Až budete připraveni zastavit dev proxy, stiskněte ctrl+c.

Napodobení oznámení Centra Správa Teams pro zakázání konektoru Microsoft Graphu

V editoru kódu otevřete ~appFolder/presets/microsoft-graph-connector-notification/devproxyrc.json soubor , který ~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 oznámení o zákazu a změňte vlastnost na enabledtrue. 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 Graph postupujte stejně jako dříve.

Až budete připraveni zastavit dev proxy, stiskněte ctrl+c.

Další krok

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

GraphConnectorNotificationPlugin

Sdílet prostřednictvím