{"id":35449,"date":"2025-11-29T22:01:03","date_gmt":"2025-11-29T19:01:03","guid":{"rendered":"https:\/\/fatihsoysal.com\/blog\/modern-options-modeli-ile-nette-coklu-istemci-konfigurasyon-baglama\/"},"modified":"2025-11-29T22:01:03","modified_gmt":"2025-11-29T19:01:03","slug":"modern-options-modeli-ile-nette-coklu-istemci-konfigurasyon-baglama","status":"publish","type":"post","link":"https:\/\/fatihsoysal.com\/blog\/modern-options-modeli-ile-nette-coklu-istemci-konfigurasyon-baglama\/","title":{"rendered":"Modern Options Modeli ile .NET’te \u00c7oklu \u0130stemci Konfig\u00fcrasyon Ba\u011flama"},"content":{"rendered":"

<\/p>\n

G\u00fcn\u00fcm\u00fcz\u00fcn h\u0131zla de\u011fi\u015fen yaz\u0131l\u0131m d\u00fcnyas\u0131nda, bir uygulaman\u0131n birden fazla istemciye (tenant) hizmet vermesi giderek yayg\u0131nla\u015fan bir mimari yakla\u015f\u0131md\u0131r. SaaS (Software as a Service) uygulamalar\u0131ndan mikroservis tabanl\u0131 \u00e7\u00f6z\u00fcmlere kadar pek \u00e7ok senaryoda, her istemcinin kendine \u00f6zg\u00fc ayarlara veya davran\u0131\u015flara sahip olmas\u0131 gerekebilir. Bu durum, .NET uygulamalar\u0131nda konfig\u00fcrasyon y\u00f6netimini karma\u015f\u0131k bir hale getirebilir. Geleneksel y\u00f6ntemlerle her istemci i\u00e7in ayr\u0131 ayr\u0131 ayarlar\u0131 y\u00f6netmek, \u00f6zellikle istemci say\u0131s\u0131 artt\u0131\u011f\u0131nda, s\u00fcrd\u00fcr\u00fclebilirlik ve esneklik a\u00e7\u0131s\u0131ndan ciddi zorluklar do\u011furur. Peki, bu karma\u015f\u0131kl\u0131\u011f\u0131 nas\u0131l a\u015fabiliriz? Modern .NET’in sundu\u011fu g\u00fc\u00e7l\u00fc “Options Pattern” (Se\u00e7enekler Deseni) bu noktada imdad\u0131m\u0131za yeti\u015fiyor. Bu makalede, \u00e7oklu istemci senaryolar\u0131nda .NET uygulamalar\u0131n\u0131z\u0131n konfig\u00fcrasyon y\u00f6netimini modern Options deseniyle nas\u0131l kolayla\u015ft\u0131raca\u011f\u0131n\u0131z\u0131 ke\u015ffedecek, ad\u0131m ad\u0131m rehberler ve pratik \u00f6rneklerle uygulayarak bu g\u00fc\u00e7l\u00fc deseni projenize entegre etmeyi \u00f6\u011freneceksiniz.<\/p>\n

\u00c7oklu istemci mimarilerinde, her bir istemcinin kendine \u00f6zg\u00fc veritaban\u0131 ba\u011flant\u0131 dizeleri, harici API anahtarlar\u0131, performans ayarlar\u0131 veya kullan\u0131c\u0131 aray\u00fcz\u00fc tercihleri olabilir. Bu konfig\u00fcrasyonlar\u0131 dinamik olarak, uygulama yeniden ba\u015flat\u0131lmadan veya kodda de\u011fi\u015fiklik yapmadan y\u00f6netebilmek, modern ve esnek bir uygulama i\u00e7in hayati \u00f6nem ta\u015f\u0131r. Options deseni, bu t\u00fcr dinamik konfig\u00fcrasyon ihtiya\u00e7lar\u0131na g\u00fc\u00e7l\u00fc, tip g\u00fcvenli ve performansl\u0131 bir \u00e7\u00f6z\u00fcm sunar. Okuyucunun konuya s\u0131f\u0131rdan hakim olmas\u0131n\u0131 sa\u011flayacak bir yakla\u015f\u0131mla, temel kavramlardan ba\u015flay\u0131p ileri d\u00fczey implementasyonlara kadar ilerleyece\u011fiz. B\u00f6ylece, hem yeni ba\u015flayanlar hem de deneyimli .NET geli\u015ftiricileri i\u00e7in de\u011ferli bilgiler sunmay\u0131 hedefliyoruz. Bu yolculuk boyunca, ger\u00e7ek d\u00fcnya senaryolar\u0131yla konuyu somutla\u015ft\u0131racak ve pratik ipu\u00e7lar\u0131yla \u00e7\u00f6z\u00fcm yetene\u011finizi geli\u015ftirece\u011fiz.<\/p>\n

.NET Options Deseni: Modern Uygulamalar\u0131n Temel Ta\u015f\u0131<\/h2>\n

.NET Core ve .NET 5+ ile birlikte gelen konfig\u00fcrasyon sistemi, uygulamalar\u0131m\u0131z\u0131n ayarlar\u0131n\u0131 y\u00f6netme \u015feklimizde devrim niteli\u011finde de\u011fi\u015fiklikler getirdi. Bu sistemin en g\u00fc\u00e7l\u00fc bile\u015fenlerinden biri de Options Deseni’dir. Options deseni, konfig\u00fcrasyon verilerini strongly typed (kesin tipli) C# s\u0131n\u0131flar\u0131na ba\u011flayarak, kod i\u00e7erisinde bu verilere g\u00fcvenli ve d\u00fczenli bir \u015fekilde eri\u015fmemizi sa\u011flar. Geleneksel y\u00f6ntemlerle IConfiguration<\/code> aray\u00fcz\u00fcn\u00fc kullanarak string tabanl\u0131 eri\u015fim yerine, Options deseni ile intellisense deste\u011fi al\u0131r, yaz\u0131m hatalar\u0131n\u0131 derleme zaman\u0131nda yakalar ve kodun daha okunabilir olmas\u0131n\u0131 sa\u011flar\u0131z.<\/p>\n

Bu desenin kalbinde \u00fc\u00e7 ana aray\u00fcz bulunur: IOptions<\/code>, IOptionsSnapshot<\/code> ve IOptionsMonitor<\/code>. Her birinin farkl\u0131 kullan\u0131m senaryolar\u0131 ve \u00f6zellikleri vard\u0131r:<\/p>\n

\nIOptions<\/code>: Uygulama \u00f6mr\u00fc boyunca de\u011fi\u015fmeyen, statik konfig\u00fcrasyonlar i\u00e7in idealdir. Singleton olarak kaydedilir ve konfig\u00fcrasyon verileri uygulaman\u0131n ba\u015flang\u0131c\u0131nda bir kez y\u00fcklenir. De\u011fi\u015fiklikler otomatik olarak alg\u0131lanmaz. Bu nedenle, s\u00fcrekli de\u011fi\u015fmesi beklenmeyen, genel uygulama ayarlar\u0131 i\u00e7in tercih edilir.<\/li>\n
IOptionsSnapshot<\/code>: Request (istek) bazl\u0131 veya scoped konfig\u00fcrasyonlar i\u00e7in tasarlanm\u0131\u015ft\u0131r. Her HTTP iste\u011fi veya her servis scope’u i\u00e7in konfig\u00fcrasyonun anl\u0131k bir “snapshot”\u0131n\u0131 sa\u011flar. Uygulama ba\u015flat\u0131ld\u0131ktan sonra appsettings.json<\/code> gibi kaynaklarda yap\u0131lan de\u011fi\u015fiklikler, yeni bir istek geldi\u011finde otomatik olarak alg\u0131lan\u0131r ve g\u00fcncel de\u011ferler d\u00f6nd\u00fcr\u00fcl\u00fcr. Bu sayede, uygulaman\u0131z\u0131 yeniden ba\u015flatmaya gerek kalmadan konfig\u00fcrasyon g\u00fcncellemelerini y\u00f6netebilirsiniz. \u00c7oklu istemci senaryolar\u0131nda dinamik konfig\u00fcrasyon i\u00e7in genellikle en uygun se\u00e7enektir.<\/li>\n
IOptionsMonitor<\/code>: Konfig\u00fcrasyon de\u011fi\u015fikliklerini anl\u0131k olarak takip etmek isteyen ve bu de\u011fi\u015fikliklere reaktif olarak yan\u0131t vermesi gereken servisler i\u00e7in kullan\u0131l\u0131r. Singleton olarak kaydedilir ve her zaman en g\u00fcncel konfig\u00fcrasyon de\u011ferini sa\u011flar. Ayr\u0131ca, konfig\u00fcrasyon de\u011fi\u015fti\u011finde tetiklenecek olaylara abone olma yetene\u011fi de sunar. Uzun \u00f6m\u00fcrl\u00fc servisler veya \u00f6nbellekleme mekanizmalar\u0131 i\u00e7in olduk\u00e7a faydal\u0131d\u0131r.<\/li>\n<\/ul>\nOptions deseni, Microsoft.Extensions.Configuration<\/code> ve Microsoft.Extensions.Options<\/code> k\u00fct\u00fcphaneleri arac\u0131l\u0131\u011f\u0131yla g\u00fc\u00e7l\u00fc bir \u015fekilde entegre edilmi\u015ftir. Bu sayede, uygulaman\u0131n ba\u015flang\u0131c\u0131nda, IServiceCollection<\/code> \u00fczerine AddOptions<\/code> metodunu kullanarak konfig\u00fcrasyon s\u0131n\u0131flar\u0131n\u0131z\u0131 kaydedebilir ve Bind<\/code> metodu ile IConfiguration<\/code>‘dan gelen verileri bu s\u0131n\u0131flara ba\u011flayabilirsiniz. Bu yap\u0131, konfig\u00fcrasyon y\u00f6netimini daha mod\u00fcler, test edilebilir ve s\u00fcrd\u00fcr\u00fclebilir hale getirir. Options deseni, .NET ekosisteminde Dependency Injection (Ba\u011f\u0131ml\u0131l\u0131k Enjeksiyonu) ile birlikte kullan\u0131ld\u0131\u011f\u0131nda tam potansiyeline ula\u015f\u0131r, b\u00f6ylece konfig\u00fcrasyon ayarlar\u0131n\u0131 ihtiya\u00e7 duyan servislere kolayca enjekte edebilirsiniz.<\/p>\n
\u00c7oklu \u0130stemci Ortamlar\u0131nda Konfig\u00fcrasyon Y\u00f6netiminin Zorluklar\u0131 Nelerdir?<\/h2>\n\u00c7oklu istemci (multi-tenant) uygulamalar geli\u015ftirirken konfig\u00fcrasyon y\u00f6netimi, tek istemcili uygulamalara k\u0131yasla \u00f6nemli \u00f6l\u00e7\u00fcde karma\u015f\u0131kla\u015fabilir. Her istemcinin kendine \u00f6zg\u00fc ayarlar\u0131 olmas\u0131 gerekti\u011finde, bu ayarlar\u0131 do\u011fru, g\u00fcvenli ve esnek bir \u015fekilde uygulamaya entegre etmek bir dizi zorlu\u011fu beraberinde getirir. Bu zorluklar\u0131 anlamak, Options deseni gibi modern \u00e7\u00f6z\u00fcmlerin de\u011ferini daha iyi kavramam\u0131za yard\u0131mc\u0131 olacakt\u0131r.<\/p>\n
\u0130lk olarak, kod tekrar\u0131 ve y\u00f6netilebilirlik sorunlar\u0131<\/strong> kar\u015f\u0131m\u0131za \u00e7\u0131kar. Her istemci i\u00e7in ayr\u0131 ayr\u0131 sabit kodlanm\u0131\u015f (hard-coded) de\u011ferler kullanmak, kodun kalabal\u0131kla\u015fmas\u0131na, hatalara daha a\u00e7\u0131k hale gelmesine ve bak\u0131m\u0131n\u0131n zorla\u015fmas\u0131na neden olur. Yeni bir istemci eklendi\u011finde veya mevcut bir istemcinin ayarlar\u0131 de\u011fi\u015fti\u011finde, kodda manuel de\u011fi\u015fiklikler yapmak zorunda kalmak, \u00f6zellikle b\u00fcy\u00fck uygulamalarda, s\u00fcrd\u00fcr\u00fclemez bir durumdur. Ayr\u0131ca, her istemci i\u00e7in ayr\u0131 appsettings.json<\/code> dosyalar\u0131 kullanmaya \u00e7al\u0131\u015fmak da deploy (da\u011f\u0131t\u0131m) s\u00fcre\u00e7lerini karma\u015f\u0131kla\u015ft\u0131r\u0131r ve hata potansiyelini art\u0131r\u0131r.<\/p>\n
\u0130kinci \u00f6nemli zorluk, dinamik konfig\u00fcrasyon de\u011fi\u015fiklikleri ve uygulama yeniden ba\u015flatmalar\u0131<\/strong>d\u0131r. Bir SaaS uygulamas\u0131nda, bir istemcinin abonelik seviyesi de\u011fi\u015fti\u011finde veya yeni bir \u00f6zellik a\u00e7\u0131ld\u0131\u011f\u0131nda, uygulaman\u0131n bu de\u011fi\u015fikli\u011fi an\u0131nda alg\u0131lamas\u0131 ve ilgili konfig\u00fcrasyonu g\u00fcncellemesi gerekebilir. Geleneksel konfig\u00fcrasyon y\u00f6ntemleri genellikle uygulama yeniden ba\u015flat\u0131lmas\u0131n\u0131 gerektirir, bu da kullan\u0131c\u0131 deneyimini olumsuz etkiler ve y\u00fcksek eri\u015filebilirlik gerektiren sistemler i\u00e7in kabul edilemezdir. \u00c7oklu istemci ortam\u0131nda her istemcinin ayarlar\u0131n\u0131 dinamik olarak ve uygulamay\u0131 kesintiye u\u011fratmadan g\u00fcncelleyebilmek kritik bir ihtiya\u00e7t\u0131r.<\/p>\n
\u00dc\u00e7\u00fcnc\u00fcs\u00fc, g\u00fcvenlik ve hassas veri y\u00f6netimi<\/strong>dir. Her istemcinin kendine ait API anahtarlar\u0131, veritaban\u0131 ba\u011flant\u0131 dizeleri veya \u015fifreleri gibi hassas bilgilerini bar\u0131nd\u0131rmak zorunda kalabiliriz. Bu bilgilerin yanl\u0131\u015fl\u0131kla bir istemciden di\u011ferine s\u0131zmas\u0131n\u0131 \u00f6nlemek veya genel olarak bu t\u00fcr verileri g\u00fcvenli bir \u015fekilde depolamak ve eri\u015fmek b\u00fcy\u00fck bir endi\u015fe kayna\u011f\u0131d\u0131r. Konfig\u00fcrasyon dosyalar\u0131na do\u011frudan yazmak yerine, g\u00fcvenli depolama mekanizmalar\u0131n\u0131 (Azure Key Vault gibi) entegre etmek ve bu verilere istemci baz\u0131nda, yetkilendirme kontroll\u00fc eri\u015fim sa\u011flamak zorunluluk haline gelir.<\/p>\n
Son olarak, \u00f6l\u00e7eklenebilirlik ve performans<\/strong> sorunlar\u0131 g\u00f6z ard\u0131 edilemez. Y\u00fczlerce veya binlerce istemciye hizmet veren bir uygulamada, her bir istemcinin konfig\u00fcrasyonunu verimli bir \u015fekilde y\u00fcklemek ve y\u00f6netmek performans\u0131 do\u011frudan etkileyebilir. Gereksiz yere t\u00fcm konfig\u00fcrasyonlar\u0131 y\u00fcklemek veya her istekte ayn\u0131 ayarlar\u0131 tekrar tekrar okumak kaynak israf\u0131na yol a\u00e7abilir. Bu zorluklar\u0131n \u00fcstesinden gelmek i\u00e7in, konfig\u00fcrasyonlar\u0131n ak\u0131ll\u0131ca \u00f6nbelle\u011fe al\u0131nmas\u0131, tembel y\u00fckleme (lazy loading) tekniklerinin kullan\u0131lmas\u0131 ve optimize edilmi\u015f veri eri\u015fim stratejilerinin benimsenmesi gerekir. Modern Options deseni, t\u00fcm bu zorluklar\u0131 ele almak i\u00e7in g\u00fc\u00e7l\u00fc ve esnek bir \u00e7er\u00e7eve sunar.<\/p>\n
Modern Options Deseni ile \u00c7oklu \u0130stemci Konfig\u00fcrasyon Ba\u011flama: Ad\u0131m Ad\u0131m Rehber<\/h2>\n\u00c7oklu istemci (multi-tenant) uygulamalar\u0131nda Options desenini kullanarak dinamik konfig\u00fcrasyon y\u00f6netimi yapmak, karma\u015f\u0131k g\u00f6r\u00fcnen bir problemi \u015f\u0131k bir \u00e7\u00f6z\u00fcme d\u00f6n\u00fc\u015ft\u00fcrebilir. Temel ama\u00e7, her gelen istek i\u00e7in hangi istemcinin ayarlar\u0131n\u0131n ge\u00e7erli oldu\u011funu belirlemek ve bu ayarlara tip g\u00fcvenli bir \u015fekilde eri\u015fimi sa\u011flamakt\u0131r. Bu b\u00f6l\u00fcmde, bu s\u00fcreci ad\u0131m ad\u0131m inceleyecek ve pratik kod \u00f6rnekleriyle peki\u015ftirece\u011fiz.<\/p>\n
\u00d6ncelikle, her istemcinin ayarlar\u0131n\u0131 temsil edecek bir C# s\u0131n\u0131f\u0131 tan\u0131mlamam\u0131z gerekiyor. Bu s\u0131n\u0131f, konfig\u00fcrasyon dosyas\u0131ndaki ilgili b\u00f6l\u00fcmle e\u015fle\u015fmelidir. \u00d6rne\u011fin, bir API servisi i\u00e7in istemciye \u00f6zel bir anahtar ve URL tutabiliriz:<\/p>\n
\npublic class ClientSpecificSettings\n{\n    public string ApiKey { get; set; }\n    public string ServiceUrl { get; set; }\n    public int TimeoutSeconds { get; set; } = 30; \/\/ Varsay\u0131lan de\u011fer\n}\n  <\/pre>\n<\/code><\/p>\n
Ard\u0131ndan, bu ayarlar\u0131 depolayaca\u011f\u0131m\u0131z bir konfig\u00fcrasyon kayna\u011f\u0131na ihtiyac\u0131m\u0131z var. appsettings.json<\/code> dosyas\u0131 bu i\u015f i\u00e7in kullan\u0131labilir ve her istemci i\u00e7in ayr\u0131 bir b\u00f6l\u00fcm tan\u0131mlayabiliriz. \u0130stemci adlar\u0131n\u0131 veya kimliklerini bu b\u00f6l\u00fcmlerin anahtar\u0131 olarak kullanmak yayg\u0131n bir yakla\u015f\u0131md\u0131r:<\/p>\n
\n{\n  \"Logging\": {\n    \"LogLevel\": {\n      \"Default\": \"Information\",\n      \"Microsoft.AspNetCore\": \"Warning\"\n    }\n  },\n  \"AllowedHosts\": \"*\",\n  \"ClientA\": {\n    \"ApiKey\": \"API_KEY_CLIENT_A_123\",\n    \"ServiceUrl\": \"https:\/\/api.clienta.com\/v1\",\n    \"TimeoutSeconds\": 45\n  },\n  \"ClientB\": {\n    \"ApiKey\": \"API_KEY_CLIENT_B_456\",\n    \"ServiceUrl\": \"https:\/\/api.clientb.com\/v2\",\n    \"TimeoutSeconds\": 60\n  },\n  \"DefaultClient\": {\n    \"ApiKey\": \"DEFAULT_API_KEY\",\n    \"ServiceUrl\": \"https:\/\/api.default.com\/v1\",\n    \"TimeoutSeconds\": 30\n  }\n}\n  <\/pre>\n<\/code><\/p>\n
Bu yap\u0131da, her istemci i\u00e7in belirli bir isim alt\u0131nda ayarlar gruplanm\u0131\u015ft\u0131r. \u015eimdi bu named options (isimlendirilmi\u015f se\u00e7enekler) yap\u0131s\u0131n\u0131 .NET<\/code> DI konteynerine kaydetmemiz gerekiyor. Bu i\u015flemi Program.cs<\/code> veya Startup.cs<\/code> dosyan\u0131zdaki ConfigureServices<\/code> metodunda yapabilirsiniz:<\/p>\n
\npublic void ConfigureServices(IServiceCollection services)\n{\n    \/\/ HttpContextAccessor'\u0131 ekliyoruz ki, istek baz\u0131nda ClientId'ye eri\u015febilelim\n    services.AddHttpContextAccessor(); \n\n    \/\/ Her bir istemci i\u00e7in named options kaydediyoruz. \n    \/\/ \"ClientA\" ve \"ClientB\" appsettings.json'daki b\u00f6l\u00fcmlerle e\u015fle\u015fmeli.\n    services.AddOptions(\"ClientA\")\n            .Bind(Configuration.GetSection(\"ClientA\"));\n\n    services.AddOptions(\"ClientB\")\n            .Bind(Configuration.GetSection(\"ClientB\"));\n\n    services.AddOptions(\"DefaultClient\")\n            .Bind(Configuration.GetSection(\"DefaultClient\"));\n\n    \/\/ \u0130stemciye \u00f6zg\u00fc konfig\u00fcrasyonu \u00e7\u00f6z\u00fcmleyecek servisi kaydediyoruz.\n    \/\/ Bu servis her istek i\u00e7in yeni bir ClientSpecificSettings \u00f6rne\u011fi d\u00f6nd\u00fcrecek.\n    services.AddScoped(sp =>\n    {\n        var httpContextAccessor = sp.GetRequiredService();\n        var optionsMonitor = sp.GetRequiredService>();\n\n        \/\/ X-Client-Id ba\u015fl\u0131\u011f\u0131ndan veya route verisinden istemci kimli\u011fini alabiliriz.\n        \/\/ Burada basit\u00e7e HTTP ba\u015fl\u0131\u011f\u0131n\u0131 kullan\u0131yoruz.\n        var clientId = httpContextAccessor.HttpContext?.Request.Headers[\"X-Client-Id\"].FirstOrDefault() \n                       ?? \"DefaultClient\"; \/\/ Varsay\u0131lan istemciye fallback\n\n        \/\/ \u0130stemci kimli\u011fine g\u00f6re named option'\u0131 al\u0131yoruz\n        return optionsMonitor.Get(clientId);\n    });\n\n    \/\/ Opsiyonel olarak, IClientConfigurationResolver aray\u00fcz\u00fc ile daha temiz bir ba\u011f\u0131ml\u0131l\u0131k\n    \/\/ enjeksiyonu sa\u011flayabiliriz.\n    \/\/ services.AddScoped();\n}\n  <\/pre>\n<\/code><\/p>\n
Yukar\u0131daki kod blo\u011funda dikkat etmeniz gereken en \u00f6nemli nokta, AddScoped<\/code> ile ClientSpecificSettings<\/code> tipini do\u011frudan kaydedi\u015fimizdir. Bu, her HTTP iste\u011fi (request) i\u00e7in ClientSpecificSettings<\/code>'in yeni bir \u00f6rne\u011finin olu\u015fturulmas\u0131n\u0131 ve o istek s\u0131ras\u0131nda belirlenen istemciye ait konfig\u00fcrasyon de\u011ferleriyle doldurulmas\u0131n\u0131 sa\u011flar. Bu sayede, uygulaman\u0131n herhangi bir yerinde ClientSpecificSettings<\/code>'i do\u011frudan enjekte etti\u011finizde, o anki iste\u011fe ait do\u011fru ayarlar\u0131 otomatik olarak al\u0131rs\u0131n\u0131z.<\/p>\n
Uygulama Mimarisi ve Kod \u00d6rnekleri<\/h3>\nKonfig\u00fcrasyonlar\u0131 ba\u015far\u0131l\u0131 bir \u015fekilde kaydettikten sonra, bu ayarlara servislerimizden nas\u0131l eri\u015fece\u011fimize bakal\u0131m. Art\u0131k herhangi bir serviste ClientSpecificSettings<\/code> s\u0131n\u0131f\u0131n\u0131 do\u011frudan enjekte edebiliriz. \u00c7\u00fcnk\u00fc AddScoped<\/code> ile kaydetti\u011fimiz fabrika metodu, o anki istemciye ait ayarlar\u0131 d\u00f6nd\u00fcrecektir:<\/p>\n
\npublic class ThirdPartyApiService\n{\n    private readonly ClientSpecificSettings _clientSettings;\n\n    \/\/ ClientSpecificSettings do\u011frudan enjekte ediliyor.\n    \/\/ IOptionsSnapshot yerine do\u011frudan T tipi enjekte edildi\u011finde,\n    \/\/ AddScoped'daki fabrika metodu devreye girer.\n    public ThirdPartyApiService(ClientSpecificSettings clientSettings)\n    {\n        _clientSettings = clientSettings ?? throw new ArgumentNullException(nameof(clientSettings));\n    }\n\n    public async Task CallClientApiAsync(string endpoint)\n    {\n        Console.WriteLine($\"\u0130stemci Ayarlar\u0131 - API Key: {_clientSettings.ApiKey}, URL: {_clientSettings.ServiceUrl}, Timeout: {_clientSettings.TimeoutSeconds}s\");\n\n        using var httpClient = new HttpClient();\n        httpClient.Timeout = TimeSpan.FromSeconds(_clientSettings.TimeoutSeconds);\n        httpClient.DefaultRequestHeaders.Add(\"X-Api-Key\", _clientSettings.ApiKey);\n\n        var requestUrl = $\"{_clientSettings.ServiceUrl}\/{endpoint}\";\n        Console.WriteLine($\"Calling API at: {requestUrl}\");\n\n        try\n        {\n            var response = await httpClient.GetStringAsync(requestUrl);\n            return response;\n        }\n        catch (HttpRequestException ex)\n        {\n            Console.WriteLine($\"API \u00e7a\u011fr\u0131s\u0131 ba\u015far\u0131s\u0131z oldu: {ex.Message}\");\n            throw;\n        }\n    }\n}\n  <\/pre>\n<\/code><\/p>\n
Bu yakla\u015f\u0131m, kodunuzu \u00e7ok daha temiz ve okunakl\u0131 hale getirir. Her servis, kendi ihtiyac\u0131 olan konfig\u00fcrasyonlar\u0131 do\u011frudan al\u0131r ve hangi istemciye ait oldu\u011funu bilme veya belirleme y\u00fck\u00fc ta\u015f\u0131maz. Bu sorumluluk, Dependency Injection konteynerine ve bizim AddScoped<\/code> i\u00e7inde tan\u0131mlad\u0131\u011f\u0131m\u0131z \u00e7\u00f6z\u00fcmleme mant\u0131\u011f\u0131na aittir.<\/p>\n
\n    Uzman \u0130pucu: \u0130stemci kimli\u011fini belirlemek i\u00e7in sadece HTTP ba\u015fl\u0131klar\u0131n\u0131 kullanmak yerine, URL'deki bir segmenti (\u00f6rne\u011fin, \/api\/{clientId}\/...<\/code>) veya bir JWT token i\u00e7indeki iddia (claim) de\u011ferini de kullanabilirsiniz. Bu, daha esnek ve g\u00fcvenli bir kimlik belirleme stratejisi sunar.
\n  <\/aside>\nBu \u00e7\u00f6z\u00fcmle, \u00e7oklu istemci konfig\u00fcrasyonlar\u0131n\u0131 y\u00f6netirken hem esneklik hem de performans elde etmi\u015f olursunuz. IOptionsMonitor<\/code>'\u0131n kullan\u0131lmas\u0131, appsettings.json<\/code> dosyas\u0131nda d\u0131\u015far\u0131dan yap\u0131lan de\u011fi\u015fikliklerin bile uygulama yeniden ba\u015flat\u0131lmadan alg\u0131lanabilmesini sa\u011flar, ki bu \u00f6zellikle konfig\u00fcrasyonlar\u0131n s\u0131k g\u00fcncellendi\u011fi veya harici kaynaklardan geldi\u011fi senaryolarda paha bi\u00e7ilmezdir. Ayr\u0131ca, bu desenin sa\u011flad\u0131\u011f\u0131 tip g\u00fcvenli\u011fi sayesinde, konfig\u00fcrasyon de\u011ferlerine yanl\u0131\u015f bir isimle eri\u015fme veya yanl\u0131\u015f t\u00fcrde bir de\u011fer okuma riskini minimize edersiniz.<\/p>\n
Ger\u00e7ek D\u00fcnya Senaryosu, Performans ve G\u00fcvenlik \u0130pu\u00e7lar\u0131: \u0130leri D\u00fczey Konular<\/h2>\n\u015eimdiye kadar ele ald\u0131\u011f\u0131m\u0131z mekanizmalar\u0131n ger\u00e7ek bir SaaS (Software as a Service) platformunda nas\u0131l de\u011fer yaratt\u0131\u011f\u0131na dair bir vaka analizine ve ard\u0131ndan performans ile g\u00fcvenlik ipu\u00e7lar\u0131na g\u00f6z atal\u0131m.<\/p>\n
Vaka Analizi: SaaS Platformunda Dinamik \u0130stemci Konfig\u00fcrasyonu<\/h3>\nHayal edin ki, farkl\u0131 abonelik seviyelerine (Basic, Premium, Enterprise) sahip bir e-ticaret analiz platformu geli\u015ftiriyorsunuz. Her abonelik seviyesi i\u00e7in farkl\u0131 \u00f6zellikler aktif ediliyor, farkl\u0131 veri saklama s\u00fcreleri uygulan\u0131yor ve hatta entegre olunan \u00fc\u00e7\u00fcnc\u00fc taraf API'lerin kullan\u0131m limitleri veya anahtarlar\u0131 de\u011fi\u015fiyor olabilir. \u00d6rne\u011fin:<\/p>\n
\nBasic \u0130stemciler:<\/strong> Yaln\u0131zca son 30 g\u00fcnl\u00fck verileri g\u00f6rebilir, raporlama \u00f6zellikleri s\u0131n\u0131rl\u0131d\u0131r ve g\u00fcnde 1000 API \u00e7a\u011fr\u0131s\u0131 limitine sahiptirler.<\/li>\n
Premium \u0130stemciler:<\/strong> Son 1 y\u0131ll\u0131k verileri analiz edebilir, geli\u015fmi\u015f raporlama se\u00e7eneklerine sahiptir ve g\u00fcnde 10.000 API \u00e7a\u011fr\u0131s\u0131 limitine sahiptirler.<\/li>\n
Enterprise \u0130stemciler:<\/strong> S\u0131n\u0131rs\u0131z veri saklama, \u00f6zel entegrasyonlar ve g\u00fcnde 100.000 API \u00e7a\u011fr\u0131s\u0131 veya daha fazlas\u0131 gibi y\u00fcksek limitlere sahiptirler.<\/li>\n<\/ul>\nBu senaryoda, her gelen istek i\u00e7in hangi istemcinin ayarlar\u0131n\u0131n ge\u00e7erli oldu\u011funu bilmek ve uygulamay\u0131 bu ayarlara g\u00f6re dinamik olarak yap\u0131land\u0131rmak zorunludur. Modern Options deseni tam da bu noktada devreye girer. \u0130stek ba\u015fl\u0131klar\u0131ndan, JWT token'dan veya bir \u00f6zel middleware arac\u0131l\u0131\u011f\u0131yla belirlenen istemci kimli\u011fi (tenant ID) kullan\u0131larak, IOptionsMonitor<\/code> ile ilgili istemcinin t\u00fcm konfig\u00fcrasyonlar\u0131 (veri saklama s\u00fcresi, API limitleri, entegrasyon anahtarlar\u0131 vb.) an\u0131nda y\u00fcklenir ve servislere enjekte edilir. B\u00f6ylece, ayn\u0131 kod taban\u0131 farkl\u0131 istemcilere farkl\u0131 i\u015flevsellikler sunabilir. Yeni bir Premium istemci kaydoldu\u011funda, sadece veritaban\u0131ndaki abonelik bilgisini g\u00fcncellemek veya appsettings.json<\/code>'a yeni bir istemci konfig\u00fcrasyonu eklemek yeterli olur; uygulama kodu yeniden derlenip da\u011f\u0131t\u0131lmaya gerek kalmaz. Bu, s\u00fcrekli da\u011f\u0131t\u0131m (Continuous Deployment) ve h\u0131zl\u0131 adaptasyon yetene\u011fi i\u00e7in kritik bir avantajd\u0131r.<\/p>\n
Performans ve G\u00fcvenlik \u0130pu\u00e7lar\u0131<\/h3>\n\u00c7oklu istemci konfig\u00fcrasyonlar\u0131n\u0131 y\u00f6netirken hem performans hem de g\u00fcvenlik konular\u0131n\u0131 g\u00f6z \u00f6n\u00fcnde bulundurmak hayati \u00f6nem ta\u015f\u0131r:<\/p>\n
\nPerformans Optimizasyonu:<\/strong>\n\n\u00d6nbellekleme:<\/strong> \u00d6zellikle veritaban\u0131 veya harici bir servisten y\u00fcklenen konfig\u00fcrasyonlar i\u00e7in g\u00fc\u00e7l\u00fc bir \u00f6nbellekleme mekanizmas\u0131 kullan\u0131n. IOptionsMonitor<\/code> zaten de\u011fi\u015fiklikleri izleyerek dahili bir \u00f6nbellek sunar, ancak e\u011fer konfig\u00fcrasyonlar \u00e7ok s\u0131k de\u011fi\u015fmiyorsa ve uygulama genelinde payla\u015f\u0131labilirse, IMemoryCache<\/code> gibi daha genel \u00f6nbellek \u00e7\u00f6z\u00fcmleriyle de performans art\u0131\u015f\u0131 sa\u011flayabilirsiniz.<\/li>\n
Tembel Y\u00fckleme (Lazy Loading):<\/strong> Yaln\u0131zca belirli bir \u00f6zellik veya servis taraf\u0131ndan kullan\u0131lan konfig\u00fcrasyonlar\u0131, ilgili \u00f6zellik veya servis \u00e7a\u011fr\u0131ld\u0131\u011f\u0131nda y\u00fckleyin. Bu, ba\u015flang\u0131\u00e7 y\u00fckleme s\u00fcrelerini azaltabilir.<\/li>\n
Do\u011fru Options T\u00fcr\u00fcn\u00fc Se\u00e7me:<\/strong> \u0130htiya\u00e7lar\u0131n\u0131za uygun IOptions<\/code>, IOptionsSnapshot<\/code> veya IOptionsMonitor<\/code> kullan\u0131n. \u00d6rne\u011fin, uygulama \u00f6mr\u00fc boyunca de\u011fi\u015fmeyen ayarlar i\u00e7in IOptions<\/code> kullanmak, gereksiz de\u011fi\u015fiklik izleme y\u00fck\u00fcn\u00fc ortadan kald\u0131r\u0131r.<\/li>\n<\/ul>\n<\/li>\n
G\u00fcvenlik Yakla\u015f\u0131m\u0131:<\/strong>\n\nHassas Veri Depolama:<\/strong> API anahtarlar\u0131, veritaban\u0131 ba\u011flant\u0131 dizeleri gibi hassas bilgileri appsettings.json<\/code> dosyalar\u0131nda do\u011frudan tutmaktan ka\u00e7\u0131n\u0131n. Bunun yerine, Azure Key Vault, AWS Secrets Manager gibi bulut tabanl\u0131 gizlilik y\u00f6netim servislerini veya ortam de\u011fi\u015fkenlerini (environment variables) kullan\u0131n. .NET<\/code>'in konfig\u00fcrasyon sistemi bu kaynaklar\u0131 do\u011fal olarak destekler.<\/li>\n
Yetkilendirme ve Eri\u015fim Kontrol\u00fc:<\/strong> Konfig\u00fcrasyonlara eri\u015fimi, rol tabanl\u0131 yetkilendirme (RBAC) ile s\u0131n\u0131rlay\u0131n. \u00d6zellikle konfig\u00fcrasyon y\u00f6netim aray\u00fczleri geli\u015ftiriyorsan\u0131z, sadece yetkili kullan\u0131c\u0131lar\u0131n de\u011fi\u015fiklik yapabilmesini sa\u011flay\u0131n.<\/li>\n
Giri\u015f Do\u011frulamas\u0131:<\/strong> E\u011fer konfig\u00fcrasyon verileri kullan\u0131c\u0131 girdilerinden veya d\u0131\u015f kaynaklardan geliyorsa, bu verileri her zaman do\u011frulay\u0131n (validation). Microsoft.Extensions.Options.DataAnnotations<\/code> gibi k\u00fct\u00fcphanelerle Options s\u0131n\u0131flar\u0131n\u0131za do\u011frulama kurallar\u0131 ekleyebilirsiniz.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\nBu ileri d\u00fczey ipu\u00e7lar\u0131, \u00e7oklu istemci uygulamalar\u0131n\u0131z\u0131n sadece i\u015flevsel de\u011fil, ayn\u0131 zamanda performansl\u0131 ve g\u00fcvenli olmas\u0131n\u0131 da sa\u011flayacakt\u0131r. Modern .NET ekosistemi, bu t\u00fcr karma\u015f\u0131k senaryolar i\u00e7in g\u00fc\u00e7l\u00fc ve esnek ara\u00e7lar sunarak geli\u015ftiricilerin i\u015fini \u00f6nemli \u00f6l\u00e7\u00fcde kolayla\u015ft\u0131rmaktad\u0131r. Ayr\u0131ca, farkl\u0131 istemci tipleri (mobil uygulama, web uygulamas\u0131) i\u00e7in de bu konfig\u00fcrasyonlar\u0131 merkezi olarak y\u00f6netebilir ve istemciye \u00f6zel UI veya davran\u0131\u015flar i\u00e7in de kullanabilirsiniz. \u00d6rne\u011fin, mobil uygulamalar\u0131n farkl\u0131 \u00e7\u00f6z\u00fcn\u00fcrl\u00fck veya \u00f6zellik setleri i\u00e7in belirli ayarlar\u0131 dinamik olarak almas\u0131, uygulaman\u0131n esnekli\u011fini art\u0131r\u0131r.<\/p>\n
\n