Delen via


Melding van het Mock Teams-beheercentrum voor Microsoft Graph-connectors

Met Microsoft Graph-connectors kunt u de inhoud van uw organisatie overbrengen naar Microsoft 365. Met Behulp van Microsoft Graph-connectors kunt u uw inhoud vinden vanaf één locatie, ongeacht waar u deze opslaat. Bovendien krijgt Microsoft Copilot voor Microsoft 365 toegang tot de inhoud, zodat u hiermee relevantere antwoorden krijgt.

Wanneer u Graph-connectors in uw organisatie implementeert, moet u overwegen deze als Microsoft Teams-app te verpakken. Op die manier worden ze geïmplementeerd in het Teams-beheercentrum, van waaruit beheerders ze op een vertrouwde manier kunnen beheren. Als u een Graph-connector als teams-app wilt verpakken, moet u deze uitbreiden met een API die de webhook van het Teams-beheercentrum ontvangt.

Met Dev Proxy kunt u testen hoe uw Microsoft Graph-connector meldingen verwerkt vanuit het Teams-beheercentrum. U kunt de melding voor het in- en uitschakelen van de Graph-connector nakijken en controleren of de connector deze correct verwerkt. Met behulp van Dev Proxy kunt u valideren dat de connector end-to-end wordt geconfigureerd: van het valideren van het token tot het uitvoeren van de initiële inhoudsopname. Met Dev Proxy kunt u uw connector lokaal testen zonder deze te implementeren in het Teams-beheercentrum.

Voordat u begint

Voer de volgende stappen uit voordat u begint met het mocken van meldingen in het Teams-beheercentrum.

Download de meldingen van het Teams-beheercentrum voor de vooraf ingestelde Dev Proxy voor Microsoft Graph-connectors

Download eerst de vooraf ingestelde Dev Proxy voor het simuleren van meldingen van het Teams-beheercentrum voor Microsoft Graph-connectors. Voer in de opdrachtprompt de volgende opdracht uit:

devproxy preset get microsoft-graph-connector-notification

Dev Proxy downloadt de voorinstelling en slaat deze op in de map voorinstellingen in de installatiemap van uw Dev Proxy.

De voorinstelling configureren om de melding naar uw API te verzenden

Open het ~appFolder/presets/microsoft-graph-connector-notification/graph-connector-notification-enabled.json bestand in een code-editor, waarbij ~appFolder verwijst naar de Dev Proxy-installatiemap. Werk de request.url eigenschap bij met de URL van uw API die de melding ontvangt van het Teams-beheercentrum.

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

Volg dezelfde stappen voor het graph-connector-notification-disabled.json bestand.

Tenant-id en Entra-app configureren voor uw Microsoft Graph-connector

Dev Proxy simuleert het valideren van het token vanuit de melding van het Teams-beheercentrum en het uitgeven van een toegangstoken voor Microsoft Graph voor uw connector. Dev Proxy maakt gebruik van een gesimuleerde Microsoft 365-tenant-id en een Entra-app. Als u aanvragen van uw Graph-connector wilt onderscheppen, werkt u de tenant-id bij naar fa15d692-e9c7-4460-a743-29f29522229 en entra-app-id naar 00001111-aaaa-2222-bbbb-3333cccc4444. Als u uw eigen id's wilt gebruiken, werkt u de waarden bij in alle vooraf ingestelde bestanden.

De melding van het Teams-beheercentrum nabootsen voor het inschakelen van de Microsoft Graph-connector.

Start uw API die de melding ontvangt van het Teams-beheercentrum. Zorg ervoor dat de aanvragen worden geproxyd door middel van Dev Proxy.

Start vervolgens in een opdrachtprompt Dev Proxy met de voorinstelling voor het simuleren van de melding van het Teams-beheercentrum voor het inschakelen van de Microsoft Graph-connector.

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

Nadat de Dev Proxy is gestart, drukt u op w om de webhook te simuleren vanuit het Teams-beheercentrum voor het inschakelen van de Microsoft Graph-connector. Dev Proxy verzendt de melding naar uw API, die deze moet verwerken alsof deze afkomstig is uit het Teams-beheercentrum.

Schermopname van een opdrachtprompt die in tweeën is gesplitst. Top: Dev Proxy die een gesimuleerde melding geeft. Onder: een Microsoft Graph-connector die deze ontvangt.

Als u klaar bent, drukt u op Ctrl+c om de dev-proxy te stoppen.

De melding van het Teams-beheercentrum namaken voor het uitschakelen van de Microsoft Graph-connector

Open het ~appFolder/presets/microsoft-graph-connector-notification/devproxyrc.json bestand in een code-editor, waarbij ~appFolder verwijst naar de map van de Dev Proxy-installatie. Zoek het exemplaar van de ingeschakelde melding met de GraphConnectorNotificationPlugin en wijzig de eigenschap enabled naar false. Zoek het exemplaar van de uitgeschakelde melding GraphConnectorNotificationPlugin, en wijzig de enabled eigenschap in true. Het configuratiebestand moet er ongeveer als volgt uitzien:

{
  "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v0.24.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
}

Sla uw wijzigingen op.

Volg dezelfde stappen als eerder beschreven bij het testen van de melding voor het inschakelen van de Microsoft Graph-connector.

Als u klaar bent, drukt u op Ctrl+c om de dev-proxy te stoppen.

Volgende stap

Meer informatie over GraphConnectorNotificationPlugin.

Meer informatie