Cómo resolver el error AADSTS900144 de parámetro que falta en Azure AD

By Mirko Peters · 2026-04-21

A nadie le gusta toparse con un muro de errores de autenticación, pero el error AADSTS900144 de parámetro que falta en Azure AD es uno de esos obstáculos clásicos que frustran a todos, desde los desarrolladores de aplicaciones hasta los administradores de TI. Este artículo te explica exactamente qué hay detrás de ese error, qué comprobar primero y los pasos necesarios para que los usuarios puedan

Automatically translated with AI from the original post. Read the English original

A nadie le gusta toparse con un muro de errores de autenticación, pero el error AADSTS900144 de parámetro que falta en Azure AD es uno de esos obstáculos clásicos que frustran a todos, desde los desarrolladores de aplicaciones hasta los administradores de TI. Este artículo te explica exactamente qué hay detrás de ese error, qué comprobar primero y los pasos necesarios para que los usuarios puedan volver a entrar. Repasaremos las causas y las soluciones, desde los errores habituales con parámetros hasta el análisis en profundidad de los flujos de OAuth y la integración de aplicaciones en la nube.

Tanto si das soporte a Microsoft 365, Azure, Power Platform o cualquier solución que se conecte a Entra ID, encontrarás consejos para las soluciones del lado del cliente y del lado del servidor. Aquí tienes solución de problemas basada en casos reales, buenas prácticas listas para entornos empresariales y enlaces adicionales a contenido sobre gobernanza en la nube, todo pensado para ayudarte a evitar dolores de cabeza la próxima vez que aparezca este error.

¿Por qué aparece «AADSTS900144» en la autenticación de Azure AD?

El error «AADSTS900144: Request body must contain the following parameter» aparece cuando faltan datos críticos en una solicitud de autenticación enviada a Azure Active Directory (o Microsoft Entra ID). En pocas palabras, Azure busca información como grant_type o client_id en tu solicitud de token y no la encuentra, o bien la información está, pero tiene un formato incorrecto o se encuentra en el lugar equivocado.

Este error es más común durante los flujos de OAuth 2.0, sobre todo cuando usuarios o aplicaciones intentan iniciar sesión en servicios de nube empresariales. Normalmente se debe a que algo falla en los parámetros del cuerpo de la solicitud que se envían al canjear un código de autorización por un token. Si se omite un parámetro obligatorio, se escribe mal o se coloca fuera del cuerpo POST esperado, Azure AD detiene el proceso de inmediato con el código AADSTS900144.

Puedes ver este error al integrar aplicaciones de negocio personalizadas, al registrar nuevas aplicaciones en Azure o cuando clientes de escritorio (como Microsoft Teams) encuentran problemas de autenticación. A veces, incluso un error al copiar y pegar o una modificación rápida del registro de la aplicación puede desincronizar el parámetro. El mensaje puede parecer críptico, pero es la forma que tiene Azure de decirte: «Vuelve atrás, revisa tu solicitud y corrige lo que falta».

Si trabajas con aplicaciones multiinquilino, ten en cuenta que las discrepancias en el contexto del inquilino o en los puntos de conexión del servicio pueden generar una confusión similar, y a veces hacen que parezca que falta un parámetro cuando en realidad se ha enrutado mal. Entender estos mecanismos hace que la solución de problemas sea más rápida y menos estresante para los equipos de soporte.

Problemas habituales con los parámetros del cuerpo de la solicitud y soluciones rápidas

El error AADSTS900144 casi siempre se reduce a algo que se omite o que se coloca en el lugar equivocado en la solicitud de token. Los protagonistas habituales son client_id y grant_type. Si tu aplicación omite incluso un solo parámetro obligatorio, el punto de conexión de tokens de Azure AD rechaza la solicitud sin contemplaciones. Comprueba también que usas el método HTTP POST, porque GET y otros verbos no sirven en este caso.

Empieza por confirmar que tu aplicación envía las solicitudes con el tipo de contenido application/x-www-form-urlencoded. Sorprende lo a menudo que un tipo de contenido incorrecto hace que Azure AD busque parámetros que no puede leer. A continuación, abre cualquier herramienta de solicitudes HTTP (Postman, curl o incluso Fiddler) e inspecciona el cuerpo sin procesar: ¿están realmente client_id, grant_type, client_secret y los demás en la carga, y no como valores de la cadena de consulta o escondidos en los encabezados?

Si modificas un registro de aplicación, recuerda que los parámetros esperados pueden cambiar según el flujo de concesión. Por ejemplo, si usas la concesión de código de autorización, también debes proporcionar code. No siempre es evidente, así que compara siempre tu tipo de concesión con la documentación de Azure antes de dar el problema por resuelto.

En las aplicaciones multiinquilino, ten cuidado al enviar solicitudes al punto de conexión /common cuando tu inquilino de destino necesita un GUID o un valor específico. De lo contrario, tu «parámetro que falta» podría ser simplemente una solicitud enrutada incorrectamente. Enrutar solicitudes a una URL equivocada, sobre todo en escenarios entre inquilinos, puede hacer tropezar incluso a desarrolladores con experiencia, así que verifica siempre el punto de conexión y los parámetros en conjunto. Corrige esos aspectos y, en la mayoría de los casos, el temido AADSTS900144 desaparecerá ante tus ojos.

Solución de problemas en el lado del cliente: borrar credenciales en caché y restablecer aplicaciones

A veces el problema no está en tu código, sino en la máquina local, que altera el flujo de autenticación. Las credenciales almacenadas en caché y las cookies antiguas pueden conservar tokens desactualizados o datos de parámetros dañados, sobre todo en aplicaciones de escritorio como Microsoft Teams u Outlook. Cuando eso ocurre, los usuarios siguen recibiendo el mensaje AADSTS900144 incluso después de resolver los problemas del back-end.

El primer paso más sencillo es eliminar las credenciales guardadas. En Windows, usa el Administrador de credenciales para quitar los tokens en caché vinculados a tu cuenta. En las aplicaciones web, borrar las cookies y los datos del sitio del navegador puede poner en marcha un proceso de reautenticación limpio. En los casos más persistentes, sobre todo en Microsoft Teams, prueba a hacer un restablecimiento local: cierra la sesión en todas partes, cierra la aplicación y elimina las carpetas de caché antes de reiniciarla. Algunos usuarios necesitarán eliminar por completo el perfil de su cuenta de Teams desde la configuración del dispositivo para asegurarse de que no quede ningún rastro, y después reinstalar Teams desde cero.

Si das soporte a otros usuarios, ofréceles una lista de comprobación sencilla: borrar las credenciales, cerrar la aplicación, vaciar la caché y volver a iniciar sesión. Así se reducen al mínimo el tiempo de inactividad y la confusión de los usuarios de negocio, que solo quieren que sus aplicaciones vuelvan a funcionar. Los equipos de soporte de TI deben confirmar siempre que no quedan datos de autenticación antiguos antes de investigar más a fondo, ya que los restos de configuraciones previas son una causa habitual de los errores AADSTS900144 persistentes.

Si gestionas la gobernanza de Microsoft Teams o problemas de autenticación recurrentes, conviene tener en cuenta que las soluciones técnicas por sí solas no "resuelven" la gobernanza. Para profundizar en por qué la gobernanza nunca es una meta final y cómo llevarla a la práctica, consulta esta guía sobre la gobernanza de Teams y la ilusión de control, o explora este manual sobre la automatización del ciclo de vida de Teams para ver estrategias prácticas.

Buenas prácticas para evitar AADSTS900144 en aplicaciones empresariales

Evitar el error AADSTS900144 depende realmente de la disciplina con las solicitudes OAuth y las configuraciones de las aplicaciones. Haz un hábito de validar todos los parámetros obligatorios, sobre todo client_id y grant_type, antes de enviar solicitudes al endpoint de token de Azure AD. Las comprobaciones automatizadas en tu canalización de implementación pueden detectar parámetros ausentes o mal formados antes de que lleguen a producción y te ahorrarán muchos tickets más adelante.

Usa las herramientas para desarrolladores de Microsoft Entra ID para simular solicitudes de autenticación y ver lo que ve Azure AD. Esto ayuda a detectar no solo los parámetros que faltan, sino también endpoints o directivas que no coinciden y que pueden bloquear solicitudes válidas en inquilinos concretos. Configurar pruebas unitarias con endpoints simulados de Entra ID puede reducir aún más las sorpresas, al mostrar los problemas de parámetros en desarrollo y no en el lanzamiento.

En las organizaciones con una gobernanza estricta o varios equipos de desarrollo, integra la validación en las prácticas de infraestructura como código. Usa comprobaciones de esquema en las plantillas de implementación de ARM o Bicep para exigir que todos los parámetros OAuth obligatorios se incluyan en el registro de la aplicación. Así se reduce el riesgo de desviaciones y configuraciones incorrectas, sobre todo a medida que las aplicaciones evolucionan.

Para un enfoque centrado en la seguridad, mantente atento a las concesiones de consentimiento OAuth y a la aplicación de directivas. Los atacantes aprovechan los ajustes de consentimiento poco restrictivos, así que restringe el consentimiento de los usuarios, exige editores aprobados y aplica flujos de trabajo de administrador. Para una visión sólida de estas amenazas y de las medidas de mitigación, lee este análisis de los ataques de consentimiento OAuth en Entra ID. Si estás refinando los procesos de gobernanza, merece la pena apoyarse en la automatización, el RBAC y Azure Policy; consulta esta guía de estrategia para la gobernanza empresarial en Azure para ver ideas de diseño y controles aplicables.