GraphConnectorNotificationPlugin

Article
04/08/2024

Simule la notification lors de l’activation ou de la désactivation d’un connecteur Microsoft Graph dans Teams Administration Center (TAC). Valide les demandes de création et de suppression de la connexion externe.

Pour émettre la demande de notification configurée, appuyez w sur la session d’invite de commandes où le proxy dev est en cours d’exécution.

Émission de demandes de notification

étend GraphConnectorNotificationPlugin le avec des MockRequestPlugins fonctionnalités supplémentaires pour simuler les notifications à partir du TAC.

par jeton	Description
`@dynamic.validationToken`	Jeton JWT pour valider l’authenticité de la notification. Le proxy de développement le remplace par un jeton JWT valide, signé par le `Dev Proxy CA` certificat.

Validation de la gestion des notifications et émission de demandes de connecteur Graph

En plus de simuler les demandes de notification, le GraphConnectorNotificationPlugin valide si l’API de notification gère correctement les notifications et émet les demandes Microsoft Graph correctes.

Pour gérer les notifications TAC, le plug-in vérifie si l’API envoie une réponse 202 Acceptée sans corps. En outre, le plug-in inspecte les requêtes POST et DELETE sur le point de /external/connections/* terminaison Microsoft Graph. Il vérifie si la demande contient l’en-tête GraphConnectors-Ticket avec le ticket spécifié dans la notification. Si l’une des vérifications échoue, le plug-in consigne une erreur.

Définition de instance de plug-in

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

Exemple de configuration

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

Propriétés de configuration

Propriété	Description	Default	Obligatoire
`audience`	ID d’inscription d’application Microsoft Entra que le connecteur Microsoft Graph utilise pour authentifier la demande de notification	empty	Yes
`mockFile`	Chemin d’accès au fichier contenant la demande simulée	`mock-request.json`	Yes
`tenant`	ID de locataire dans lequel le connecteur Microsoft Graph crée la connexion externe	empty	Yes

Options de ligne de commande

None

Exemple de fichier de requête factice

Voici plusieurs exemples de fichiers API qui définissent une API CRUD pour obtenir des informations sur les clients.

Activer une notification TAC du connecteur Microsoft Graph

Voici un exemple de notification envoyée par Teams Administration Center lorsqu’un utilisateur active un connecteur 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" ]
    }
  }
}

Partager via