Symulowane powiadomienie Centrum administracyjnego Teams dla łączników Microsoft Graph

Artykuł
2025-03-10

Łączniki programu Microsoft Graph umożliwiają przenoszenie zawartości organizacji na platformę Microsoft 365. Za pomocą łączników programu Microsoft Graph możesz znaleźć zawartość z jednego miejsca, niezależnie od tego, gdzie ją przechowujesz. Co więcej, zapewnia Microsoft Copilot dla platformy Microsoft 365 dostęp do zawartości, dzięki czemu może pomóc uzyskać bardziej odpowiednie odpowiedzi.

Podczas wdrażania łączników programu Graph w organizacji należy rozważyć ich spakowanie jako aplikacji Microsoft Teams. Dzięki temu są one wdrażane w Centrum administracyjnym usługi Teams, z którego administratorzy mogą kontrolować je w znany sposób. Aby spakować łącznik programu Graph jako aplikację usługi Teams, należy ją rozszerzyć przy użyciu interfejsu API odbierającego element webhook z Centrum administracyjnego usługi Teams.

Serwer proxy deweloperów umożliwia testowanie, jak łącznik Microsoft Graph obsługuje powiadomienia z Centrum administracyjnego Teams. Możesz symulować powiadomienie dotyczące włączania i wyłączania łącznika Graph i sprawdzić, czy łącznik przetwarza je poprawnie. Za pomocą Dev Proxy można zweryfikować konfigurowanie łącznika końcowego w całości: od weryfikacji tokenu po przeprowadzenie początkowego pobierania treści. Dev Proxy umożliwia lokalne testowanie łącznika bez wdrażania go w Centrum administracyjnym Teams.

Zanim rozpoczniesz

Przed rozpoczęciem pozorowania powiadomień centrum administracyjnego usługi Teams wykonaj następujące kroki.

Pobierz powiadomienia z Centrum administracyjnego usługi Teams dotyczące ustawień wstępnych proxy dewelopera dla łączników Microsoft Graph

Zacznij od pobrania ustawień wstępnych Dev Proxy do symulowania powiadomień Centrum administracyjnego Teams dla łączników Microsoft Graph. W wierszu polecenia uruchom następujące polecenie:

devproxy preset get microsoft-graph-connector-notification

Dev Proxy pobiera presety i zapisuje je w folderze presetów w katalogu instalacyjnym Dev Proxy.

Skonfiguruj ustawienie wstępne, aby wysłać powiadomienie do twojego interfejsu API

W edytorze kodu otwórz plik ~appFolder/presets/microsoft-graph-connector-notification/graph-connector-notification-enabled.json, w którym ~appFolder odwołuje się do folderu instalacyjnego Dev Proxy. request.url Zaktualizuj właściwość przy użyciu adresu URL interfejsu API, który odbiera powiadomienie z Centrum administracyjnego usługi Teams.

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

Wykonaj te same kroki dla graph-connector-notification-disabled.json pliku.

Skonfiguruj identyfikator dzierżawy i aplikację Entra dla łącznika Microsoft Graph

Serwer proxy Dev symuluje walidację tokenu z powiadomienia Centrum administracyjnego Teams i wystawia token dostępu dla Microsoft Graph dla łącznika. Dev Proxy używa symulowanego identyfikatora dzierżawy Microsoft 365 i aplikacji Entra. Aby przechwycić żądania z łącznika Graph, zaktualizuj identyfikator dzierżawy do fa15d692-e9c7-4460-a743-29f29522229 i identyfikator aplikacji Entra do 00001111-aaaa-2222-bbbb-3333cccc4444. Jeśli chcesz użyć własnych identyfikatorów, zaktualizuj wartości we wszystkich plikach wstępnych.

Symulowanie powiadomienia centrum administracyjnego Teams o włączeniu łącznika Microsoft Graph

Uruchom interfejs API, który odbiera powiadomienie z Centrum administracyjnego usługi Teams. Upewnij się, że kieruje swoje żądania za pośrednictwem Dev Proxy.

Następnie w wierszu polecenia uruchom Dev Proxy z ustawieniem wstępnym na potrzeby symulowania powiadomienia z Centrum administracyjnego Teams w celu włączenia łącznika Microsoft Graph.

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

Po uruchomieniu serwera proxy dewelopera naciśnij w, aby zasymulować webhook z Centrum administracyjnego Teams w celu włączenia łącznika Microsoft Graph. Serwer Dev Proxy wysyła powiadomienie do Twojego interfejsu API, które powinno przetworzyć je tak, jakby pochodziło z Centrum administracyjnego usługi Teams.

Gdy będzie gotowe, aby zatrzymać Dev Proxy, naciśnij Ctrl+c.

Symulowanie powiadomienia w Centrum Administracyjnym Teams o wyłączeniu łącznika Microsoft Graph

W edytorze kodu otwórz plik ~appFolder/presets/microsoft-graph-connector-notification/devproxyrc.json, w którym ~appFolder odnosi się do folderu instalacyjnego Dev Proxy. Znajdź wystąpienie GraphConnectorNotificationPlugin dla włączonego powiadomienia i zmień właściwość enabled na false. Znajdź wystąpienie GraphConnectorNotificationPlugin wyłączonego powiadomienia i zmień enabled właściwość na true. Plik konfiguracji powinien być podobny do następującego:

{
  "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v0.24.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
}

Zapisz zmiany.

Wykonaj te same kroki, jak opisano wcześniej podczas testowania powiadomienia w celu włączenia łącznika programu Microsoft Graph.

Gdy będziesz gotowy, aby zatrzymać Dev Proxy, naciśnij Ctrl+c.

Następny krok

Dowiedz się więcej na temat programu GraphConnectorNotificationPlugin.

GraphConnectorNotificationPlugin

Udostępnij za pośrednictwem