croc 10.1.0 + x64

croc - безопасная и простая передача данных

croc - это инструмент, который я создал для того, чтобы легко и безопасно
переносить данные с одного компьютера на другой.
Существует множество инструментов, которые могут это сделать, но AFAIK
croc является единственным инструментом, который легко устанавливается и
используется на любой платформе, имеет безопасную одноранговую передачу и
возможность возобновления прерванной передачи.


Обзор

 передача зашифрованных данных с помощью кодовой фразы
croc безопасно передает данные с помощью кодовых фраз - комбинации из трёх
случайных слов (mnemonicoded 4 bytes - мнемокодированное 4 байта). Кодовая
фраза используется отправителем и получателем для обмена ключами с проверкой
подлинности пароля (pake),
https://github.com/schollz/pake
криптографического метода использования общего слабого ключа (code phrase -
кодовой фразы) для создания надёжного ключа для безопасного сквозного
шифрования. По умолчанию кодовая фраза может быть использована только один
раз между двумя сторонами, поэтому у злоумышленника будет менее 1-го из 4-х
миллиардов шансов правильно угадать кодовую фразу, чтобы украсть данные.
Злоумышленник с неправильной кодовой фразой не пройдет pake, и отправитель
будет уведомлен без какой-либо передачи данных. Только два человека с
правильной кодовой фразой смогут передавать зашифрованные данные через
ретранслятор.

 быстрая передача данных по протоколу TCP
Фактическая передача данных осуществляется с помощью ретранслятора, либо
с использованием необработанных сокетов TCP (TCP sockets), либо веб-сокетов
(websockets). Если оба компьютера находятся в локальной сети, то croc будет
использовать локальный ретранслятор, иначе используется публичный ретранслятор.
Все данные, проходящие через ретранслятор, шифруются с помощью ключа сеанса
(PAKE-generated session key), сгенерированного PAKE, поэтому ретранслятор не
может шпионить за информацией, проходящей через него. Данные передаются
блоками, где каждый блок сжимается и шифруется, а получатель отслеживает
полученные блоки, чтобы в случае прерывания можно было возобновить передачу.

 relay позволяет подключать любые два компьютера
croc отличается от утилиты типа scp тем, что не требует наличия двух
компьютеров с включенной переадресацией портов (port-forwarding). Вместо
этого croc будет использовать ретранслятор (relay) - временную настройку
сервера локально (если оба компьютера подключены к локальной сети) или
публично (по умолчанию croc4.schollz.com). Любые два компьютера могут
подключаться к ретранслятору, и после защиты своего канала с помощью PAKE
они могут передавать зашифрованные метаданные и данные через ретранслятор.
Ретранслятор работает путем того, что сначала компьютеры обмениваются
данными по протоколу PAKE через веб-сокеты (websockets), затем обмениваются
зашифрованными метаданными, а затем сшивают tcp-соединения напрямую, чтобы
они могли передавать данные напрямую.

 зачем нужна ещё одна утилита для передачи данных?
моя мотивация к написанию "крокодила" (croc), как бы глупо это ни звучало,
заключается в том, что я хотел создать программу, которая позволила бы легко
отправить документальный фильм PBS размером 3 GB+ моему другу в другую страну.
У моего друга компьютер с Windows, и ему неудобно пользоваться терминалом.
Поэтому я хотел написать программу, которая, несмотря на свою безопасность,
была бы проста для получения файла. croc справляется с этой задачей, и теперь
я использую его почти каждый день на работе. Чтобы получить файл, вы можете
просто скачать исполняемый файл и дважды щёлкнуть по нему.
Название программы навеяно басней о лягушке и крокодиле.
https://web.archive.org/web/20180926035731/http://allaboutfrogs.org/stories/crocodile.html

Лягушонок и крокодил
---------------------------------------------------------------------------
Жил-был лягушонок, который жил посреди болота. Вся его семья жила в этом
болоте в течение нескольких поколений, но этот лягушонок решиа, что у него
достаточно влаги, чтобы хватило на всю жизнь. Он решил, что вместо этого
найдёт сухое место для жизни.
Единственное, что отделяло его от суши, была болотистая, мутная,
стремительно текущая река. Но река была домом для всевозможных скользких,
скользких змей, которые не любили ничего больше, чем хорошую, пухлую
лягушку на ужин, поэтому Лягушонок не осмеливался пытаться переплыть её.
Так что в течение многих дней лягушонок оставался на месте, прыгая вдоль
берега, пытаясь придумать, как переправиться.
Змеи шипели и глумились над ним, призывая подойти ближе, но он отказался.
Время от времени они подкрадывались ближе, открывая пасть для атаки, но
лягушонок всегда отпрыгивал в сторону. Но, независимо от того, как далеко
он искал вверх по течению или вниз по течению, лягушонок не мог найти путь
через воду.
Он был уверен, что здесь будет мост или место, где сходятся берега, но
всё, что он нашёл, это ещё больше тростника и воды. Через некоторое время
даже змеи перестали дразнить его и ушли на поиски более легкой добычи.
Лягушонок разочарованно вздохнул и сел дуться в камыше. Внезапно он заметил
два больших глаза, смотрящих на него из воды. Гигантское бревнообразное
животное открыло пасть и спросило его: "Что ты делаешь, Лягушка? Наверняка
там достаточно мух, чтобы поесть."
Лягушонок квакнул от удивления и отскочил от крокодила. Это существо
могло проглотить его целиком в одно мгновение, не думая об этом! Убедившись,
что находится на безопасном расстоянии, он ответил. "Мне надоело жить в
болотистой воде, и я хочу перебраться на другой берег реки. Но если я
переплыву, змеи съедят меня".
Крокодил хмыкнул в знак согласия и некоторое время сидел, задумавшись.

- Ну, если ты боишься змей, я мог бы подвезти тебя через реку, - предложил
он.
- О нет, я так не думаю, - быстро ответил Лягушонок. - Ты съешь меня по
дороге или уйдешь под воду, чтобы змеи могли меня достать!
- Так почему же я позволю змеям схватить тебя? Я думаю, что они - ужасная
неприятность со своим шипением и скольжением! Реке было бы гораздо лучше
вообще без них! В любом случае, если ты так беспокоишься, что я могу тебя
съесть, ты можешь ехать на мне - на хвосте.

Лягушонок обдумал его предложение. Он очень хотел выбраться на сухую землю,
и другого пути через реку, казалось, не было. Он посмотрел на крокодила
своими короткими, приземистыми глазами и задумался о мотивах крокодила. Но
если бы он ехал на хвосте, крокодил все равно не смог бы его съесть. И он
был прав насчет змей - ни один уважающий себя крокодил не стал бы давать
змеям еду.

- Ладно, для меня это звучит как хороший план. Повернись, чтобы я мог
запрыгнуть тебе на хвост.

Крокодил шлепнул хвостом по болотистой грязи и позволил лягушке взобраться
на него, а сам поковылял к реке. Но он не мог просунуть свой хвост в воду в
качестве руля, потому что лягушка была на нем, и если он опустит свой хвост
в воду, змеи съедят лягушку. Какое-то время они неуклюже плыли вниз по
течению, пока крокодил не сказал:
- Запрыгивай мне на спину, чтобы я мог рулить прямо с помощью хвоста.
Лягушонок зашевелился, и путешествие стало гладким.
С того места, где он сидел, лягушонок ничего не видел, кроме затылка
Крокодила.

- Почему бы тебе не запрыгнуть мне на голову, чтобы видеть всё вокруг? -
пригласил Крокодил.
- Но я больше ничего не хочу видеть, - ответил лягушонок, внезапно
занервничав.
- О, пойдём. Прекрасный вид! Ты, конечно, не думаешь, что я съем тебя
после того, как мы пройдем половину пути. Мой дом находится на болоте,
и какой смысл переплывать реку, полную змей, если я не оставлю тебя на
другом берегу?

Лягушонку было любопытно, как выглядит река, поэтому он забрался на голову
Крокодила. С этого вида река выглядела почти красиво. Он наблюдал за
стрекозами, порхающими над водой, и улыбался в предвкушении, когда увидел
твердую землю за рогозом. Когда крокодил подходил достаточно близко,
лягушонок прыгала с головы и устремлялась на свободу. Он не дал бы крокодилу
шанса съесть его.

- У меня щекочет нос, - вдруг пожаловался крокодил, прервав ход мыслей
лягушонка. - Я думаю, что где-то вокруг него жужжит муха, или в него
попал кусочек пуха рогоза, пока я вез тебя через реку.
- Я не вижу мухи, - сказала лягушка, глядя на зеленую морду крокодила.
Казалось странным, что что-то может щекотать крокодила сквозь его
толстую кожу.
- Не могли бы вы проверить мой нос на предмет куска пуха рогоза?> - умолял
крокодил, подергивая носом. - Боюсь, я чихну и отправлю тебя в полет. Я
не хочу скармливать тебя змеям>. Из его глаз хлынула слеза, как будто он
сдерживал сильное чихание.
- Берег недалеко, - подумала лягушка. И это самое малое, что он мог сделать,
чтобы отплатить ему за то, что он привел его. Поэтому он запрыгнул на морду
крокодила и проверил ноздри. Еще чуть-чуть, и он мог прыгнуть... - Не вижу...
- начал он.
И вот тут, с потрясающим ЧАВКАНИЕМ! Лягушонок исчез. Крокодил удовлетворенно
облизнул губы и слегка чихнул.
- Хорошо, я уже чувствую себя намного лучше, - улыбнулся он и повернулся,
чтобы вернуться домой.

Использование

Основное использование заключается в том, чтобы просто сделать
$ croc send FILE
отправить, а затем на другом компьютере вы можете просто сделать
$ croc [code phrase]
Для получения (вам будет предложено ввести кодовую фразу). Обратите внимание,
что по умолчанию вам не нужны никакие аргументы для получения, вместо этого
вам будет предложено ввести кодовую фразу. Это позволяет вам просто дважды
щелкнуть исполняемый файл для запуска (хорошо для тех из нас, кто не является
компьютерным мастером).

 пользовательская кодовая фраза
Вы можете отправить свою кодовую фразу (должно быть более 4-х символов):
$ croc send --code [code phrase] [filename]


 Локальное использование (Use locally)
croc автоматически попытается установить локальное соединение в вашей
локальной сети, чтобы передать файл намного быстрее. Он использует peer
discovery, по сути, транслируя сообщение в локальную подсеть, чтобы узнать,
хочет ли другой пользователь croc получить файл. croc будет использовать
первое входящее соединение либо из локальной сети, либо из публичного
ретранслятора и довести дело до конца с pake.
Вы можете изменить это поведение, заставив croc использовать только
локальные соединения (--local) или принудительно использовать только
публичный ретранслятор (--no-local):
$ croc --local/--no-local send [filename]


 Использование каналов - stdin и stdout (Using pipes - stdin and stdout)
Вы можете легко использовать croc в каналах (pipes), когда вам нужно
отправить данные через stdin или получить данные из stdout. Для отправки
можно просто использовать каналы (pipes):
$ cat [filename] | croc send
В этом случае croc автоматически использует данные stdin, отправляет и
присваивает имя файла вида "croc-stdin-123456789". Для получения в stdout
вы всегда можете просто использовать флаги (опции), которые автоматически
одобрят передачу и передадут её в stdout.
$ croc -yes -stdout [code phrase] > out
Весь остальной текст, выводимый в консоль, будет отправлен в stdout, поэтому
он не будет мешать отправке сообщения в stdout.


 Ретранслятор с самостоятельным узлом (Self-host relay)
Ретранслятор необходим для сшивания параллельных входящих и исходящих
соединений. Ретранслятор временно хранит информацию о подключении и
зашифрованную метаинформацию. По умолчанию используется общедоступный
ретранслятор по адресу.
ws://198.199.67.130:8153
Вы также можете запустить свой собственный ретранслятор, это очень просто,
просто выполните:
$ croc relay
Убедитесь, что открыты tcp-порты (см. "croc relay --help" какие порты нужно
открыть). Ретранслятор также можно настроить на то, какую эллиптическую
кривую они будут использовать (по умолчанию siec)
Вы можете отправлять файлы, используя свой ретранслятор, введя, "-relay",
чтобы изменить используемый ретранслятор, если вы хотите разместить свой
собственный:
$ croc -relay "ws://myrelay.example.com" send [filename]


 Конфигурационный файл (Configuration file)
Вы также можете сделать некоторые параметры статическими с помощью
конфигурационного файла. Чтобы начать работу с конфигурационным файлом,
просто выполните команду:
$ croc config
которая сгенерирует файл, с возможностью редактирования. Любые изменения,
которые вы вносите в конфигурационный файл, будут применены перед флагами
(опциями) командной строки, если таковые имеются.

10 октября 2018 г