Cookies Netscape en JSON : comment convertir et importer les cookies X

Vous avez un fichier cookies.txt, mais l'extension ou l'outil d'automatisation que vous voulez utiliser n'accepte qu'un tableau de cookies au format JSON. Convertir des cookies Netscape en JSON est une petite tâche dès que vous savez ce que signifie chaque colonne du fichier, et cela prend quelques secondes avec un convertisseur qui vous indique exactement quelles lignes il n'a pas pu lire.

Ce guide explique le format du fichier de cookies Netscape, montre à quoi ressemble le côté JSON et détaille l'utilisation de l'outil de conversion gratuit. Il couvre ensuite l'import du résultat dans un éditeur de cookies et la vérification que la session X fonctionne réellement. Vous découvrirez aussi les quelques erreurs de collage à l'origine de la plupart des échecs, et ce qu'il faut faire quand un outil demande du Base64 plutôt que du JSON.

Cookies Netscape en JSON : les sept colonnes séparées par des tabulations

Un fichier de cookies Netscape est un texte brut avec un cookie par ligne. Chaque ligne contient sept champs séparés par un seul caractère de tabulation, toujours dans le même ordre. Curl, wget et la plupart des extensions de navigateur qui exportent des cookies écrivent cette structure.

• Domaine : l'endroit où le cookie s'applique, par exemple .x.com. Un point au début signifie que les sous-domaines sont inclus.
• Indicateur de sous-domaines : TRUE ou FALSE, qui indique si les sous-domaines peuvent aussi recevoir le cookie.
• Chemin : en général une simple barre oblique, c'est-à-dire tout le site.
• Secure : TRUE si le cookie n'est envoyé qu'en HTTPS.
• Expiration : un horodatage Unix en secondes. Un zéro désigne un cookie de session qui prend fin à la fermeture du navigateur.
• Nom : le nom du cookie, comme auth_token ou ct0.
• Valeur : la valeur du cookie elle-même, qui est la partie secrète.

Deux cas particuliers reviennent souvent. Les lignes qui commencent par un dièse sont des commentaires et sont ignorées, avec une exception : une ligne qui commence par le préfixe #HttpOnly_ est un vrai cookie dont le domaine suit le préfixe, marqué comme HTTP-only. Certains exports laissent aussi la dernière valeur vide, donc une ligne de six champs est possible et reste valide.

Le format de cookies JSON attendu par les extensions

Les imports de cookies en JSON prennent normalement la forme d'un tableau d'objets, un objet par cookie, avec une clé pour chaque champ. Le convertisseur gratuit de ce site produit les clés domain, includeSubdomains, path, secure, expires, name, value et httpOnly. Il reprend les sept colonnes, plus un indicateur pour le préfixe HTTP-only.

Notez que les extensions ne sont pas toutes uniformes. Les API d'extensions de navigateur appellent souvent le champ d'expiration expirationDate plutôt que expires, et certaines ajoutent des clés comme hostOnly ou sameSite. Avant de déplacer un gros lot, exportez un seul cookie depuis l'extension dans laquelle vous comptez importer et comparez ses noms de clés avec la sortie du convertisseur. Si les noms diffèrent, un simple rechercher-remplacer sur le nom de la clé règle généralement le problème.

Convertir cookies.txt en JSON avec l'outil gratuit

Le plus rapide est d'utiliser l'outil de conversion de cookies Netscape en JSON. Il s'exécute dans votre navigateur : le texte que vous collez n'est ni envoyé ni stocké sur le serveur. Traitez tout de même le contenu comme un mot de passe, car les valeurs de cookies sont des identifiants de session actifs.

• Collez tout le fichier cookies.txt, lignes de commentaire comprises. Inutile de nettoyer quoi que ce soit au préalable.
• Lisez les trois compteurs : cookies valides, lignes en erreur et lignes ignorées. Les lignes ignorées sont des commentaires et des lignes vides, ce qui est normal.
• Si des lignes en erreur apparaissent, ouvrez la liste des lignes illisibles. Chaque entrée indique le numéro de ligne et la raison.
• Copiez la liste JSON quand le nombre de cookies valides correspond à ce que vous attendez.

Si vous ne savez pas de quel type de fichier il s'agit, collez d'abord quelques lignes dans l'identificateur de format. Un fichier de livraison dont les lignes de compte sont séparées par des deux-points n'a rien à voir avec un fichier de cookies séparé par des tabulations, et notre guide sur la vérification de la structure d'un fichier livré avant d'utiliser un outil de format explique comment les distinguer.

Importer le JSON dans un éditeur de cookies et vérifier la session

Une fois le JSON en main, importez-le dans une extension d'édition de cookies, dans un profil de navigateur réservé à cet usage.

• Ouvrez d'abord x.com dans ce profil, pour que l'extension dispose d'une page et d'un domaine auxquels rattacher les cookies.
• Ouvrez l'option d'import de l'extension et collez le tableau JSON.
• Rechargez la page et vérifiez que vous voyez votre fil d'accueil connecté plutôt que l'écran de connexion.

Pour une connexion à X, les cookies qui comptent le plus sont auth_token, qui porte la session, et ct0, le jeton complémentaire utilisé par le site pour les requêtes. Vérifiez que leur domaine est .x.com (ou l'ancien .twitter.com si votre export l'utilise), que le chemin est une barre oblique et que l'expiration est une date future. Un horodatage expiré est la raison la plus courante pour laquelle un import par ailleurs parfait échoue. Pour une vue d'ensemble de la connexion par jeton, lisez comment se connecter à Twitter avec un auth token.

Erreurs de conversion courantes : tabulations, lignes #HttpOnly_ et commentaires

La plupart des échecs viennent d'une poignée d'erreurs, et la liste d'erreurs du convertisseur les désigne directement.

• Tabulations remplacées par des espaces : copier depuis une fenêtre de messagerie, un traitement de texte ou certaines pages web peut remplacer les tabulations par des espaces. L'outil voit alors un seul long champ au lieu de sept. Copiez plutôt depuis le fichier d'origine dans un éditeur de texte brut.
• Mauvais nombre de champs : chaque ligne doit avoir six ou sept champs. Une ligne avec des espaces en trop dans la valeur ou une colonne manquante est signalée avec son numéro de ligne.
• Domaine ou nom vide : une ligne dont le domaine ou le nom du cookie est vide est inutilisable, donc l'outil la liste au lieu de deviner.
• Expiration qui n'est pas un nombre : le cinquième champ doit être composé de chiffres. Une date écrite en toutes lettres ou un caractère parasite est rejeté.
• Confusion avec les commentaires : les lignes commençant par un dièse sont ignorées, mais les lignes #HttpOnly_ sont de vrais cookies. Si votre total est plus bas que prévu, vérifiez qu'elles n'ont pas été supprimées lors d'une étape de nettoyage précédente.

Après avoir corrigé la source, collez à nouveau et comparez le nombre de cookies valides avec celui que vous attendiez. Un convertisseur qui signale chaque ligne illisible vaut mieux qu'un autre qui les écarte en silence.

Poursuivre vers le Base64 quand un outil le demande

Certains panneaux et formulaires d'import veulent le tableau de cookies sous la forme d'une seule chaîne Base64 plutôt que d'un JSON lisible. Collez le JSON dans l'outil JSON vers Base64 et choisissez la sortie compacte sur une ligne, sauf si la destination demande une indentation. Pour inspecter ou déboguer une chaîne Base64 existante, le sens inverse est expliqué dans décoder des données de cookies Base64 vers du JSON.

Gardez votre cookies.txt d'origine comme source de référence, car les versions JSON et Base64 peuvent toujours en être régénérées. Quand vous serez prêt à ajouter des comptes à votre flux de travail, consultez la catégorie des comptes anciens, puis servez-vous des outils gratuits ci-dessus pour préparer le format dont votre outil a besoin.

Questions fréquentes

Quelle est la différence entre le format de cookies Netscape et le JSON ?

Un fichier Netscape est un texte brut avec sept colonnes séparées par des tabulations sur chaque ligne. Le JSON est un tableau structuré dans lequel chaque cookie est un objet doté de clés nommées. Ils contiennent les mêmes informations : la conversion change la présentation, pas les données du cookie.

Pourquoi mon cookies.txt collé affiche-t-il zéro cookie ?

Le plus souvent, les tabulations ont été remplacées par des espaces pendant la copie, si bien que chaque ligne a un mauvais nombre de champs. Copiez directement depuis le fichier d'origine dans un éditeur de texte brut, puis collez à nouveau. Un fichier qui ne contient que des commentaires ou des lignes vides donne aussi zéro cookie.

Une ligne qui commence par #HttpOnly_ est-elle un commentaire ou un vrai cookie ?

C'est un vrai cookie. Le préfixe le marque seulement comme HTTP-only, et le domaine commence juste après. Les lignes ordinaires qui commencent par un dièse sont des commentaires et sont ignorées.

Quels champs de cookie comptent le plus pour une connexion à X ?

Le nom et la valeur de auth_token et de ct0 comptent le plus, avec un domaine correct comme .x.com, un chemin réduit à une barre oblique et une date d'expiration non dépassée. Des champs comme l'indicateur de sous-domaines posent rarement problème quand ceux-là sont bons.

Puis-je reconvertir le JSON en Netscape ou en Base64 plus tard ?

Le Base64 fonctionne dans les deux sens avec les outils JSON vers Base64 et Base64 vers JSON. Le site ne propose pas de convertisseur JSON vers Netscape, donc conservez votre cookies.txt d'origine au cas où vous auriez de nouveau besoin de ce format.