GraphConnectorNotificationPlugin

Artikel
04/09/2024

Simulerar meddelandet när du aktiverar eller inaktiverar en Microsoft Graph-anslutningsapp i Teams Admin Center (TAC). Validerar begäranden om att skapa och ta bort den externa anslutningen.

Om du vill utfärda den konfigurerade meddelandebegäran trycker du w i kommandotolken där Dev Proxy körs.

Utfärda meddelandebegäranden

GraphConnectorNotificationPlugin utökar MockRequestPlugins med extra funktioner för att simulera meddelanden från TAC.

Token	Description
`@dynamic.validationToken`	JWT-token för att verifiera meddelandets äkthet. Dev Proxy ersätter den med en giltig JWT-token, signerad av certifikatet `Dev Proxy CA` .

Validera hantering av meddelanden och utfärda Graph-anslutningsbegäranden

Bredvid simuleringen av meddelandebegäranden GraphConnectorNotificationPlugin verifierar om meddelande-API:et hanterar meddelanden och problem korrekt.

För hantering av TAC-meddelanden kontrollerar plugin-programmet om API:et skickar ett 202-godkänt svar utan brödtext. Dessutom inspekterar plugin-programmet POST- och DELETE-begäranden till /external/connections/* Microsoft Graph-slutpunkten. Den kontrollerar om begäran innehåller GraphConnectors-Ticket huvudet med det ärende som anges i meddelandet. Om någon av kontrollerna misslyckas loggar plugin-programmet ett fel.

Definition av plugin-instans

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

Konfigurationsexempel

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

Konfigurationsegenskaper

Egenskap	Beskrivning	Standardvärde	Obligatorisk
`audience`	Det Microsoft Entra appregistrerings-ID som Microsoft Graph-anslutningsappen använder för att autentisera meddelandebegäran	tomt	Yes
`mockFile`	Sökväg till filen som innehåller mock-begäran	`mock-request.json`	Yes
`tenant`	Klientorganisations-ID:t där Microsoft Graph-anslutningsappen skapar den externa anslutningen	tomt	Yes

Kommandoradsalternativ

Ingen

Exempel på simulerad begärandefil

Här följer flera exempel på API-filer som definierar ett CRUD-API för information om kunder.

Aktivera ett TAC-meddelande för Microsoft Graph-anslutningsappen

Följande är ett exempel på ett meddelande som Teams Admin Center skickar när en användare aktiverar en Microsoft Graph-anslutningsapp.

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

Dela via