"Belirtilen belirteç bu kaynak sunucuyla kullanılamaz" yanıtını vermek ASP.NET dağıtıldığında bir hata oluşuyor.

ASP.NET Dağıtımında SSO Belirteci Hatalarını Giderme

Tek Oturum Açma (SSO) kullanarak bir ASP.NET uygulamasını dağıtırken, geliştiricilerin yerel geliştirme ortamlarında deneyimlediklerinden farklı sorunlar ortaya çıkabilir. Yaygın sorunlardan biri şu hatayla karşılaşmaktır: "Belirtilen belirteç bu kaynak sunucuyla kullanılamaz". Yerel testler sırasında her şey mükemmel çalıştığında bu durum sinir bozucu olabilir.

Bu gibi durumlarda sorun genellikle Kimlik Sağlayıcının (IDP) canlı ve yerel ortamlardaki belirteçleri işleme şekli arasındaki tutarsızlıklarla ilgilidir. Örneğin, belirteç kitle değerlerindeki veya veren kuruluş URL'lerindeki farklılıklar, yetkilendirme hatalarını tetikleyebilir. Bu sorunlar genellikle korunan kaynaklarla etkileşimde bulunulduğunda 401 yetkisiz yanıtla sonuçlanır.

Bu makalede, özellikle token hedef kitlesi uyumsuzluklarına odaklanarak bu tür sorunların yaygın nedenlerini inceleyeceğiz. Ayrıca ASP.NET uygulamanızın belirteçlerinin hem yerel hem de konuşlandırılmış ortamlarda doğru şekilde doğrulandığından nasıl emin olabileceğinizi de keşfedeceğiz. Bu ayrımı anlamak sorunun çözümü açısından çok önemlidir.

Son olarak, üretimde belirteç doğrulama hatalarını önlemek için yapılandırma dosyalarınızı ayarlamaya ve IDP'nizi test etmeye yönelik en iyi uygulamaları sunacağız. Bu yönergeleri izleyerek ASP.NET uygulamalarınız için sorunsuz dağıtım ve güvenilir kimlik doğrulaması sağlayabilirsiniz.

ASP.NET SSO Dağıtımında Belirteç Doğrulamasını Anlama

Yukarıdaki örnekte temel sorun, yerel ve canlı ortamlarda oluşturulan tokenların hedef kitle değerindeki uyumsuzluk etrafında dönüyor. Bu durum genellikle Kimlik Sağlayıcı (IDP) farklı alan adları veya alt sayfalardaki belirteçleri düzgün şekilde işlemediğinde görülür. Sağlanan komut dosyaları, hedef kitle ve ihraççı ayarlarını ayarlayarak hem yerel hem de canlı ortamların belirteçleri tutarlı bir şekilde doğrulamasını sağlamaya odaklanıyor. Komut JwtTaşıyıcı Ekle özellikle ASP.NET'te JWT Taşıyıcı kimlik doğrulamasını yapılandırmak için kullanılır; bu, Tek Oturum Açma (SSO) bağlamında belirteçlerin işlenmesi için çok önemlidir. Bu komut, uygulamanın IDP tarafından verilen belirteçleri doğru şekilde yorumlayıp doğrulamasını sağlar.

İkinci önemli husus ise kullanımıdır. TokenDoğrulamaParametreleriJWT belirteçlerini doğrulamak için çeşitli kuralları ve parametreleri belirten. Tokenı verenin, hedef kitlenin ve son kullanma tarihinin her iki ortamda da doğru şekilde doğrulanmasını sağlar. Bu parametre son derece özelleştirilebilir ve geliştiricilerin birden fazla geçerli yayıncı ve hedef kitle belirlemesine olanak tanır; bu, yerel ve canlı kurulumlar arasındaki farklar nedeniyle bu durumda gereklidir. Komut dosyaları, hem canlı sistem URL'sinin hem de localhost URL'sinin dahil edildiğini gösterir. Geçerli İhraççılar dizi, her iki ortamdan da belirteçlerin kabul edilmesini sağlar.

Bunlara ek olarak yöntem GetLeftPart belirteç doğrulamasında kullanılan URL'leri basitleştirmek ve standartlaştırmak için kullanılır. URL'nin yalnızca gerekli kısmını (temel yetkili gibi) çıkararak bu yöntem, verenin ve hedef kitlenin nasıl ele alındığı konusunda tutarlılık sağlar. Bu komut, URL yapılarında sondaki eğik çizgilerin eksik olması gibi ince farklılıklar oluşturabilecek ortamlarla çalışırken çok önemlidir. Komut dosyası ayrıca hedef kitleyi dinamik olarak ayarlamak için bir çözüm sunarak tokenın ister localhost'ta ister canlı bir sistemde oluşturulmuş olsun geçerli olmasını sağlar.

Çözümün son kısmı, aşağıdakileri kullanarak birim testleri oluşturmayı içerir: İddia.Doğru xUnit test çerçevesinden komut. Bu testler, uygulamayı dağıtmadan önce hedef kitle ve veren kuruluş ayarlarının doğru şekilde yapılandırıldığını doğrulamak açısından çok önemlidir. Test senaryoları, hem yerel hem de canlı ortamlardaki belirteçleri simüle ederek geliştiricilerin, geliştirme döngüsünün başlarında doğrulamadaki herhangi bir tutarsızlığı yakalamasına olanak tanır. Geliştiriciler bu testleri kullanarak ASP.NET uygulamasının beklenmedik kimlik doğrulama sorunlarıyla karşılaşmadan birden fazla ortamda doğru şekilde çalıştığından emin olabilirler.

// Solution 1: Ensure Correct Audience Setting in appsettings.json
// Ensure that the audience values match exactly between local and live environments.
// appsettings.json for the live environment
{
  "IdentityProvider": {
    "IssuerUrl": "https://company.solutions/SSO_IDP",
    "ClientId": "adminclient",
    "ClientSecret": "your_secret_here"
  }
}
// Solution 2: Modify the Token Audience Validation in Startup.cs
// In the IDP configuration, add trailing slashes or handle both cases.
services.AddAuthentication()
    .AddJwtBearer(options =>
    {
        options.Audience = configuration["IdentityProvider:IssuerUrl"] + "/";
        options.TokenValidationParameters = new TokenValidationParameters
        {
            ValidateAudience = true,
            ValidAudiences = new[] { configuration["IdentityProvider:IssuerUrl"], configuration["IdentityProvider:IssuerUrl"] + "/" }
        };
    });

// Solution 3: Handle issuer differences between local and live environments in Startup.cs
services.AddAuthentication()
    .AddJwtBearer(options =>
    {
        options.TokenValidationParameters = new TokenValidationParameters
        {
            ValidateIssuer = true,
            ValidIssuers = new[] { configuration["IdentityProvider:IssuerUrl"], configuration["IdentityProvider:IssuerUrl"] + "/" }
        };
    });
// Ensure tokens generated by both local and live environments have valid issuers.
// This prevents mismatches during authentication in different environments.

// Unit Test: Validate audience setting for tokens
public class TokenValidationTests
{
    [Fact]
    public void Test_Audience_Validation_LiveEnvironment()
    {
        var token = GenerateToken("https://company.solutions/SSO_IDP");
        Assert.True(ValidateToken(token, "https://company.solutions/SSO_IDP"));
    }
    [Fact]
    public void Test_Audience_Validation_LocalEnvironment()
    {
        var token = GenerateToken("https://localhost:7007/");
        Assert.True(ValidateToken(token, "https://localhost:7007/"));
    }
}

ASP.NET Dağıtımı Sırasında Belirteç Hedef Kitlesi Sorunlarını Çözme

ASP.NET dağıtımında belirteçle ilgili sorunları düzeltmenin temel yönlerinden biri, JWT belirteçlerindeki kitle değerinin nasıl çalıştığını anlamayı içerir. Tek Oturum Açma (SSO) sisteminde hedef kitle genellikle belirtecin amaçlanan alıcısını temsil eder. Bu değer yanlışsa veya eşleşmezse jeton geçersiz hale gelir ve bu da yetkilendirme hatalarına yol açar. Bu sorunların ortak kaynağı, yerel geliştirme ortamı ile canlı dağıtım ortamı arasındaki hedef kitlenin nasıl tanımlandığına ilişkin farklılıklardır.

Bir SSO sistemi dağıtırken karşılaşılan en önemli zorluklardan biri, Kimlik Sağlayıcının (IDP) ortamın temel URL'sine bağlı olarak farklı hedef kitle değerlerine sahip belirteçler sunabilmesidir. Örneğin, yerel ortamdaki hedef kitle "https://localhost:7007/" gibi bir şey olabilirken, canlı ortam "https://company.solutions/SSO_IDP" gibi farklı bir URL yapısı kullanıyor olabilir. Değerlerdeki bu uyumsuzluk, "Belirtilen belirteç bu kaynak sunucuyla kullanılamaz." hatasına neden olur. Bunu düzeltmek için geliştiricilerin hedef kitlenin hem IDP hem de appsettings.json dosyasında doğru şekilde yapılandırıldığından emin olması gerekir.

Hedef kitle uyumsuzluklarına ek olarak, belirtecin geçerlilik süresi ve verici doğrulaması gibi diğer faktörler de belirteç doğrulamasını etkileyebilir. ASP.NET Core'un ara yazılımında bu ayarların düzgün şekilde yapılandırılması, hem yerel hem de canlı ortamlardaki belirteçlerin tutarlı bir şekilde işlenmesini sağlar. Ayrıntılı birim testleri eklemek, hataları üretime ulaşmadan önce yakalayarak dağıtım sırasında bu sorunların önlenmesine de yardımcı olabilir. Ortamlar arasında test yapmak, yerel geliştirmeden canlı dağıtıma sorunsuz bir geçiş sağlar.