Устранение неполадок с проверкой подлинности подключаемого модуля MCP и API

В этой статье рассматриваются распространенные проблемы и вопросы при настройке проверки подлинности для протокола контекста модели (MCP) и подключаемых модулей API в агентах, работающих в Microsoft 365 Copilot.

Чтобы в ответах агента отображались ошибки проверки подлинности, включите режим разработчика. Многие ошибки, описанные в этой статье, содержатся на карте сведений об отладке.

Пользователи не могут войти в систему, или обмен токенов не происходит

Несоответствие значений поставщика OAuth, конфигурации проверки подлинности и манифеста подключаемого модуля является наиболее распространенной причиной сбоев входа. Проверьте следующие значения:

  • Базовый URL-адрес в конфигурации проверки подлинности соответствует url свойству объекта спецификации сервера MCP в манифесте подключаемого модуля для подключаемых модулей MCP или с записью в массиве servers в документе OpenAPI для подключаемых модулей API.
  • URI https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect перенаправления регистрируется как разрешенный URI перенаправления или URL-адрес обратного вызова авторизации у вашего поставщика OAuth.
  • Объект reference_idпроверки подлинности во время выполнения совпадает с идентификатором конфигурации проверки подлинности , созданным порталом разработчика Microsoft Teams.
  • Параметры ограничения приложения (ограничение использования приложением) и ограничения организации (ограничение использования организацией) разрешают ваше приложение и клиент Teams.

307 Temporary Redirect из конечной точки маркера

Серверы OAuth 2.0, возвращающие 307 Temporary Redirect коды состояния HTTP из конечной точки маркера, не поддерживаются. Настройте поставщика для использования конечной точки прямого токена.

Сохраненные учетные данные сохраняются после удаления агента

Пользователи могут выйти из агента в разделе Chat параметров>агентов в Microsoft 365 Copilot. Для OAuth 2.0 при выходе из системы очищается сохраненный маркер. Для единого входа Microsoft Entra маркер не может быть очищен напрямую, и он может продолжать сохраняться после удаления агента из-за кэширования единого входа, настроек клиента или различий в клиенте.

Чтобы принудительно выполнить повторную проверку подлинности для единого входа Entra, удалите согласие пользователя или отзовите его сеансы с помощью API Microsoft GraphrevokeSignInSessions.

Если ваш MCP-сервер или API использует поток от имени пользователя для получения доступа к другому веб-API, который требует от пользователя предоставления согласия, возвратите ошибку 401 Unauthorized , чтобы агент предложил пользователю войти в систему, чтобы предоставить согласие.

Также подтвердите, что:

  • URI идентификатора приложения, созданный порталом разработчика Teams, добавляется к идентификатору idUris вашей регистрации приложения Entra.
  • https://teams.microsoft.com/api/platform/v1.0/oAuthConsentRedirect добавляется к URI перенаправления на веб-платформе .
  • Идентификатор клиента хранилища маркеров Microsoft Enterprise (ab3be6b7-f5df-413d-ac2d-abf1e3fd9c0b) добавляется как разрешенное клиентское приложение в разделе Предоставление API и, если вы проверяете идентификатор клиентского приложения, в качестве разрешенной аудитории маркеров.

Несоответствие идентификатора приложения между конфигурацией проверки подлинности и подключаемым модулем

Если вы видите ошибки в отладочной информации, карте похожие на:

OAuth authentication failed: The App ID used in the request does not match the App ID in the authentication configuration. (HTTP 404)

Перейдите на портал разработчиков Teams. Найдите регистрацию клиента OAuth или клиента единого входа (SSO) и убедитесь, что идентификатор приложения в подключаемом модуле совпадает с зарегистрированным идентификатором приложения.

Базовый URL-адрес в конфигурации проверки подлинности не соответствует плагину

Если вы видите ошибки в отладочной информации, карте похожие на:

OAuth authentication failed: The base URL in your authentication configuration does not match the server URL. (HTTP 401)

Перейдите на портал разработчиков Teams. Найдите регистрацию клиента OAuth или клиента единого входа и убедитесь, что URL-адрес сервера MCP в подключаемом модуле совпадает с зарегистрированным базовым URL-адресом.

Идентификатор ссылки в манифесте плагина неверен или отсутствует

Если вы видите ошибки в отладочной информации, карте похожие на:

OAuth authentication failed: No matching configuration found for referenceID in 'runtime.auth' section of the action manifest

Перейдите на портал разработчиков Teams. Найдите регистрацию клиента OAuth или клиента единого входа и убедитесь, что идентификатор в среде выполнения сервера MCP совпадает с идентификатором auth.reference_id конфигурации проверки подлинности на портале разработки Teams.

Политика организации ограничивает доступ

Если вы видите ошибки в отладочной информации, карте похожие на:

OAuth authentication failed: Access is restricted by your organization's policy. (HTTP 404)

Обратитесь к администраторам организации, чтобы проверить и включить доступ для вашего приложения.

Кнопка входа неактивна или отображает общую ошибку

Если ваша кнопка входа неактивна или неактивна, или ее нажатие выдает общую ошибку "Запрос не может быть обработан", это состояние может указывать на временную проверку подлинности или проблемы с сеансом. Повторите запрос. Если проблема не устранена, переустановите приложение или обратитесь к администраторам организации.

Всплывающее окно входа не открывается

Включите всплывающие окна для сайта в параметрах браузера и повторите попытку.

Всплывающее окно входа открывается, но зависает или никогда не закрывается

Если открывается всплывающее окно входа и пользователь завершает проверку подлинности, но оно так и не закрывается, а Copilot не получает результат проверки подлинности, ссылка всплывающего окна window.opener , скорее всего, была уничтожена в ходе цепочки перенаправлений OAuth. Без window.opener: всплывающее окно не сможет передать результат проверки подлинности обратно в Copilot. Распространенным симптомом является сбой входа с первого раза, но успешная попытка повторной, так как кэшированные учетные данные пропускают уничтоженную window.openerстраницу.

Проверьте следующие элементы в цепочке перенаправлений OAuth.

  • Обнуление window.openerJavaScript : Некоторые страницы входа устанавливаются window.opener = null в качестве общей меры безопасности против обратного табнабинга. Если какая-либо страница в цепочке перенаправления проверки подлинности выполняет этот код, всплывающее окно теряет подключение к Copilot. Область защиты от табуляции только навигацией, инициируемой пользователем, и не очищается window.opener при перенаправлениях во всплывающих окнах.
  • Cross-Origin-Opener-Policy с заголовком : same-origin Если какая-либо страница в цепочке перенаправления обслуживает Cross-Origin-Opener-Policy: same-origin заголовок ответа, браузер навсегда отделяет window.opener ссылку при переходе между источниками. Убедитесь, что все страницы в цепочке перенаправлений OAuth либо пропускают заголовок Cross-Origin-Opener-Policy (по умолчанию используется ), unsafe-noneлибо явно устанавливают его в unsafe-none.
  • Ссылки с использованием rel="noopener": Теги привязки с rel="noopener" полосой window.opener с целевой страницы. Не используйте rel="noopener" для навигации во всплывающем окне проверки подлинности.

Чтобы устранить эту проблему, откройте средства разработчика браузера во всплывающем окне и вводите текст window.opener в консоли на каждом шаге цепочки перенаправлений. Если window.opener возвращает значение null до последнего перенаправления, определите, на какой странице оно было удалено. Вы также можете провести проверку заголовков отклика вкладки "Сеть" для Cross-Origin-Opener-Policy значений на каждой странице в цепочке.

Ошибка с неверными учетными данными

Если во всплывающем окне входа или в ответе чата отображается ошибка "Неверные учетные данные", убедитесь, что вы вводите правильные учетные данные. Если ошибка сохраняется, убедитесь, что у пользователя есть необходимые разрешения.

URL-адрес входа не найден

Удалите и переустановите приложение, а затем попробуйте войти еще раз.

Внутренняя ошибка сервера во время проверки подлинности

Проверьте сведения во всплывающем окне проверки подлинности и обратитесь к администраторам вашей организации по поводу проблем с разрешениями.

Если появится диалоговое окно согласия с запросом разрешений или коммерческого обоснования, просмотрите запрашиваемые разрешения и при необходимости предоставьте коммерческое обоснование. Если вы не уверены или если диалоговое окно согласия запрашивает разрешения, требующие согласия администратора, обратитесь к администраторам вашей организации.