darkwire.io

Darkwire.io

Простой зашифрованный веб -чат. Powered By Socket.io, веб -криптография API. Этот проект является примером того, как работает шифрование на стороне клиента и как вы можете интегрировать его в качестве службы чата.

Darkwire Server

Darkwire Server - это приложение Node.js.

Darkwire Web Client

Веб -клиент Darkwire.io написан в JavaScript с React JS и Redux.

Разработка

Предварительные условия

Скопируйте файлы .env.dist в server/ и client/ каталогах без расширений .dist и адаптируйте их к вашим потребностям.

У вас должно быть подключение к HTTPS для работы Darkwire, потому что он использует API Crypto Browser, который доступен только на Localhost и за подключением HTTPS.

Ручная установка

Вы можете использовать NVM для установки правильной версии узла, используя эту команду:

 nvm install # If the right node version is not already installed
nvm use
npm install yarn -g # To install yarn

Установить зависимости

 $ yarn

Начать сервер и клиент

 $ yarn setup
$ yarn dev

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

Просто запустите следующее:

 $ docker-compose up

Это автоматически создаст для вас файлы по умолчанию .env .

Производство

Создать сервер и клиентские сборки производства

 $ yarn build

Начальный сервер

 $ yarn start

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

Построить это.

 $ docker build --tag darkwire.io:latest .

Затем запустите его. Пример:

 $ docker run --init --name darkwire.io --rm -p 3001:3001 darkwire.io

Вы можете использовать любую из переменных среды, доступной в server/.env.dist и client/.env.dist . По умолчанию доступны в Dockerfile

Безопасность

Пожалуйста, сообщите о любых вопросах безопасности [email protected] .

Как это работает

Darkwire использует комбинацию асимметричного шифрования (RSA-OAEP), симметричных сеан-клавиш (AES-CBC) и подписания клавиш (HMAC) для безопасности.

Вот обзор чата между Алисой и Бобом (также относится к групповым чатам):

1. Боб создает комнату и сразу же создает публичную/частную пару ключей (RSA-OAEP).
2. Алиса присоединяется к комнате, а также создает публичную/частную пару ключей. Ее посылают открытый ключ Боба, и она отправляет Бобу своего открытого ключа.
3. Когда Боб отправляет сообщение, создается три вещи: ключ сеанса (AES-CBC), ключ подписания (HMAC SHA-256) и вектор инициализации (используется в процессе шифрования).
4. Сообщение Боба зашифровано с помощью ключа сеанса и вектора инициализации, и подпись создается с использованием ключа подписи.
5. Ключ сеанса и ключ подписания зашифрованы с помощью открытого ключа каждого получателя (в данном случае только Алиса, но в групповом чате несколько).
6. Зашифрованное сообщение, вектор инициализации, подпись, зашифрованный сеанс и зашифрованный ключ подписи отправляются всем получателям (в данном случае просто Алиса) в качестве пакета.
7. Алиса получает пакет и расшифровывает клавишу сеанса и подписание, используя свой закрытый ключ. Она расшифровывает сообщение с расшифрованным ключом и вектором сеанса и проверяет подпись с расшифрованным ключом подписания.

Групповые чаты работают одинаково, потому что на шаге 5 мы шифруем ключи от всех. Когда сообщение отправляется, оно включает зашифрованные ключи для всех в комнате, а затем получатели выбирают те, которые для них на основе их идентификатора пользователя.

Человек в среднем атаках

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

Передача файла

Darkwire кодирует документы в BASE64 с использованием BTOA и зашифруется так же, как и сообщения чата.

1. Когда файл «загружен», документ кодируется на клиенте, а сервер получает зашифрованную строку Base64.
2. Сервер отправляет зашифрованную строку Base64 клиентам в той же чате.
3. Клиенты, получающие зашифрованную строку Base64, затем расшифровывают и декодируют строку Base64 с помощью ATOB.

Предел передачи файла REACT_APP_MAX_FILE_SIZE умолчанию составляет 4 МБ, но может быть изменен в .env

Главы и сервер

Darkwire использует Socket.io для передачи зашифрованной информации с использованием безопасных веб -питания (WSS).

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

История чата хранится в браузере каждого участника, поэтому он эффективно стерт (для этого пользователя), когда их окно закрыто.