darkwire.io

Darkwire.io

Einfacher verschlüsselter Web -Chat. Angetrieben von Socket.io, der Web -Kryptographie -API. Dieses Projekt ist ein Beispiel dafür, wie Client -Seitenverschlüsselung funktioniert und wie Sie sie als Chat -Dienst integrieren können.

Darkwire Server

Darkwire Server ist eine Node.js -Anwendung.

Darkwire Web Client

Der Darkwire.io -Web -Client ist in JavaScript mit React JS und Redux geschrieben.

Entwicklung

Voraussetzungen

Kopieren Sie .env.dist -Dateien in server/ und client/ Verzeichnissen ohne die .dist -Erweiterungen und passen Sie sie an Ihre Anforderungen an.

Sie müssen eine HTTPS -Verbindung haben, damit Darkwire funktioniert, da sie die Krypto -Browser -API verwendet, die nur auf Localhost und hinter einer HTTPS -Verbindung zugänglich ist.

Handbuch Setup

Sie können mit NVM die richtige Version des Knotens mit diesem Befehl installieren:

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

Abhängigkeiten installieren

 $ yarn

Server und Client starten

 $ yarn setup
$ yarn dev

Verwenden von Docker-Compose

Führen Sie einfach Folgendes aus:

 $ docker-compose up

Dadurch wird automatisch die Standard .env -Dateien für Sie erstellt.

Produktion

Erstellen Sie Server- und Client -Produktionsergebnisse

 $ yarn build

Server starten

 $ yarn start

Verwenden von Docker

Bauen Sie es.

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

Dann führen Sie es aus. Beispiel:

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

Sie können eine der Umgebungsvariablen verwenden, die im server/.env.dist und client/.env.dist verfügbar sind. Die Standardeinstellungen sind in Dockerfile verfügbar

Sicherheit

Bitte melden Sie alle Sicherheitsprobleme an [email protected] .

Wie es funktioniert

DarkWire verwendet eine Kombination aus asymmetrischer Verschlüsselung (RSA-OAEP), symmetrischer Sitzungsschlüssel (AES-CBC) und Signierschlüssel (HMAC) für die Sicherheit.

Hier finden Sie einen Überblick über einen Chat zwischen Alice und Bob (auch für Gruppen -Chats gilt):

1. Bob schafft einen Raum und erstellt sofort ein öffentliches/privates Schlüsselpaar (RSA-OAEP).
2. Alice schließt sich in den Raum und schafft auch ein öffentliches/privates Schlüsselpaar. Sie schickt Bobs öffentlichen Schlüssel und schickt Bob ihren öffentlichen Schlüssel.
3. Wenn Bob eine Nachricht sendet, werden drei Dinge erstellt: ein Sitzungsschlüssel (AES-CBC), ein Signaturschlüssel (HMAC SHA-256) und ein Initialisierungsvektor (verwendet im Verschlüsselungsprozess).
4. Bobs Nachricht wird mit dem Sitzungsschlüssel- und Initialisierungsvektor verschlüsselt, und eine Signatur wird mit dem Signierschlüssel erstellt.
5. Der Sitzungsschlüssel und der Signierschlüssel sind mit dem öffentlichen Schlüssel jedes Empfängers verschlüsselt (in diesem Fall nur Alice, jedoch in einem Gruppenchat mehrfach).
6. Die verschlüsselte Nachricht, Initialisierungsvektor, Signatur, verschlüsselter Sitzungsschlüssel und verschlüsselter Unterzeichnungsschlüssel werden an alle Empfänger (in diesem Fall nur Alice) als Paket gesendet.
7. Alice erhält das Paket und entschlüsselt den Sitzungsschlüssel und die Signierschlüssel mit ihrem privaten Schlüssel. Sie entschlüsselt die Nachricht mit dem entschlüsselten Sitzungsschlüssel und Vektor und überprüft die Signatur mit dem entschlüsselten Signaturschlüssel.

Gruppen -Chats funktionieren genauso, denn in Schritt 5 verschlüsseln wir Tasten mit dem öffentlichen Schlüssel aller. Wenn eine Nachricht gesendet wird, enthält sie verschlüsselte Schlüssel für alle im Raum, und die Empfänger wählen dann die für sie basierend auf ihrer Benutzer -ID aus.

MAN-in-the-Middle-Angriffe

DarkWire bietet keine Garantie dafür, dass die Person, mit der Sie kommunizieren, ist, wie Sie glauben. Die Authentifizierungsfunktionalität kann in zukünftige Versionen aufgenommen werden.

Dateiübertragung

DarkWire codiert Dokumente in Base64 mit BTOA und wird genauso verschlüsselt wie Chat -Nachrichten.

1. Wenn eine Datei "hochgeladen" ist, wird das Dokument auf dem Client codiert und der Server empfängt die verschlüsselte Base64 -Zeichenfolge.
2. Der Server sendet die verschlüsselte Base64 -Zeichenfolge im selben Chatraum an Clients.
3. Clients, die die verschlüsselte Base64 -String erhalten und dann die Base64 -String mit ATOB entschlüsseln und dekodiert.

Die standardmäßige übertragbare Dateigrößengröße ist 4 MB, kann jedoch in .env -Datei mit der Variablen REACT_APP_MAX_FILE_SIZE geändert werden.

Sockets & Server

DarkWire verwendet Socket.io, um verschlüsselte Informationen mit Secure WebSockets (WSS) zu übertragen.

Räume werden auf dem Server im Speicher gespeichert, bis alle Teilnehmer gegangen sind. An diesem Punkt wird der Raum zerstört. Für die Dauer des Lebensdauers werden nur öffentliche Schlüssel im Serverspeicher gespeichert.

Der Chat -Verlauf wird in den Browser jedes Teilnehmers gespeichert, sodass er (für diesen Benutzer) effektiv gelöscht wird, wenn ihr Fenster geschlossen ist.