INICIO
tecnologia · solución de problemas
que error es el 401, Pantalla de navegador mostrando el mensaje 401 Unauthorized en rojo
tecnologia ·#6564 ·Lectura 6 min. · Redactor: Gonzalo E.Garcia

🚫 Error 401: qué es y cómo arreglarlo

Respuesta corta
Verificado
Redactado por Humanos!

El 401 siempre debe incluir la cabecera WWW-Authenticate con al menos un esquema de autenticación válido según el RFC 9110.

01

Mis trucos para entender (y arreglar) el temido error 401 sin volverte loco

Si alguna vez has visto en pantalla un mensaje de 401 Unauthorized, Authorization required o incluso un seco Access Denied, no te asustes: no estás vetado del sitio. El servidor simplemente te está diciendo que no sabe quién eres todavía, y hasta que no demuestres tu identidad, no te va a entregar el contenido. Es un error del lado del cliente, familia 4xx, y tiene una lógica interna bastante coherente una vez que entiendes por qué aparece.

Recuerdo una tarde en la que estaba montando un panel interno para un cliente y me topé de frente con un 401 al intentar acceder a una ruta protegida por .htaccess. Llevaba veinte minutos revisando el .htpasswd con lupa, pensando que había tecleado mal una contraseña, cuando el problema era que estaba apuntando la petición a una versión anterior del archivo de autenticación. Lección aprendida: antes de dudar de tus credenciales, duda de la ruta.

Lo que ocurre bajo el capó es sencillo de imaginar. Tu navegador o tu aplicación lanza una petición HTTP hacia un recurso que el servidor ha marcado como protegido. El servidor reconoce la petición perfectamente, pero se niega a atenderla porque no lleva ninguna credencial válida, o las que lleva no son suficientes. Y aquí viene un detalle técnico que mucha gente ignora: toda respuesta 401 debe ir acompañada de una cabecera WWW-Authenticate. Ese campo le dice al cliente qué método de autenticación espera, y sin él, estaríamos adivinando. Las especificaciones del IETF lo dejan claro, un servidor que devuelve 401 está obligado a incluir al menos un desafío aplicable.

  • Basic → usuario y contraseña codificados en Base64. Rápido, pero poco seguro si no vas por HTTPS.
  • Bearer → tokens de seguridad que obtienes tras un login correcto y reenvías en cada petición posterior.
  • Digest → protocolo de desafío-respuesta, más elaborado que Basic.
  • HOBA → HTTP Origin-Bound Authentication, no almacena contraseñas y resiste phishing.
  • Mutual → cliente y servidor se autentican mutuamente con certificados.
  • AWS4-HMAC-SHA256 → el algoritmo que usa Amazon Web Services para firmar sus peticiones.

El servidor puede ofrecerte varios esquemas a la vez, en varias líneas o separados por comas. Tú, como cliente, eliges uno y lo envías en la cabecera Authorization. Un flujo típico: pides el recurso, recibes 401 con un reto Basic, repites la petición metiendo usuario:contraseña en Base64, y si todo cuadra obtienes un 200 OK.

En mis años gestionando infraestructuras de comercio electrónico, he visto equipos enteros perder una mañana entera porque alguien olvidó el prefijo "Bearer " en la cabecera Authorization. El token era perfecto, la clave era correcta, pero sin esa palabra mágica delante, el servidor simplemente no reconocía el esquema y devolvía 401 sin más explicación. Un carácter, un espacio, un prefijo ausente, y todo se cae.

A partir de aquí, cuando depuras una API moderna, te conviene mirar la cabecera WWW-Authenticate con lupa. En Chrome, abre DevTools (F12), pestaña Network, recarga, busca la entrada con estado 401 y despliega Response Headers. Ahí verás exactamente qué te está pidiendo el servidor: un esquema, un realm, un scope. Es tu mapa de ruta para saber por dónde tirar.

“Un solo carácter de espacio o una errata en la cabecera Authorization basta para provocar un 401, aunque las credenciales sean perfectas.”

Dato clave
que error es el 401, Escritorio con portátil mostrando cabeceras HTTP y notas de depuración
Imagen

Escritorio con portátil mostrando cabeceras HTTP y notas de depuración

02

Autenticación frente a autorización: donde todo el mundo se equivoca

La confusión clásica entre 401 y 403 Forbidden es casi un rito de iniciación en cualquier curso de desarrollo web. Y la culpa no es tuya, es de los propios nombres de los códigos, que literalmente dicen lo contrario de lo que significan. Te lo cuento desde mi experiencia: durante años he tenido que explicarle a compañeros que un 401 no es un problema de permisos, es un problema de identidad, y un 403 sí lo es. El nombre "Unauthorized" en el 401 apunta hacia autorización, pero el código trata sobre autenticación. Es un pequeño drama semántico heredado de los primeros RFC.

En una de mis primeras migraciones de un ecommerce a Drupal, un cliente me llamó desesperado porque desde la redacción le aparecía 401 al editar entradas. Resultó que la sesión había caducado por inactividad y el servidor devolvía 401 porque, técnicamente, ya no reconocía la identidad del editor. No era un permiso mal configurado, era una sesión muerta. Un reinicio de sesión y listo.

Las causas habituales del 401 en producción son bastante previsibles:

CausaQué revisar
Credenciales incorrectas o obsoletasContraseña, clave API, token roto por rotación
URL mal escritaErrores tipográficos, caracteres especiales, enlaces rotos
Sesión caducadaTiempo de inactividad, expiración del token (reclamación exp en un JWT)
Permiso mal configurado en archivos.htaccess, directivas auth_basic en nginx, ACL sobre el recurso
Esquema de autenticación no admitidoServidor exige OAuth y tú mandas Basic, o viceversa
Ámbitos o audiencia del token erróneosOAuth scope incorrecto, aud que no coincide con el servidor de recursos

Como usuario, la primera acción siempre es verificar credenciales. Si usas una API, comprueba que los tokens no han expirado: decodifica un JWT y mira la reclamación exp. Si no tienes acceso al panel, borra cookies y caché del navegador, en Chrome desde el menú de tres puntos, rango "Todo", marcando "Cookies" e "Imágenes y archivos en caché". Vaciar la caché DNS también ayuda: en Windows, ipconfig /flushdns desde un CMD como administrador; en macOS, sudo killall -HUP mDNSResponder; en Linux, sudo systemd-resolve --flush-caches.

Si eres el responsable del servidor y el 401 aparece sin motivo aparente, prueba a desactivar temporalmente la protección por contraseña. En Apache, localiza el .htaccess con las directivas AuthType Basic, AuthName, AuthUserFile y require valid-user, haz copia de seguridad y elimínalo junto al .htpasswd. En WordPress, renombrar la carpeta Plugins desde el gestor de archivos puede revelar un conflicto silencioso. Yo suelo recomendar también probar las credenciales de forma aislada con curl -H "Authorization: Bearer <token>", así descartas que el problema esté en la capa de aplicación antes de señalar al servidor con el dedo.

Los subcódigos te dan pistas finas: 401.1 es login fallido, 401.2 es configuración del servidor, 401.3 es un bloqueo por ACL. Si ves 401.501 o 401.502, estás superando límites de peticiones; con 401.503 o 401.504, tu IP o tu nombre de host están en una lista negra. Y ojo, el 401 solo bloquea el recurso protegido, no todo el sitio.

En las APIs modernas el 401 ha mutado a algo más elegante: un mecanismo de descubrimiento. Una API OAuth usa el propio desafío 401 para, mediante el parámetro resource_metadata en WWW-Authenticate, apuntar a un documento bajo /.well-known/oauth-protected-resource. El Model Context Protocol construye su flujo de autorización sobre esto: un agente recibe un 401, sigue la pista del metadata y obtiene un token sin configuración previa. Elegante, ¿verdad?

Conclusión:

¿que error es el 401?

Si te soy sincero, después de más de tres décadas peleándome con servidores, APIs, WordPress, Drupal y todo tipo de infraestructura web, sigo considerando que los nombres de estos códigos son una trampa semántica. Yo pienso que el verdadero problema del 401 no es técnico, es de lenguaje: llamamos 'no autorizado' a un error de identidad y 'prohibido' a uno de permisos, y eso siembra confusión desde el primer día. Y lo que más me molesta en producción es ver un cliente atrapado en un bucle reintentando credenciales cuando en realidad le correspondería un 403, porque el 401, al llevar WWW-Authenticate, le invita a actuar, a volver a intentarlo, y ninguna credencial de su alcance va a cambiar el resultado. Así que la próxima vez que aparezca ese molesto 401, respira, mira la cabecera, comprueba un espacio en blanco que no debería estar, decodifica el token, y sobre todo pregúntate si estás ante un problema de quién eres o de qué puedes hacer. Porque son preguntas muy distintas, aunque los nombres te digan lo contrario. Es complicado dar una sola respuesta universal, cada 401 tiene su propio matiz según la arquitectura que lo genere.

Fuentes: 1º Developer.mozilla.org, 2º Geeksforgeeks.org, 3º Hostinger.com, 4º Http.dev
IMAGEN1-AUTOR:Nexuscurioso|Licencia:Todos los derechos reservados|Url:---
IMAGEN2-AUTOR:Nexuscurioso|Licencia:Todos los derechos reservados|Url:---
Redacción: Gonzalo E.Garcia · Actualizado en: 14/11/2026
Valoración para Respuesta Valoración para Respuesta Valoración para Respuesta Valoración para Respuesta Valoración para Respuesta Valoración para Respuesta Valoración para Respuesta Valoración para Respuesta Valoración para Respuesta Valoración para Respuesta
4.1 / 5 · 47 valoraciones Valorar

¿Tienes algo que aportar? Envíanos tu respuesta

Me topé con un 403 mil veces en mi carrera, y hoy te cuento qué es de verdad Me topé con un 403 mil veces en mi carrera, y hoy te cuento qué es de verdad Lo que yo he aprendido enfrentando el error 403 en mis proyectos web Lo que yo he aprendido enfrentando el error 403 en mis proyectos web
¿Quieres ver más respuestas sobre que error es el 401?