GraphConnectorNotificationPlugin

Článek
04/09/2024

Simuluje oznámení při povolení nebo zakázání konektoru Microsoft Graphu v Teams Správa Center (TAC). Ověří požadavky na vytvoření a odstranění externího připojení.

Pokud chcete vydat nakonfigurovaný požadavek na oznámení, stiskněte w v relaci příkazového řádku, ve které běží dev proxy server.

Vydávání žádostí o oznámení

MockRequestPlugins Rozšiřuje GraphConnectorNotificationPlugin o další funkce pro simulaci oznámení z TAC.

Token	Description
`@dynamic.validationToken`	Token JWT k ověření pravosti oznámení. Dev Proxy ho nahradí platným tokenem JWT podepsaným certifikátem `Dev Proxy CA` .

Ověřování zpracování oznámení a vydávání požadavků konektoru Graph

Vedle simulace požadavků na oznámení ověří, GraphConnectorNotificationPlugin jestli rozhraní API pro oznámení správně zpracovává oznámení a vydává správné požadavky Microsoft Graphu.

Při zpracování oznámení TAC modul plug-in zkontroluje, jestli rozhraní API odešle odpověď 202 Accepted bez textu. Modul plug-in navíc kontroluje požadavky POST a DELETE na koncový bod Microsoft Graphu /external/connections/* . Zkontroluje, jestli požadavek obsahuje hlavičku GraphConnectors-Ticket s lístkem uvedeným v oznámení. Pokud se některé z kontrol nezdaří, modul plug-in zaznamená chybu.

Definice instance modulu plug-in

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

Příklad konfigurace

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

Vlastnosti konfigurace

Vlastnost	Popis	Default	Vyžadováno
`audience`	ID registrace Microsoft Entra aplikace, které konektor Microsoft Graph používá k ověření žádosti o oznámení.	empty	Yes
`mockFile`	Cesta k souboru obsahujícímu napodobenou žádost	`mock-request.json`	Yes
`tenant`	ID tenanta, ve kterém konektor Microsoft Graphu vytvoří externí připojení	empty	Yes

Možnosti příkazového řádku

Žádné

Příklad napodobení souboru požadavku

Níže je několik příkladů souborů rozhraní API, které definují rozhraní CRUD API pro informace o zákaznících.

Povolení oznámení TAC konektoru Microsoft Graphu

Následuje příklad oznámení, které Teams Správa Center odešle, když uživatel povolí konektor Microsoft Graphu.

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

Sdílet prostřednictvím