NuGet: Microsoft Sertifika Değişimi Kurulumu Kırmasın

Microsoft, NuGet paketlerini author-signing ile imzalarken kullanılan X.509 sertifikasını güncelliyor. 23 Eylül 2026’dan sonra yeni sertifika geçerli olacak; trustedSigners veya dotnet nuget verify parmak izi beyaz listesi kullananlar güncelleme yapmalı.

Microsoft, NuGet paketlerini imzalarken kullandığı X.509 sertifikasını güncelliyor. NuGet ekibinin duyurusuna göre 23 Eylül 2026 itibarıyla yeni sertifika, Microsoft’un varsayılan author-signing sertifikası olacak. Paketleri yalnızca Microsoft tarafından author-signed olduğu doğrulandığında kuran ekipleri doğrudan ilgilendiriyor bu değişiklik. nuget.config dosyanızda güvenilen imzalayan (trusted signers) listesi tutuyorsanız ya da dotnet nuget verify ile parmak izi doğrulaması yapıyorsanız, yapılandırmayı zamanında güncellemediğinizde paket kurulumlarınız hata verebilir.

Değişen ne?

Microsoft, NuGet paketlerini author-signing yöntemiyle imzalıyor. Geçiş tarihinden sonra yeni paketler mevcut sertifikayla imzalanmayacak, yerine yeni sertifika geçecek. Daha eski sertifikalarla imzalanmış mevcut paketler ise imzalarını korumaya devam ediyor, yani geçmişte yayımlanmış paketler bu değişiklikten etkilenmiyor.

Duyuruda paylaşılan SHA-256 parmak izleri şöyle:

  • Mevcut sertifika:566A31882BE208BE4422F7CFD66ED09F5D4524A5994F50CCC8B05EC0528C1353
  • Yeni sertifika:9A1B131BEE0605433056A4EA3815478A8E177961A968C6C0027C1093D1FEB630

Microsoft’un belirttiğine göre yeni sertifikayla imzalanmış paketler, eski sertifikalarla imzalanmış paketlerle aynı şekilde kurulabilecek. Kırılma yalnızca parmak izlerini elle beyaz listeye aldığınız senaryolarda ortaya çıkıyor.

Kimler etkileniyor?

Şu iki durumdan biri sizde geçerliyse aksiyon almanız gerekiyor.

1. NuGet client policy ile güvenilen imzalayan listesi kullanıyorsanız

Etkilenip etkilenmediğinizi anlamak için nuget.config dosyanızda aşağıdaki gibi bir yapılandırma var mı, ona bakın. Bu dosyalar farklı kapsamlarda birden fazla konumda bulunabilir; makine genelindeki bir yapılandırma da devrede olabilir.

<config>
<add key="signatureValidationMode" value="require" />
</config>
<trustedSigners>
<author name="Microsoft">
<certificate fingerprint="3F9001EA83C560D712C24CF213C3D312CB3BFF51EE89435D3430BD06B5D0EECE" hashAlgorithm="SHA256" allowUntrustedRoot="false" />
<certificate fingerprint="AA12DA22A49BCE7D5C1AE64CC1F3D892F150DA76140F210ABD2CBFFCA2C18A27" hashAlgorithm="SHA256" allowUntrustedRoot="false" />
<certificate fingerprint="566A31882BE208BE4422F7CFD66ED09F5D4524A5994F50CCC8B05EC0528C1353" hashAlgorithm="SHA256" allowUntrustedRoot="false" />
</author>
</trustedSigners>

2. dotnet nuget verify ile parmak izi doğrulaması yapıyorsanız

Bir paketin Microsoft tarafından author-signed olduğunu doğrulamak için şuna benzer bir komut çalıştırıyorsanız etkileneceksiniz:

dotnet nuget verify <PackagePath> --certificate-fingerprint 3F9001EA83C560D712C24CF213C3D312CB3BFF51EE89435D3430BD06B5D0EECE --certificate-fingerprint AA12DA22A49BCE7D5C1AE64CC1F3D892F150DA76140F210ABD2CBFFCA2C18A27 --certificate-fingerprint 566A31882BE208BE4422F7CFD66ED09F5D4524A5994F50CCC8B05EC0528C1353

Bu iki senaryodan hiçbiri sizde yoksa sertifika güncellemesinden etkilenmemeniz bekleniyor.

Yeni sertifikayı nasıl eklersiniz?

Duyurunun temel mesajı, yeni parmak izini eski parmak izlerini silmeden eklemeniz. Eski sertifikaları listede tutmak, o sertifikalarla imzalanmış paketleri kurmaya devam edebilmeniz için gerekli.

Client policy tarafı

Güvenilen imzalayanlar listesini güncellemezseniz, yeni sertifikayla imzalanmış bir paketi kurma girişimi NU3034 hatasıyla başarısız olur. Yeni sertifikayı eklemenin en pratik yolu dotnet nuget trust komutu:

dotnet nuget trust author Microsoft 9A1B131BEE0605433056A4EA3815478A8E177961A968C6C0027C1093D1FEB630 --algorithm SHA256

Bu komut.NET 6 SDK ve sonrasında kullanılabiliyor, ilgili nuget.config dosyasını da günceller. Belirli bir yapılandırma dosyasını hedeflemek isterseniz --configfile <Path> parametresini kullanabilirsiniz. Birden fazla nuget.config kapsamının bulunduğu ortamlarda yanlış dosyayı güncellememek açısından bu önemli.

Alternatif olarak yeni parmak izini mevcut Microsoft girdisine elle ekleyebilirsiniz. Sonuçta hem eski hem yeni sertifikaları içeren bir blok elde etmelisiniz:

<trustedSigners>
<author name="Microsoft">
<certificate fingerprint="3F9001EA83C560D712C24CF213C3D312CB3BFF51EE89435D3430BD06B5D0EECE" hashAlgorithm="SHA256" allowUntrustedRoot="false" />
<certificate fingerprint="AA12DA22A49BCE7D5C1AE64CC1F3D892F150DA76140F210ABD2CBFFCA2C18A27" hashAlgorithm="SHA256" allowUntrustedRoot="false" />
<certificate fingerprint="566A31882BE208BE4422F7CFD66ED09F5D4524A5994F50CCC8B05EC0528C1353" hashAlgorithm="SHA256" allowUntrustedRoot="false" />
<certificate fingerprint="9A1B131BEE0605433056A4EA3815478A8E177961A968C6C0027C1093D1FEB630" hashAlgorithm="SHA256" allowUntrustedRoot="false" />
</author>
</trustedSigners>

Paket doğrulama tarafı

dotnet nuget verify kullanıyorsanız yeni parmak izini eskilerini koruyarak komuta ekleyin:

dotnet nuget verify <PackagePath> --certificate-fingerprint 3F9001EA83C560D712C24CF213C3D312CB3BFF51EE89435D3430BD06B5D0EECE --certificate-fingerprint AA12DA22A49BCE7D5C1AE64CC1F3D892F150DA76140F210ABD2CBFFCA2C18A27 --certificate-fingerprint 566A31882BE208BE4422F7CFD66ED09F5D4524A5994F50CCC8B05EC0528C1353 --certificate-fingerprint 9A1B131BEE0605433056A4EA3815478A8E177961A968C6C0027C1093D1FEB630

Her --certificate-fingerprint seçeneği, kabul edilen bir SHA-256 imzalayan sertifika parmak izi ekliyor. Dört değeri birden listede tutarsanız hem yeni imzalanan paketler hem de eski Microsoft sertifikalarıyla imzalanmış mevcut paketler doğrulanabilir.

Pratikte nereye bakmalı?

Bu tür bir yapılandırma tek bir yerde durmuyor olabilir. Duyuruda da vurgulandığı gibi nuget.config dosyaları farklı kapsamlarda birden çok konumda bulunabilir: çözüm/depo kökü, kullanıcı profili ve makine genelindeki yapılandırmalar. İmza doğrulaması ise çoğu zaman geliştirici makinesinden çok CI/CD ajanlarında ve build imajlarında zorunlu kılınıyor. Güncellemeyi yalnızca yerel ortamda yapıp geçerseniz pipeline tarafında sürpriz NU3034 hataları çıkabilir, yapılandırmanın uygulandığı tüm konumları gözden geçirmekte fayda var.

Kaynakta geçiş için “en erken 23 Eylül 2026” ifadesi kullanılıyor; yani kesin bir kesinti takvimi değil, bu tarihten itibaren geçerli olacak bir varsayılan değişikliği söz konusu. NuGet ekibinin önerisi de bu yüzden aksiyonu tarihe yaklaşmadan, mümkün olan en kısa sürede almak.

Sorun yaşarsanız

Etkilenip etkilenmediğinizden emin değilseniz ya da adımları uygularken sorunla karşılaşırsanız NuGet ekibine iletişim kanalları üzerinden ulaşabilirsiniz. Genel NuGet geri bildirimleri ve önerileri içinse hata/öneri gönderme rehberini inceleyip NuGet/Home deposunda tartışma başlatabilir veya issue açabilirsiniz.

Kaynaklar ve İleri Okuma

Bu yazı yapay zeka (büyük dil modelleri) ile hazırlanmış, insan editör tarafından incelenmiştir. İçerik üretim sürecimiz.
Aşkın KILIÇ

20+ yıl deneyimli Azure Solutions Architect. Microsoft sertifikalı bulut mimari ve DevOps danışmanı. Azure, yapay zekâ ve bulut teknolojileri üzerine Türkçe teknik içerikler üretiyor.

AZ-305AZ-104AZ-500AZ-400DP-203AI-102

Bu içerik işinize yaradı mı?

Benzer içerikleri kaçırmamak için YouTube ve GitHub hesaplarımı takip edin.

Haftalık Bülten

Her pazar özenle seçilmiş teknoloji yazıları doğrudan e-postanıza gelsin.

Kurumsal DevOps ve bulut dönüşümü danışmanlığı: Danışmanlık Hizmetleri

3 Yorum

  1. trustedSigners kullanan CI pipeline’ımız var, bu yazı tam zamanında geldi. Fingerprint güncellemesini şimdiden yapıp not aldım, 2026’da sürpriz yaşamayalım. Peki eski sertifikayla imzalanmış paketler geçiş sonrası doğrulamada sorun çıkarır mı acaba?

  2. Bunu görmesem 2026’da CI pipeline’ımız sebepsiz yere patlayınca saatlerce debug edecektik herhalde. trustedSigners kısmında fingerprint mi güncellemek gerekiyor yoksa iki sertifikayı paralel tanımlamak mı daha mantıklı, onu tam çözemedim?

  3. Bunu duymamıştım, iyi ki yazmışsınız. Bizim CI pipeline’da trustedSigners tanımlı, demek ki 2026’dan önce güncellemem lazım yoksa build’ler patlar. Not aldım, teşekkürler.

Bir yanıt yazın

E-posta adresiniz yayınlanmayacak. Gerekli alanlar * ile işaretlenmişlerdir

✉

Haftalık Bülten

Azure, DevOps ve Yapay Zeka dünyasındaki en güncel içerikleri her hafta doğrudan e-postanıza alın.

Spam yok. İstediğiniz zaman iptal edebilirsiniz.
📱
Uygulamayı Yükle Ana ekrana ekle, çevrimdışı oku
Kategoriler
Ara
Paylaş
WhatsApp
İçindekiler
← Copilot Code Review: Kişisel v...
GitHub Actions Node 20 Desteği... →
📩

Gitmeden önce!

Her pazar özenle seçilmiş teknoloji yazıları ve AI haberleri doğrudan e-postanıza gelsin. Ücretsiz, spam yok.

🔒 Bilgileriniz güvende. İstediğiniz zaman ayrılabilirsiniz.

📬 Haftalık bülten: Teknoloji + AI haberleri
Beni Takip Et Yeni Azure / AI / DevOps yazılarını GitHub ve RSS üzerinden takip edin.