GraphConnectorNotificationPlugin

Статья
04/08/2024

Имитирует уведомление при включении или отключении соединителя Microsoft Graph в Центре Администратор Teams (TAC). Проверяет запросы на создание и удаление внешнего подключения.

Чтобы отправить настроенный запрос на уведомление, нажмите в w сеансе командной строки, где запущен прокси-сервер разработки.

Выдача запросов на уведомления

расширяет GraphConnectorNotificationPlugin с помощью MockRequestPlugins дополнительных функций для имитации уведомлений из TAC.

Токен	Описание
`@dynamic.validationToken`	Маркер JWT для проверки подлинности уведомления. Прокси-сервер разработки заменяет его действительным маркером JWT, подписанным сертификатом `Dev Proxy CA` .

Проверка обработки уведомлений и выдача запросов соединителя Graph

Наряду с имитацией запросов на уведомления, проверяет, GraphConnectorNotificationPlugin правильно ли api уведомлений обрабатывает уведомления и выдает правильные запросы Microsoft Graph.

Для обработки уведомлений TAC подключаемый модуль проверяет, отправляет ли API ответ 202 Accepted без текста. Кроме того, подключаемый модуль проверяет запросы POST и DELETE к конечной точке /external/connections/* Microsoft Graph. Он проверяет, содержит GraphConnectors-Ticket ли запрос заголовок с билетом, указанным в уведомлении. Если любая из проверок завершается неудачно, подключаемый модуль регистрирует ошибку.

Определение экземпляра подключаемого модуля

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

Пример конфигурации

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

Свойства конфигурации

Свойство	Описание	По умолчанию	Обязательно
`audience`	Идентификатор регистрации приложения Microsoft Entra, который соединитель Microsoft Graph использует для проверки подлинности запроса уведомления.	пустых	Да
`mockFile`	Путь к файлу, содержащу макет запроса	`mock-request.json`	Да
`tenant`	Идентификатор клиента, в котором соединитель Microsoft Graph создает внешнее подключение.	пустых	Да

Параметры командной строки

None

Пример файла запроса макета

Ниже приведено несколько примеров файлов API, которые определяют API CRUD для получения сведений о клиентах.

Включение уведомления TAC соединителя Microsoft Graph

Ниже приведен пример уведомления, которое Teams Администратор Center отправляет, когда пользователь включает соединитель Microsoft Graph.

{
  "$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",
    "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" ]
    }
  }
}

Поделиться через