Simulare la notifica dell'interfaccia di amministrazione di Teams per i connettori di Microsoft Graph

I connettori di Microsoft Graph consentono di trasferire il contenuto dell'organizzazione in Microsoft 365. Usando i connettori di Microsoft Graph è possibile trovare il contenuto da un'unica posizione, indipendentemente dalla posizione in cui è archiviata. Inoltre, offre a Microsoft Copilot per Microsoft 365 l'accesso al contenuto, in modo che possa aiutarti a ottenere risposte più pertinenti.

Quando si distribuiscono connettori Graph nell'organizzazione, è consigliabile creare pacchetti come app di Microsoft Teams. In questo modo, vengono distribuiti nell'interfaccia di amministrazione di Teams, da cui gli amministratori possono controllarli in modo familiare. Per creare un pacchetto di un connettore Graph come app Teams, è necessario estenderlo con un'API che riceve il webhook dall'interfaccia di amministrazione di Teams.

Dev Proxy consente di testare il modo in cui il connettore Microsoft Graph gestisce le notifiche dall'interfaccia di amministrazione di Teams. È possibile simulare la notifica per abilitare e disabilitare il connettore Graph e verificare se il connettore lo elabora correttamente. Usando Dev Proxy, è possibile convalidare la configurazione del connettore end-to-end: dalla convalida del token all'esecuzione dell'inserimento del contenuto iniziale. Dev Proxy consente di testare il connettore in locale senza distribuirlo nell'interfaccia di amministrazione di Teams.

Operazioni preliminari

Prima di iniziare a simulare le notifiche dell'interfaccia di amministrazione di Teams, completare la procedura seguente.

Scaricare le notifiche dell'interfaccia di amministrazione di Teams per i connettori di Microsoft Graph Dev Proxy preimpostati

Per iniziare, scaricare il set di impostazioni Dev Proxy per simulare le notifiche dell'interfaccia di amministrazione di Teams per i connettori Microsoft Graph. Nel prompt dei comandi eseguire il comando seguente:

devproxy preset get microsoft-graph-connector-notification

Dev Proxy scarica il set di impostazioni e lo salva nella cartella dei set di impostazioni nella directory di installazione di Dev Proxy.

Configurare il set di impostazioni per inviare la notifica all'API

In un editor di codice aprire il ~appFolder/presets/microsoft-graph-connector-notification/graph-connector-notification-enabled.json file, dove ~appFolder fa riferimento alla cartella di installazione di Dev Proxy. Aggiornare la request.url proprietà con l'URL dell'API che riceve la notifica dall'interfaccia di amministrazione di Teams.

{
  "$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",
    // [...] trimmed for brevity
  }
}

Seguire la stessa procedura per il graph-connector-notification-disabled.json file.

Configurare l'ID tenant e l'app Entra per il connettore Microsoft Graph

Dev Proxy simula la convalida del token dalla notifica dell'interfaccia di amministrazione di Teams e l'emissione di un token di accesso per Microsoft Graph per il connettore. Dev Proxy usa un ID tenant simulato di Microsoft 365 e un'app Entra. Per intercettare le richieste dal connettore Graph, aggiornare l'ID tenant a fa15d692-e9c7-4460-a743-29f29522229 e l'ID app Entra in 00001111-aaaa-2222-bbbb-3333cccc4444. Se vuoi usare i tuoi ID, aggiorna i valori in tutti i file predefiniti.

Simulare la notifica dell'interfaccia di amministrazione di Teams per abilitare il connettore Microsoft Graph

Avviare l'API che riceve la notifica dall'interfaccia di amministrazione di Teams. Assicurarsi che eseghe le richieste tramite Dev Proxy.

Successivamente, in un prompt dei comandi avviare Dev Proxy con il set di impostazioni per simulare la notifica dell'interfaccia di amministrazione di Teams per abilitare il connettore Microsoft Graph.

devproxy --config-file "~appFolder/presets/microsoft-graph-connector-notification/devproxyrc.json"

Dopo l'avvio di Dev Proxy, premere w per simulare il webhook dall'interfaccia di amministrazione di Teams per abilitare il connettore Microsoft Graph. Dev Proxy invia la notifica all'API, che deve elaborarla come se provenisse dall'interfaccia di amministrazione di Teams.

Screenshot di una divisione del prompt dei comandi in due. Top: Dev Proxy che emette una notifica simulata. In basso: un connettore Microsoft Graph che lo riceve.

Quando si è pronti, per arrestare Il proxy di sviluppo premere CTRL+C.

Simulare la notifica dell'interfaccia di amministrazione di Teams per disabilitare il connettore Microsoft Graph

In un editor di codice aprire il ~appFolder/presets/microsoft-graph-connector-notification/devproxyrc.json file, dove ~appFolder fa riferimento alla cartella di installazione di Dev Proxy. Individuare l'istanza di GraphConnectorNotificationPlugin per la notifica abilitata e modificare la enabled proprietà in false. Individuare l'istanza di GraphConnectorNotificationPlugin per la notifica disabilitata e modificare la enabled proprietà in true. Il file di configurazione dovrebbe essere simile al seguente:

{
  "$schema": "https://raw.githubusercontent.com/microsoft/dev-proxy/main/schemas/v0.16.0/rc.schema.json",
  "plugins": [
    {
      "name": "GraphConnectorGuidancePlugin",
      "enabled": true,
      "pluginPath": "~appFolder/plugins/dev-proxy-plugins.dll"
    },
    {
      "name": "GraphConnectorNotificationPlugin",
      "enabled": false,
      "pluginPath": "~appFolder/plugins/dev-proxy-plugins.dll",
      "configSection": "graphConnectorNotificationEnabled"
    },
    {
      "name": "GraphConnectorNotificationPlugin",
      "enabled": true,
      "pluginPath": "~appFolder/plugins/dev-proxy-plugins.dll",
      "configSection": "graphConnectorNotificationDisabled"
    },
    // [...] trimmed for brevity
  ]
  // [...] trimmed for brevity
}

Salva le modifiche.

Seguire la stessa procedura descritta in precedenza durante il test della notifica per abilitare il connettore Microsoft Graph.

Quando si è pronti, per arrestare Il proxy di sviluppo premere CTRL+C.

Passaggio successivo

Altre informazioni su GraphConnectorNotificationPlugin.

Ulteriori informazioni