Skip to Content

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 HTTPSKurumsal sertifikanızla HTTPS
Tarayıcıdan Appliance’aŞifresizHTTPSHTTPS
Oturum açma çerezleriSecure olarak işaretlenmemişSecureSecure
Cihaz bağlantısı (port 18080)ŞifresizŞifresiz443 üzerinde HTTPS
Cihazlar için uygulama görüntüleri ve aracı güncellemeleriŞifresizŞifresiz443 ü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 kendisindenEvetEvet

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. Filtrelemeyi DOCKER-USER zincirinde veya ağ güvenlik duvarınızda yapın: kurulum /opt/ironflock/docker-user-firewall.sh.example konumunda 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 ironflock aracını doğrulayın (bkz. ironflock Aracı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 install bunu 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 install veya ironflock appliance configure komutunun --2fa seç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İçerikErişim
.envTüm hizmetlerin parolaları ve anahtarları, ilk yönetici parolası, proxy ve SMTP kimlik bilgileriYalnı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 anahtarYalnızca kayıt defteri hizmeti (0600)
.env.prev, rotation.logSon rotasyondan önceki .env; hangi gizli bilgi için ne zaman rotasyon yapıldığı, değerler olmadanYalnı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-password ile (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: .env içinde; ardından sudo ironflock appliance restart ile yeniden başlatın.
  • Proxy: sudo ironflock appliance configure ile (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 bilgilerBir rotasyonun yaptığı
WAMP_SECRET_SVC_*, WAMP_SYSTEM_SECRET ve diğer hizmet gizli bilgileriOnu kullanan hizmetler yeniden başlar; bağlantıları saniyeler içinde geri gelir.
KRATOS_SECRETS_COOKIEYeni 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_PASSWORDVeritabanı rolü yeni parolayı alır, ardından hizmetleri yeniden başlar. Önce sorar; --yes yanıtlar.
REGISTRY_TOKEN_KEYUygulama 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_SECRETAppliance’ı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_KEYUygulamalar 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_PASSWORDironflock 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/ ve registry-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.gz

Arş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 restart

Appliance’ı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

  1. Appliance hâlâ çevrimiçiyken lisansı taşıyın veya serbest bırakın — bkz. Lisansınızı Yeni Donanıma Taşıma.

  2. Yazılımı kaldırın:

    sudo ironflock appliance remove --purge sudo ironflock agent remove

    ironflock 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 --purge ile verilerini de kaldırır: .env ve license.env ile birlikte /opt/ironflock kurulum dizinini, Docker birimlerini ve görüntüleri. Ardından ironflock agent remove, Appliance’ın kendi cihaz aracısını kaldırır. Her komut neyi kaldıracağını listeler ve önce sorar; --yes yanıtlar. Docker’ın kendisi kurulu kalır; /usr/local/bin içindeki ironflock da öyle. Bkz. ironflock appliance remove ve ironflock agent remove.

  3. 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österen until=<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_URI içinde ?tls.rejectUnauthorized=false — posta sunucunuzdan gelen her sertifikayı kabul eder.
  • --2fa available — ikinci faktörler hiçbir zaman istenmez.
Last updated on