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:

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. Yükleyici 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: yükleyici /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.
• 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).

Hesaplar ve Erişim

• Yönetici hesabı: her Appliance kurulumda kendi yönetici parolasını alır; yükleyici 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. Yükleyici seçeneği --2fa 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.

Ana Makinedeki Gizli Bilgiler

Yükleyici, Appliance’ın gizli bilgilerini kurulum sırasında bir kez üretir ve güncellemeler boyunca korur. Bunlar /opt/ironflock/ altında bulunur:

Yükleyici ayrıca Docker’ın IronFlock kayıt defterinde lisans 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.

Kendiniz değiştirebilecekleriniz:

• Yönetici parolası: profilde veya Yerel Çalıştırma bölümündeki sıfırlama komutuyla.
• HTTPS sertifikası: certs/ içindeki dosyaları değiştirin; Appliance yeni sertifikayı otomatik olarak devralır.
• Lisans anahtarı: yönetici profilinin lisans bölümünde.
• SMTP ve proxy kimlik bilgileri: .env içinde; ardından sudo systemctl restart ironflock.service ile yeniden başlatın.

Dahili hizmet gizli bilgileri için IronFlock ekibiyle iletişime geçin.

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). Appliance bunları HTTPS üzerinden indirir ve bir güncelleme başarısız olursa otomatik olarak geri alır.
• 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.

Yedekleme ve Geri Yükleme

Appliance’ın yerleşik bir yedekleme özelliği yoktur. Yedeklemek için sudo systemctl stop ironflock.service 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).

.env dosyasını aynı zamana ait birimlerle birlikte saklayın: birimlerdeki şifreli veriler yalnızca o .env içindeki anahtarlarla okunabilir.

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 systemctl disable --now ironflock.service
   sudo docker compose -f /opt/ironflock/docker-compose.yml \
       --env-file /opt/ironflock/.env down -v
   sudo rm -rf /opt/ironflock

   Yükleyici, Docker’ın IronFlock kayıt defterinde lisans anahtarıyla oturum açmasını sağladı; bu oturumu da kaldırın:

   sudo docker logout instance-registry.ironflock.com

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:

• TUNNEL_TLS_INSECURE_SKIP_VERIFY ve CLOUD_TUNNEL_TLS_INSECURE_SKIP_VERIFY — uzaktan erişim tünellerinin sertifika denetimini kapatır.
• AGENT_UPDATE_ALLOW_UNSIGNED — bir cihaz aracısının imzasız güncellemeleri uygulamasına izin verir.
• 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.