Перейти к содержимому

Куки

Куки из профиля и обратно

Хранилище куки профиля уезжает одним файлом через «Экспорт куки» в меню профиля и возвращается в другой профиль через «Импорт куки». Сколько записей приехало и сколько не прошло, вы видите двумя числами, а сам файл это живые входы.
Десять
Полей программа читает в файле
3
Написаний срока подойдёт
Один
Профилей в файле
О принятом и отвергнутом
Что вам скажут после импорта

Что лежит в файле

Вы получаете один обычный файл JSON: список записей куки.

В каждой записи едут восемь перечисленных ниже вещей, решающих, куда запись вернётся и сколько там проживёт, и всё прочее, что дал движок. Из файла программа прочтёт ещё два поля: целый адрес вместо собранного из домена и пометку сеансовой куки.

  • Имя и значение

    Сам ключ сессии и имя, по которому его читает сайт.

  • Домен и путь

    Какому сайту запись вернётся и в какую его часть.

  • Secure и HttpOnly

    Поедет ли она только по закрытой связи и видят ли её сценарии страницы.

  • SameSite и срок

    Поедет ли она с запросом, начатым на другом сайте, и когда умрёт.

Какой файл подойдёт

Пункт «Импорт куки» в меню профиля примет JSON и Netscape, в том числе экспорт других антидетект-браузеров, записи Firefox и текстовый .txt, какой пишут расширения для куки и curl.

Срок в миллисекундах станет секундами, пометка «сеансовая» срок не сотрёт, а запись с прошедшим сроком не импортируется.

Вы забираете всё хранилище

Пунктом «Экспорт куки» в меню профиля вы забираете в поставляемой сборке всё, что есть у профиля, а не куки той страницы, что сейчас перед вами. Число в сообщении это число записей, ушедших в файл.

Где лежит хранилище, решает движок, выбранный в настройке. От него же зависит, нужен ли открытый профиль.

По умолчанию файл называется по имени профиля, причём всё, кроме букв, цифр, точки, дефиса и подчёркивания, программа заменит, а куда его положить, выбираете вы.

Движок в настройкеГде хранилищеЧтобы прочитать или записать
ARMANOS BrowserВнутри работающего браузераПрофиль должен работать в этой сборке
Встроенный движокВ папке профиля на дискеРаботает и с закрытым

Вам скажут, а не отдадут пустой файл

Когда в настройке стоит ARMANOS Browser, профиль, который в этой сборке не запущен, вас попросят запустить, а не отдадут пустой файл, открыт он или нет. Пустой файл под зелёным сообщением выглядит ровно так же, как профиль вовсе без сессии.

Экспорт из окна и очистка

Внутри открытого профиля Cmd+Shift+K на Маке или Ctrl+Shift+K на остальных экспортирует его куки прямо в файл.

«Очистить куки…» в меню профиля стирает все куки профиля на этом компьютере, а «Очистить куки» в полосе делает это для отмеченных. Данные сайтов остаются.

В файле лежат живые входы

Кто открыл этот файл, тот вошёл в эти аккаунты, и программа говорит об этом до окна сохранения, а не после.

Файл держат права доступа, а не пароль. На macOS и Linux он достаётся только вашей учётной записи, и эти права уезжают вместе с копией.

На Windows файл защищают не права. Там он получает права той папки, куда вы его положили.

Удалите его после переезда

Файл куки на рабочем столе или на флешке это рабочий вход, пока жива сессия.

Непринятое вы тоже увидите

Браузер отвергает запись куки по множеству обычных причин, а одно голое число принятого читается как полностью переехавшая сессия.

Поэтому в сообщении стоят оба числа, и человеку, которого сайт снова просит войти, есть куда посмотреть.

Три причины ниже это отказы самой программы, и только последняя приходит от браузера, хотя сообщение считает их все одним числом.

Что было в файлеЧто с этим происходитКуда это зачтут
Ни домена, ни адресаЗаписи некуда вернутьсяОтвергнута
Нет имениЗапись без имени это не кукиОтвергнута
Непонятный браузеру срокДату отбрасывают, а запись всё равно входитИ принята, и отвергнута
Правило самого браузераSecure на открытом адресе или несовпавший доменОтвергнута

Куки не везут машину

Сессия это половина того, что держит аккаунт залогиненным. Вторая половина это устройство, с которого сайт эту сессию видел.

Номер профиля это семя, из которого выводится его отпечаток, и ни один файл куки этот номер не везёт.

Файл куки подходит там, где переехать должны одни входы, а сам профиль остаётся на месте.

  • Файл куки

    Хранилище одного профиля и больше ничего.

  • Файл переноса

    Профиль вместе с сессией и своим номером, закрытый вашим паролем.

  • Сессия в папке

    Тот же архив, который везёт ваша собственная папка в облаке.

Куки внутри сценария

Шаг сценария «Куки» работает с куки того профиля, в котором идёт, по одной записи за раз.

Шаг читает куки того сайта, на котором стоит, пока во вкладке открыта веб-страница. На пустой или внутренней странице он берёт домен, вписанный в него вами.

  • Прочитать куки

    Одну названную запись текущего сайта в переменную.

  • Записать куки

    Одну запись для текущего сайта или для названного домена.

  • Удалить куки

    Одну названную запись.

  • Очистить куки этого сайта

    Все куки текущего сайта, и шаг возвращает, сколько их ушло.

Чего это не делает

  • Архивы и файлы не в виде JSON или Netscape не читаются.
  • Вам не скажут, какое правило отвергло какую запись. Число на экране есть, а подробностей за ним нет.
  • В готовый профиль куки ложатся по одному профилю: импорта сразу в выделенные нет.
  • Сам по себе переезд куки входа не выполняет. Сайт взвешивает ещё устройство и адрес и может спросить сессию заново.

Как проверить

Каждое утверждение выше лежит в одном файле, и почти у каждого есть стенд, который можно запустить.

Экспорт берёт всё хранилище, а не страницу перед вами
apps/desktop/src/lib/forkPage.js · apps/desktop/test/cookie-transfer.js
SameSite и срок доезжают до браузера при импорте
apps/desktop/test/cookie-transfer.js
Импорт считает отвергнутое рядом с принятым
apps/desktop/src/main/main.js
Файл куки пишется только для вашей учётной записи
apps/desktop/src/lib/secureFile.js · apps/desktop/test/secrets-on-disk.js
Сценарий читает куки только для сайта своего шага
apps/desktop/src/main/main.js · apps/desktop/test/rules-and-runs.js
Куки по API у открытого и закрытого профиля
apps/desktop/test/api-куки.js · apps/desktop/test/api-куки-закрытого-живьём.js

Вопросы

Можно принести файл из другой программы?
Если это обычный список записей куки, да. Мы читаем поля, которые есть у куки, а не собственную базу одного продукта.
Может ли скрипт читать и загружать куки?
Да, через локальный API, у открытого и у закрытого профиля; куки остаются на этом компьютере.
Сходятся ли два числа в сообщении?
Не всегда. Запись, чью дату прочитать не удалось, входит без неё и считается на обеих сторонах: потерянный срок стоит того, чтобы сказать.
Останется ли аккаунт залогиненным после переезда?
Часто, но не всегда. Сайт взвешивает ещё машину и адрес, поэтому сессия, приехавшая без своего отпечатка, выглядит новым устройством.

Заберите одну сессию с собой

В ARMANOS откройте профиль и запишите его хранилище в файл, который повезёте сами.