Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Este artigo aborda problemas e perguntas comuns ao configurar a autenticação para MCP (Protocolo de Contexto de Modelo) e plug-ins de API em agentes em execução no Microsoft 365 Copilot.
Para ver os erros de autenticação nas respostas do agente, habilite o modo de desenvolvedor. Muitos dos erros neste artigo aparecem no card de informações de depuração.
- Os usuários não conseguem entrar ou a troca de token falha
-
307 Temporary Redirectdo ponto de extremidade do token - As credenciais armazenadas persistem após a desinstalação do agente
- O consentimento para SSO do Microsoft Entra não é solicitado
- Incompatibilidade da ID do aplicativo entre a configuração de autenticação e o plug-in
- A URL base na configuração de autenticação não corresponde ao plug-in
- A ID de referência no manifesto do plug-in está incorreta ou ausente
- A política da organização restringe o acesso
- O botão Entrar está inativo ou exibe erro geral
- O pop-up de entrada não abre
- O pop-up de entrada abre, mas fica preso ou nunca fecha
- Erro de credenciais incorretas
- URL de entrada não encontrada
- Erro de servidor interno durante a autenticação
- A caixa de diálogo de consentimento é exibida durante a entrada
Os usuários não conseguem entrar ou a troca de token falha
Valores incompatíveis entre seu provedor OAuth, sua configuração de autenticação e seu manifesto de plug-in são a causa mais comum de falhas de entrada. Verifique os seguintes valores:
- O URL Base em sua configuração de autenticação corresponde à
urlpropriedade do objeto de especificação do servidor MCP no manifesto do plug-in para plug-ins MCP ou uma entrada naserversmatriz em seu documento OpenAPI para plug-ins de API. - O URI
https://teams.microsoft.com/api/platform/v1.0/oAuthRedirectde redirecionamento é registrado como um URI de redirecionamento permitido ou URL de retorno de chamada de autorização com seu provedor OAuth. - O
reference_idobjeto de autenticação no tempo de execução corresponde à ID de configuração de autenticação gerada pelo portal do desenvolvedor do Microsoft Teams. - As configurações de restrição de aplicativo (Restringir uso por aplicativo) e restrição organizacional (Restringir uso por organização) permitem seu aplicativo e locatário do Teams.
307 Temporary Redirect do ponto de extremidade do token
Servidores OAuth 2.0 que retornam 307 Temporary Redirect códigos de status HTTP do ponto de extremidade do token não têm suporte. Configure seu provedor para usar um ponto de extremidade de token direto.
As credenciais armazenadas persistem após a desinstalação do agente
Os usuários podem sair de um agente nas configurações> de ChatAgentes no Microsoft 365 Copilot. Para o OAuth 2.0, sair limpa o token armazenado. Para o SSO do Microsoft Entra, o token não pode ser limpo diretamente e pode continuar a persistir depois que um agente for desinstalado devido ao armazenamento em cache do SSO, configurações de locatário ou diferenças de cliente.
Para forçar a reautenticação para o SSO do Entra, remova o consentimento do usuário ou revogue suas sessões usando a API do Microsoft GraphrevokeSignInSessions.
O consentimento para SSO do Microsoft Entra não é solicitado
Se o servidor MCP ou a API usar o fluxo em nome de para obter acesso a outra API da Web que exija que o usuário conceda consentimento, retorne um 401 Unauthorized erro para fazer com que o agente solicite que o usuário entre para conceder consentimento.
Confirme também se:
- O URI da ID do aplicativo gerado pelo portal do desenvolvedor do Teams é adicionado ao identifierUris do registro do aplicativo Entra.
-
https://teams.microsoft.com/api/platform/v1.0/oAuthConsentRedirecté adicionado aos URIs de redirecionamento na plataforma Web . - A ID do cliente do repositório de tokens do Microsoft Enterprise (
ab3be6b7-f5df-413d-ac2d-abf1e3fd9c0b) é adicionada como um aplicativo cliente permitido em Expor uma API e, se você validar a ID do aplicativo cliente, como um público-alvo de token permitido.
Incompatibilidade da ID do aplicativo entre a configuração de autenticação e o plug-in
Se você vir erros no seu card de informações de depuração semelhantes a:
OAuth authentication failed: The App ID used in the request does not match the App ID in the authentication configuration. (HTTP 404)
Acesse o portal do desenvolvedor do Teams. Localize o registro do cliente OAuth ou do cliente de logon único (SSO) e verifique se a ID do aplicativo em seu plug-in corresponde à ID do aplicativo registrada.
A URL base na configuração de autenticação não corresponde ao plug-in
Se você vir erros no seu card de informações de depuração semelhantes a:
OAuth authentication failed: The base URL in your authentication configuration does not match the server URL. (HTTP 401)
Acesse o portal do desenvolvedor do Teams. Localize o registro do cliente OAuth ou do cliente SSO e verifique se o URL do servidor MCP no plug-in corresponde ao URL base registrado.
A ID de referência no manifesto do plug-in está incorreta ou ausente
Se você vir erros no seu card de informações de depuração semelhantes a:
OAuth authentication failed: No matching configuration found for referenceID in 'runtime.auth' section of the action manifest
Acesse o portal do desenvolvedor do Teams. Localize o registro do cliente OAuth ou do cliente SSO e verifique se a ID no tempo de auth.reference_id execução do servidor MCP corresponde à ID de configuração de autenticação no portal do desenvolvedor do Teams.
A política da organização restringe o acesso
Se você vir erros no seu card de informações de depuração semelhantes a:
OAuth authentication failed: Access is restricted by your organization's policy. (HTTP 404)
Entre em contato com os administradores da sua organização para revisar e habilitar o acesso para seu aplicativo.
O botão Entrar está inativo ou exibe erro geral
Se o botão de entrada estiver inativo ou desabilitado, ou selecioná-lo exibir um erro geral de "A solicitação não pode ser processada", essa condição poderá indicar problemas temporários de autenticação ou sessão. Repita a consulta. Se o problema continuar, reinstale o aplicativo ou entre em contato com os administradores da sua organização.
O pop-up de entrada não abre
Habilite pop-ups para o site nas configurações do seu navegador e tente novamente.
O pop-up de entrada abre, mas fica preso ou nunca fecha
Se o pop-up de entrada abrir e o usuário concluir a autenticação, mas o pop-up nunca fechar e o Copilot não receber o resultado da autenticação, a referência do window.opener pop-up provavelmente foi destruída durante a cadeia de redirecionamento OAuth. Sem window.opener, o pop-up não pode comunicar o resultado da autenticação de volta ao Copilot. Um sintoma comum é que o login falha na primeira vez, mas é bem-sucedido na tentativa, pois as credenciais armazenadas em cache ignoram a página que destruiu window.opener.
Verifique os seguintes itens na cadeia de redirecionamento OAuth.
-
Anulação do
window.openerJavaScript: Algumas páginas de logon definidaswindow.opener = nullcomo uma medida de segurança geral contra tabnabbing reverso. Se qualquer página na cadeia de redirecionamento de autenticação executar esse código, o pop-up perderá sua conexão com o Copilot. Escopo tabnabbing proteções apenas para navegação iniciada pelo usuário e não limparwindow.openerdurante redirecionamentos in-popup. -
Cross-Origin-Opener-Policydefinido comosame-origin: Se qualquer página na cadeia de redirecionamento exibir umCross-Origin-Opener-Policy: same-origincabeçalho de resposta, o navegador cortará permanentemente awindow.openerreferência na navegação entre origens. Verifique se todas as páginas em sua cadeia de redirecionamento OAuth omitem oCross-Origin-Opener-Policycabeçalho (cujo padrão éunsafe-none) ou defina-o explicitamente comounsafe-none. -
Links usando
rel="noopener": Ancore as tags comrel="noopener"a faixawindow.openerda página de destino. Não userel="noopener"para navegação no pop-up de autenticação.
Para depurar esse problema, abra as ferramentas de desenvolvedor do navegador na janela pop-up e digite window.opener no Console em cada etapa da cadeia de redirecionamento. Se window.opener retornar null antes do redirecionamento final, identifique qual página o limpou. Você também pode marcar os cabeçalhos de resposta da guia Rede para Cross-Origin-Opener-Policy valores em cada página da cadeia.
Erro de credenciais incorretas
Se você vir um erro de "Credenciais incorretas" no pop-up de entrada ou na resposta do chat, verifique se você está inserindo as credenciais corretas. Se o erro persistir, verifique se o usuário tem as permissões necessárias.
URL de entrada não encontrada
Desinstale e reinstale o aplicativo e tente entrar novamente.
Erro de servidor interno durante a autenticação
Verifique os detalhes no pop-up de autenticação e entre em contato com os administradores da sua organização se tiver problemas de permissão.
A caixa de diálogo de consentimento é exibida durante a entrada
Se uma caixa de diálogo de consentimento for exibida solicitando permissões ou justificativa comercial, revise as permissões solicitadas e forneça uma justificativa comercial, se necessário. Se você não tiver certeza, ou se a caixa de diálogo de consentimento solicitar permissões que exijam consentimento do administrador, entre em contato com os administradores da sua organização.