Отправить билет Мои билеты
Добро пожаловать
Вход в систему  Зарегистрироваться

Подключение PowerDMARC к Microsoft Copilot Studio

Обзор

В данном руководстве подробно описан процесс подключения вашей учетной записи PowerDMARC к Microsoft Copilot Studio с использованием протокола Model Context Protocol (MCP). После подключения агент Copilot Studio сможет запрашивать актуальные данные PowerDMARC, включая домены, отчеты DMARC и аналитику угроз, непосредственно из вашей среды Microsoft, используя естественный язык.

ПРИМЕЧАНИЕ

Для этой интеграции требуется среда Power Platform с включенной функцией Dataverse. Для публикации агента для конечных пользователей необходима лицензия Microsoft Copilot Studio. Без лицензии на публикацию агент полностью работоспособен для внутреннего тестирования.

1. Создать токен MCP для PowerDMARC

Токен MCP определяет, к каким данным PowerDMARC имеет доступ агент Copilot Studio. Настройка прав доступа осуществляется для каждого токена отдельно.

  1. Войдите в свою учетную запись PowerDMARC и перейдите в «Настройки» > «Настройки API».

  2. Нажмите «Создать токен» и присвойте ему понятное имя (например, Copilot Studio MCP).

  3. В разделе «Права доступа»выберите области данных, к которым агент должен иметь доступ:

  • Для агента, работающего только в режиме чтения: включите функции «Сводный отчет DMARC», «Аналитический отчет DMARC», «Управление доменами» и «Аналитика угроз»

  • Для получения полного доступа: включите все доступные права доступа

  1. Включить переключатель переключатель.

  2. Включить переключатель «Основной токен API» . Одновременно статус «Основной» может иметь только один токен.

  3. Нажмите Сохранить.

  4. Перейти к MCP в левой боковой панели.

  5. Выберите свой токен из MCP Token .

  6. Скопируйте полный URL-адрес сервера MCP (mcp-dmarc.com) — он содержит ваш токен аутентификации и используется в разделе 3.

ПРИМЕЧАНИЕ

URL-адрес сервера MCP содержит ваш токен API и предоставляет доступ к данным PowerDMARC. Относитесь к нему как к паролю — не публикуйте его и не добавляйте в систему управления версиями.

2. Настройка среды Microsoft Power Platform

Для работы агентов Copilot Studio требуется среда Power Platform с включенной функцией Dataverse. Если у вас уже есть подходящая среда, перейдите к разделу 3.

2.1 Создание среды Power Platform

  1. Перейти на admin.powerplatform.microsoft.com и войдите в систему.

  2. Перейти к Среды > «Новое».

  3. Введите имя (например, PowerDMARC-MCP), установите тип на «Производственная среда», а также включите Dataverse.

  4. Выберите свой регион и нажмите «Сохранить». Подготовка среды займет несколько минут.

ПРИМЕЧАНИЕ

Для агентов Copilot Studio требуется Dataverse. Если Dataverse не включен в данной среде, агент не может быть создан или сохранен.

2.2 Привязать тарифный план

  1. В Центре администрирования Power Platform перейдите в раздел «Биллинг» > Лицензирование > Управление тарифными планами.

  2. Нажмите «Новый тарифный план» и привяжите его к своей подписке Azure и группе ресурсов.

  3. Свяжите тарифный план с созданной выше средой и нажмите «Сохранить».

ПРИМЕЧАНИЕ

Если раскрывающийся список групп ресурсов пуст, сначала создайте группу ресурсов в портале Azure в разделе «Группы ресурсов» > «Создать», а затем вернитесь к этому шагу.

3. Создать агент Copilot Studio

  1. Перейдите в Copilot Studio, используя URL-адрес, соответствующий вашей среде:

https://copilotstudio.microsoft.com/environments/{your-environment-id}/home

ПРИМЕЧАНИЕ

Всегда используйте URL-адрес, соответствующий вашей среде, а не URL-адрес главной страницы Copilot Studio по умолчанию. URL-адрес по умолчанию перенаправляет на вашу личную среду, в которой отсутствует Dataverse. Идентификатор вашей среды можно найти в Центре администрирования Power Platform в разделе «Среды».

  1. Нажмите «Создать» > Новый агент и присвойте ему имя (например, Агент PowerDMARC MCP).

  2. После создания перейдите в «Инструменты» в левой боковой панели.

  3. Нажмите «Добавить инструмент» > Протокол контекста модели (MCP).

4. Настройте соединение с MCP

  1. В мастере инструмента MCP вставьте URL-адрес сервера MCP , скопированный в разделе 1, шаг 9.

  2. В разделе Тип аутентификациивыберите API-ключ.

  3. Укажите имя заголовка на «Авторизация».

  4. Установите значение заголовка на Bearer {ваш-токен}, заменив {your-token} на часть JWT из URL-адреса вашего сервера MCP.

  5. Нажмите «Подключиться». Copilot Studio связывается с сервером MCP и загружает доступные инструменты.

  6. Просмотрите список отображенных инструментов — они отражают права доступа, закрепленные за вашим токеном API. Включайте или отключайте инструменты по мере необходимости.

  7. Нажмите Сохранить.

ПРИМЕЧАНИЕ

Если подключение не удалось установить из-за ошибки аутентификации, убедитесь, что в PowerDMARC для вашего токена включены оба переключателя: «MCP» и «Primary API Token». Если произошло превышение времени ожидания при подключении, проверьте, доступен ли сайт mcp-dmarc.com из вашей сети.

5. Проверить соединение

  1. В агенте Copilot Studio откройте панель «Тестирование» панель в правой части экрана.

  2. Введите тестовый запрос, например:

  • Отобразить мои домены

  • Покажите мне данные DMARC за последние 7 дней

  • Сколько писем не прошло проверку DMARC на этой неделе?

  1. Агент запускает соответствующие инструменты MCP и возвращает актуальные данные из вашей учетной записи PowerDMARC.

ПРИМЕЧАНИЕ

Утилита list_domains — это самый надёжный способ провести первоначальную проверку. Успешный ответ подтверждает, что соединение с MCP, аутентификация и права доступа работают корректно.

6. Публикация агента

ПРЕДУПРЕЖДЕНИЕ

Для публикации агента Copilot Studio для конечных пользователей требуется полная лицензия Microsoft Copilot Studio. Без этой лицензии агент работает только в режиме внутреннего тестирования и не может быть развернут в таких каналах, как Teams или веб-приложение.

Чтобы опубликовать материал после получения необходимой лицензии:

  1. В агенте нажмите «Опубликовать» в верхней панели навигации.

  2. Выберите целевой канал (например, Microsoft TeamsВеб).

  3. Следуйте инструкциям по развертыванию для конкретного канала, предоставленным Copilot Studio.

7. Контроль доступа

Настройки

Подробности

Кто может настроить интеграцию

Любой пользователь PowerDMARC, имеющий доступ к настройкам API

Права доступа к токенам

Настройка по токену API — используйте области доступа «только для чтения» для развертываний общих агентов

Лимит токенов первичного API

Для каждой учетной записи в любой момент времени в качестве «Основного» может быть указан только один токен

Чувствительность к URL-адресу сервера MCP

Содержит встроенный токен аутентификации — обращайтесь с ним как с секретными учетными данными

Публикация агентов

Требуется лицензия Microsoft Copilot Studio в арендаторской среде Microsoft

Учетные записи MSSP

Каждый MSSP может самостоятельно настроить свой собственный токен и агент Copilot Studio

Для получения дополнительной помощи посетите сайт support.powerdmarc.com

P
PowerDMARC является автором этой статьи о решении.

Нашли ли вы его полезным? Да Нет

Отправить отзыв
Извините, мы не смогли быть полезными. Помогите нам улучшить эту статью с помощью ваших отзывов.