Compartir a través de

GraphConnectorNotificationPlugin

  • Artículo

Simula la notificación al habilitar o deshabilitar un conector de Microsoft Graph en el Centro de administración de Teams (TAC). Valida las solicitudes para crear y eliminar la conexión externa.

Para emitir la solicitud de notificación configurada, presione w en la sesión del símbolo del sistema donde se ejecuta El proxy de desarrollo.

Captura de pantalla de un símbolo del sistema dividido en dos. La parte superior muestra que el proxy de desarrollo emite una notificación simulada del Centro de administración de Teams. La parte inferior muestra un conector de Microsoft Graph que recibe la notificación.

Emisión de solicitudes de notificación

El GraphConnectorNotificationPlugin amplía el MockRequestPlugins con funcionalidad adicional para simular notificaciones de TAC.

Seña Descripción
@dynamic.validationToken Token JWT para validar la autenticidad de la notificación. Dev Proxy lo reemplaza por un token JWT válido, firmado por el certificado de Dev Proxy CA.

Validación de notificaciones de control y emisión de solicitudes del conector de Graph

Junto a simular las solicitudes de notificación, el GraphConnectorNotificationPlugin valida si la API de notificación controla correctamente las notificaciones y problemas correctos de las solicitudes de Microsoft Graph.

Para controlar las notificaciones TAC, el complemento comprueba si la API envía una respuesta aceptada 202 sin un cuerpo. Además, el complemento inspecciona las solicitudes POST y DELETE al punto de conexión de Microsoft Graph /external/connections/*. Comprueba si la solicitud contiene el encabezado GraphConnectors-Ticket con el vale especificado en la notificación. Si se produce un error en alguna de las comprobaciones, el complemento registra un error.

Definición de instancia del complemento

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

Ejemplo de configuración

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

Propiedades de configuración

Propiedad Descripción Predeterminado Obligatorio
audience Identificador de registro de aplicaciones de Microsoft Entra que usa el conector de Microsoft Graph para autenticar la solicitud de notificación vacío Sí
mockFile Ruta de acceso al archivo que contiene la solicitud simulada mock-request.json Sí
tenant Identificador de inquilino donde el conector de Microsoft Graph crea la conexión externa. vacío Sí

Opciones de línea de comandos

Ninguno

Ejemplo de archivo de solicitud ficticio

A continuación se muestran varios ejemplos de archivos de API que definen una API CRUD para obtener información sobre los clientes.

Habilitación de una notificación TAC del conector de Microsoft Graph

A continuación se muestra un ejemplo de una notificación que envía el Centro de administración de Teams cuando un usuario habilita un conector de Microsoft Graph.

{
  "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v0.24.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" ]
    }
  }
}