GraphConnectorNotificationPlugin

Artikel
04/09/2024

Simuliert die Benachrichtigung beim Aktivieren oder Deaktivieren eines Microsoft Graph-Connectors in Teams Admin Center (TAC). Überprüft Anforderungen zum Erstellen und Löschen der externen Verbindung.

Um die konfigurierte Benachrichtigungsanforderung auszugeben, drücken Sie w in der Eingabeaufforderungssitzung, in der der Dev Proxy ausgeführt wird.

Ausstellen von Benachrichtigungsanforderungen

Erweitert GraphConnectorNotificationPlugin um MockRequestPlugins zusätzliche Funktionen, um Benachrichtigungen von TAC zu simulieren.

Token	BESCHREIBUNG
`@dynamic.validationToken`	JWT-Token, um die Echtheit der Benachrichtigung zu überprüfen. Der Dev Proxy ersetzt es durch ein gültiges JWT-Token, das `Dev Proxy CA` vom Zertifikat signiert ist.

Überprüfen der Verarbeitung von Benachrichtigungen und Ausstellen von Graph-Connectoranforderungen

Neben der Simulation der Benachrichtigungsanforderungen überprüft, GraphConnectorNotificationPlugin ob die Benachrichtigungs-API Benachrichtigungen ordnungsgemäß verarbeitet und korrekte Microsoft Graph-Anforderungen ausgibt.

Für die Verarbeitung von TAC-Benachrichtigungen überprüft das Plug-In, ob die API eine 202 Accepted-Antwort ohne Text sendet. Darüber hinaus überprüft das Plug-In POST- und DELETE-Anforderungen an den /external/connections/* Microsoft Graph-Endpunkt. Es überprüft, ob die Anforderung den GraphConnectors-Ticket Header mit dem in der Benachrichtigung angegebenen Ticket enthält. Wenn eine der Überprüfungen fehlschlägt, protokolliert das Plug-In einen Fehler.

Definition von Plug-In-instance

{
  "name": "GraphConnectorNotificationPlugin",
  "enabled": true,
  "pluginPath": "~appFolder/plugins/dev-proxy-plugins.dll",
  "configSection": "graphConnectorNotificationEnabled"
}

Konfigurationsbeispiel

{
  "graphConnectorNotificationEnabled": {
    "mockFile": "graph-connector-notification-enabled.json",
    "tenant": "fa15d692-e9c7-4460-a743-29f29522229",
    "audience": "00001111-aaaa-2222-bbbb-3333cccc4444"
  }
}

Konfigurationseigenschaften

Eigenschaft	BESCHREIBUNG	Standard	Erforderlich
`audience`	Die Microsoft Entra App-Registrierungs-ID, die der Microsoft Graph-Connector zum Authentifizieren der Benachrichtigungsanforderung verwendet.	empty	Yes
`mockFile`	Pfad zur Datei, die die Simuliertanforderung enthält	`mock-request.json`	Yes
`tenant`	Die Mandanten-ID, an der der Microsoft Graph-Connector die externe Verbindung erstellt.	empty	Yes

Befehlszeilenoptionen

Keine

Beispiel für eine Simulierte Anforderungsdatei

Es folgen mehrere Beispiele für API-Dateien, die eine CRUD-API für Informationen zu Kunden definieren.

Aktivieren einer TAC-Benachrichtigung für den Microsoft Graph-Connector

Im Folgenden finden Sie ein Beispiel für eine Benachrichtigung, die Teams Admin Center sendet, wenn ein Benutzer einen Microsoft Graph-Connector aktiviert.

{
  "$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",
    "body": {
      "value": [
        {
          "changeType": "updated",
          "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
          "resource": "external",
          "clientState": null,
          "resourceData": {
            "@odata.type": "#Microsoft.Graph.connector",
            "@odata.id": "external",
            "id": "35177924-33fc-444d-bd51-f059ce385ec2",
            "state": "enabled",
            "connectorsTicket":"eyJhbGciOiJIUzI1"
          },
          "subscriptionExpirationDateTime": "2021-06-26T12:40:26.4436785-07:00",
          "tenantId": "fa15d692-e9c7-4460-a743-29f29522229"
        }
      ],
      "validationTokens": [ "@dynamic.validationToken" ]
    }
  }
}

Freigeben über