GraphConnectorNotificationPlugin

Articolo
02/05/2025

Simula la notifica durante l'abilitazione o la disabilitazione di un connettore Microsoft Graph in Teams Amministrazione Center (TAC). Convalida le richieste di creazione ed eliminazione della connessione esterna.

Per eseguire la richiesta di notifica configurata, premere w nella sessione del prompt dei comandi in cui è in esecuzione Dev Proxy.

Invio di richieste di notifica

Estende GraphConnectorNotificationPlugin l'oggetto MockRequestPlugins con funzionalità aggiuntive per simulare le notifiche da TAC.

token	Descrizione
`@dynamic.validationToken`	Token JWT per convalidare l'autenticità della notifica. Dev Proxy lo sostituisce con un token JWT valido, firmato dal `Dev Proxy CA` certificato.

Convalida delle notifiche e dell'emissione di richieste del connettore Graph

Accanto a simulare le richieste di notifica, l'API GraphConnectorNotificationPlugin di notifica convalida se l'API di notifica gestisce correttamente le notifiche e i problemi corretti delle richieste di Microsoft Graph.

Per la gestione delle notifiche TAC, il plug-in verifica se l'API invia una risposta accettata 202 senza un corpo. Inoltre, il plug-in controlla le richieste POST e DELETE all'endpoint /external/connections/* di Microsoft Graph. Verifica se la richiesta contiene l'intestazione con il GraphConnectors-Ticket ticket specificato nella notifica. Se uno dei controlli ha esito negativo, il plug-in registra un errore.

Definizione dell'istanza del plug-in

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

Esempio di configurazione

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

Proprietà di configurazione

Proprietà	Descrizione	Predefinito	Necessario
`audience`	ID di registrazione dell'app Microsoft Entra usato dal connettore Microsoft Graph per autenticare la richiesta di notifica	empty	Sì
`mockFile`	Percorso del file contenente la richiesta fittizia	`mock-request.json`	Sì
`tenant`	ID tenant in cui il connettore Microsoft Graph crea la connessione esterna	empty	Sì

Opzioni della riga di comando

Nessuno

Esempio di file di richiesta fittizia

Di seguito sono riportati diversi esempi di file API che definiscono un'API CRUD per informazioni sui clienti.

Abilitare una notifica TAC del connettore Microsoft Graph

Di seguito è riportato un esempio di notifica inviata da Teams Amministrazione Center quando un utente abilita un connettore 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" ]
    }
  }
}

Condividi tramite