Bezpieczeństwo
Appliance działa na sprzęcie i w sieci, które obsługujesz ty. IronFlock dostarcza oprogramowanie i jego ustawienia domyślne; to, jak dobrze Appliance jest chroniony, zależy także od wybranego trybu, otaczającej go sieci i hosta, na którym działa. Ta strona jest listą kontrolną dla tej części.
Co chroni każdy tryb
Appliance działa w jednym z trzech trybów opisanych w HTTPS i certyfikaty. Różnią się one tym, co jest szyfrowane i weryfikowane:
| Zwykły HTTP (domyślny) | HTTPS z samodzielnie wystawionym CA | HTTPS z twoim firmowym certyfikatem | |
|---|---|---|---|
| Przeglądarka do Appliance | Nieszyfrowane | HTTPS | HTTPS |
| Ciasteczka logowania | Nieoznaczone jako secure | Secure | Secure |
Łącze urządzenia (port 18080) | Nieszyfrowane | Nieszyfrowane | HTTPS na 443 |
| Obrazy aplikacji i aktualizacje agenta dla urządzeń | Nieszyfrowane | Nieszyfrowane | HTTPS na 443 |
| Tunel zdalnego dostępu urządzeń | Szyfrowany, serwer niezweryfikowany | Szyfrowany, serwer niezweryfikowany | Szyfrowany i zweryfikowany |
| Passkeys i klucze bezpieczeństwa | Tylko z samego Appliance | Tak | Tak |
Używaj HTTPS z twoim firmowym certyfikatem wszędzie tam, gdzie Appliance dzieli sieć z innymi systemami. To jedyny tryb, w którym podłączone urządzenia weryfikują, z kim się komunikują. Dwa pozostałe tryby nadają się do segmentu sieci, do którego dostęp mają wyłącznie Appliance, jego urządzenia i jego operatorzy.
Co pozostaje nieszyfrowane
Nawet z HTTPS część ruchu nie jest szyfrowana. Zaplanuj swoją sieć z uwzględnieniem tego:
- Łącze urządzenia na porcie
18080jest publikowane na każdym interfejsie sieciowym w każdym trybie. Łączą się z nim agent urządzenia samego Appliance i aplikacje działające na Appliance, a w trybie zwykłym i z samodzielnie wystawionym CA także wszystkie podłączone urządzenia. - Tunele zdalnego dostępu do Appliance (port
7000) są szyfrowane w trybie zwykłym i z samodzielnie wystawionym CA, ale urządzenia nie mogą sprawdzić certyfikatu Appliance. Ktoś z dostępem do ścieżki sieciowej mógłby podszyć się pod serwer tuneli Appliance. Agenci urządzeń zapisują w logu ostrzeżenie, gdy łączą się w ten sposób. - Połączenia między usługami wewnątrz Appliance, na przykład z jego bazami danych, nie są szyfrowane. Nie opuszczają one hosta.
- Dane w spoczynku nie są szyfrowane przez Appliance. Użyj szyfrowania systemu operacyjnego hosta lub dysku, jeśli Appliance przechowuje wrażliwe dane albo może opuścić twoją siedzibę.
Lista kontrolna zabezpieczeń
- Wybierz tryb pasujący do twojej sieci (zobacz Co chroni każdy tryb).
- Ogranicz, kto może dotrzeć do portów Appliance. Instalacja niczego nie otwiera w twojej zaporze, a Docker publikuje porty Appliance z pominięciem zwykłych reguł wejściowych zapory hosta (
ufw,firewalld). Filtruj w łańcuchuDOCKER-USERlub na zaporze sieciowej: instalacja zostawia szablon w/opt/ironflock/docker-user-firewall.sh.example. Zezwalaj na porty urządzeń (18080,15001,15002,7000,30000–30049) wyłącznie z sieci urządzeń — zobacz Urządzenia łączące się z Appliance. - Aktualizuj system operacyjny hosta i ogranicz, kto ma na nim konto. Każdy z dostępem root do hosta może odczytać wszystkie sekrety Appliance.
- Używaj kluczy SSH zamiast haseł do dostępu administracyjnego do hosta.
- Skonfiguruj synchronizację czasu — zobacz Synchronizacja czasu (NTP).
- Zmień hasło administratora po pierwszym logowaniu i skonfiguruj drugi składnik dla konta administratora.
- Wymagaj drugiego składnika od wszystkich, gdy wszystkie konta już go mają (zobacz Konta i dostęp).
- Chroń konto ironflock.com, do którego należy instancja, drugim składnikiem: ma ono z chmury dostęp administratora do Appliance.
- Wyłącz połączenie z chmurą, jeśli nikt nie musi pracować na Appliance z ironflock.com (zobacz Połączenie z chmurą).
- Instaluj tylko aplikacje, którym ufasz. Aplikacje działają na Appliance i na twoich urządzeniach z szerokim dostępem do hosta, w tym do plików konfiguracyjnych Appliance.
- Aktualizuj Appliance (zobacz Aktualizacje).
- Sprawdź
ironflockprzed pierwszą instalacją (zobacz Sprawdźironflockprzed pierwszą instalacją).
Konta i dostęp
- Konto administratora: każdy Appliance otrzymuje przy instalacji własne hasło administratora;
ironflock appliance installpokazuje je jeden raz. Jeśli zostanie utracone, ustaw nowe zgodnie z opisem w Praca lokalna — wylogowuje to także wszystkie sesje administratora. - Nowi użytkownicy mogą się zarejestrować wyłącznie z zaproszeniem z projektu na Appliance. Bez zaproszenia rejestracja jest odrzucana, również przez logowanie społecznościowe.
- Drugi składnik: użytkownicy mogą skonfigurować aplikację uwierzytelniającą (TOTP), passkeys lub klucze bezpieczeństwa oraz kody odzyskiwania. Passkeys i klucze bezpieczeństwa wymagają HTTPS. Opcja
--2fapoleceniaironflock appliance installlubironflock appliance configureustawia zasadę, która pozostaje ustawiona po aktualizacjach:available— użytkownicy mogą skonfigurować drugi składnik, ale nigdy nie są o niego proszeni.effective(domyślnie) — użytkownicy, którzy mają drugi składnik, muszą go używać.required— każdy użytkownik musi używać drugiego składnika. Najpierw upewnij się, że każde konto go ma: użytkownik bez niego nie może się już zalogować.
- Sesje trwają 24 godziny.
- Dostęp z ironflock.com: konto ironflock.com, które utworzyło klucz instancji, jest połączone z kontem administratora Appliance. Zaproszeni przez ciebie użytkownicy łączą własne konta ironflock.com — zobacz Powiązanie kont. Użytkownik może w każdej chwili usunąć to połączenie. Aby zablokować wszelki dostęp z ironflock.com, administrator wyłącza połączenie z chmurą.
Sekrety na hoście
ironflock appliance install generuje sekrety Appliance jeden raz, podczas instalacji, i zachowuje je po aktualizacjach. Znajdują się one w /opt/ironflock/:
| Plik | Zawartość | Dostęp |
|---|---|---|
.env | Hasła i klucze wszystkich usług, początkowe hasło administratora, poświadczenia proxy i SMTP | Tylko root (0600) |
license.env | Klucz instancji oraz to, co zapisuje z nim weryfikacja licencji | Root i usługi IronFlock (0640) |
certs/ | Certyfikat HTTPS i jego klucz; z samodzielnie wystawionym CA także klucz CA | Klucze prywatne tylko root (0600) |
registry-token-certs/ | Klucz podpisujący tokeny pobierania obrazów aplikacji | Tylko usługa rejestru (0600) |
.env.prev, rotation.log | .env sprzed ostatniej rotacji; który sekret i kiedy poddano rotacji, bez wartości | Tylko root (0600) |
Instalacja loguje też Dockera do rejestru IronFlock twoim kluczem instancji, więc konfiguracja Dockera użytkownika root również go zawiera.
Uwzględnij te pliki w kopiach zapasowych i chroń kopie zapasowe tak jak sam Appliance. Nigdy nie usuwaj .env ani nie pozwalaj, by instalacja wygenerowała go ponownie: bazy danych i zaszyfrowane dane zależą od jego wartości. Aby wymienić sekret, przeprowadź jego rotację.
Co możesz wymienić samodzielnie:
- Hasło administratora: w profilu lub poleceniem
sudo ironflock appliance reset-admin-password(zobacz Praca lokalna). - Certyfikat HTTPS: własny certyfikat poleceniem
sudo ironflock appliance configure --tls-cert <file> --tls-key <file>(zobacz HTTPS i certyfikaty). Certyfikat z własnego CA Appliance odnawia się sam: cotygodniowe sprawdzenie podpisuje nowy, gdy do wygaśnięcia zostaje mniej niż 30 dni. - Klucz instancji: w sekcji licencji w profilu administratora lub poleceniem
sudo ironflock appliance configure --license-file <file>, gdzie plik zawiera nowy klucz. Nowy klucz musi otworzyć rejestr IronFlock, zanim zostanie zapisany. - Poświadczenia SMTP: w
.env, a następnie zrestartuj poleceniemsudo ironflock appliance restart. - Proxy: poleceniem
sudo ironflock appliance configure(zobacz Za firmowym proxy). - Wewnętrzne sekrety usług:
sudo ironflock appliance rotate <NAME>, zobacz niżej.
Rotacja wewnętrznego sekretu
sudo ironflock appliance rotate <NAME> nadaje jednemu sekretowi z .env nową wartość podczas działania Appliance. Nowa wartość trafia najpierw tam, gdzie przechowywana jest stara (rola bazy danych, plik urządzenia agenta, para kluczy tokenów rejestru), a potem do .env. Odtwarzane są tylko usługi, które odczytują ten sekret, a polecenie sprawdza, czy są sprawne. .env sprzed zmiany pozostaje jako .env.prev, a rotation.log wymienia każdą rotację, nigdy wartość. ironflock appliance rotate --help wyświetla nazwy, które polecenie może poddać rotacji. Zobacz ironflock appliance rotate.
Przeprowadzaj rotacje przez SSH lub na konsoli Appliance, a nie w terminalu urządzenia samego Appliance w IronFlock: rotacja, która restartuje usługi, od których zależy ten terminal, przerywa go.
| Sekrety | Co robi rotacja |
|---|---|
WAMP_SECRET_SVC_*, WAMP_SYSTEM_SECRET i pozostałe sekrety usług | Usługi, które z niego korzystają, są restartowane; ich połączenia wracają w ciągu kilku sekund. |
KRATOS_SECRETS_COOKIE | Nowe logowania używają nowego klucza; sesje zalogowane wcześniej pozostają ważne, ponieważ poprzedni klucz jest zachowywany do następnej rotacji. |
POSTGRES_PASSWORD, PGPASSWORD_*, DATASERVICE_PASSWORD | Rola bazy danych otrzymuje nowe hasło, a następnie jej usługi są restartowane. Najpierw pyta; --yes odpowiada. |
REGISTRY_TOKEN_KEY | Tokeny pobierania obrazów aplikacji są podpisywane nowym kluczem; tokeny podpisane wcześniej pozostają ważne do następnej rotacji. Najpierw pyta; --yes odpowiada. |
APPLIANCE_DEVICE_SECRET | Urządzenie samego Appliance otrzymuje nowe poświadczenie; jego agent jest restartowany i w ciągu minuty znów jest online. Najpierw pyta; --yes odpowiada. |
FILE_CRED_KEY | Aplikacje zachowują swoje pliki; ich dostęp do magazynu przechodzi na nowy klucz. Dla bezpośrednich poświadczeń S3 aplikacji wybierz --keep-direct-access albo --revoke-direct-access. Zachowane poświadczenia działają dalej, przy planowej rotacji: kto zna poprzedni klucz, nadal może je wyprowadzić, dlatego ustawienia magazynu każdej aplikacji oznaczają je do wymiany, a sudo ironflock appliance revoke-direct-access usuwa później pozostałe. Unieważnione poświadczenia od razu przestają działać i są usuwane, na przykład po podejrzeniu wycieku. Najpierw pyta (--yes odpowiada) i wymaga Appliance w wersji 1.6.23 lub nowszej. |
APPLIANCE_ADMIN_PASSWORD | Nowe początkowe hasło administratora, tak samo jak ironflock appliance reset-admin-password. |
Rotację FLEETDB_SECRET_KEYS, KRATOS_SECRETS_CIPHER i dwóch kluczy OBJECTSTORE_ADMIN_* przeprowadzaj wyłącznie wspólnie z zespołem IronFlock: zależą od nich dane zapisane z ich użyciem. Klucz instancji zmienia się w profilu administratora lub poleceniem ironflock appliance configure, a nie za pomocą rotate.
Połączenia wychodzące i telemetria
Miejsca docelowe, z którymi łączy się Appliance, są wymienione w Konfiguracja zapory sieciowej; wszystkie te połączenia są szyfrowane.
- Weryfikacja licencji wysyła klucz licencyjny, odcisk sprzętu oraz tokeny dostępu połączeń Appliance z App Store online.
- Asystent AI wysyła prompty przez bramę LLM IronFlock, chyba że skonfigurujesz własną bramę.
- Brak telemetrii. Appliance nie wysyła analityki użycia: ani interfejs Appliance, ani jego usługi nie raportują użycia do IronFlock ani do stron trzecich.
- Z przeglądarki użytkownika: kafelki map są ładowane z Mapbox, a wprowadzanie głosowe korzysta z usługi rozpoznawania mowy Deepgram. Te połączenia nawiązuje przeglądarka, nie Appliance.
Aktualizacje
- Aktualizacje Appliance uruchamia administrator (zobacz Utrzymanie), a podpisuje je IronFlock.
ironflocksprawdza listę dostępnych wersji i manifest wydania nowej wersji kluczem wydań appliance, który zawiera, a następnie porównuje z tym manifestem każdy plik nowej wersji i każdy obraz kontenera. Zmieniony lub niepodpisany plik albo jakikolwiek obraz inny niż wydany zatrzymuje aktualizację, zanim cokolwiek zmieni się na Appliance. Aktualizacja nigdy sama nie przenosi Appliance do starszej wersji, a jeśli aktualizacja się nie powiedzie, Appliance wraca do wersji, na której działał wcześniej. - Aktualizacje agenta urządzeń są podpisane. Każdy agent sprawdza podpis przed zastosowaniem aktualizacji i wycofuje zmiany, jeśli nowa wersja się nie uruchomi — zobacz Aktualizacje agenta urządzeń.
- System operacyjny hosta, łącznie z Dockerem, jest twoją odpowiedzialnością.
Sprawdź ironflock przed pierwszą instalacją
Appliance sam sprawdza każdą aktualizację: ironflock sprawdza każde wydanie Appliance kluczem wydań IronFlock Appliance, który zawiera, zanim je zainstaluje. Zaufać musisz skryptowi instalacyjnemu ironflock, który działa jako root. Sprawdź go przed uruchomieniem, jak opisuje sekcja Najpierw zweryfikuj skrypt instalacyjny: gpg musi zgłosić prawidłowy podpis kluczem IronFlock Bootstrap z odciskiem F6C9 4D96 CE31 5377 ACA7 C8EA 4990 5433 7321 2788. Skrypt z kolei sprawdza ironflock tym kluczem, zanim go zainstaluje. Oba klucze wymienia strona Klucze podpisujące.
Kopia zapasowa i przywracanie
Aby wykonać kopię zapasową całego Appliance, zatrzymaj go poleceniem sudo ironflock appliance stop i skopiuj:
- folder
/opt/ironflock/, łącznie z.env,license.env,certs/iregistry-token-certs/; - wolumeny Dockera Appliance (
docker volume ls), które zawierają bazy danych, pliki, lokalny App Store i pliki użytkowników.
Następnie uruchom go ponownie poleceniem sudo ironflock appliance start. Przechowuj .env razem z wolumenami z tego samego momentu: zaszyfrowane dane w wolumenach można odczytać wyłącznie kluczami z tego .env.
Same sekrety można zapisać podczas działania Appliance:
sudo ironflock appliance backup -o /root/appliance-secrets.tar.gzArchiwum zawiera .env, license.env, CA, klucze tokenów rejestru, spis sekretów i rotation.log; plik może odczytać tylko root. Utraconego FLEETDB_SECRET_KEYS ani FILE_CRED_KEY nie da się odzyskać w żaden inny sposób: zaszyfruj archiwum i przechowuj je razem z kopiami zapasowymi wolumenów.
Aby przywrócić sekrety na zainstalowanym Appliance, przywróć je z --force podczas jego działania, a potem zrestartuj go, aby każda usługa odczytała przywrócone pliki:
sudo ironflock appliance restore appliance-secrets.tar.gz --force
sudo ironflock appliance restart.env Appliance sprzed przywrócenia pozostaje jako .env.prev. Na nowej maszynie zainstaluj ironflock, uruchom sudo ironflock appliance restore appliance-secrets.tar.gz, a następnie zainstaluj Appliance jak zwykle, z kluczem instancji i dotychczasowymi opcjami, na przykład --tls. Zobacz ironflock appliance backup i ironflock appliance restore.
Wycofanie z eksploatacji
-
Przenieś lub zwolnij licencję, póki Appliance jest jeszcze online — zobacz Przenoszenie licencji na nowy sprzęt.
-
Usuń oprogramowanie:
sudo ironflock appliance remove --purge sudo ironflock agent removeironflock appliance remove --purgeusuwa usługi, kontenery i sieć Appliance, logowanie Dockera do rejestru IronFlock, zmiany wprowadzone na hoście przez jego instalację, a z--purgetakże jego dane: katalog instalacji/opt/ironflockz.envilicense.env, wolumeny Dockera i obrazy.ironflock agent removeusuwa potem własnego agenta urządzenia Appliance. Każde z tych poleceń wymienia, co usuwa, i najpierw pyta;--yesodpowiada. Sam Docker pozostaje zainstalowany, podobnie jakironflockw/usr/local/bin. Zobaczironflock appliance removeiironflock agent remove. -
Jeśli sprzęt opuszcza twoją siedzibę, wymaż jego dysk — powyższe polecenia usuwają pliki, ale ich nie nadpisują.
Ustawienia osłabiające bezpieczeństwo
Niektóre ustawienia istnieją wyłącznie do rozwiązywania problemów. W środowisku produkcyjnym pozostaw je nieustawione:
AGENT_UPDATE_ALLOW_UNSIGNED— pozwala agentowi urządzenia stosować niepodpisane aktualizacje. Działa tylko jakountil=<time>, najwyżej 24 godziny naprzód, a potem sam wygasa.TUNNEL_AUTHZ_ENFORCE=false— pozwala urządzeniom otwierać tunele bez potwierdzania swojej tożsamości.?tls.rejectUnauthorized=falsewSMTP_CONNECTION_URI— akceptuje dowolny certyfikat od twojego serwera poczty.--2fa available— o drugi składnik nigdy się nie prosi.