Skip to content
This repository has been archived by the owner on Sep 19, 2022. It is now read-only.

Latest commit

 

History

History
76 lines (52 loc) · 1.78 KB

installation.md

File metadata and controls

76 lines (52 loc) · 1.78 KB

Installation

Voraussetzungen

  • NodeJs - NodeJs
  • OpenSSL - OpenSSL um Zertifikate zu generieren.

Projekt starten

Abhängigkeiten installieren

Im root-Verzeichnis erforderliche Abhängigkeiten über

npm install

installieren.

Zertifikate

Die Anwendung basiert auf SSL, daher muss für den lokalen Betrieb ein selbstsigniertes Zertifikat mit privatem Schlüssel erstellt werden.

Privaten Schlüssel erstellen

openssl genrsa -des3 -out server.key 1024

CSR generieren

Bei "Common Name" "localhost" eintragen.

openssl req -new -key server.key -out server.csr

Passwortabfrage des privaten Schlüssels entfernen da sonst bei jedem Neustart des Webservices das Passwort erneut eingegeben bzw. direkt im Code der formbox-api hinterlegt werden muss.

cp server.key server.key.org
openssl rsa -in server.key.org -out server.key

Selbstsigniertes Zertifikat generieren

openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt

Der Pfad des Privaten Schlüssels und der Zertifikatsdatei muss in der Konfigurationsdatei (.env) korrekt gesetzt sein. Standardmäßig müssen die generierten Zertifikate nach "*/formbox-api/certs/" kopiert werden.

Zertifikat in Zertifikatspeicher importieren

Abschließend muss das Zertifikat in den Zertifikatsspeicher für vertrauenswürdige Root-Zertifikate importiert werden.

Windows: Eingabeaufforderung als Administrator starten und

certutil -addstore -f "ROOT" server.crt

ausführen.

Linux (Ubuntu, Debian):

sudo cp server.crt /usr/local/share/ca-certificates
sudo update-ca-certificates

Applikation starten:

Die Konfigurationsmöglichkeiten sind hier zu finden.

npm start