Yapılandırma

Bu kılavuzda merkez sunucunun bir ayarını değiştirecek ve merkez sunucuyu bu ayarla çalıştıracaksınız. Proxus'ta tanımladığınız şeylerin çoğu (cihazlar, alarm kuralları, kullanıcılar) veritabanında saklanır ve değişiklikler hemen geçerli olur. Merkez sunucunun ve Edge Gateway'in başlarken ihtiyaç duyduğu, sayıca daha az olan ayarlar ise tek bir dosyada tutulur: Proxus-config.toml. Bağlantı noktaları, veritabanı bağlantıları, günlük düzeyleri ve parola kuralları bu ayarlara örnektir.

Başlamadan önce

• Administrators rolündeki bir kullanıcıyla oturum açın.
• Kısa bir kesinti planlayın. Değiştirilen ayar ancak yeniden başlatmadan sonra geçerli olur.
• Değiştireceğiniz anahtarı belirleyin. Tüm anahtarlar Yapılandırma anahtarları sayfasında listelenir.

Dosyanın yeri

Proxus başlarken dosyayı bulamazsa varsayılan değerlerle yeni bir dosya oluşturur. Sürüm yükseltmesi mevcut dosyanın üzerine yazmaz.

Merkez sunucunun kendisi için oluşturduğu anahtarlar da aynı klasördedir. Bunlardan biri keys/STORE/certificate-store.key dosyasıdır. Sertifika deposundaki özel anahtarlar bu anahtarla şifrelenir ve çözülür. Bu yüzden yalnızca yapılandırma dosyasını değil, klasörün tamamını yedekleyin. Bkz. Yedekleme ve geri yükleme.

Dosyanın yapısı

Dosya TOML biçimindedir. Bölüm adları köşeli parantez içinde yazılır, her bölümün altında Key = value satırları bulunur. # işareti yorum başlatır.

[Logging]
Loglevel = 3        # 0 Trace, 1 Debug, 2 Information, 3 Warning, 4 Error, 5 Critical
LogToFile = true

[Security]
Lockout.MaxFailedAccessAttempts = 3

Başlıca bölümler:

HTTPS ve sertifika ayarları

Bu anahtarlar, merkez sunucuya TLS üzerinden nasıl erişileceğini belirler. Anahtarların açıklamaları Yapılandırma anahtarları sayfasındadır.

[Service]
UI-HTTPS-Port = "8443"               # empty turns HTTPS off
# RedirectHttpToHttps = "false"      # "true" sends HTTP to HTTPS and turns on HSTS
# PublicHttpsPort = "8443"           # the port others reach HTTPS on, if published differently
# PublicHostNames = "proxus.plant.example, 203.0.113.10"

[NATS]
# TlsHostNames = "nats.plant.example"

[MQTTBroker]
TlsPort = 8883                       # 0 turns MQTT over TLS off
PlainEnabled = true                  # false accepts TLS only

Kullanıcıların ya da Edge Gateway'lerin merkez sunucuya erişirken kullandığı tüm adları ve adresleri PublicHostNames anahtarına ekleyin. Böylece merkez sunucunun HTTPS ve NATS sertifikaları bu adları da kapsar. Edge Gateway kurulum komutu oluştururken seçtiğiniz adresler NATS sertifikasına otomatik olarak eklenir.

Ayarı Yapılandırma düzenleyici ile değiştirin

1. Yönetim > Yapılandırma düzenleyici ekranını açın. Dosyanın tamamı metin olarak açılır.
2. Anahtarı bulun ve değerini değiştirin.
3. Kaydet düğmesine tıklayın.
4. Yapılandırma değişikliklerini onayla uyarısını onaylayın. Dosya kaydedilir.
5. Proxus, Platformu yeniden başlatmayı onayla penceresini açar. Hemen yeniden başlatmak için Yeniden başlat düğmesine tıklayın. İsterseniz daha sonra kendiniz yeniden başlatabilirsiniz.

1. Kaydet, dosyayı kaydeder ve düzenleyiciyi açık bırakır.
2. Kaydet ve kapat, dosyayı kaydeder ve düzenleyiciyi kapatır.

Yeniden başlat, proxus adlı Docker Compose projesinin konteynerlerini yeniden başlatır. Merkez sunucu en son başlatılır. Bu komut yalnızca Docker kurulumlarında ve yığın bu proje adıyla başlatıldıysa çalışır (bkz. Docker). Diğer durumlarda yığını kendiniz yeniden başlatın:

docker compose -p proxus restart

Her kayıt işleminde sistem günlüklerine, kullanıcı adınızı içeren bir uyarı yazılır.

Anahtarı varsayılan değerine döndürün

Varsayılan değerler dosyada yorum satırı olarak yer alır. Bir değeri silmek ya da yeniden yorum satırına çevirmek varsayılan değeri geri getirmez. Varsayılan değeri açıkça yazın, kaydedin ve yeniden başlatın.

Ortam değişkenleri dosyadaki değerleri geçersiz kılar

Her anahtar ortam değişkeni olarak da tanımlanabilir. Değişken adı, bölüm adıyla anahtar adı iki alt çizgiyle birleştirilerek oluşturulur. Örnekler:

Ortam değişkeni, dosyadaki değeri geçersiz kılar. Ürünle gelen docker-compose.yml dosyası bazı değişkenleri zaten tanımlar. Örneğin merkez sunucuda Logging__Loglevel: "3" ve iki konteynerde de NATS__BrokerUrl. Bu anahtarları Yapılandırma düzenleyicide değiştirmek tek başına yetmez. Compose dosyasındaki değişkeni de değiştirin ya da kaldırın.

PROXUS_CERTIFICATE_STORE_KEY ortam değişkeninin dosyada karşılığı yoktur. Sertifika deposunun anahtarını keys/STORE/certificate-store.key dosyası yerine dışarıdan, örneğin bir Kubernetes Secret'tan vermek için bu değişkeni kullanın (32 baytlık base64 değer). Değeri güvenli bir yerde saklayın. Bu anahtar olmadan saklanan sertifikalar okunamaz.

Sonraki adımlar

• Tüm yapılandırma anahtarları: her anahtarın varsayılan değerine ve anlamına bakın.
• Kurulumu güvenli hâle getirin: HTTPS ve parola ayarlarını kurulumunuza göre sıkılaştırın.