Skip to Content

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 CAHTTPS z twoim firmowym certyfikatem
Przeglądarka do ApplianceNieszyfrowaneHTTPSHTTPS
Ciasteczka logowaniaNieoznaczone jako secureSecureSecure
Łącze urządzenia (port 18080)NieszyfrowaneNieszyfrowaneHTTPS na 443
Obrazy aplikacji i aktualizacje agenta dla urządzeńNieszyfrowaneNieszyfrowaneHTTPS na 443
Tunel zdalnego dostępu urządzeńSzyfrowany, serwer niezweryfikowanySzyfrowany, serwer niezweryfikowanySzyfrowany i zweryfikowany
Passkeys i klucze bezpieczeństwaTylko z samego ApplianceTakTak

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 18080 jest 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ńcuchu DOCKER-USER lub 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ź ironflock przed pierwszą instalacją (zobacz Sprawdź ironflock przed pierwszą instalacją).

Konta i dostęp

  • Konto administratora: każdy Appliance otrzymuje przy instalacji własne hasło administratora; ironflock appliance install pokazuje 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 --2fa polecenia ironflock appliance install lub ironflock appliance configure ustawia 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/:

PlikZawartośćDostęp
.envHasła i klucze wszystkich usług, początkowe hasło administratora, poświadczenia proxy i SMTPTylko root (0600)
license.envKlucz instancji oraz to, co zapisuje z nim weryfikacja licencjiRoot i usługi IronFlock (0640)
certs/Certyfikat HTTPS i jego klucz; z samodzielnie wystawionym CA także klucz CAKlucze prywatne tylko root (0600)
registry-token-certs/Klucz podpisujący tokeny pobierania obrazów aplikacjiTylko usługa rejestru (0600)
.env.prev, rotation.log.env sprzed ostatniej rotacji; który sekret i kiedy poddano rotacji, bez wartościTylko 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 poleceniem sudo 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.

SekretyCo robi rotacja
WAMP_SECRET_SVC_*, WAMP_SYSTEM_SECRET i pozostałe sekrety usługUsługi, które z niego korzystają, są restartowane; ich połączenia wracają w ciągu kilku sekund.
KRATOS_SECRETS_COOKIENowe 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_PASSWORDRola bazy danych otrzymuje nowe hasło, a następnie jej usługi są restartowane. Najpierw pyta; --yes odpowiada.
REGISTRY_TOKEN_KEYTokeny 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_SECRETUrzą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_KEYAplikacje 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_PASSWORDNowe 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. ironflock sprawdza 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/ i registry-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.gz

Archiwum 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

  1. Przenieś lub zwolnij licencję, póki Appliance jest jeszcze online — zobacz Przenoszenie licencji na nowy sprzęt.

  2. Usuń oprogramowanie:

    sudo ironflock appliance remove --purge sudo ironflock agent remove

    ironflock appliance remove --purge usuwa usługi, kontenery i sieć Appliance, logowanie Dockera do rejestru IronFlock, zmiany wprowadzone na hoście przez jego instalację, a z --purge także jego dane: katalog instalacji /opt/ironflock z .env i license.env, wolumeny Dockera i obrazy. ironflock agent remove usuwa potem własnego agenta urządzenia Appliance. Każde z tych poleceń wymienia, co usuwa, i najpierw pyta; --yes odpowiada. Sam Docker pozostaje zainstalowany, podobnie jak ironflock w /usr/local/bin. Zobacz ironflock appliance remove i ironflock agent remove.

  3. 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 jako until=<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=false w SMTP_CONNECTION_URI — akceptuje dowolny certyfikat od twojego serwera poczty.
  • --2fa available — o drugi składnik nigdy się nie prosi.
Last updated on