Compartir a través de

GraphConnectorNotificationPlugin

  • Artículo

Simula la notificación al habilitar o deshabilitar un conector de Microsoft Graph en Teams Administración Center (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 una división del símbolo del sistema en dos. La parte superior muestra el proxy de desarrollo que emite una notificación simulada del Centro de teams Administración. La parte inferior muestra un conector de Microsoft Graph que recibe la notificación.

Emisión de solicitudes de notificación

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

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

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

Junto a simular las solicitudes de notificación, valida GraphConnectorNotificationPlugin 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 cuerpo. Además, el complemento inspecciona las solicitudes POST y DELETE al punto de conexión de /external/connections/* Microsoft Graph. Comprueba si la solicitud contiene el GraphConnectors-Ticket encabezado con el vale especificado en la notificación. Si se produce un error en cualquiera 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 Valor predeterminado Requerido
audience Identificador de registro de aplicación Microsoft Entra que usa el conector de Microsoft Graph para autenticar la solicitud de notificación empty Sí
mockFile Ruta de acceso al archivo que contiene la solicitud ficticia mock-request.json Sí
tenant Identificador de inquilino donde el conector de Microsoft Graph crea la conexión externa. empty Sí

Opciones de línea de comandos

None

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 Teams Administración Center envía cuando un usuario habilita un conector de 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" ]
    }
  }
}