GraphConnectorNotificationPlugin

Artigo
04/08/2024

Simula a notificação ao ativar ou desativar um conector do Microsoft Graph no Teams Administração Center (TAC). Valida pedidos para criar e eliminar a ligação externa.

Para emitir o pedido de notificação configurado, prima w na sessão da linha de comandos onde o Dev Proxy está em execução.

Emitir pedidos de notificação

O GraphConnectorNotificationPlugin expande a MockRequestPlugins funcionalidade com funcionalidade adicional para simular notificações a partir do TAC.

Token	Description
`@dynamic.validationToken`	Token JWT para validar a autenticidade da notificação. O Proxy dev substitui-o por um token JWT válido, assinado pelo `Dev Proxy CA` certificado.

Validar o processamento de notificações e a emissão de pedidos do conector do Graph

Junto a simular os pedidos de notificação, o GraphConnectorNotificationPlugin valida se a API de notificação processa corretamente as notificações e os problemas corretos dos pedidos do Microsoft Graph.

Para processar notificações TAC, o plug-in verifica se a API envia uma resposta 202 Aceite sem um corpo. Além disso, o plug-in inspeciona os pedidos POST e DELETE para o ponto final do /external/connections/* Microsoft Graph. Verifica se o pedido contém o GraphConnectors-Ticket cabeçalho com o pedido especificado na notificação. Se uma das verificações falhar, o plug-in regista um erro.

Definição da instância do plug-in

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

Exemplo de configuração

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

Propriedades de configuração

Propriedade	Descrição	Predefinição	Necessário
`audience`	O ID de registo de aplicações Microsoft Entra que o conector do Microsoft Graph utiliza para autenticar o pedido de notificação	vazio	Yes
`mockFile`	Caminho para o ficheiro que contém o pedido simulado	`mock-request.json`	Yes
`tenant`	O ID do inquilino onde o conector do Microsoft Graph cria a ligação externa	vazio	Yes

Opções da linha de comandos

Nenhuma

Exemplo de ficheiro de pedido simulado

Seguem-se vários exemplos de ficheiros de API que definem uma API CRUD para obter informações sobre os clientes.

Ativar uma notificação TAC do conector do Microsoft Graph

Segue-se um exemplo de uma notificação que o Teams Administração Center envia, quando um utilizador ativa um conector do 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" ]
    }
  }
}

Partilhar via