Notificação simulada do Centro de Administração do Teams para conectores do Microsoft Graph
Os conectores do Microsoft Graph permitem que você traga seu conteúdo organizacional para o Microsoft 365. Usando os conectores do Microsoft Graph, você pode encontrar seu conteúdo em um só lugar, não importa onde você o armazene. Além disso, dá ao Microsoft Copilot para Microsoft 365 acesso ao conteúdo, para que possa ajudá-lo a obter respostas mais relevantes.
Ao implantar conectores do Graph em sua organização, você deve considerar empacotá-los como aplicativo Microsoft Teams. Dessa forma, eles são implantados no Centro de Administração do Teams, a partir do qual os administradores podem controlá-los de forma familiar. Para empacotar um conector do Graph como um aplicativo do Teams, você precisa estendê-lo com uma API que receba o webhook do Centro de Administração do Teams.
O Proxy de Desenvolvimento permite testar como o conector do Microsoft Graph lida com notificações do Centro de Administração do Teams. Você pode simular a notificação para ativar e desativar o conector do Graph e verificar se o conector o processa corretamente. Usando o Dev Proxy, você pode validar a configuração do conector de ponta a ponta: desde a validação do token até a execução da ingestão inicial de conteúdo. O Dev Proxy permite que você teste seu conector localmente sem implantá-lo no Centro de Administração do Teams.
Antes de começar
Antes de começar a zombar das notificações do Centro de Administração do Teams, conclua as etapas a seguir.
Baixe as notificações do Centro de Administração do Teams para a predefinição de Proxy de Desenvolvimento de conectores do Microsoft Graph
Inicie baixando a predefinição do Proxy de Desenvolvimento para simular as notificações do Centro de Administração do Teams para conectores do Microsoft Graph. No prompt de comando, execute o seguinte comando:
devproxy preset get microsoft-graph-connector-notification
O Dev Proxy baixa a predefinição e a salva na pasta de predefinições no diretório de instalação do Dev Proxy.
Configure a predefinição para enviar a notificação para sua API
Em um editor de código, abra o ~appFolder/presets/microsoft-graph-connector-notification/graph-connector-notification-enabled.json arquivo, onde ~appFolder se refere à pasta de instalação do Dev Proxy. Atualize a request.url propriedade com o URL da sua API que recebe a notificação do Centro de Administração do 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
}
}
Siga as mesmas etapas para o graph-connector-notification-disabled.json arquivo.
Configurar a ID do locatário e o aplicativo Entra para seu conector do Microsoft Graph
O Proxy de Desenvolvimento simula a validação do token da notificação do Centro de Administração do Teams e a emissão de um token de acesso para o Microsoft Graph para o seu conector. O Dev Proxy usa um ID de locatário simulado do Microsoft 365 e um aplicativo Entra. Para intercetar solicitações do conector do Graph, atualize o ID do locatário para fa15d692-e9c7-4460-a743-29f29522229 e o ID do aplicativo Entra para 00001111-aaaa-2222-bbbb-3333cccc4444. Se você quiser usar suas próprias IDs, atualize os valores em todos os arquivos predefinidos.
Simular a notificação do Centro de Administração do Teams para habilitar o conector do Microsoft Graph
Inicie a API que recebe a notificação do Centro de Administração do Teams. Certifique-se de que ele faz proxy de suas solicitações por meio do Dev Proxy.
Em seguida, em um prompt de comando, inicie o Proxy de Desenvolvimento com a predefinição para simular a notificação do Centro de Administração do Teams para habilitar o conector do Microsoft Graph.
devproxy --config-file "~appFolder/presets/microsoft-graph-connector-notification/devproxyrc.json"
Depois que o Proxy de Desenvolvimento for iniciado, pressione w para simular o webhook do Centro de Administração do Teams para habilitar o conector do Microsoft Graph. O Dev Proxy envia a notificação para sua API, que deve processá-la como se viesse do Centro de Administração do Teams.
Quando estiver pronto, para parar o Dev Proxy, pressione Ctrl+c.
Simular a notificação do Centro de Administração do Teams para desativar o conector do Microsoft Graph
Em um editor de código, abra o ~appFolder/presets/microsoft-graph-connector-notification/devproxyrc.json arquivo, onde ~appFolder se refere à pasta de instalação do Dev Proxy. Localize a instância do para a notificação habilitada GraphConnectorNotificationPlugin e altere a enabled propriedade para false. Localize a GraphConnectorNotificationPlugin instância do para a notificação desabilitada e altere a enabled propriedade para true. O arquivo de configuração deve ser semelhante a:
{
"$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
}
Guardar as suas alterações.
Siga as mesmas etapas descritas anteriormente ao testar a notificação para habilitar o conector do Microsoft Graph.
Quando estiver pronto, para parar o Dev Proxy, pressione Ctrl+c.
Próximo passo
Saiba mais sobre o GraphConnectorNotificationPlugin.
