Блог ·

Как защищено локальное соединение

Интерфейс Блокнотика — это веб-страница, которую отдаёт программа по адресу 127.0.0.1. Другие компьютеры до этого адреса не дотянутся — но любой сайт, открытый в вашем браузере, может попробовать. Страница какого-нибудь случайного сайта способна велеть браузеру отправить запрос на http://127.0.0.1:41873/…. Если бы локальная программа на такие запросы отвечала, этот сайт мог бы читать и менять ваши заметки.

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

1. Слушать только 127.0.0.1

Сервер привязан к адресу обратной петли, а не ко всем сетевым интерфейсам. Никто в вашей сети Wi-Fi или в офисной сети подключиться не сможет, правила брандмауэра не нужны. Порт выбирается случайно при каждом запуске, если вы не задали его сами.

2. Ключ сеанса, которого нет у других сайтов

При запуске программа создаёт случайный 256-битный ключ и открывает браузер по адресу /auth?token=…. Этот адрес кладёт ключ в cookie (HttpOnly, SameSite=Strict) и перенаправляет на главную страницу, так что ключ исчезает из адресной строки.

Главная страница отдаётся только при наличии этой cookie. В ней ключ записан в теге <meta>, и скрипт страницы отправляет его с каждым запросом к API в отдельном заголовке X-Blocknotik-Token.

Самое важное: API не смотрит на cookie и принимает только заголовок. Чужой сайт может заставить браузер приложить cookie к запросу, но добавить собственный заголовок к запросу на другой источник без явного разрешения этого источника (CORS) не может — а Блокнотик такого разрешения не даёт никогда. Поэтому поддельный запрос с другого сайта приходит без ключа и получает 401.

3. Проверить, кто спрашивает

Каждый запрос проходит ещё три проверки:

Запросы, которые что-то меняют, должны к тому же быть в формате JSON или загрузкой файлов. Обычная HTML-форма на чужом сайте умеет отправлять только text/plain или закодированные данные формы, поэтому отклоняется ещё до всех остальных проверок.

4. Пути не выходят за пределы папки

Каждое имя заметки, пришедшее со страницы, проверяется, прежде чем дойти до файловой системы: это должен быть относительный путь с окончанием .md, без .., без скрытых папок, без символов и имён, которые Windows трактует по-особому. После соединения с папкой заметок программа раскрывает символические ссылки и ещё раз проверяет, что результат по-прежнему внутри. Zip-архивы при импорте проходят такую же очистку, так что архив с ../../что-нибудь внутри не запишет ничего за пределы папки.

5. Из заметок ничего не выполняется

Markdown превращается в HTML самой программой, и весь текст при этом экранируется. HTML, написанный в заметке, показывается как текст. Ссылки создаются только для адресов http, https и mailto; ссылки javascript: и data: отбрасываются. Картинки загружаются только из папки с заметками.

Вдобавок каждый ответ несёт строгую политику Content-Security-Policy: скрипты — только от самой программы, никаких встроенных скриптов, никаких соединений куда-либо ещё, никакого встраивания во фреймы. Даже если что-то проскочит мимо обработчика Markdown, браузер откажется это выполнять или отправлять данные на сторону.

От чего это не защищает

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

Проверено, а не только описано

Тесты отправляют запросы без ключа, с неверным ключом, с одной только cookie, с чужим Host, с чужим Origin, с телом text/plain и с именами заметок вроде ../x.md и .trash/x.md — и проверяют, что каждый из них отклонён. Прогон Linux-сборки в браузере повторяет главные из этих проверок на настоящей программе. Код — в файлах server.go и store.go в архиве с исходниками.

← Все записи