Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
En este artículo se tratan problemas y preguntas comunes al configurar la autenticación para el Protocolo de contexto de modelo (MCP) y complementos de API en agentes que se ejecutan en Microsoft 365 Copilot.
Para ver los errores de autenticación en las respuestas del agente, habilite el modo de desarrollador. Muchos de los errores de este artículo aparecen en la tarjeta de información de depuración.
- Los usuarios no pueden iniciar sesión o se produce un error en el intercambio de tokens
-
307 Temporary Redirectdesde el punto de conexión de token - Las credenciales almacenadas persisten después de desinstalar el agente
- No se solicita el consentimiento del SSO de Microsoft Entra
- El id. de la aplicación no coincide entre la configuración de autenticación y el complemento
- La dirección URL base en la configuración de autenticación no coincide con la del complemento
- El identificador de referencia en el manifiesto del complemento es incorrecto o falta
- La directiva de la organización restringe el acceso
- El botón de inicio de sesión está inactivo o muestra un error general
- No se abre la ventana emergente de inicio de sesión
- La ventana emergente de inicio de sesión se abre, pero se atasca o nunca se cierra
- Error de credenciales incorrectas
- URL de inicio de sesión no encontrada
- Error interno del servidor durante la autenticación
- El cuadro de diálogo de consentimiento aparece durante el inicio de sesión
Los usuarios no pueden iniciar sesión o se produce un error en el intercambio de tokens
Los valores que no coinciden entre el proveedor de OAuth, la configuración de autenticación y el manifiesto del complemento son la causa más común de errores de inicio de sesión. Compruebe los siguientes valores:
- La URL base en la configuración de autenticación coincide con la
urlpropiedad del objeto de especificación del servidor MCP en el manifiesto de complementos para complementos MCP o con una entrada de la matriz en elserversdocumento OpenAPI para complementos de API. - El URI
https://teams.microsoft.com/api/platform/v1.0/oAuthRedirectde redireccionamiento se registra como un URI de redireccionamiento permitido o una URL de devolución de llamada de autorización con el proveedor de OAuth. - El
reference_idobjeto de autenticación en tiempo de ejecución coincide con el id. de configuración de autenticación generado por el portal para desarrolladores de Microsoft Teams. - Las opciones de restricción de aplicaciones (restringir el uso por aplicación) y restricción de la organización (restringir el uso por organización) permiten la aplicación y el inquilino de Teams.
307 Temporary Redirect desde el punto de conexión de token
No se admiten los servidores OAuth 2.0 que devuelven 307 Temporary Redirect códigos de estado HTTP desde su punto de conexión de token. Configure el proveedor para usar un punto de conexión de token directo.
Las credenciales almacenadas persisten después de desinstalar el agente
Los usuarios pueden cerrar la sesión de un agente desdeAgentes de configuración> de chat en Microsoft 365 Copilot. Para OAuth 2.0, cerrar sesión borra el token almacenado. Para el SSO de Microsoft Entra, el token no se puede borrar directamente y podría continuar persistiendo después de desinstalar un agente debido al almacenamiento en caché de SSO, la configuración de inquilinos o las diferencias de cliente.
Para forzar la reautenticación para el SSO de Entra, quite el consentimiento del usuario o revoque sus sesiones mediante la API de Microsoft GraphrevokeSignInSessions.
No se solicita el consentimiento del SSO de Microsoft Entra
Si el servidor MCP o la API usa el flujo en nombre de para obtener acceso a otra API web que requiere que el usuario otorgue consentimiento, devuelva un 401 Unauthorized error para que el agente solicite al usuario que inicie sesión para otorgar consentimiento.
Confirme también que:
- El URI de identificador de aplicación generado por el portal para desarrolladores de Teams se agrega al identifierUris del registro de la aplicación Entra.
-
https://teams.microsoft.com/api/platform/v1.0/oAuthConsentRedirectse agrega a los URI de redireccionamiento en la plataforma web . - El id
ab3be6b7-f5df-413d-ac2d-abf1e3fd9c0b. de cliente () del almacén de tokens de Microsoft Enterprise se agrega como aplicación cliente permitida en Exponer una API y, si valida el id. de la aplicación cliente, como audiencia de token permitida.
El id. de la aplicación no coincide entre la configuración de autenticación y el complemento
Si ve errores en la tarjeta de información de depuración similares a:
OAuth authentication failed: The App ID used in the request does not match the App ID in the authentication configuration. (HTTP 404)
Vaya al portal para desarrolladores de Teams. Busque el registro de su cliente OAuth o cliente de inicio de sesión único (SSO) y verifique que el ID de la aplicación en el complemento coincida con el ID de la aplicación registrada.
La dirección URL base en la configuración de autenticación no coincide con la del complemento
Si ve errores en la tarjeta de información de depuración similares a:
OAuth authentication failed: The base URL in your authentication configuration does not match the server URL. (HTTP 401)
Vaya al portal para desarrolladores de Teams. Busque el registro de su cliente OAuth o cliente SSO y verifique que la URL del servidor MCP en el complemento coincida con la URL base registrada.
El identificador de referencia en el manifiesto del complemento es incorrecto o falta
Si ve errores en la tarjeta de información de depuración similares a:
OAuth authentication failed: No matching configuration found for referenceID in 'runtime.auth' section of the action manifest
Vaya al portal para desarrolladores de Teams. Busque el registro de su cliente OAuth o cliente SSO y verifique que el Id. en el tiempo auth.reference_id de ejecución de su servidor MCP coincida con el Id. de configuración de autenticación en el portal para desarrolladores de Teams.
La directiva de la organización restringe el acceso
Si ve errores en la tarjeta de información de depuración similares a:
OAuth authentication failed: Access is restricted by your organization's policy. (HTTP 404)
Póngase en contacto con los administradores de su organización para revisar y habilitar el acceso para la aplicación.
El botón de inicio de sesión está inactivo o muestra un error general
Si el botón de inicio de sesión está inactivo o deshabilitado, o al seleccionarlo aparece un error general "La solicitud no se puede procesar", esta condición podría indicar problemas temporales de autenticación o sesión. Intente realizar una consulta de nuevo. Si el problema persiste, vuelva a instalar la aplicación o póngase en contacto con los administradores de su organización.
No se abre la ventana emergente de inicio de sesión
Habilite los elementos emergentes para el sitio en la configuración de su navegador y vuelva a intentarlo.
La ventana emergente de inicio de sesión se abre, pero se atasca o nunca se cierra
Si se abre el menú emergente de inicio de sesión y el usuario completa la autenticación, pero el elemento emergente no se cierra nunca y Copilot no recibe el resultado de la autenticación, es probable que la referencia del window.opener elemento emergente se haya destruido durante la cadena de redireccionamiento de OAuth. Sin window.opener, la ventana emergente no puede comunicar el resultado de la autenticación a Copilot. Un síntoma común es que el inicio de sesión falla la primera vez, pero se realiza correctamente al reintentarlo, porque las credenciales almacenadas en caché omiten la página que destruyó window.opener.
Compruebe los siguientes elementos de la cadena de redireccionamiento de OAuth.
-
Anulación de
window.openerJavaScript : Algunas páginas de inicio de sesión configuradaswindow.opener = nullcomo una medida de seguridad general contra la tabulación inversa. Si alguna página de la cadena de redireccionamiento de autenticación ejecuta este código, el elemento emergente pierde su conexión con Copilot. Ámbito de las protecciones de tabulación solo para la navegación iniciada por el usuario y no se desactivanwindow.openerdurante los redireccionamientos en los elementos emergentes. -
Cross-Origin-Opener-PolicyEncabezado establecido ensame-origin: Si alguna página de la cadena de redireccionamiento sirve unCross-Origin-Opener-Policy: same-originencabezado de respuesta, el navegador corta permanentemente la referencia en lawindow.openernavegación entre orígenes. Asegúrese de que todas las páginas de la cadena de redireccionamiento de OAuth omitan elCross-Origin-Opener-Policyencabezado (que por defecto esunsafe-none) o lo establezcan explícitamente enunsafe-none. -
Vínculos que usan
rel="noopener": Etiquetas de anclaje conrel="noopener"franjawindow.openerde la página de destino. No lo userel="noopener"para la navegación dentro del elemento emergente de autenticación.
Para depurar este problema, abra las herramientas para desarrolladores de su navegador en la ventana emergente y escriba window.opener la Consola en cada paso de la cadena de redireccionamiento. Si window.opener regresa null antes de la redirección final, identifique qué página la borró. También puede comprobar los encabezados de respuesta de la pestaña Red para Cross-Origin-Opener-Policy ver los valores en cada página de la cadena.
Error de credenciales incorrectas
Si ves un error de "credenciales incorrectas" en la ventana emergente de inicio de sesión o en la respuesta del chat, asegúrate de que estás introduciendo las credenciales correctas. Si el error persiste, asegúrese de que el usuario tiene los permisos necesarios.
URL de inicio de sesión no encontrada
Desinstale y reinstale la aplicación e intente iniciar sesión de nuevo.
Error interno del servidor durante la autenticación
Compruebe los detalles en el cuadro emergente de autenticación y póngase en contacto con los administradores de su organización para ver si hay problemas de permisos.
El cuadro de diálogo de consentimiento aparece durante el inicio de sesión
Si aparece un cuadro de diálogo de consentimiento solicitando permisos o justificación comercial, revise los permisos solicitados y proporcione una justificación comercial si es necesario. Si no está seguro o si el cuadro de diálogo de consentimiento solicita permisos que requieren el consentimiento del administrador, póngase en contacto con los administradores de su organización.