GameParticles
Développeur

L'encodage Base64 expliqué : définition et cas d'usage

Base64 expliqué simplement : des octets au texte, pourquoi ce n'est pas du chiffrement, base64url pour les JWT et les URL, exemples en JS et Python.

Mis à jour

Base64 est une manière de représenter des données binaires à l'aide de 64 caractères ASCII imprimables : A-Z, a-z, 0-9, + et /, avec = pour le remplissage. Il existe pour que des octets quelconques puissent traverser des systèmes conçus pour le texte, comme les e-mails, le JSON et les URL. Ce n'est pas du chiffrement, et n'importe qui peut le décoder instantanément.

Comment fonctionne Base64

Base64 prend les octets d'entrée trois par trois (24 bits) et les découpe en quatre groupes de 6 bits. Chaque valeur de 6 bits, de 0 à 63, correspond à un caractère de l'alphabet. La chaîne Man correspond aux octets 77 97 110, ce qui donne TWFu. Si la longueur de l'entrée n'est pas un multiple de trois, le dernier groupe est complété par des signes = : Ma devient TWE= et M devient TQ==.

Le prix à payer, c'est la taille. Chaque groupe de 3 octets devient 4 caractères : la sortie Base64 est donc environ 33 % plus volumineuse que l'entrée, sans compter le remplissage. Une image de 300 Ko devient à peu près 400 Ko de texte.

Pourquoi il existe

De nombreux protocoles ont été conçus pour du texte ASCII sur 7 bits et s'étranglent sur des octets bruts. L'e-mail (MIME) en est l'exemple classique : les pièces jointes sont encodées en Base64 pour survivre aux serveurs de messagerie qui altèrent tout ce qui sort des caractères imprimables. Le même problème se pose partout où un conteneur textuel doit transporter des octets :

  • JSON n'a pas de type binaire, les API placent donc le contenu des fichiers dans un champ de type chaîne, en Base64.
  • Les en-têtes HTTP sont du texte, si bien que l'authentification HTTP Basic envoie Authorization: Basic dXNlcjpwYXNz, qui n'est autre que user:pass encodé.
  • Les URI de données intègrent des fichiers directement dans le HTML ou le CSS : data:image/png;base64,iVBORw0KGgo....
  • Les JWT transportent leur en-tête et leur charge utile sous forme de segments base64url séparés par des points.
  • Les certificats et les clés au format PEM sont du Base64 placé entre des lignes -----BEGIN et -----END.

Base64 n'est pas une mesure de sécurité

L'alphabet et l'algorithme étant publics, le décodage ne demande aucune clé. dXNlcjpwYXNz redevient user:pass en un seul appel. Les identifiants Basic Auth, les charges utiles de JWT et tout ce qui est « simplement du Base64 » sont lisibles par quiconque voit la chaîne. Si vous avez besoin de confidentialité, chiffrez d'abord, puis encodez le texte chiffré en Base64 s'il doit circuler sous forme de texte. Si vous devez confirmer que des données n'ont pas été altérées, utilisez une signature ou un HMAC.

Traitez une chaîne Base64 exactement comme vous traiteriez le texte en clair qu'elle contient. La journaliser, la coller dans un ticket ou la committer dans git expose les données d'origine.

Base64 standard et base64url

Le Base64 standard utilise + et /, qui ont tous deux une signification particulière dans les URL. + devient une espace dans les chaînes de requête et / est un séparateur de chemin. La variante base64url (RFC 4648, section 5) les remplace par - et _ et supprime généralement le remplissage =. C'est pourquoi un JWT ressemble à eyJhbGciOiJIUzI1NiJ9, sans remplissage ni barre oblique.

Si un décodeur rejette un jeton avec le message « invalid character », vérifiez de quelle variante il s'agit. La conversion se résume à remplacer deux caractères : - par +, _ par /, puis à rajouter des = jusqu'à ce que la longueur soit un multiple de quatre. L'encodeur et décodeur Base64 gère les chaînes simples, Unicode compris : vous pouvez ainsi vérifier ce que contient un segment donné.

Encoder dans les langages courants

  • JavaScript (navigateur) : btoa("hello") donne aGVsbG8= et atob() fait l'opération inverse. Ces fonctions n'acceptent que des chaînes Latin-1 ; pour de l'Unicode, encodez d'abord en octets UTF-8 avec TextEncoder, puis convertissez les octets.
  • Node.js : Buffer.from("hello").toString("base64") et Buffer.from(s, "base64").toString(). Passez "base64url" pour la variante adaptée aux URL.
  • Python : base64.b64encode(b"hello") renvoie b'aGVsbG8=' ; utilisez base64.urlsafe_b64encode pour la forme adaptée aux URL. L'entrée doit être de type bytes : appelez donc .encode("utf-8") sur les chaînes.
  • Shell : echo -n "hello" | base64 pour encoder et base64 -d pour décoder. Le -n a son importance, sans quoi vous encodez aussi un saut de ligne final.

C'est le point Unicode qui piège le plus souvent. btoa("é") lève une exception dans le navigateur parce que é est hors de Latin-1. Encodez d'abord en octets UTF-8 et le résultat est w6k=.

Intégrer des images sous forme d'URI de données

Les petites icônes et les logos peuvent être intégrés directement dans le HTML ou le CSS sous la forme data:image/svg+xml;base64,... afin d'économiser une requête HTTP. Cela vaut la peine pour des images de moins de quelques kilo-octets présentes sur toutes les pages. Au-delà, la pénalité de 33 % sur la taille et la perte de la mise en cache par le navigateur font d'une URL d'image classique le meilleur choix. Le convertisseur d'image en Base64 fournit la chaîne brute, une URI de données complète, une règle CSS background ou une balise HTML img, pour que vous colliez la forme dont vous avez besoin.

Base64 et encodage d'URL

Ils répondent à des problèmes différents. Base64 transforme des octets quelconques en texte sûr. L'encodage d'URL (ou encodage-pourcent) échappe certains caractères réservés dans un texte qui est déjà du texte : une espace devient %20 et & devient %26. Vous avez souvent besoin des deux : encodez une valeur en Base64, puis appliquez-lui l'encodage d'URL si elle va dans une chaîne de requête, car le Base64 standard contient +, / et =. L'encodeur d'URL montre précisément quels caractères changent.

D'autres outils d'encodage et de mise en forme se trouvent dans la catégorie développeur.

Essayez

Collez n'importe quelle chaîne, un segment de jeton ou la valeur d'un en-tête Basic Auth dans l'encodeur et décodeur Base64. Il s'exécute entièrement dans votre navigateur, gère l'Unicode et passe de l'encodage au décodage d'un simple clic sur une bascule.

Outils de ce guide

Questions fréquentes

Base64 est-il une forme de chiffrement ?

Non. Base64 est un encodage dont l'alphabet est public et qui n'utilise aucune clé. N'importe qui peut le décoder instantanément : il n'apporte donc aucune confidentialité. Si le contenu est sensible, chiffrez-le d'abord, puis encodez le résultat en Base64 s'il doit circuler sous forme de texte.

Pourquoi une chaîne Base64 se termine-t-elle par un ou deux signes égal ?

Base64 travaille par blocs de 3 octets. Quand la longueur de l'entrée n'est pas un multiple de trois, le dernier bloc est complété et ce remplissage apparaît sous la forme = ou ==. Base64url supprime généralement ce remplissage.

De combien Base64 augmente-t-il la taille de mes données ?

D'environ 33 pour cent. Chaque groupe de 3 octets en entrée devient 4 caractères en sortie, auxquels s'ajoutent jusqu'à deux caractères de remplissage à la fin.

Quelle est la différence entre Base64 et base64url ?

Base64url remplace + par - et / par _ pour que la chaîne puisse figurer sans risque dans les URL et les noms de fichiers, et il omet généralement le remplissage =. Les JWT utilisent base64url. Pour le reste, les données sont identiques.

Plus de guides pour développeurs

Formateur JSON
Développeur · Formatez, validez et minifiez du JSON avec coloration syntaxique.
↵
Encoder / décoder en Base64
Développeur · Encodez un texte en Base64 ou décodez du Base64 en texte brut.
↵
Encodeur / Décodeur d'URL
Développeur · Encodez ou décodez des composants d'URL et des chaînes de requête.
↵
Générateur de hash
Développeur · Générez des hashs MD5, SHA-1, SHA-256 et SHA-512.
↵
Générateur d'UUID
Développeur · Générez des UUID v4 (aléatoires) en masse en un clic.
↵
Testeur de regex
Développeur · Testez des expressions régulières sur du texte avec surbrillance des correspondances en direct.
↵
Compteur de mots
Texte · Comptez les mots, caractères, phrases, paragraphes et le temps de lecture.
↵
Convertisseur de casse
Texte · Convertissez un texte en MAJUSCULES, minuscules, Titre, camelCase, snake_case, etc.
↵
Trieur de listes
Texte · Triez, inversez, dédoublonnez et mélangez des listes de texte.
↵
Aperçu Markdown
Texte · Écrivez du Markdown et voyez l'aperçu rendu en direct, côte à côte.
↵
Calculateur de pourcentage
Nombres · Calculez pourcentages, hausses, baisses et le % d'un nombre par rapport à un autre.
↵
Convertisseur de couleurs
Couleurs · Convertissez instantanément des couleurs entre HEX, RGB, HSL et HSV.
↵
Snake
Arcade · Mangez, grandissez, évitez les murs. Un classique indémodable.
↵
2048
Réflexion · Faites glisser les tuiles et fusionnez-les pour atteindre la légendaire tuile 2048.
↵
Word Grid
Réflexion · Devinez le mot caché de cinq lettres en six essais grâce aux indices de couleur.
↵
Sudoku
Réflexion · Remplissez la grille 9x9 par la logique. Quatre niveaux, de facile à expert.
↵
Démineur
Stratégie · Servez-vous des chiffres pour déminer le terrain. Logique classique, trois niveaux.
↵
Breakout
Arcade · Cassez toutes les briques avec la raquette et la balle. Bonus, combos, niveaux sans fin.
↵
Entraînement dactylo
Détente · Améliorez MPM et précision : exercices de 30 secondes à 5 minutes. Repérez vos touches faibles.
↵
TypeRunner
Arcade · Course de dactylographie multijoueur. Défiez vos amis par lien, battez l'ordinateur ou poursuivez votre fantôme.
↵
Typing Blocks
Arcade · Tapez chaque mot avant que son bloc de bois ne se pose. Ratez, et la pile grimpe vers la ligne.
↵
Bubble Shooter
Arcade · Visez, jouez avec les murs et éclatez des groupes de trois bulles ou plus.
↵
Road Rush
Arcade · Affrontez sept rivaux dans le trafic et prenez la tête à coups de poing.
↵