darkwire.io

Darkwire.io

Obrolan web terenkripsi sederhana. Didukung oleh Socket.io, Web Cryptography API. Proyek ini adalah contoh bagaimana enkripsi sisi klien bekerja dan bagaimana Anda dapat mengintegrasikannya sebagai layanan obrolan.

Server Darkwire

Darkwire Server adalah aplikasi Node.js.

Klien Web Darkwire

Klien Web Darkwire.io ditulis dalam JavaScript dengan React JS dan Redux.

Perkembangan

Prasyarat

Salin file .env.dist di server/ dan client/ direktori tanpa ekstensi .dist dan menyesuaikannya dengan kebutuhan Anda.

Anda harus memiliki koneksi HTTPS untuk Darkwire untuk bekerja karena menggunakan Crypto Browser API yang hanya dapat diakses di LocalHost dan di belakang koneksi HTTPS.

Pengaturan manual

Anda dapat menggunakan NVM untuk menginstal versi node yang tepat menggunakan perintah ini:

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

Instal dependensi

 $ yarn

Mulai Server dan Klien

 $ yarn setup
$ yarn dev

Menggunakan Docker-Compose

Jalankan saja berikut ini:

 $ docker-compose up

Ini akan secara otomatis membuat file .env default untuk Anda.

Produksi

Buat server dan produksi klien membangun

 $ yarn build

Mulai server

 $ yarn start

Menggunakan Docker

Membangunnya.

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

Lalu jalankan. Contoh:

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

Anda dapat menggunakan salah satu variabel lingkungan yang tersedia di server/.env.dist dan client/.env.dist . Default tersedia di Dockerfile

Keamanan

Harap laporkan masalah keamanan apa pun ke [email protected] .

Cara kerjanya

Darkwire menggunakan kombinasi enkripsi asimetris (RSA-OAEP), tombol sesi simetris (AES-CBC) dan kunci penandatanganan (HMAC) untuk keamanan.

Berikut gambaran obrolan antara Alice dan Bob (juga berlaku untuk obrolan grup):

1. Bob menciptakan kamar dan segera menciptakan pasangan kunci publik/pribadi (RSA-OAEP).
2. Alice bergabung dengan ruangan dan juga menciptakan pasangan kunci publik/pribadi. Dia dikirim kunci publik Bob dan dia mengirimi Bob kunci publiknya.
3. Ketika Bob pergi untuk mengirim pesan, tiga hal dibuat: kunci sesi (AES-CBC), kunci penandatanganan (HMAC SHA-256) dan vektor inisialisasi (digunakan dalam proses enkripsi).
4. Pesan Bob dienkripsi dengan kunci sesi dan vektor inisialisasi, dan tanda tangan dibuat menggunakan kunci penandatanganan.
5. Kunci sesi dan kunci penandatanganan dienkripsi dengan kunci publik masing -masing penerima (dalam hal ini hanya Alice, tetapi dalam beberapa obrolan grup beberapa).
6. Pesan terenkripsi, vektor inisialisasi, tanda tangan, kunci sesi terenkripsi dan kunci penandatanganan terenkripsi dikirim ke semua penerima (dalam hal ini hanya Alice) sebagai paket.
7. Alice menerima paket dan mendekripsi kunci sesi dan kunci penandatanganan menggunakan kunci pribadinya. Dia mendekripsi pesan dengan kunci dan vektor sesi yang didekripsi, dan memverifikasi tanda tangan dengan kunci penandatanganan yang didekripsi.

Obrolan grup bekerja dengan cara yang sama karena pada langkah 5 kami mengenkripsi kunci dengan kunci publik semua orang. Ketika sebuah pesan dikirim, itu termasuk kunci terenkripsi untuk semua orang di ruangan itu, dan penerima kemudian memilih yang untuk mereka berdasarkan ID pengguna mereka.

Serangan manusia-di-menengah

Darkwire tidak memberikan jaminan bahwa orang yang Anda komunikasikan adalah siapa yang Anda pikirkan. Fungsionalitas otentikasi dapat dimasukkan dalam versi mendatang.

Transfer file

Darkwire mengkodekan dokumen ke base64 menggunakan btoa dan dienkripsi dengan cara yang sama dengan pesan obrolan.

1. Ketika sebuah file "diunggah", dokumen dikodekan pada klien dan server menerima string Base64 yang dienkripsi.
2. Server mengirimkan string Base64 terenkripsi ke klien di ruang obrolan yang sama.
3. Klien yang menerima string Base64 yang dienkripsi kemudian mendekripsi dan mendekode string Base64 menggunakan ATOB.

Batas ukuran file yang dapat ditransfer default adalah 4MB, tetapi dapat diubah dalam file .env dengan variabel REACT_APP_MAX_FILE_SIZE .

Soket & Server

Darkwire menggunakan socket.io untuk mengirimkan informasi terenkripsi menggunakan Secure Websockets (WSS).

Kamar disimpan dalam memori di server sampai semua peserta telah pergi, pada titik mana ruangan dihancurkan. Hanya kunci publik yang disimpan dalam memori server selama durasi kehidupan ruangan.

Riwayat obrolan disimpan di browser masing -masing peserta, sehingga secara efektif dihapus (untuk pengguna itu) ketika jendela mereka ditutup.