Konfigürasyon Dosyası Referansı | Proxus Dokümantasyon

Çekirdek Sunucunun davranışı Proxus-config.toml dosyası tarafından kontrol edilir. Bu dosyadaki her ayar, Docker ve Kubernetes dağıtımları için tercih edilen yöntem olan ortam değişkenleri kullanılarak geçersiz kılınabilir.

lightbulb

Değişken Eşleme Kuralı

Bir TOML anahtarını ortam değişkeni ile geçersiz kılmak için:

TOML bölüm adı ile anahtar adını çift alt çizgi (__) ile birleştirin.
TOML dosyasındaki büyük/küçük harf yazımını koruyun.
İç içe bölümler için her seviyeyi __ ile ayırın.
Örnekler:
- [NATS] BrokerUrl → NATS__BrokerUrl
- [Database] ConnectionString → Database__ConnectionString
- [Security.Password] MinLength → Security__Password__MinLength
- [[WEBAPI.Authentication.Jwt]] ilk girdinin Issuer değeri → WEBAPI__Authentication__Jwt__0__Issuer

Çift alt çizgi, .NET'in konfigürasyon hiyerarşisi ayırıcısı (:) için belirlediği konvansiyondur; çünkü POSIX kabukları ortam değişkeni adlarında : karakterine izin vermez.

Notasyon Notları

Boş değer de override eder. NATS__BrokerUrl="" TOML değerini boş string ile ezer. TOML değerine geri dönmek için değişkeni "" yapmak yerine tamamen silmek gerekir.
Tireli TOML anahtarları. Bazı anahtarlar (örneğin Service__UI-Port) tire içerir. POSIX kabukları export X=Y sözdiziminde tireyi kabul etmez; bu adlar yalnızca Docker Compose environment: listelerinde, Kubernetes manifest env: dizilerinde veya env "Service__UI-Port=8080" ./Proxus.Server gibi inline kullanımlarda çalışır.
Dizi (array) bölümleri. TOML [[Section.Sub]] dizileri sayısal indeksle ifade edilir. İlk girdinin Key değeri Section__Sub__0__Key, ikincisi Section__Sub__1__Key, vb. olur.
Komut satırı en üstte kazanır. ./Proxus.Server --GatewayID=1 gibi başlangıç argümanları hem ortam değişkenlerini hem TOML'u ezer.

Çekirdek Servis Ayarları

[Service] bölümünü kontrol eder. Mikroservisler için kimlik ve ağ portlarını tanımlar.

TOML Anahtarı	Ortam Değişkeni	Tip	Açıklama
Name	`Service__Name`	String	Loglarda/kümede görünen örnek adı.
UI-Port	`Service__UI-Port`	String	Yönetim Konsolu için HTTP portu.
UI-HTTPS-Port	`Service__UI-HTTPS-Port`	String	Yönetim Konsolu için HTTPS portu.
UI-Address	`Service__UI-Address`	String	UI için bağlama adresi (örn., 0.0.0.0).
WEBApi-Port	`Service__WEBApi-Port`	String	REST API için HTTP portu.
WEBApi-HTTPS-Port	`Service__WEBApi-HTTPS-Port`	String	REST API için HTTPS portu.
WEBApi-Address	`Service__WEBApi-Address`	String	API için bağlama adresi.
Server-Port	`Service__Server-Port`	String	Dahili iletişim için ana gRPC portu.
Server-HTTPS-Port	`Service__Server-HTTPS-Port`	String	Güvenli gRPC portu.
Server-Address	`Service__Server-Address`	String	Sunucu için bağlama adresi.
Certificate source	-	UI-managed	HTTPS sertifikaları artık Yönetim → Certificate Store üzerinden seçilir. `Proxus-config.toml` portları tanımlar; sertifika materyali UI üzerinden yönetilir.

Veritabanları

Proxus hibrit bir depolama modeli kullanır (İlişkisel + Zaman Serisi). [Database] ve [ClickHouse] bölümlerini kontrol eder.

Genel Veritabanı Ayarları

[Database] bölümünü kontrol eder.

TOML Anahtarı	Ortam Değişkeni	Tip	Açıklama
ConnectionString	`Database__ConnectionString`	String	PostgreSQL bağlantı dizesi (Kullanıcılar, Konfig).
TelemetryDB	`Database__TelemetryDB`	String	Telemetri arka ucu: `clickhouse` veya `timescale`.
InsertStrategy	`Database__InsertStrategy`	String	`Bulk` (Önerilen) veya `Single`.
BulkInsertInterval	`Database__BulkInsertInterval`	Int	Ms cinsinden tampon boşaltma aralığı (Varsayılan: 1000).
MaxConcurrentInserts	`Database__MaxConcurrentInserts`	Int	Maksimum paralel yazma işlemi.
EnableDataStoreCache	`Database__EnableDataStoreCache`	Bool	Sistem tabloları için Seviye-2 önbellekleme.
TablesExcludedFromCache	`Database__TablesExcludedFromCache__0`, `…__1`, …	Dizi	Asla önbelleğe alınmayacak tablolar. Her dizi girdisi indeksiyle ayarlanır (örn. `Database__TablesExcludedFromCache__0=Log`).
DeviceRawDataRetentionPolicy	`Database__DeviceRawDataRetentionPolicy`	String	Ham veri saklama süresi (örn., `7d`, `1y`). `0s` = devre dışı.

ClickHouse Ayarları

[ClickHouse] bölümünü kontrol eder.

TOML Anahtarı	Ortam Değişkeni	Tip	Açıklama
ClickHouseHost	`ClickHouse__ClickHouseHost`	String	ClickHouse sunucusunun ana bilgisayar adı.
ClickHousePort	`ClickHouse__ClickHousePort`	Int	HTTP arayüz portu (Varsayılan: 8123).
ClickHouseMySqlPort	`ClickHouse__ClickHouseMySqlPort`	Int	MySQL tel-protokol portu (Varsayılan: 9004).
ClickHouseDatabase	`ClickHouse__ClickHouseDatabase`	String	Veritabanı adı (Varsayılan: `proxus`).
ClickHouseUsername	`ClickHouse__ClickHouseUsername`	String	Kimlik doğrulama kullanıcı adı.
ClickHousePassword	`ClickHouse__ClickHousePassword`	String	Kimlik doğrulama şifresi.
ClickHouseWriteIntervalSeconds	`ClickHouse__ClickHouseWriteIntervalSeconds`	Int	Toplu yazma frekansı.
ClickHouseTTLExpression	`ClickHouse__ClickHouseTTLExpression`	String	TTL SQL ifadesi (örn., `toIntervalMonth(3)`).
ClickHouseLogTTLExpression	`ClickHouse__ClickHouseLogTTLExpression`	String	Loglar için TTL ifadesi (örn. `INTERVAL 45 DAY`).

[NATS]

[NATS] bölümünü kontrol eder.

TOML Anahtarı	Ortam Değişkeni	Tip	Açıklama
BrokerUrl	`NATS__BrokerUrl`	String	Broker bağlantı URL'si (örn., `nats://localhost:4222`).
BrokerUser	`NATS__BrokerUser`	String	Küme kullanıcı adı.
BrokerPassword	`NATS__BrokerPassword`	String	Küme şifresi.

Güvenlik & Kimlik Doğrulama

Küresel Güvenlik

[Security] bölümünü kontrol eder.

TOML Anahtarı	Ortam Değişkeni	Tip	Açıklama
Lockout.Enabled	`Security__Lockout__Enabled`	Bool	Başarısızlıkta hesap kilitlemeyi etkinleştir.
Lockout.MaxFailedAccessAttempts	`Security__Lockout__MaxFailedAccessAttempts`	Int	Kilitlemeden önceki maksimum deneme.
Lockout.DefaultLockoutTimeSpan	`Security__Lockout__DefaultLockoutTimeSpan`	Int	Saniye cinsinden kilitleme süresi.

Şifre Politikası

[Security.Password] bölümünü kontrol eder.

TOML Anahtarı	Ortam Değişkeni	Tip	Açıklama
MinLength	`Security__Password__MinLength`	Int	Minimum karakter sayısı.
MaxLength	`Security__Password__MaxLength`	Int	Maksimum karakter sayısı.
RequireUppercase	`Security__Password__RequireUppercase`	Int	Gerekli büyük harf sayısı.
RequireLowercase	`Security__Password__RequireLowercase`	Int	Gerekli küçük harf sayısı.
RequireDigits	`Security__Password__RequireDigits`	Int	Gerekli rakam sayısı.
RequireSpecialCharacters	`Security__Password__RequireSpecialCharacters`	Int	Gerekli sembol sayısı.
AllowedSpecialCharacters	`Security__Password__AllowedSpecialCharacters`	String	Geçerli sembollerin listesi (örn., `!@#$%`).
PasswordHistory	`Security__Password__PasswordHistory`	Int	Hatırlanacak eski şifre sayısı.
PasswordExpirationDays	`Security__Password__PasswordExpirationDays`	Int	Şifre süresinin dolmasına kalan gün sayısı.
PasswordExpirationWarningDays	`Security__Password__PasswordExpirationWarningDays`	Int	Süre dolmadan önce uyarılacak gün sayısı.
PreventCommonPasswords	`Security__Password__PreventCommonPasswords`	Bool	Sözlük kelimelerini engelle.
PreventKeyboardPatterns	`Security__Password__PreventKeyboardPatterns`	Bool	`qwerty` veya `12345` gibi desenleri engelle.
PreventRepeatedCharacters	`Security__Password__PreventRepeatedCharacters`	Bool	`aaaaa` gibi tekrarları engelle.
MaxRepeatedCharacters	`Security__Password__MaxRepeatedCharacters`	Int	Maksimum ardışık tekrar.
RequireChangeOnFirstLogin	`Security__Password__RequireChangeOnFirstLogin`	Bool	Yeni kullanıcılar için değişikliği zorla.
TempPasswordExpirationHours	`Security__Password__TempPasswordExpirationHours`	Int	Geçici şifrelerin geçerlilik süresi (saat).

JWT & WebAPI

[Jwt] ve [[WEBAPI.Authentication.Jwt]] bölümlerini kontrol eder. İkincisi bir TOML tablo dizisidir; ilk girdi için 0 indeksi kullanılır.

TOML Anahtarı	Ortam Değişkeni	Tip	Açıklama
Issuer	`Jwt__Issuer`	String	Token Yayıncı (Issuer) talebi.
Audience	`Jwt__Audience`	String	Token Hedef Kitle (Audience) talebi.
Key	`Jwt__Key`	String	256-bit İmzalama Anahtarı.
Issuer (API)	`WEBAPI__Authentication__Jwt__0__Issuer`	String	API'ye özgü yayıncı.
Audience (API)	`WEBAPI__Authentication__Jwt__0__Audience`	String	API'ye özgü hedef kitle.
IssuerSigningKey	`WEBAPI__Authentication__Jwt__0__IssuerSigningKey`	String	API'ye özgü imzalama anahtarı.
TokenExpireTime	`WEBAPI__Authentication__Jwt__0__TokenExpireTime`	String	Token geçerlilik süresi.

Birleşik İsim Alanı

[UNS] bölümünü kontrol eder.

TOML Anahtarı	Ortam Değişkeni	Tip	Açıklama
UNSVersion	`UNS__UNSVersion`	String	UNS topic yolları için sürüm öneki (varsayılan: `v1`).
UNSPayloadFormat	`UNS__UNSPayloadFormat`	String	Yük formatı: `JSON` (varsayılan) veya `SparkplugB`.
UNSGroupId	`UNS__UNSGroupId`	String	SparkplugB Grup Kimliği (format SparkplugB olduğunda kullanılır).
UNSEdgeNodeId	`UNS__UNSEdgeNodeId`	String	SparkplugB Edge Düğüm Tanımlayıcısı.
UNSRetainMessages	`UNS__UNSRetainMessages`	Bool	Yayında MQTT Retain bayrağını ayarla.
QoS:Telemetry	`UNS__QoS__Telemetry`	String	Telemetri yayını QoS değeri (`0`, `1`, `2`; varsayılan: `0`).
QoS:State	`UNS__QoS__State`	String	Durum yayını QoS değeri (`0`, `1`, `2`; varsayılan: `1`).
QoS:Command	`UNS__QoS__Command`	String	Komut yayını QoS değeri (`0`, `1`, `2`; varsayılan: `1`).

UNS Optimizasyonları

[UNS.Optimizations] bölümünü kontrol eder.

TOML Anahtarı	Ortam Değişkeni	Tip	Açıklama
TelemetryThinPayload	`UNS__Optimizations__TelemetryThinPayload`	Bool	Telemetri yüklerinden "context" nesnesini kaldır.
SummaryIncludeContext	`UNS__Optimizations__SummaryIncludeContext`	Bool	`_summary` mesajlarına ISA-95 bağlamını dahil et.
SummaryIntervalMs	`UNS__Optimizations__SummaryIntervalMs`	Int	`_summary` için min yayın aralığı (ms).
LastSeenIntervalMs	`UNS__Optimizations__LastSeenIntervalMs`	Int	`_lastSeen` için min yayın aralığı (ms).
StatusOnChangeOnly	`UNS__Optimizations__StatusOnChangeOnly`	Bool	`_status` bilgisini yalnızca değer değiştiğinde yayınla.
SummaryOnlyOnChange	`UNS__Optimizations__SummaryOnlyOnChange`	Bool	`_summary` bilgisini yalnızca hash değiştiğinde yayınla.

Fieldbus

[Fieldbus] bölümünü kontrol eder.

TOML Anahtarı	Ortam Değişkeni	Tip	Açıklama
UseBatchReadForSupportedProtocols	`Fieldbus__UseBatchReadForSupportedProtocols`	Bool	Ağ trafiğini azaltmak için desteklenen protokollerde toplu okumayı etkinleştir.

Browse

[Browse] bölümünü kontrol eder.

TOML Anahtarı	Ortam Değişkeni	Tip	Açıklama
UseEdgeRemoteBrowse	`Browse__UseEdgeRemoteBrowse`	Bool	Hub UI'ın edge istek/yanıt göz atma akışını kullanmasını zorla.

Entegrasyonlar

[MQTTBroker], [MQTTAPI] ve [HttpServer] bölümlerini kontrol eder.

Gömülü MQTT Broker

[MQTTBroker] bölümünü kontrol eder.

TOML Anahtarı	Ortam Değişkeni	Tip	Açıklama
Enabled	`MQTTBroker__Enabled`	Bool	Dahili broker'ı etkinleştir.
MQTTBrokerPort	`MQTTBroker__MQTTBrokerPort`	Int	Dinleme portu.
AllowAnonymous	`MQTTBroker__AllowAnonymous`	Bool	Kimlik doğrulamasız bağlantılara izin ver.
MasterToken	`MQTTBroker__MasterToken`	String	Süper kullanıcı token'ı.
BrokerHostAddress	`MQTTBroker__BrokerHostAddress`	String	Bağlama adresi.
EnableMQTTHooks	`MQTTBroker__EnableMQTTHooks`	Bool	Dahili kancaları etkinleştir.

Harici MQTT İstemcisi

[MQTTAPI] bölümünü kontrol eder.

TOML Anahtarı	Ortam Değişkeni	Tip	Açıklama
MQTTServer	`MQTTAPI__MQTTServer`	String	Harici Broker Adresi.
MQTTPort	`MQTTAPI__MQTTPort`	Int	Harici Broker Portu.
MQTTUser	`MQTTAPI__MQTTUser`	String	Kullanıcı adı.
MQTTPassword	`MQTTAPI__MQTTPassword`	String	Şifre.
MQTTVersion	`MQTTAPI__MQTTVersion`	String	Protokol Sürümü (`V310` veya `V500`).
MQTTConnectionTimeOut	`MQTTAPI__MQTTConnectionTimeOut`	Int	Bağlantı zaman aşımı (saniye).
MQTTKeepAlivePeriod	`MQTTAPI__MQTTKeepAlivePeriod`	Int	Canlı Tutma (sn).
MQTTCleanSession	`MQTTAPI__MQTTCleanSession`	Bool	Temiz Oturum bayrağı.
MQTTQos	`MQTTAPI__MQTTQos`	Int	Varsayılan QoS (0, 1, 2).
MQTTRetain	`MQTTAPI__MQTTRetain`	Bool	Varsayılan Retain bayrağı.

HTTP Sunucusu

[HttpServer] bölümünü kontrol eder.

TOML Anahtarı	Ortam Değişkeni	Tip	Açıklama
Enabled	`HttpServer__Enabled`	Bool	HTTP Toplama uç noktasını etkinleştir.
Port	`HttpServer__Port`	Int	Dinleme portu.
MaxConcurrentConnections	`HttpServer__MaxConcurrentConnections`	Int	Maksimum bağlantı.
MaxRequestBodySize	`HttpServer__MaxRequestBodySize`	Long	Bayt cinsinden maksimum yük boyutu.
KeepAliveTimeout	`HttpServer__KeepAliveTimeout`	Int	Canlı tutma zaman aşımı.
MaxKeepAliveRequests	`HttpServer__MaxKeepAliveRequests`	Int	Bağlantı başına maksimum istek.
RequestHeadersTimeout	`HttpServer__RequestHeadersTimeout`	Int	Başlık okuma zaman aşımı.
EnableHttps	`HttpServer__EnableHttps`	Bool	TLS'i etkinleştir.
SslCertificateThumbprint	`HttpServer__SslCertificateThumbprint`	String	Certificate Store içinde bulunan bir sertifikaya opsiyonel referans. Boş bırakılırsa varsayılan platform sertifikası kullanılır.
RateLimitPermitLimit	`HttpServer__RateLimitPermitLimit`	Int	Pencere başına istek.
RateLimitWindowSeconds	`HttpServer__RateLimitWindowSeconds`	Int	Hız sınırı pencere boyutu.
EnableCompression	`HttpServer__EnableCompression`	Bool	GZIP/Brotli etkinleştir.

Küme & Aktörler

[Cluster] ve [ProtoActor] bölümlerini kontrol eder.

TOML Anahtarı	Ortam Değişkeni	Tip	Açıklama
GrpcInterfaceBinding	`Cluster__GrpcInterfaceBinding`	String	Küme trafiği için bağlanılacak IP.
ClusterProvider	`Cluster__ClusterProvider`	String	Sağlayıcı tipi (örn. Kubernetes, Consul).
IdentityLookupStrategy	`Cluster__IdentityLookupStrategy`	String	Aktör bulma stratejisi.
HeartbeatExpiration	`Cluster__HeartbeatExpiration`	Int	Küme kalp atışı zaman aşımı.
ActorRequestTimeout	`Cluster__ActorRequestTimeout`	Int	Aktör çağrıları için varsayılan zaman aşımı.
ActorActivationTimeout	`Cluster__ActorActivationTimeout`	Int	Aktör oluşturma zaman aşımı.
GossipRequestTimeout	`Cluster__GossipRequestTimeout`	Int	Gossip protokolü zaman aşımı.
ActorSpawnVerificationTimeout	`Cluster__ActorSpawnVerificationTimeout`	Int	Uzak düğümlerde aktör oluşturma doğrulama zaman aşımı.
AdvertisedHost	`Cluster__AdvertisedHost`	String	Diğer küme düğümlerine ilan edilen ana bilgisayar adresi.
RedisConnection	`Cluster__RedisConnection`	String	Servis keşfi/kimlik depolaması için Redis bağlantı dizesi.
DeveloperLogging	`ProtoActor__DeveloperLogging`	Bool	Ayrıntılı aktör loglaması.
SubscribersStorageType	`ProtoActor__PubSub__SubscribersStorageType`	String	PubSub arka ucu (`Redis`, `InMemory`).
RedisConnectionString	`ProtoActor__PubSub__RedisConnectionString`	String	Redis bağlantı dizesi.
RedisMaxConcurrency	`ProtoActor__PubSub__RedisMaxConcurrency`	Int	Redis eşzamanlılık sınırı.

Kullanıcı Fonksiyonları

[UserFunctions] bölümünü kontrol eder.

TOML Anahtarı	Ortam Değişkeni	Tip	Açıklama
ExceptionThresholdPerFunction	`UserFunctions__ExceptionThresholdPerFunction`	Int	Yayından kaldırmadan önceki maksimum çökme sayısı (Varsayılan: 10).
UseAutoDisposeInjector	`UserFunctions__UseAutoDisposeInjector`	Bool	Dispose çağrılarını otomatik enjekte et.
UseAutoTryCatchInjector	`UserFunctions__UseAutoTryCatchInjector`	Bool	Try/Catch bloklarını otomatik enjekte et.
LogProxusCompilerGeneratedCode	`UserFunctions__LogProxusCompilerGeneratedCode`	Bool	Oluşturulan C# kodunu hata ayıkla.
LogLevelPolicy	`UserFunctions__LogLevelPolicy__0`, `…__1`, …	Dizi	Log hız sınırları (örn., `Error:20 1m`). Her politika girdisi indeksiyle ayarlanır.

Gözlemlenebilirlik & Bakım

Loglama & İzleme

[Logging], [Tracing], [Metrics] ve [Otlp] bölümlerini kontrol eder.

TOML Anahtarı	Ortam Değişkeni	Tip	Açıklama
Loglevel	`Logging__Loglevel`	Int	0=Trace, 1=Debug, 2=Info, ...
LogRetentionTime	`Logging__LogRetentionTime`	Int	Veritabanı logları için saklama gün sayısı.
LogToFile	`Logging__LogToFile`	Bool	Logları diske yaz.
LogSqlQueries	`Logging__LogSqlQueries`	Bool	Oluşturulan SQL'i logla (Ayrıntılı!).
Enable (Tracing)	`Tracing__Enable`	Bool	OpenTelemetry İzlemeyi Etkinleştir.
Enable (Metrics)	`Metrics__Enable`	Bool	OpenTelemetry Metriklerini Etkinleştir.
Endpoint (OTLP)	`Otlp__Endpoint`	String	OTLP Toplayıcı URL'si.
MetricsIntervalMilliseconds	`Otlp__MetricsIntervalMilliseconds`	Int	Dışa aktarma aralığı.

Veri Ayarları

[Data] bölümünü kontrol eder.

TOML Anahtarı	Ortam Değişkeni	Tip	Açıklama
MaxDeviceDataLoad	`Data__MaxDeviceDataLoad`	Int	UI grafikleri için getirilecek maksimum kayıt sayısı.
DeviceDataTimeRange	`Data__DeviceDataTimeRange`	String	Varsayılan UI zaman aralığı.
LogsTimeRange	`Data__LogsTimeRange`	String	Varsayılan Log zaman aralığı (örn. "1d").
DeviceMetricsTransmissionInterval	`Data__DeviceMetricsTransmissionInterval`	Int	Sağlık metrikleri itme aralığı.

Çeşitli

Edge Gateway

[EdgeGateway] bölümünü kontrol eder.

TOML Anahtarı	Ortam Değişkeni	Tip	Açıklama
EdgeMode	`EdgeGateway__EdgeMode`	String	`Proxus` (Çekirdek) veya `Standalone` (Ajan).
Integration	`EdgeGateway__Integration`	String	Entegrasyon modu.
GatewayName	`EdgeGateway__GatewayName`	String	Gateway'in mantıksal adı.
GatewayID	`EdgeGateway__GatewayID`	String	Sayısal ID (Çekirdek her zaman 1'dir).
EdgeMetricsTransmissionInterval	`EdgeGateway__EdgeMetricsTransmissionInterval`	Int	Edge sağlık itme aralığı.

[UI]

[UI] bölümünü kontrol eder.

TOML Anahtarı	Ortam Değişkeni	Tip	Açıklama
ForceSkiaRendering	`UI__ForceSkiaRendering`	Bool	Grafikler için Skia render etmeyi zorla.
EnableDashboardExportRestrictedMode	`UI__EnableDashboardExportRestrictedMode`	Bool	Dışa aktarma formatlarını kısıtla.
EnableDashboardCustomPalette	`UI__EnableDashboardCustomPalette__0`, `…__1`, …	Dizi	Dashboard grafikleri için özel HEX renk paleti (örn. `UI__EnableDashboardCustomPalette__0=#3dbb8b`).

[DevExpress.ExpressApp]

[DevExpress.ExpressApp] bölümünü kontrol eder.

TOML Anahtarı	Ortam Değişkeni	Tip	Açıklama
Languages	`DevExpress__ExpressApp__Languages`	String	Desteklenen UI dilleri.
ShowLanguageSwitcher	`DevExpress__ExpressApp__ShowLanguageSwitcher`	Bool	Dil menüsünü göster veya gizle.

[DevExpress.ExpressApp.ThemeSwitcher]

[DevExpress.ExpressApp.ThemeSwitcher] bölümünü kontrol eder.

TOML Anahtarı	Ortam Değişkeni	Tip	Açıklama
DefaultItemName	`DevExpress__ExpressApp__ThemeSwitcher__DefaultItemName`	String	Varsayılan tema.
ShowSizeModeSwitcher	`DevExpress__ExpressApp__ThemeSwitcher__ShowSizeModeSwitcher`	Bool	Kompakt/dokunmatik geçişini göster.

Model Bağlam Protokolü (MCP)

[MCP] bölümünü kontrol eder. AI Ajan arayüzü ve güvenlik izinleri.

TOML Anahtarı	Ortam Değişkeni	Tip	Açıklama
Enabled	`MCP__Enabled`	Bool	MCP sunucusu işlevselliğini etkinleştir.
AllowedMethods	`MCP__AllowedMethods`	String	İzin verilen HTTP fiilleri (örn. "GET,POST").
BlockDelete	`MCP__BlockDelete`	Bool	Kullanıcı izinlerinden bağımsız olarak tüm DELETE işlemlerini engelle.
BlockBulkOperations	`MCP__BlockBulkOperations`	Bool	Tek bir istekte birden fazla varlığın değiştirilmesini engelle.
AdminOnly	`MCP__AdminOnly`	Bool	Erişimi yalnızca Yöneticiler grubuna kısıtla.
AnonymousDiscoveryMode	`MCP__AnonymousDiscoveryMode`	String	Anonymous discovery politikası: `ToolsAndOverview`, `ToolsOnly` veya `Disabled`. Bilinmeyen değerler fail-closed davranır.
ServerBaseUrl	`MCP__ServerBaseUrl`	String	Login ve downstream OData için kullanılan exact Proxus origin'i. Loopback dışı dağıtımlarda zorunludur.
AllowedBaseUrls	`MCP__AllowedBaseUrls__0`, `…__1`, …	Dizi	Login ve downstream OData için izinli ek exact HTTP(S) Proxus origin'leri. Boşsa `ServerBaseUrl` veya loopback development dışında hedef eklenmez.
AllowedOrigins	`MCP__AllowedOrigins__0`, `…__1`, …	Dizi	`/mcp` için kabul edilen ek exact browser Origin değerleri. Boşsa yalnız `ServerBaseUrl` veya eşleşen loopback development origin'i kabul edilir.
SessionTtlMinutes	`MCP__SessionTtlMinutes`	Int	Business session ömrü (dakika).
SessionHeaderName	`MCP__SessionHeaderName`	String	Uyumluluk amaçlı business-session header adı. Stateful protocol binding tercih edilir.
SessionCookieName	`MCP__SessionCookieName`	String	Yalnız protocol-session binding kullanılamadığında kullanılan compatibility cookie adı.
SessionKeyPrefix	`MCP__SessionKeyPrefix`	String	Saklanan MCP business session anahtarları için prefix.
RateLimitEnabled	`MCP__RateLimitEnabled`	Bool	İstek hızı sınırlamasını etkinleştir.
RateLimitRequestsPerMinute	`MCP__RateLimitRequestsPerMinute`	Int	Kullanıcı/dakika başına maksimum istek.
ODataRateLimitRequestsPerMinute	`MCP__ODataRateLimitRequestsPerMinute`	Int	Kullanıcı/dakika başına maksimum MCP OData isteği.
TelemetryRateLimitRequestsPerMinute	`MCP__TelemetryRateLimitRequestsPerMinute`	Int	Kullanıcı/dakika başına maksimum MCP telemetri isteği.
GraphRateLimitRequestsPerMinute	`MCP__GraphRateLimitRequestsPerMinute`	Int	Kullanıcı/dakika başına maksimum MCP graph isteği.
AuditLogging	`MCP__AuditLogging`	Bool	Tüm işlemleri denetim izine kaydet.
IPWhitelist	`MCP__IPWhitelist__0`, `…__1`, …	Dizi	İzin verilen IP adresleri/CIDR blokları. Boş = Hepsine İzin Ver.
MaxConcurrentSessionsPerUser	`MCP__MaxConcurrentSessionsPerUser`	Int	Maksimum aktif oturum (0 = Sınırsız).
AlertOnSuspiciousActivity	`MCP__AlertOnSuspiciousActivity`	Bool	Anomali tespitinde uyarıları tetikle.
DebugLogging	`MCP__DebugLogging`	Bool	Tanılama için ayrıntılı konsol loglaması.

[MCP.ClickHouse]

Yalnız yöneticiye açık telemetry_query MCP aracının kullandığı korumalı ClickHouse istemcisini kontrol eder. Global [MCP] AdminOnly seçeneği kapalı olsa bile araç yalnız yönetici Proxus rollerine açık kalır.

TOML Anahtarı	Ortam Değişkeni	Tip	Açıklama
Username	`MCP__ClickHouse__Username`	String	Ayrı ClickHouse kullanıcı adı. Production kullanıcısına yalnız yapılandırılmış telemetri ve log tablolarında `SELECT` verilmelidir.
Password	`MCP__ClickHouse__Password`	Secret	Ayrı ClickHouse kullanıcısının parolası. Production secret'ını kaynak koda eklemek yerine korumalı environment variable veya secret store kullanın.
AllowSharedCredentialsInDevelopment	`MCP__ClickHouse__AllowSharedCredentialsInDevelopment`	Bool	Yalnız development ortamında platform ClickHouse kimlik bilgilerine fallback izni verir. Production'da kapalı tutun.
DefaultHours	`MCP__ClickHouse__DefaultHours`	Int	MCP telemetri sorguları için varsayılan geriye dönük zaman penceresi (saat).
MaxHours	`MCP__ClickHouse__MaxHours`	Int	MCP telemetri sorguları için izin verilen en uzun geriye dönük zaman penceresi (saat).
MaxResultRows	`MCP__ClickHouse__MaxResultRows`	Int	Tek MCP telemetri sorgusunun döndürebileceği satır sayısı için kesin üst sınır.
MaxRowsToRead	`MCP__ClickHouse__MaxRowsToRead`	Long	ClickHouse'un tek sorguda tarayabileceği maksimum satır sayısı.
MaxBytesToRead	`MCP__ClickHouse__MaxBytesToRead`	Long	ClickHouse'un tek sorguda okuyabileceği maksimum kaynak byte sayısı.
MaxMemoryUsage	`MCP__ClickHouse__MaxMemoryUsage`	Long	Tek sorgu için byte cinsinden maksimum ClickHouse bellek kullanımı.
MaxExecutionTimeSeconds	`MCP__ClickHouse__MaxExecutionTimeSeconds`	Int	Tek sorgu için maksimum çalışma süresi.
MaxThreads	`MCP__ClickHouse__MaxThreads`	Int	Tek sorguda kullanılabilecek maksimum ClickHouse worker thread sayısı.
MaxResultBytes	`MCP__ClickHouse__MaxResultBytes`	Long	Byte cinsinden maksimum yanıt payload boyutu.

Tüm güvenlik sınırları pozitif olmalıdır. Sınıra ulaşan sorgu kontrollü bir kaynak-sınırı yanıtıyla kapanır; ajan önce limitleri yükseltmek yerine cihaz, tag veya zaman kapsamını daraltmalıdır.

Üst Seviye Konfigürasyon

Tek bir anahtar tutan üst seviye TOML bölümlerini kontrol eder.

TOML Anahtarı	Ortam Değişkeni	Tip	Açıklama
`[Development]` AllowedHosts	`Development__AllowedHosts`	String	İzin verilen ana bilgisayar başlıklarının virgülle ayrılmış listesi.
`[Culture]` Name	`Culture__Name`	String	.NET Kültürünü zorla (örn. `tr-TR`).
`[Kestrel.EndpointDefaults]` Protocols	`Kestrel__EndpointDefaults__Protocols`	String	HTTP Protokol sürümleri (örn. `Http1AndHttp2`, `Http2`).

Ana Bilgisayar Ortamı

Bunlar Proxus konfigürasyonunun parçası değil; .NET çalışma zamanı tarafından tüketilen gerçek işletim sistemi ortam değişkenleridir. Tamlık için listelenmiştir.

Değişken Adı	Açıklama
DYLD_FALLBACK_LIBRARY_PATH	Sistem kütüphanesi yolu geçersiz kılma (macOS/Linux yerel birlikte çalışabilirliği için kritik).
ASPNETCORE_ENVIRONMENT	ASP.NET Core hosting ortamı (örn. `Production`, `Development`).