Skip to Content

Sicherheit

Die Appliance läuft auf Hardware und in einem Netzwerk, die Sie betreiben. IronFlock liefert die Software und ihre Standardeinstellungen; wie gut die Appliance geschützt ist, hängt außerdem vom gewählten Modus, vom umgebenden Netzwerk und vom Host ab, auf dem sie läuft. Diese Seite ist die Checkliste für diesen Teil.

Was jeder Modus schützt

Die Appliance läuft in einem von drei Modi, die unter HTTPS & Zertifikate beschrieben sind. Sie unterscheiden sich darin, was verschlüsselt und was überprüft wird:

Einfaches HTTP (Standard)HTTPS mit einer selbst ausgestellten CAHTTPS mit Ihrem Unternehmenszertifikat
Browser zur ApplianceUnverschlüsseltHTTPSHTTPS
Login-CookiesNicht als sicher markiertSicherSicher
Geräteverbindung (Port 18080)UnverschlüsseltUnverschlüsseltHTTPS auf 443
App-Images und Agent-Updates für GeräteUnverschlüsseltUnverschlüsseltHTTPS auf 443
Fernzugriffs-Tunnel der GeräteVerschlüsselt, Server nicht überprüftVerschlüsselt, Server nicht überprüftVerschlüsselt und überprüft
Passkeys und SicherheitsschlüsselNur von der Appliance selbst ausJaJa

Verwenden Sie HTTPS mit Ihrem Unternehmenszertifikat überall dort, wo sich die Appliance ein Netzwerk mit anderen Systemen teilt. Es ist der einzige Modus, in dem verbundene Geräte überprüfen, mit wem sie kommunizieren. Die beiden anderen Modi eignen sich für ein Netzwerksegment, das nur die Appliance, ihre Geräte und ihre Betreiber erreichen können.

Was unverschlüsselt bleibt

Auch mit HTTPS wird ein Teil des Datenverkehrs nicht verschlüsselt. Planen Sie Ihr Netzwerk entsprechend:

  • Die Geräteverbindung auf Port 18080 wird in jedem Modus auf jeder Netzwerkschnittstelle veröffentlicht. Der eigene Geräte-Agent der Appliance und die auf der Appliance laufenden Apps verbinden sich mit ihr, im Modus einfaches HTTP und mit einer selbst ausgestellten CA außerdem alle verbundenen Geräte.
  • Fernzugriffs-Tunnel zur Appliance (Port 7000) sind im Modus einfaches HTTP und mit einer selbst ausgestellten CA verschlüsselt, doch die Geräte können das Zertifikat der Appliance nicht prüfen. Wer Zugriff auf den Netzwerkpfad hat, könnte sich als Tunnel-Server der Appliance ausgeben. Geräte-Agenten protokollieren eine Warnung, wenn sie sich auf diese Weise verbinden.
  • Verbindungen zwischen den Diensten innerhalb der Appliance, etwa zu ihren Datenbanken, sind nicht verschlüsselt. Sie verlassen den Host nicht.
  • Ruhende Daten werden von der Appliance nicht verschlüsselt. Nutzen Sie die Verschlüsselung des Betriebssystems oder der Festplatte des Hosts, wenn die Appliance sensible Daten speichert oder Ihr Gelände verlassen kann.

Checkliste zur Härtung

  • Wählen Sie den Modus, der zu Ihrem Netzwerk passt (siehe Was jeder Modus schützt).
  • Beschränken Sie, wer die Ports der Appliance erreichen kann. Die Installation öffnet nichts in Ihrer Firewall, und Docker veröffentlicht die Ports der Appliance an den üblichen Eingangsregeln der Host-Firewall (ufw, firewalld) vorbei. Filtern Sie in der Chain DOCKER-USER oder an Ihrer Netzwerk-Firewall: Die Installation legt dafür eine Vorlage unter /opt/ironflock/docker-user-firewall.sh.example ab. Erlauben Sie die Geräte-Ports (18080, 15001, 15002, 7000, 30000–30049) nur aus Ihren Gerätenetzwerken — siehe Geräte, die sich mit der Appliance verbinden.
  • Halten Sie das Betriebssystem des Hosts aktuell und beschränken Sie, wer ein Konto darauf hat. Wer Root-Zugriff auf den Host hat, kann jedes Secret der Appliance lesen.
  • Verwenden Sie SSH-Schlüssel statt Passwörtern für den administrativen Zugriff auf den Host.
  • Richten Sie die Zeitsynchronisation ein — siehe Zeitsynchronisation (NTP).
  • Ändern Sie das Admin-Passwort nach der ersten Anmeldung und richten Sie einen zweiten Faktor für das Admin-Konto ein.
  • Verlangen Sie einen zweiten Faktor von allen, sobald alle Konten einen haben (siehe Konten und Zugriff).
  • Schützen Sie das ironflock.com-Konto, dem die Instanz gehört, mit einem zweiten Faktor: Es hat aus der Cloud Admin-Zugriff auf die Appliance.
  • Schalten Sie die Cloud-Verbindung aus, wenn niemand von ironflock.com aus auf der Appliance arbeiten muss (siehe Cloud-Verbindung).
  • Installieren Sie nur Apps, denen Sie vertrauen. Apps laufen auf der Appliance und auf Ihren Geräten mit weitreichendem Zugriff auf den Host, einschließlich der Konfigurationsdateien der Appliance.
  • Halten Sie die Appliance aktuell (siehe Updates).
  • Prüfen Sie ironflock vor der ersten Installation (siehe ironflock vor der ersten Installation prüfen).

Konten und Zugriff

  • Admin-Konto: Jede Appliance erhält bei der Installation ihr eigenes Admin-Passwort; ironflock appliance install zeigt es einmal an. Geht es verloren, setzen Sie ein neues, wie unter Lokaler Betrieb beschrieben — dabei werden auch alle Admin-Sitzungen abgemeldet.
  • Neue Benutzer können sich nur mit einer Einladung aus einem Projekt auf der Appliance registrieren. Ohne Einladung wird die Registrierung abgelehnt, auch über Social Login.
  • Zweiter Faktor: Benutzer können eine Authenticator-App (TOTP), Passkeys oder Sicherheitsschlüssel sowie Wiederherstellungscodes einrichten. Passkeys und Sicherheitsschlüssel benötigen HTTPS. Die Option --2fa von ironflock appliance install oder ironflock appliance configure legt die Richtlinie fest, und sie bleibt über Updates hinweg bestehen:
    • available — Benutzer können einen zweiten Faktor einrichten, werden aber nie danach gefragt.
    • effective (Standard) — Benutzer, die einen zweiten Faktor haben, müssen ihn verwenden.
    • required — jeder Benutzer muss einen zweiten Faktor verwenden. Stellen Sie zuvor sicher, dass jedes Konto einen hat: Ein Benutzer ohne zweiten Faktor kann sich nicht mehr anmelden.
  • Sitzungen dauern 24 Stunden.
  • Zugriff über ironflock.com: Das ironflock.com-Konto, das den Instanzschlüssel erstellt hat, ist mit dem Admin-Konto der Appliance verknüpft. Von Ihnen eingeladene Benutzer verknüpfen ihre eigenen ironflock.com-Konten — siehe Konten verknüpfen. Ein Benutzer kann diese Verknüpfung jederzeit aufheben. Um jeden Zugriff über ironflock.com zu unterbinden, schaltet der Admin die Cloud-Verbindung aus.

Secrets auf dem Host

ironflock appliance install erzeugt die Secrets der Appliance einmalig bei der Installation und behält sie über Updates hinweg bei. Sie liegen unter /opt/ironflock/:

DateiInhaltZugriff
.envPasswörter und Schlüssel aller Dienste, das initiale Admin-Passwort, Proxy- und SMTP-ZugangsdatenNur root (0600)
license.envDer Instanzschlüssel und was die Lizenzvalidierung dazu speichertroot und die IronFlock-Dienste (0640)
certs/Das HTTPS-Zertifikat und sein Schlüssel; bei einer selbst ausgestellten CA auch der Schlüssel der CAPrivate Schlüssel nur root (0600)
registry-token-certs/Der Schlüssel, der die Tokens für App-Image-Abrufe signiertNur der Registry-Dienst (0600)
.env.prev, rotation.logDie .env vor der letzten Rotation; wann welches Secret rotiert wurde, ohne WerteNur root (0600)

Die Installation meldet Docker außerdem mit Ihrem Instanzschlüssel bei der IronFlock-Registry an, sodass auch die Docker-Konfiguration von root ihn enthält.

Nehmen Sie diese Dateien in Ihre Backups auf und schützen Sie die Backups wie die Appliance selbst. Löschen Sie .env nie, und lassen Sie sie nicht von einer Installation neu erzeugen: Die Datenbanken und die verschlüsselten Daten hängen von ihren Werten ab. Um ein Secret zu ersetzen, rotieren Sie es.

Was Sie selbst ersetzen können:

  • Admin-Passwort: im Profil oder mit sudo ironflock appliance reset-admin-password (siehe Lokaler Betrieb).
  • HTTPS-Zertifikat: Ihr eigenes Zertifikat mit sudo ironflock appliance configure --tls-cert <file> --tls-key <file> (siehe HTTPS & Zertifikate). Ein Zertifikat der eigenen CA der Appliance erneuert sich selbst: Eine wöchentliche Prüfung signiert ein neues, wenn weniger als 30 Tage verbleiben.
  • Instanzschlüssel: im Lizenzbereich des Admin-Profils oder mit sudo ironflock appliance configure --license-file <file>, wobei die Datei den neuen Schlüssel enthält. Der neue Schlüssel muss die IronFlock-Registry öffnen, bevor er geschrieben wird.
  • SMTP-Zugangsdaten: in .env, anschließend Neustart mit sudo ironflock appliance restart.
  • Proxy: mit sudo ironflock appliance configure (siehe Hinter einem Unternehmens-Proxy).
  • Interne Secrets der Dienste: sudo ironflock appliance rotate <NAME>, siehe unten.

Ein internes Secret rotieren

sudo ironflock appliance rotate <NAME> gibt einem Secret der .env einen neuen Wert, während die Appliance läuft. Der neue Wert kommt zuerst dorthin, wo der alte hinterlegt ist (eine Datenbankrolle, die Gerätedatei des Agenten, das Token-Schlüsselpaar der Registry), dann in die .env. Nur die Dienste, die das Secret lesen, werden neu erstellt, und der Befehl prüft, dass sie gesund sind. Die .env vor der Änderung bleibt als .env.prev erhalten, und rotation.log listet jede Rotation auf, nie einen Wert. ironflock appliance rotate --help listet die Namen auf, die er rotieren kann. Siehe ironflock appliance rotate.

Führen Sie Rotationen über SSH oder an der Konsole der Appliance aus, nicht im Terminal des eigenen Geräts der Appliance in IronFlock: Eine Rotation, die die Dienste neu startet, von denen dieses Terminal abhängt, unterbricht es.

SecretsWas eine Rotation bewirkt
WAMP_SECRET_SVC_*, WAMP_SYSTEM_SECRET und die anderen Secrets der DiensteDie Dienste, die es verwenden, starten neu; ihre Verbindungen bestehen innerhalb von Sekunden wieder.
KRATOS_SECRETS_COOKIENeue Anmeldungen verwenden den neuen Schlüssel; vorher begonnene Sitzungen bleiben gültig, weil der vorherige Schlüssel bis zur nächsten Rotation erhalten bleibt.
POSTGRES_PASSWORD, PGPASSWORD_*, DATASERVICE_PASSWORDDie Datenbankrolle erhält das neue Passwort, danach starten ihre Dienste neu. Fragt vorher; --yes antwortet.
REGISTRY_TOKEN_KEYTokens für App-Image-Abrufe werden mit einem neuen Schlüssel signiert; vorher signierte Tokens bleiben bis zur nächsten Rotation gültig. Fragt vorher; --yes antwortet.
APPLIANCE_DEVICE_SECRETDas eigene Gerät der Appliance erhält neue Zugangsdaten; sein Agent startet neu und ist innerhalb einer Minute wieder online. Fragt vorher; --yes antwortet.
FILE_CRED_KEYDie Apps behalten ihre Dateien; ihr Zugriff auf den Speicher wechselt auf den neuen Schlüssel. Für die direkten S3-Zugangsdaten der Apps wählen Sie --keep-direct-access oder --revoke-direct-access. Behaltene Zugangsdaten funktionieren weiter, für eine planmäßige Rotation: Wer den vorherigen Schlüssel kennt, kann sie weiterhin ableiten. Deshalb markieren die Speichereinstellungen jeder App sie zum Ersetzen, und sudo ironflock appliance revoke-direct-access entfernt später die übrigen. Widerrufene Zugangsdaten funktionieren sofort nicht mehr und werden entfernt, etwa nach einem vermuteten Leck. Fragt vorher (--yes antwortet) und erfordert Appliance-Version 1.6.23 oder neuer.
APPLIANCE_ADMIN_PASSWORDEin neues initiales Admin-Passwort, wie mit ironflock appliance reset-admin-password.

Rotieren Sie FLEETDB_SECRET_KEYS, KRATOS_SECRETS_CIPHER und die beiden OBJECTSTORE_ADMIN_*-Schlüssel nur gemeinsam mit dem IronFlock-Team: Damit gespeicherte Daten hängen von ihnen ab. Der Instanzschlüssel wird im Admin-Profil oder mit ironflock appliance configure geändert, nicht mit rotate.

Ausgehende Verbindungen und Telemetrie

Die Ziele, mit denen sich die Appliance verbindet, sind unter Firewall-Konfiguration aufgeführt; alle diese Verbindungen sind verschlüsselt.

  • Die Lizenzvalidierung sendet den Lizenzschlüssel, einen Fingerabdruck der Hardware und die Zugriffstokens der Verbindungen der Appliance zum Online App Store.
  • Der KI-Assistent sendet Prompts über das LLM-Gateway von IronFlock, sofern Sie kein eigenes Gateway konfigurieren.
  • Keine Telemetrie. Die Appliance sendet keine Nutzungsanalysen: Weder die Appliance-UI noch ihre Dienste melden Nutzungsdaten an IronFlock oder Dritte.
  • Aus dem Browser des Benutzers: Kartenkacheln werden von Mapbox geladen, und die Spracheingabe nutzt den Spracherkennungsdienst Deepgram. Diese Verbindungen baut der Browser auf, nicht die Appliance.

Updates

  • Appliance-Updates werden vom Admin gestartet (siehe Wartung) und sind von IronFlock signiert. ironflock prüft die Liste der verfügbaren Versionen und das Release-Manifest der neuen Version gegen den Appliance-Release-Schlüssel, den es mitbringt, dann jede Datei der neuen Version und jedes Container-Image gegen dieses Manifest. Eine veränderte oder unsignierte Datei oder ein anderes als das veröffentlichte Image bricht das Update ab, bevor sich auf der Appliance etwas ändert. Ein Update stuft die Appliance nie von sich aus auf eine ältere Version zurück, und wenn ein Update fehlschlägt, kehrt die Appliance zu der Version zurück, mit der sie vorher lief.
  • Updates des Geräte-Agenten sind signiert. Jeder Agent prüft die Signatur, bevor er ein Update anwendet, und rollt zurück, wenn die neue Version nicht startet — siehe Updates des Geräte-Agenten.
  • Das Betriebssystem des Hosts liegt in Ihrer Verantwortung, einschließlich Docker.

ironflock vor der ersten Installation prüfen

Jedes Update prüft die Appliance selbst: ironflock prüft jedes Release der Appliance gegen den Appliance-Release-Schlüssel von IronFlock, den es mitbringt, bevor es dieses installiert. Worauf Sie vertrauen, ist das Installationsskript von ironflock, das als root läuft. Prüfen Sie es, bevor es läuft, wie unter Das Installationsskript vorher prüfen beschrieben: gpg muss eine gültige Signatur des IronFlock-Bootstrap-Schlüssels mit dem Fingerabdruck F6C9 4D96 CE31 5377 ACA7 C8EA 4990 5433 7321 2788 melden. Das Skript prüft seinerseits ironflock gegen diesen Schlüssel, bevor es das Programm installiert. Beide Schlüssel sind unter Signaturschlüssel aufgeführt.

Backup und Wiederherstellung

Um die ganze Appliance zu sichern, stoppen Sie sie mit sudo ironflock appliance stop und kopieren:

  • den Ordner /opt/ironflock/, einschließlich .env, license.env, certs/ und registry-token-certs/;
  • die Docker-Volumes der Appliance (docker volume ls), die die Datenbanken, Dateien, den local App Store und die Benutzerdateien enthalten.

Starten Sie sie danach wieder mit sudo ironflock appliance start. Bewahren Sie .env zusammen mit den Volumes desselben Zeitpunkts auf: Die verschlüsselten Daten in den Volumes lassen sich nur mit den Schlüsseln in dieser .env lesen.

Die Secrets allein lassen sich sichern, während die Appliance läuft:

sudo ironflock appliance backup -o /root/appliance-secrets.tar.gz

Das Archiv enthält .env, license.env, die CA, die Registry-Token-Schlüssel, das Verzeichnis der Secrets und rotation.log; nur root kann die Datei lesen. Ein verlorener FLEETDB_SECRET_KEYS oder FILE_CRED_KEY lässt sich auf keinem anderen Weg wiederherstellen: Verschlüsseln Sie das Archiv und bewahren Sie es bei den Volume-Backups auf.

Um die Secrets auf einer installierten Appliance zurückzuspielen, stellen Sie sie mit --force wieder her, während sie läuft, und starten Sie sie dann neu, damit jeder Dienst die wiederhergestellten Dateien liest:

sudo ironflock appliance restore appliance-secrets.tar.gz --force sudo ironflock appliance restart

Die .env der Appliance vor der Wiederherstellung bleibt als .env.prev erhalten. Auf einer neuen Maschine installieren Sie ironflock, führen sudo ironflock appliance restore appliance-secrets.tar.gz aus und installieren die Appliance dann wie gewohnt, mit dem Instanzschlüssel und den bisherigen Optionen, etwa --tls. Siehe ironflock appliance backup und ironflock appliance restore.

Außerbetriebnahme

  1. Ziehen Sie die Lizenz um oder geben Sie sie frei, solange die Appliance noch online ist — siehe Lizenz auf neue Hardware umziehen.

  2. Entfernen Sie die Software:

    sudo ironflock appliance remove --purge sudo ironflock agent remove

    ironflock appliance remove --purge entfernt die Dienste, Container und das Netzwerk der Appliance, die Anmeldung von Docker an der IronFlock-Registry, die Änderungen, die ihre Installation am Host vorgenommen hat, und mit --purge auch ihre Daten: das Installationsverzeichnis /opt/ironflock mit .env und license.env, die Docker-Volumes und die Images. ironflock agent remove entfernt danach den eigenen Geräte-Agenten der Appliance. Jeder Befehl listet auf, was er entfernt, und fragt vorher; --yes antwortet. Docker selbst bleibt installiert, ebenso ironflock in /usr/local/bin. Siehe ironflock appliance remove und ironflock agent remove.

  3. Verlässt die Hardware Ihr Gelände, löschen Sie ihre Festplatte sicher — die obigen Befehle löschen Dateien, überschreiben sie aber nicht.

Einstellungen, die die Sicherheit schwächen

Einige Einstellungen gibt es nur zur Fehlersuche. Lassen Sie sie im Produktivbetrieb ungesetzt:

  • AGENT_UPDATE_ALLOW_UNSIGNED — erlaubt einem Geräte-Agenten, unsignierte Updates anzuwenden. Er wirkt nur als until=<time> höchstens 24 Stunden im Voraus und läuft danach von selbst ab.
  • TUNNEL_AUTHZ_ENFORCE=false — erlaubt Geräten, Tunnel zu öffnen, ohne ihre Identität nachzuweisen.
  • ?tls.rejectUnauthorized=false in SMTP_CONNECTION_URI — akzeptiert jedes Zertifikat Ihres Mailservers.
  • --2fa available — zweite Faktoren werden nie abgefragt.
Last updated on