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 CA | HTTPS mit Ihrem Unternehmenszertifikat | |
|---|---|---|---|
| Browser zur Appliance | Unverschlüsselt | HTTPS | HTTPS |
| Login-Cookies | Nicht als sicher markiert | Sicher | Sicher |
Geräteverbindung (Port 18080) | Unverschlüsselt | Unverschlüsselt | HTTPS auf 443 |
| App-Images und Agent-Updates für Geräte | Unverschlüsselt | Unverschlüsselt | HTTPS auf 443 |
| Fernzugriffs-Tunnel der Geräte | Verschlüsselt, Server nicht überprüft | Verschlüsselt, Server nicht überprüft | Verschlüsselt und überprüft |
| Passkeys und Sicherheitsschlüssel | Nur von der Appliance selbst aus | Ja | Ja |
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
18080wird 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 ChainDOCKER-USERoder an Ihrer Netzwerk-Firewall: Die Installation legt dafür eine Vorlage unter/opt/ironflock/docker-user-firewall.sh.exampleab. 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
ironflockvor der ersten Installation (sieheironflockvor der ersten Installation prüfen).
Konten und Zugriff
- Admin-Konto: Jede Appliance erhält bei der Installation ihr eigenes Admin-Passwort;
ironflock appliance installzeigt 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
--2favonironflock appliance installoderironflock appliance configurelegt 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/:
| Datei | Inhalt | Zugriff |
|---|---|---|
.env | Passwörter und Schlüssel aller Dienste, das initiale Admin-Passwort, Proxy- und SMTP-Zugangsdaten | Nur root (0600) |
license.env | Der Instanzschlüssel und was die Lizenzvalidierung dazu speichert | root und die IronFlock-Dienste (0640) |
certs/ | Das HTTPS-Zertifikat und sein Schlüssel; bei einer selbst ausgestellten CA auch der Schlüssel der CA | Private Schlüssel nur root (0600) |
registry-token-certs/ | Der Schlüssel, der die Tokens für App-Image-Abrufe signiert | Nur der Registry-Dienst (0600) |
.env.prev, rotation.log | Die .env vor der letzten Rotation; wann welches Secret rotiert wurde, ohne Werte | Nur 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 mitsudo 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.
| Secrets | Was eine Rotation bewirkt |
|---|---|
WAMP_SECRET_SVC_*, WAMP_SYSTEM_SECRET und die anderen Secrets der Dienste | Die Dienste, die es verwenden, starten neu; ihre Verbindungen bestehen innerhalb von Sekunden wieder. |
KRATOS_SECRETS_COOKIE | Neue 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_PASSWORD | Die Datenbankrolle erhält das neue Passwort, danach starten ihre Dienste neu. Fragt vorher; --yes antwortet. |
REGISTRY_TOKEN_KEY | Tokens 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_SECRET | Das 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_KEY | Die 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_PASSWORD | Ein 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.
ironflockprü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/undregistry-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.gzDas 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 restartDie .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
-
Ziehen Sie die Lizenz um oder geben Sie sie frei, solange die Appliance noch online ist — siehe Lizenz auf neue Hardware umziehen.
-
Entfernen Sie die Software:
sudo ironflock appliance remove --purge sudo ironflock agent removeironflock appliance remove --purgeentfernt 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--purgeauch ihre Daten: das Installationsverzeichnis/opt/ironflockmit.envundlicense.env, die Docker-Volumes und die Images.ironflock agent removeentfernt danach den eigenen Geräte-Agenten der Appliance. Jeder Befehl listet auf, was er entfernt, und fragt vorher;--yesantwortet. Docker selbst bleibt installiert, ebensoironflockin/usr/local/bin. Sieheironflock appliance removeundironflock agent remove. -
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 alsuntil=<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=falseinSMTP_CONNECTION_URI— akzeptiert jedes Zertifikat Ihres Mailservers.--2fa available— zweite Faktoren werden nie abgefragt.