Pozorowanie powiadomienia Centrum administracyjnego usługi Teams dla łączników programu Microsoft Graph
Łą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 w poznać 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 przetestowanie sposobu obsługi powiadomień przez łącznik programu Microsoft Graph z Centrum administracyjnego usługi Teams. Możesz wyśmiewać powiadomienie dotyczące włączania i wyłączania łącznika programu Graph i sprawdzić, czy łącznik przetworzy go poprawnie. Za pomocą serwera proxy deweloperów można zweryfikować, czy skonfigurować łącznik na końcu: od weryfikacji tokenu po uruchomienie początkowego pozyskiwania zawartości. Serwer proxy deweloperów umożliwia lokalne testowanie łącznika bez wdrażania go w Centrum administracyjnym usługi Teams.
Zanim rozpoczniesz
Przed rozpoczęciem pozorowania powiadomień centrum administracyjnego usługi Teams wykonaj następujące kroki.
Pobieranie powiadomień Centrum administracyjnego usługi Teams dla łączników programu Microsoft Graph — ustawienia wstępne serwera proxy dewelopera
Zacznij od pobrania ustawień wstępnych serwera proxy deweloperów na potrzeby symulowania powiadomień Centrum administracyjnego usługi Teams dla łączników programu Microsoft Graph. W wierszu polecenia uruchom następujące polecenie:
devproxy preset get microsoft-graph-connector-notification
Serwer proxy dewelopera pobiera ustawienia wstępne i zapisuje go w folderze ustawień wstępnych w katalogu instalacyjnym serwera proxy dev.
Konfigurowanie ustawienia wstępnego wysyłania powiadomienia do interfejsu API
W edytorze kodu otwórz ~appFolder/presets/microsoft-graph-connector-notification/graph-connector-notification-enabled.json plik, w którym ~appFolder odwołuje się do folderu instalacyjnego serwera proxy deweloperów. 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/microsoft/dev-proxy/main/schemas/v0.16.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.
Konfigurowanie identyfikatora dzierżawy i aplikacji Entra dla łącznika programu Microsoft Graph
Serwer proxy deweloperów symuluje walidację tokenu z powiadomienia Centrum administracyjnego usługi Teams i wystawia token dostępu dla programu Microsoft Graph dla łącznika. Serwer proxy deweloperów używa symulowanego identyfikatora dzierżawy platformy Microsoft 365 i aplikacji Entra. Aby przechwycić żądania z łącznika programu Graph, zaktualizuj identyfikator dzierżawy do identyfikatora aplikacji Entra na fa15d692-e9c7-4460-a743-29f29522229 00001111-aaaa-2222-bbbb-3333cccc4444. Jeśli chcesz użyć własnych identyfikatorów, zaktualizuj wartości we wszystkich plikach wstępnych.
Pozorowanie powiadomienia Centrum administracyjnego usługi Teams o włączeniu łącznika programu Microsoft Graph
Uruchom interfejs API, który odbiera powiadomienie z Centrum administracyjnego usługi Teams. Upewnij się, że serwer proxy wysyła żądania za pośrednictwem serwera proxy deweloperów.
Następnie w wierszu polecenia uruchom serwer proxy dewelopera z ustawieniem wstępnym na potrzeby symulowania powiadomienia Centrum administracyjnego usługi Teams w celu włączenia łącznika programu Microsoft Graph.
devproxy --config-file "~appFolder/presets/microsoft-graph-connector-notification/devproxyrc.json"
Po uruchomieniu serwera proxy deweloperów naciśnij w , aby zasymulować element webhook z Centrum administracyjnego usługi Teams w celu włączenia łącznika programu Microsoft Graph. Serwer proxy deweloperów wysyła powiadomienie do interfejsu API, które powinno przetworzyć je tak, jakby pochodziło z Centrum administracyjnego usługi Teams.
Gdy wszystko będzie gotowe, aby zatrzymać serwer proxy deweloperów, naciśnij Ctrl+c.
Pozorowanie powiadomienia Centrum administracyjnego usługi Teams o wyłączeniu łącznika programu Microsoft Graph
W edytorze kodu otwórz ~appFolder/presets/microsoft-graph-connector-notification/devproxyrc.json plik, w którym ~appFolder odwołuje się do folderu instalacyjnego serwera proxy deweloperów. Znajdź wystąpienie GraphConnectorNotificationPlugin powiadomienia z włączonym elementem i zmień enabled właściwość 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/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
}
Zapisz zmiany.
Wykonaj te same kroki, jak opisano wcześniej podczas testowania powiadomienia w celu włączenia łącznika programu Microsoft Graph.
Gdy wszystko będzie gotowe, aby zatrzymać serwer proxy deweloperów, naciśnij Ctrl+c.
Następny krok
Dowiedz się więcej na temat programu GraphConnectorNotificationPlugin.
