Cookies Netscape у JSON: як конвертувати й імпортувати cookies X

У вас є файл cookies.txt, а розширення або інструмент автоматизації, яким ви хочете скористатися, приймає лише масив cookies у форматі JSON. Конвертувати cookies Netscape у JSON нескладно, коли знаєш, що означає кожна колонка файлу, і це займає секунди, якщо конвертер точно показує, які рядки він не зміг прочитати.

У цьому посібнику пояснено формат файлу cookies Netscape, показано, як виглядає JSON-варіант, розглянуто безкоштовний інструмент конвертації, а далі — імпорт результату в редактор cookies і перевірку, чи сесія X справді працює. Ви також дізнаєтеся про кілька помилок вставлення, через які трапляється більшість збоїв, і про те, що робити, коли інструмент просить Base64 замість JSON.

Cookies Netscape у JSON: сім колонок, розділених табуляцією

Файл cookies Netscape — це звичайний текст з одним cookie в рядку. Кожен рядок містить сім полів, розділених одним символом табуляції, завжди в тому самому порядку. Такий формат записують curl, wget і більшість браузерних розширень для експорту cookies.

• Домен: де діє cookie, наприклад .x.com. Крапка на початку означає, що піддомени включено.
• Прапорець піддоменів: TRUE або FALSE — чи можуть cookie отримувати також піддомени.
• Шлях: зазвичай лише скісна риска, тобто весь сайт.
• Secure: TRUE, якщо cookie надсилається лише через HTTPS.
• Термін дії: позначка часу Unix у секундах. Нуль означає сесійне cookie, яке закінчується із закриттям браузера.
• Ім’я: назва cookie, наприклад auth_token або ct0.
• Значення: власне значення cookie, тобто секретна частина.

Часто трапляються два особливі випадки. Рядки, що починаються зі знака решітки, — це коментарі, і їх ігнорують, з одним винятком: рядок із префіксом #HttpOnly_ є справжнім cookie, домен якого йде після префікса, позначеним як HTTP-only. Деякі експортери також залишають останнє значення порожнім, тому рядок із шістьма полями можливий і теж коректний.

Формат JSON для cookies, якого очікують розширення

Імпорт cookies у JSON — це зазвичай масив об’єктів: по одному об’єкту на cookie, з ключем для кожного поля. Безкоштовний конвертер на цьому сайті створює ключі domain, includeSubdomains, path, secure, expires, name, value і httpOnly. Він віддзеркалює сім колонок плюс прапорець для префікса HTTP-only.

Майте на увазі: розширення не зовсім однакові. API браузерних розширень часто називають поле терміну дії expirationDate замість expires, а деякі додають ключі на кшталт hostOnly чи sameSite. Перш ніж переносити велику партію, експортуйте одне cookie з розширення, у яке плануєте імпортувати, і порівняйте назви його ключів із виводом конвертера. Якщо назви відрізняються, зазвичай допомагає швидка заміна назви ключа.

Конвертація cookies.txt у JSON безкоштовним інструментом

Найшвидший шлях — інструмент «cookies Netscape у JSON». Він працює у вашому браузері, тож вставлений текст не надсилається на сервер і не зберігається там. Проте ставтеся до вмісту як до пароля, бо значення cookies — це чинні облікові дані сесії.

• Вставте весь cookies.txt, разом із рядками коментарів. Нічого чистити заздалегідь не потрібно.
• Прочитайте три лічильники: коректні cookies, хибні рядки та пропущені рядки. Пропущені рядки — це коментарі й порожні рядки, і це нормально.
• Якщо з’явилися хибні рядки, відкрийте список нечитабельних рядків. Кожен запис показує номер рядка та причину.
• Скопіюйте список JSON, коли кількість коректних cookies збігається з очікуваною.

Якщо ви не певні, що це за файл, спершу вставте кілька рядків у визначник формату. Файл доставки з рядками акаунтів, розділеними двокрапками, — це не те саме, що файл cookies із табуляціями, а наш посібник перевірка структури доставленого файлу перед використанням інструмента форматів пояснює, як їх розрізнити.

Імпорт JSON у редактор cookies і перевірка сесії

Отримавши JSON, імпортуйте його в розширення-редактор cookies у профілі браузера, який ви використовуєте для цього.

• Спершу відкрийте x.com у цьому профілі, щоб у розширення була сторінка й домен, до яких воно прив’яже cookies.
• Відкрийте в розширенні опцію імпорту та вставте масив JSON.
• Оновіть сторінку й переконайтеся, що бачите свою головну стрічку із виконаним входом, а не екран входу.

Для входу в X найважливіші auth_token, що несе сесію, і ct0 — супутній токен, який сайт використовує в запитах. Перевірте, що їхній домен — .x.com (або старіший .twitter.com, якщо ваш експорт його використовує), шлях — скісна риска, а термін дії — дата в майбутньому. Прострочена позначка часу — найпоширеніша причина, чому цілком правильний імпорт не спрацьовує. Щоб побачити повну картину входу за токеном, прочитайте як увійти в Twitter за допомогою auth token.

Типові помилки конвертації: табуляції, рядки #HttpOnly_ і коментарі

Більшість збоїв походить з кількох помилок, і список помилок конвертера вказує просто на них.

• Табуляції перетворилися на пробіли: копіювання з вікна чату, текстового редактора чи деяких вебсторінок може замінити табуляції пробілами. Тоді інструмент бачить одне довге поле замість семи. Копіюйте з оригінального файлу в простому текстовому редакторі.
• Хибна кількість полів: у кожному рядку має бути шість або сім полів. Рядок із зайвими пробілами всередині значення або без однієї колонки повідомляється з номером рядка.
• Порожній домен чи ім’я: рядок із порожнім доменом або назвою cookie непридатний, тому інструмент виводить його у списку замість вгадувати.
• Термін дії не є числом: п’яте поле має складатися з цифр. Дата, записана текстом, або випадковий символ відхиляється.
• Плутанина з коментарями: рядки, що починаються зі знака решітки, пропускаються, але рядки #HttpOnly_ — справжні cookies. Якщо кількість менша за очікувану, перевірте, чи їх не видалив попередній етап очищення.

Після виправлення джерела вставте ще раз і порівняйте кількість коректних cookies з очікуваною. Конвертер, який повідомляє про кожен нечитабельний рядок, кращий за той, що мовчки їх відкидає.

Подальша конвертація в Base64, коли її вимагає інструмент

Деякі панелі й форми імпорту хочуть масив cookies як один рядок Base64, а не читабельний JSON. Вставте JSON в інструмент «JSON у Base64» і виберіть компактний вивід в один рядок, якщо тільки місце призначення не вимагає відступів. Щоб переглянути чи налагодити наявний рядок Base64, зворотний напрямок описано в статті декодування даних cookies Base64 назад у JSON.

Зберігайте оригінальний cookies.txt як першоджерело, адже версії JSON і Base64 завжди можна відновити з нього. Коли захочете додати акаунти у свій робочий процес, перегляньте категорію старих акаунтів, а потім скористайтеся безкоштовними інструментами вище, щоб підготувати формат, потрібний вашому інструменту.

Поширені запитання

Чим відрізняються формати cookies Netscape та JSON?

Файл Netscape — це звичайний текст із сімома колонками, розділеними табуляцією, у кожному рядку. JSON — структурований масив, у якому кожне cookie є об’єктом з іменованими ключами. Вони містять ті самі відомості, тож конвертація змінює розкладку, а не дані cookie.

Чому вставлений cookies.txt показує нуль cookies?

Зазвичай під час копіювання табуляції замінилися пробілами, тож у кожному рядку хибна кількість полів. Скопіюйте безпосередньо з оригінального файлу в простому текстовому редакторі й вставте ще раз. Файл, що містить лише коментарі або порожні рядки, також дає нуль cookies.

Рядок, що починається з #HttpOnly_, — це коментар чи справжнє cookie?

Це справжнє cookie. Префікс лише позначає його як HTTP-only, а домен починається одразу після нього. Звичайні рядки, що починаються зі знака решітки, — коментарі, і їх пропускають.

Які поля cookies найважливіші для входу в X?

Найважливіші ім’я та значення auth_token і ct0, разом із правильним доменом на кшталт .x.com, шляхом у вигляді скісної риски та датою завершення, що ще не минула. Такі поля, як прапорець піддоменів, рідко створюють проблеми, коли це в порядку.

Чи можна пізніше конвертувати JSON назад у Netscape або Base64?

Base64 працює в обидва боки з інструментами JSON у Base64 і Base64 у JSON. Сайт не пропонує конвертера з JSON у Netscape, тож зберігайте оригінальний cookies.txt, якщо цей формат може знадобитися знову.