Codificación Base64 explicada: qué es y cuándo usarla
Base64 en palabras sencillas: cómo convierte bytes en texto, por qué no es cifrado, base64url para JWT y URL, y ejemplos de código en JS y Python.
Actualizado
Base64 es una forma de representar datos binarios con 64 caracteres ASCII imprimibles: A-Z, a-z, 0-9, + y /, con = como relleno. Existe para que cualquier secuencia de bytes pueda viajar por sistemas diseñados para texto, como el correo electrónico, JSON y las URL. No es cifrado, y cualquiera puede decodificarlo al instante.
Cómo funciona Base64
Base64 toma los bytes de entrada de tres en tres (24 bits) y los divide en cuatro grupos de 6 bits. Cada valor de 6 bits, de 0 a 63, corresponde a un carácter del alfabeto. La cadena Man son los bytes 77 97 110, que se convierten en TWFu. Si la longitud de la entrada no es múltiplo de tres, el último grupo se rellena con signos =: Ma se convierte en TWE= y M en TQ==.
El costo es el tamaño. Cada 3 bytes se convierten en 4 caracteres, así que la salida en Base64 es alrededor de un 33% más grande que la entrada, más el relleno. Una imagen de 300 KB se convierte en unos 400 KB de texto.
Por qué existe
Muchos protocolos se crearon para texto ASCII de 7 bits y se atragantan con bytes en bruto. El correo electrónico (MIME) es el caso clásico: los adjuntos van en Base64 para sobrevivir a servidores de correo que destrozan todo lo que quede fuera de los caracteres imprimibles. El mismo problema aparece en cualquier lugar donde un contenedor de texto tiene que transportar bytes:
- JSON no tiene un tipo binario, así que las API colocan el contenido de los archivos en un campo de texto como Base64.
- Las cabeceras HTTP son texto, así que HTTP Basic Auth envía
Authorization: Basic dXNlcjpwYXNz, que no es más queuser:passcodificado. - Las URI de datos incrustan archivos directamente en HTML o CSS:
data:image/png;base64,iVBORw0KGgo.... - Los JWT llevan su cabecera y su payload como segmentos base64url separados por puntos.
- Los certificados y las claves en formato PEM son Base64 entre las líneas
-----BEGINy-----END.
Base64 no es seguridad
Como el alfabeto y el algoritmo son públicos, decodificar no requiere ninguna clave. dXNlcjpwYXNz vuelve a ser user:pass con una sola llamada. Las credenciales de Basic Auth, los payloads de los JWT y cualquier otra cosa que sea "solo Base64" puede leerlos cualquiera que vea la cadena. Si necesitas confidencialidad, cifra primero y después pasa el texto cifrado a Base64 si tiene que viajar como texto. Si necesitas confirmar que los datos no se han manipulado, usa una firma o un HMAC.
Trata una cadena en Base64 exactamente igual que tratarías el texto plano que contiene. Registrarla en un log, pegarla en un ticket o subirla a git con un commit expone los datos originales.
Base64 estándar frente a base64url
El Base64 estándar usa + y /, y ambos tienen un significado especial en las URL. + se convierte en un espacio en las cadenas de consulta y / es un separador de ruta. La variante base64url (RFC 4648, sección 5) los cambia por - y _ y suele eliminar el relleno con =. Por eso un JWT tiene el aspecto de eyJhbGciOiJIUzI1NiJ9, sin relleno y sin barras.
Si un decodificador rechaza un token con "invalid character", comprueba qué variante tienes. La conversión es un reemplazo de dos caracteres: - por +, _ por /, y después vuelve a añadir = hasta que la longitud sea múltiplo de cuatro. El codificador y decodificador Base64 maneja cadenas de texto, Unicode incluido, así que puedes comprobar qué contiene un segmento concreto.
Codificar en los lenguajes más comunes
- JavaScript (navegador):
btoa("hello")devuelveaGVsbG8=yatob()lo revierte. Solo funcionan con cadenas Latin-1; para Unicode, codifica primero a bytes UTF-8 conTextEncodery después convierte los bytes. - Node.js:
Buffer.from("hello").toString("base64")yBuffer.from(s, "base64").toString(). Pasa"base64url"para la variante segura para URL. - Python:
base64.b64encode(b"hello")devuelveb'aGVsbG8='; usabase64.urlsafe_b64encodepara la forma segura para URL. La entrada tiene que ser bytes, así que llama a.encode("utf-8")sobre las cadenas. - Shell:
echo -n "hello" | base64para codificar ybase64 -dpara decodificar. El-nimporta; sin él, codificas también un salto de línea final.
El detalle de Unicode es el que más confunde. btoa("é") lanza un error en el navegador porque é queda fuera de Latin-1. Codifica primero a bytes UTF-8 y el resultado es w6k=.
Incrustar imágenes como URI de datos
Los iconos y logotipos pequeños se pueden insertar directamente en HTML o CSS como data:image/svg+xml;base64,... para ahorrar una petición HTTP. Vale la pena con imágenes de menos de unos pocos kilobytes que aparecen en todas las páginas. Para cualquier cosa más grande, la penalización del 33% en tamaño y la pérdida de la caché del navegador hacen que una URL de imagen normal sea la mejor opción. El conversor de imagen a Base64 genera la cadena sin más, una URI de datos completa, una regla de fondo en CSS o una etiqueta img de HTML, para que pegues la forma que necesites.
Base64 frente a la codificación de URL
Resuelven problemas distintos. Base64 convierte bytes arbitrarios en texto seguro. La codificación de URL (codificación porcentual) escapa determinados caracteres reservados en un texto que ya es texto: un espacio se convierte en %20 y & en %26. A menudo necesitas las dos: pasas un valor a Base64 y después lo codificas para URL si va en una cadena de consulta, porque el Base64 estándar contiene +, / y =. El codificador de URL muestra exactamente qué caracteres cambian.
Hay más herramientas de codificación y formato en la categoría para desarrolladores.
Pruébalo
Pega cualquier cadena, segmento de token o valor de cabecera Basic Auth en el codificador y decodificador Base64. Funciona por completo en tu navegador, maneja Unicode y cambia entre codificar y decodificar con un solo interruptor.