GameParticles
Desarrollo

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 que user:pass codificado.
  • 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 -----BEGIN y -----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") devuelve aGVsbG8= y atob() lo revierte. Solo funcionan con cadenas Latin-1; para Unicode, codifica primero a bytes UTF-8 con TextEncoder y después convierte los bytes.
  • Node.js: Buffer.from("hello").toString("base64") y Buffer.from(s, "base64").toString(). Pasa "base64url" para la variante segura para URL.
  • Python: base64.b64encode(b"hello") devuelve b'aGVsbG8='; usa base64.urlsafe_b64encode para 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" | base64 para codificar y base64 -d para decodificar. El -n importa; 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.

Herramientas de esta guía

Preguntas frecuentes

¿Base64 es una forma de cifrado?

No. Base64 es una codificación con un alfabeto público y sin clave. Cualquiera puede decodificarla al instante, así que no aporta ninguna confidencialidad. Si el contenido es sensible, cífralo primero y después pasa el resultado a Base64 si tiene que viajar como texto.

¿Por qué la salida en Base64 termina con uno o dos signos de igual?

Base64 trabaja en bloques de 3 bytes. Cuando la longitud de la entrada no es múltiplo de tres, el último bloque se rellena y ese relleno aparece como = o ==. Base64url suele eliminar el relleno por completo.

¿Cuánto aumenta Base64 el tamaño de mis datos?

Alrededor de un 33 por ciento. Cada 3 bytes de entrada se convierten en 4 caracteres de salida, más hasta dos caracteres de relleno al final.

¿Cuál es la diferencia entre Base64 y base64url?

Base64url sustituye + por - y / por _ para que la cadena sea segura dentro de URL y nombres de archivo, y suele omitir el relleno con =. Los JWT usan base64url. Por lo demás, los datos son idénticos.

Más guías para desarrolladores

Formateador de JSON
Desarrollo · Formatea, valida y minifica JSON con resaltado de sintaxis.
↵
Codificar / decodificar Base64
Desarrollo · Codifica texto en Base64 o decodifica Base64 a texto plano.
↵
Codificador / Decodificador de URL
Desarrollo · Codifica o decodifica componentes de URL y cadenas de consulta.
↵
Generador de hash
Desarrollo · Genera hashes MD5, SHA-1, SHA-256 y SHA-512.
↵
Generador de UUID
Desarrollo · Genera UUID v4 (aleatorios) en lote con un clic.
↵
Probador de regex
Desarrollo · Prueba expresiones regulares sobre un texto con resaltado de coincidencias en vivo.
↵
Contador de palabras
Texto · Cuenta palabras, caracteres, frases, párrafos y tiempo de lectura.
↵
Conversor de mayúsculas y minúsculas
Texto · Convierte texto a MAYÚSCULAS, minúsculas, Título, camelCase, snake_case y más.
↵
Ordenador de listas
Texto · Ordena, invierte, baraja y quita duplicados de listas de texto.
↵
Vista previa de Markdown
Texto · Escribe Markdown y mira la vista previa renderizada en vivo, lado a lado.
↵
Calculadora de porcentajes
Números · Calcula porcentajes, aumentos, descuentos y qué % es un número de otro.
↵
Conversor de colores
Colores · Convierte colores entre HEX, RGB, HSL y HSV al instante.
↵
Snake
Arcade · Come, crece y no choques con las paredes. Un clásico eterno.
↵
2048
Puzles · Desliza y combina fichas hasta conseguir la legendaria ficha 2048.
↵
Word Grid
Puzles · Adivina la palabra oculta de cinco letras en seis intentos con pistas de colores.
↵
Sudoku
Puzles · Completa la cuadrícula 9x9 con lógica. Cuatro niveles, de fácil a experto.
↵
Buscaminas
Estrategia · Usa las pistas numéricas para despejar el campo de minas. Lógica clásica, tres niveles.
↵
Breakout
Arcade · Rompe todos los ladrillos con barra y bola. Power-ups, combos y niveles sin fin.
↵
Práctica de mecanografía
Casual · Mejora tus PPM y tu precisión con prácticas de 30 segundos a 5 minutos. Descubre tus teclas débiles.
↵
TypeRunner
Arcade · Carrera de mecanografía multijugador. Reta a tus amigos con un enlace, vence a la máquina o persigue a tu fantasma.
↵
Typing Blocks
Arcade · Escribe cada palabra antes de que su bloque de madera aterrice. Si fallas, la pila sube hacia la línea.
↵
Bubble Shooter
Arcade · Apunta, rebota en las paredes y explota grupos de tres o más burbujas.
↵
Road Rush
Arcade · Corre contra siete rivales entre el tráfico y ábrete paso a golpes.
↵