GraphConnectorNotificationPlugin

Symuluje powiadomienie podczas włączania lub wyłączania łącznika programu Microsoft Graph w usłudze Teams Administracja Center (TAC). Weryfikuje żądania tworzenia i usuwania połączenia zewnętrznego.

Aby wysłać skonfigurowane żądanie powiadomienia, naciśnij w w sesji wiersza polecenia, w której działa serwer proxy dewelopera.

Wystawianie żądań powiadomień

Rozszerzenie GraphConnectorNotificationPlugin rozszerzenia o MockRequestPlugins dodatkową funkcjonalność w celu symulowania powiadomień z tac.

Token	Opis
@dynamic.validationToken	Token JWT w celu zweryfikowania autentyczności powiadomienia. Serwer proxy dewelopera zastępuje go prawidłowym tokenem JWT podpisanym Dev Proxy CA przez certyfikat.

Weryfikowanie powiadomień i wystawianie żądań łącznika programu Graph

Obok symulowania żądań powiadomień sprawdza, GraphConnectorNotificationPlugin czy interfejs API powiadomień prawidłowo obsługuje powiadomienia i problemy z prawidłowymi żądaniami programu Microsoft Graph.

W przypadku obsługi powiadomień TAC wtyczka sprawdza, czy interfejs API wysyła odpowiedź 202 Accepted bez treści. Ponadto wtyczka sprawdza żądania POST i DELETE do punktu końcowego /external/connections/* programu Microsoft Graph. Sprawdza, czy żądanie zawiera GraphConnectors-Ticket nagłówek z biletem określonym w powiadomieniu. Jeśli którekolwiek z testów nie powiedzie się, wtyczka rejestruje błąd.

Definicja wystąpienia wtyczki

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

Przykład konfiguracji

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

Właściwości konfiguracji

Właściwość	Opis	Default	Wymagane
audience	Identyfikator rejestracji aplikacji Microsoft Entra używany przez łącznik programu Microsoft Graph do uwierzytelniania żądania powiadomienia	puste	Tak
mockFile	Ścieżka do pliku zawierającego pozorne żądanie	mock-request.json	Tak
tenant	Identyfikator dzierżawy, w którym łącznik programu Microsoft Graph tworzy połączenie zewnętrzne	puste	Tak

Opcje wiersza polecenia

Brak

Przykład pliku żądania pozoru

Poniżej przedstawiono kilka przykładów plików interfejsu API, które definiują interfejs API CRUD dla informacji o klientach.

Włączanie powiadomienia TAC łącznika programu Microsoft Graph

Poniżej znajduje się przykład powiadomienia wysyłanego przez usługę Teams Administracja Center, gdy użytkownik włączy łącznik programu Microsoft Graph.

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