Güvenlik
Appliance, sizin işlettiğiniz donanım üzerinde ve sizin işlettiğiniz bir ağda çalışır. IronFlock yazılımı ve varsayılan ayarlarını sağlar; Appliance’ın ne kadar iyi korunduğu ise seçtiğiniz moda, çevresindeki ağa ve üzerinde çalıştığı ana makineye de bağlıdır. Bu sayfa, o kısım için kontrol listesidir.
Her Modun Neyi Koruduğu
Appliance, HTTPS ve Sertifikalar sayfasında açıklanan üç moddan birinde çalışır. Bu modlar neyin şifrelendiği ve doğrulandığı konusunda farklılık gösterir:
| Düz HTTP (varsayılan) | Kendinden imzalı bir CA ile HTTPS | Kurumsal sertifikanızla HTTPS | |
|---|---|---|---|
| Tarayıcıdan Appliance’a | Şifresiz | HTTPS | HTTPS |
| Oturum açma çerezleri | Secure olarak işaretlenmemiş | Secure | Secure |
Cihaz bağlantısı (port 18080) | Şifresiz | Şifresiz | 443 üzerinde HTTPS |
| Cihazlar için uygulama görüntüleri ve aracı güncellemeleri | Şifresiz | Şifresiz | 443 üzerinde HTTPS |
| Cihazların uzaktan erişim tüneli | Şifreli, sunucu doğrulanmaz | Şifreli, sunucu doğrulanmaz | Şifreli ve doğrulanmış |
| Passkey’ler ve güvenlik anahtarları | Yalnızca Appliance’ın kendisinden | Evet | Evet |
Appliance’ın başka sistemlerle bir ağı paylaştığı her yerde kurumsal sertifikanızla HTTPS kullanın. Bağlı cihazların kiminle konuştuklarını doğruladığı tek mod budur. Diğer iki mod, yalnızca Appliance’ın, cihazlarının ve operatörlerinin erişebildiği bir ağ bölümü için uygundur.
Neyin Şifrelenmeden Kaldığı
HTTPS ile bile bazı trafik şifrelenmez. Ağınızı buna göre planlayın:
- Port
18080üzerindeki cihaz bağlantısı her modda her ağ arayüzünde yayımlanır. Appliance’ın kendi cihaz aracısı ve Appliance üzerinde çalışan uygulamalar buna bağlanır; düz modda ve kendinden imzalı bir CA ile tüm bağlı cihazlar da bağlanır. - Appliance’a giden uzaktan erişim tünelleri (port
7000) düz modda ve kendinden imzalı bir CA ile şifrelenir, ancak cihazlar Appliance’ın sertifikasını denetleyemez. Ağ yoluna erişimi olan biri kendini Appliance’ın tünel sunucusu olarak gösterebilir. Cihaz aracıları bu şekilde bağlandıklarında günlüğe bir uyarı yazar. - Appliance içindeki hizmetler arasındaki bağlantılar, örneğin veritabanlarına olanlar, şifrelenmez. Bu bağlantılar ana makineden dışarı çıkmaz.
- Bekleyen veriler Appliance tarafından şifrelenmez. Appliance hassas veriler depoluyorsa veya tesislerinizden çıkabilecekse, ana makinenin işletim sisteminin ya da diskin şifrelemesini kullanın.
Sağlamlaştırma Kontrol Listesi
- Ağınıza uyan modu seçin (bkz. Her Modun Neyi Koruduğu).
- Appliance’ın portlarına kimlerin erişebileceğini kısıtlayın. Kurulum güvenlik duvarınızda hiçbir şey açmaz ve Docker, Appliance’ın portlarını ana makine güvenlik duvarının olağan giriş kurallarını (
ufw,firewalld) atlayarak yayımlar. FiltrelemeyiDOCKER-USERzincirinde veya ağ güvenlik duvarınızda yapın: kurulum/opt/ironflock/docker-user-firewall.sh.examplekonumunda bir şablon bırakır. Cihaz portlarına (18080,15001,15002,7000,30000–30049) yalnızca cihaz ağlarınızdan izin verin — bkz. Cihazların Appliance’a Bağlanması. - Ana makinenin işletim sistemini güncel tutun ve üzerinde kimlerin hesabı olduğunu sınırlayın. Ana makinede root erişimi olan herkes Appliance’ın tüm gizli bilgilerini okuyabilir.
- Ana makineye yönetici erişimi için parolalar yerine SSH anahtarları kullanın.
- Saat senkronizasyonunu yapılandırın — bkz. Saat Senkronizasyonu (NTP).
- İlk oturum açmadan sonra yönetici parolasını değiştirin ve yönetici hesabı için ikinci bir faktör ayarlayın.
- Tüm hesaplarda ikinci faktör olduğunda herkes için ikinci faktörü zorunlu kılın (bkz. Hesaplar ve Erişim).
- Örneğin sahibi olan ironflock.com hesabını ikinci bir faktörle koruyun: bu hesabın buluttan Appliance’a yönetici erişimi vardır.
- Appliance üzerinde kimsenin ironflock.com üzerinden çalışması gerekmiyorsa bulut bağlantısını kapatın (bkz. Bulut Bağlantısı).
- Yalnızca güvendiğiniz uygulamaları kurun. Uygulamalar, Appliance üzerinde ve cihazlarınızda, Appliance’ın yapılandırma dosyaları dahil ana makineye geniş erişimle çalışır.
- Appliance’ı güncel tutun (bkz. Güncellemeler).
- İlk kurulumdan önce
ironflockaracını doğrulayın (bkz.ironflockAracını Kurulumdan Önce Doğrulayın).
Hesaplar ve Erişim
- Yönetici hesabı: her Appliance kurulumda kendi yönetici parolasını alır;
ironflock appliance installbunu bir kez gösterir. Kaybolursa, Yerel Çalıştırma bölümünde açıklandığı gibi yeni bir parola belirleyin — bu, tüm yönetici oturumlarını da kapatır. - Yeni kullanıcılar yalnızca Appliance üzerindeki bir projeden gelen davetle kaydolabilir. Davet olmadan kayıt, sosyal oturum açma üzerinden de olsa reddedilir.
- İkinci faktör: kullanıcılar bir kimlik doğrulayıcı uygulama (TOTP), passkey’ler veya güvenlik anahtarları ve kurtarma kodları ayarlayabilir. Passkey’ler ve güvenlik anahtarları HTTPS gerektirir.
ironflock appliance installveyaironflock appliance configurekomutunun--2faseçeneği politikayı belirler ve bu politika güncellemelerden sonra da geçerli kalır:available— kullanıcılar ikinci bir faktör ayarlayabilir, ancak bu faktör kendilerinden hiçbir zaman istenmez.effective(varsayılan) — ikinci faktörü olan kullanıcılar onu kullanmak zorundadır.required— her kullanıcı ikinci bir faktör kullanmak zorundadır. Önce her hesapta bir ikinci faktör olduğundan emin olun: ikinci faktörü olmayan bir kullanıcı artık oturum açamaz.
- Oturumlar 24 saat sürer.
- ironflock.com üzerinden erişim: örnek anahtarını oluşturan ironflock.com hesabı, Appliance’ın yönetici hesabına bağlıdır. Davet ettiğiniz kullanıcılar kendi ironflock.com hesaplarını bağlar — bkz. Hesapları Bağlama. Bir kullanıcı bu bağlantıyı istediği zaman kaldırabilir. ironflock.com üzerinden tüm erişimi durdurmak için yönetici bulut bağlantısını kapatır.
Ana Makinedeki Gizli Bilgiler
ironflock appliance install, Appliance’ın gizli bilgilerini kurulum sırasında bir kez üretir ve güncellemeler boyunca korur. Bunlar /opt/ironflock/ altında bulunur:
| Dosya | İçerik | Erişim |
|---|---|---|
.env | Tüm hizmetlerin parolaları ve anahtarları, ilk yönetici parolası, proxy ve SMTP kimlik bilgileri | Yalnızca root (0600) |
license.env | Örnek anahtarı ve lisans doğrulamasının onunla birlikte sakladıkları | Root ve IronFlock hizmetleri (0640) |
certs/ | HTTPS sertifikası ve anahtarı; kendinden imzalı bir CA ile ayrıca CA’nın anahtarı | Özel anahtarlar yalnızca root (0600) |
registry-token-certs/ | Uygulama görüntüsü çekme tokenlarını imzalayan anahtar | Yalnızca kayıt defteri hizmeti (0600) |
.env.prev, rotation.log | Son rotasyondan önceki .env; hangi gizli bilgi için ne zaman rotasyon yapıldığı, değerler olmadan | Yalnızca root (0600) |
Kurulum ayrıca Docker’ın IronFlock kayıt defterinde örnek anahtarınızla oturum açmasını sağlar; bu nedenle root kullanıcısının Docker yapılandırması da bu anahtarı içerir.
Bu dosyaları yedeklerinize dahil edin ve yedekleri Appliance’ın kendisi gibi koruyun. .env dosyasını asla silmeyin ve bir kurulumun onu yeniden üretmesine izin vermeyin: veritabanları ve şifreli veriler onun değerlerine bağlıdır. Bir gizli bilgiyi değiştirmek için rotasyonunu yapın.
Kendiniz değiştirebilecekleriniz:
- Yönetici parolası: profilde veya
sudo ironflock appliance reset-admin-passwordile (bkz. Yerel Çalıştırma). - HTTPS sertifikası: kendi sertifikanız
sudo ironflock appliance configure --tls-cert <file> --tls-key <file>ile (bkz. HTTPS ve Sertifikalar). Appliance’ın kendi CA’sından gelen bir sertifika kendiliğinden yenilenir: haftalık bir denetim, 30 günden az kaldığında yenisini imzalar. - Örnek anahtarı: yönetici profilinin lisans bölümünde ya da dosyası yeni anahtarı içeren
sudo ironflock appliance configure --license-file <file>ile. Yeni anahtar, yazılmadan önce IronFlock kayıt defterini açabilmelidir. - SMTP kimlik bilgileri:
.enviçinde; ardındansudo ironflock appliance restartile yeniden başlatın. - Proxy:
sudo ironflock appliance configureile (bkz. Kurumsal Proxy Arkasında). - Dahili hizmet gizli bilgileri:
sudo ironflock appliance rotate <NAME>, aşağıya bakın.
Dahili Bir Gizli Bilginin Rotasyonu
sudo ironflock appliance rotate <NAME>, Appliance çalışırken .env içindeki tek bir gizli bilgiye yeni bir değer verir. Yeni değer önce eski değerin tutulduğu yere (bir veritabanı rolü, ajanın cihaz dosyası, kayıt defterinin token anahtar çifti), ardından .env dosyasına gider. Yalnızca gizli bilgiyi okuyan hizmetler yeniden oluşturulur ve komut bunların sağlıklı olduğunu denetler. Değişiklikten önceki .env, .env.prev olarak kalır ve rotation.log her rotasyonu listeler, hiçbir değeri listelemez. ironflock appliance rotate --help rotasyonunu yapabileceği adları listeler. Bkz. ironflock appliance rotate.
Rotasyonları SSH üzerinden veya Appliance’ın konsolunda çalıştırın, IronFlock’taki Appliance’ın kendi cihazının terminalinde değil: bu terminalin bağlı olduğu hizmetleri yeniden başlatan bir rotasyon, terminalin bağlantısını keser.
| Gizli bilgiler | Bir rotasyonun yaptığı |
|---|---|
WAMP_SECRET_SVC_*, WAMP_SYSTEM_SECRET ve diğer hizmet gizli bilgileri | Onu kullanan hizmetler yeniden başlar; bağlantıları saniyeler içinde geri gelir. |
KRATOS_SECRETS_COOKIE | Yeni oturum açmalar yeni anahtarı kullanır; önceki anahtar bir sonraki rotasyona kadar saklandığı için daha önce açılmış oturumlar geçerli kalır. |
POSTGRES_PASSWORD, PGPASSWORD_*, DATASERVICE_PASSWORD | Veritabanı rolü yeni parolayı alır, ardından hizmetleri yeniden başlar. Önce sorar; --yes yanıtlar. |
REGISTRY_TOKEN_KEY | Uygulama görüntüsü çekme tokenları yeni bir anahtarla imzalanır; daha önce imzalanan tokenlar bir sonraki rotasyona kadar geçerli kalır. Önce sorar; --yes yanıtlar. |
APPLIANCE_DEVICE_SECRET | Appliance’ın kendi cihazı yeni bir kimlik bilgisi alır; aracısı yeniden başlar ve bir dakika içinde yeniden çevrimiçi olur. Önce sorar; --yes yanıtlar. |
FILE_CRED_KEY | Uygulamalar dosyalarını korur; depolamaya erişimleri yeni anahtara geçer. Uygulamaların doğrudan S3 kimlik bilgileri için --keep-direct-access veya --revoke-direct-access seçin. Korunan kimlik bilgileri çalışmaya devam eder, planlı bir rotasyon için: önceki anahtarı bilen biri bunları hâlâ türetebilir, bu yüzden her uygulamanın depolama ayarları bunları değiştirilmek üzere işaretler ve daha sonra sudo ironflock appliance revoke-direct-access kalanları kaldırır. İptal edilen kimlik bilgileri hemen çalışmayı bırakır ve kaldırılır, örneğin bir sızıntı şüphesinden sonra. Önce sorar (--yes yanıtlar) ve Appliance sürümü 1.6.23 veya üstünü gerektirir. |
APPLIANCE_ADMIN_PASSWORD | ironflock appliance reset-admin-password ile aynı şekilde yeni bir ilk yönetici parolası. |
FLEETDB_SECRET_KEYS, KRATOS_SECRETS_CIPHER ve iki OBJECTSTORE_ADMIN_* anahtarının rotasyonunu yalnızca IronFlock ekibiyle birlikte yapın: bunlarla depolanan veriler bunlara bağlıdır. Örnek anahtarı rotate ile değil, yönetici profilinde ya da ironflock appliance configure ile değiştirilir.
Giden Bağlantılar ve Telemetri
Appliance’ın bağlandığı hedefler Güvenlik Duvarı Yapılandırması bölümünde listelenmiştir; bu bağlantıların tümü şifrelidir.
- Lisans doğrulaması, lisans anahtarını, donanımın bir parmak izini ve Appliance’ın çevrimiçi App Store bağlantılarına ait erişim tokenlarını gönderir.
- AI asistanı, siz kendi ağ geçidinizi yapılandırmadığınız sürece istemleri IronFlock’un LLM ağ geçidi üzerinden gönderir.
- Telemetri yok. Appliance kullanım analitiği göndermez: ne Appliance arayüzü ne de hizmetleri kullanımı IronFlock’a veya üçüncü taraflara bildirir.
- Kullanıcının tarayıcısından: harita döşemeleri Mapbox’tan yüklenir ve sesli giriş, Deepgram konuşma tanıma hizmetini kullanır. Bu bağlantıları Appliance değil tarayıcı kurar.
Güncellemeler
- Appliance güncellemelerini yönetici başlatır (bkz. Bakım) ve IronFlock imzalar.
ironflock, kullanılabilir sürümlerin listesini ve yeni sürümün sürüm manifestini taşıdığı Appliance sürüm anahtarına göre, ardından yeni sürümün her dosyasını ve her konteyner görüntüsünü bu manifeste göre denetler. Değiştirilmiş veya imzasız bir dosya ya da yayımlanan görüntüden farklı herhangi bir görüntü, Appliance üzerinde herhangi bir şey değişmeden önce güncellemeyi durdurur. Bir güncelleme Appliance’ı hiçbir zaman kendiliğinden daha eski bir sürüme geri götürmez; bir güncelleme başarısız olursa Appliance daha önce çalıştırdığı sürüme geri döner. - Cihaz aracısı güncellemeleri imzalıdır. Her aracı bir güncellemeyi uygulamadan önce imzayı denetler ve yeni sürüm başlamazsa geri alır — bkz. Cihaz Aracısı Güncellemeleri.
- Docker dahil ana makinenin işletim sistemi sizin sorumluluğunuzdadır.
ironflock Aracını Kurulumdan Önce Doğrulayın
Appliance her güncellemeyi kendisi denetler: ironflock, Appliance’ın her sürümünü kurmadan önce taşıdığı IronFlock Appliance sürüm imza anahtarına göre denetler. Güvenmek zorunda kaldığınız şey, root olarak çalışan ironflock kurulum betiğidir. Onu çalışmadan önce Önce Kurulum Betiğini Doğrulama bölümünde açıklandığı gibi denetleyin: gpg, F6C9 4D96 CE31 5377 ACA7 C8EA 4990 5433 7321 2788 parmak izine sahip IronFlock Bootstrap anahtarıyla atılmış geçerli bir imza bildirmelidir. Betik de ironflock aracını kurmadan önce bu anahtara göre denetler. İki anahtar da İmza Anahtarları sayfasında listelenir.
Yedekleme ve Geri Yükleme
Appliance’ın tamamını yedeklemek için onu sudo ironflock appliance stop ile durdurun ve şunları kopyalayın:
.env,license.env,certs/veregistry-token-certs/dahil/opt/ironflock/klasörü;- veritabanlarını, dosyaları, yerel App Store’u ve kullanıcı dosyalarını barındıran Appliance’ın Docker birimleri (
docker volume ls).
Ardından onu sudo ironflock appliance start ile yeniden başlatın. .env dosyasını aynı zamana ait birimlerle birlikte saklayın: birimlerdeki şifreli veriler yalnızca o .env içindeki anahtarlarla okunabilir.
Gizli bilgiler tek başına, Appliance çalışırken kaydedilebilir:
sudo ironflock appliance backup -o /root/appliance-secrets.tar.gzArşiv .env ve license.env dosyalarını, CA’yı, kayıt defteri token anahtarlarını, gizli bilgiler sicilini ve rotation.log dosyasını içerir; dosyayı yalnızca root okuyabilir. Kaybolan bir FLEETDB_SECRET_KEYS veya FILE_CRED_KEY başka hiçbir yolla kurtarılamaz: arşivi şifreleyin ve birim yedekleriyle birlikte saklayın.
Gizli bilgileri kurulu bir Appliance’a geri koymak için, Appliance çalışırken --force ile geri yükleyin, ardından her hizmetin geri yüklenen dosyaları okuması için Appliance’ı yeniden başlatın:
sudo ironflock appliance restore appliance-secrets.tar.gz --force
sudo ironflock appliance restartAppliance’ın geri yüklemeden önceki .env dosyası .env.prev olarak kalır. Yeni bir makinede ironflock aracını kurun, sudo ironflock appliance restore appliance-secrets.tar.gz çalıştırın, ardından Appliance’ı her zamanki gibi, örnek anahtarı ve önceki seçeneklerle, örneğin --tls, kurun. Bkz. ironflock appliance backup ve ironflock appliance restore.
Hizmetten Çıkarma
-
Appliance hâlâ çevrimiçiyken lisansı taşıyın veya serbest bırakın — bkz. Lisansınızı Yeni Donanıma Taşıma.
-
Yazılımı kaldırın:
sudo ironflock appliance remove --purge sudo ironflock agent removeironflock appliance remove --purge; Appliance’ın hizmetlerini, konteynerlerini ve ağını, Docker’ın IronFlock kayıt defterindeki oturumunu, kurulumunun ana makinede yaptığı değişiklikleri ve--purgeile verilerini de kaldırır:.envvelicense.envile birlikte/opt/ironflockkurulum dizinini, Docker birimlerini ve görüntüleri. Ardındanironflock agent remove, Appliance’ın kendi cihaz aracısını kaldırır. Her komut neyi kaldıracağını listeler ve önce sorar;--yesyanıtlar. Docker’ın kendisi kurulu kalır;/usr/local/biniçindekiironflockda öyle. Bkz.ironflock appliance removeveironflock agent remove. -
Donanım tesislerinizden çıkacaksa, diskini silin — yukarıdaki komutlar dosyaları siler, ancak üzerlerine yazmaz.
Güvenliği Zayıflatan Ayarlar
Bazı ayarlar yalnızca sorun giderme için vardır. Üretimde bunları ayarlamadan bırakın:
AGENT_UPDATE_ALLOW_UNSIGNED— bir cihaz aracısının imzasız güncellemeleri uygulamasına izin verir. Yalnızca en fazla 24 saat sonrasını gösterenuntil=<time>biçiminde çalışır ve ardından kendiliğinden sona erer.TUNNEL_AUTHZ_ENFORCE=false— cihazların kimliklerini kanıtlamadan tünel açmasına izin verir.SMTP_CONNECTION_URIiçinde?tls.rejectUnauthorized=false— posta sunucunuzdan gelen her sertifikayı kabul eder.--2fa available— ikinci faktörler hiçbir zaman istenmez.