API anahtarlarını yönetme

  • Makale

PowerShell Galerisi, çeşitli yayımlama gereksinimlerini desteklemek için birden çok API anahtarı oluşturmayı destekler. API anahtarı bir veya daha fazla pakete uygulanabilir, belirli ayrıcalıklar verebilir ve son kullanma tarihi vardır.

Önemli

Kapsamı belirlenmiş API anahtarlarının kullanıma sunulmasından önce PowerShell Galerisi yayımlayan kullanıcıların "Tam erişim API anahtarı" olacaktır. Tam erişim anahtarlarının kapsamı belirlenmiş API anahtarlarına yerleşik olarak güvenlik geliştirmeleri yoktur. Tam erişim anahtarlarının süresi hiçbir zaman dolmaz ve kullanıcının sahip olduğu her şeye uygulanır. Bu anahtarı silerseniz, yeniden oluşturulamaz.

Aşağıdaki görüntüde, kapsamlı bir API anahtarı oluşturulurken kullanılabilen seçenekler gösterilmektedir.

API anahtarları oluşturma

Bu örnekte AzureRMDataFactory adlı bir API anahtarı oluşturduk. Bu anahtar değeri, 'AzureRM.DataFactory' ile başlayan ve 365 gün boyunca geçerli olan adlara sahip paketleri göndermek için kullanılabilir. Bu, aynı kuruluştaki farklı ekiplerin farklı paketler üzerinde çalıştığı tipik bir senaryodur. Ekibin üyeleri, üzerinde çalıştıkları paket için onlara ayrıcalıklar veren bir anahtara sahiptir. Süre sonu değeri eski veya unutulan anahtarların kullanımını engeller.

Glob desenlerini kullanma

Birden çok paket üzerinde çalışıyorsanız, birden çok paketi grup olarak eşleştirmek için globbing desenlerini kullanabilirsiniz. API anahtarı izinleri glob deseni ile eşleşen tüm yeni paketler için geçerlidir. Örneğin, önceki örnekte 'AzureRM.DataFactory*' Glob Deseni değeri kullanılır. Paket glob deseni ile eşleştiğinden bu anahtarı kullanarak 'AzureRm.DataFactoryV2.Netcore' adlı bir paket gönderebilirsiniz.

API anahtarlarını güvenli bir şekilde oluşturma

Güvenlik için, yeni oluşturulan bir anahtar değeri ekranda hiçbir zaman gösterilmez ve aşağıda gösterildiği gibi yalnızca Kopyala düğmesiyle kullanılabilir.

Yeni API anahtarı değeri alma

Önemli

API anahtarı değerini yalnızca oluşturduktan veya yeniledikten hemen sonra kopyalayabilirsiniz. Sayfa yenilendikten sonra görüntülenmez ve yeniden erişilebilir olmaz. Anahtar değerini kaybederseniz, Yeniden Oluştur'u kullanmanız ve yeniden üretildikten sonra anahtarı kopyalamanız gerekir.

Anahtar izinleri ve süre sonu

Kapsamlı API anahtarları aşağıdaki izinlerden herhangi birini atayabilir:

  • Yeni paketleri gönderme
  • Yeni paketleri gönderme veya güncelleştirme
  • Paketlerin listesini kaldırma

Her yeni anahtarın bir süresi vardır. Süre sonu değeri gün cinsinden ölçülür. Süre sonu için olası değerler şunlardır:

  • 1 gün
  • 90 gün
  • 180 gün
  • 270 gün
  • 365 gün (varsayılan)

Anahtar oluşturulduktan sonra bu ayarlar değiştirilemez. Süresi hiç dolmamış yeni bir anahtar oluşturamazsınız.

Mevcut API anahtarlarını düzenleme ve silme

Mevcut bir anahtarın bazı ayarlarını değiştirebilirsiniz. Daha önce belirtildiği gibi, mevcut bir API anahtarının güvenlik kapsamını değiştiremez veya süre sonunu değiştiremezsiniz. Değiştirilebilir seçenekler aşağıdaki ekran görüntüsünde gösterilmiştir:

API anahtar değerinizi düzenleme

Bir anahtar tarafından denetlenen paketleri değiştirmek için listeden tek tek paketleri seçebilir veya glob desenini değiştirebilirsiniz.

Yeniden Oluştur'a tıklanması yeni bir anahtar değeri oluşturur. Anahtarı ilk oluşturduğunuzda olduğu gibi, anahtarı güncelleştirdikten hemen sonra kopyalamanız gerekir. Bu sayfadan çıktığınızda Kopyala seçeneği kullanılamaz.

Sil'e tıklanması bir onay iletisi görüntüler. Bir anahtar silindikten sonra kullanılamaz.

Anahtar süre sonu

Süre dolmadan on gün önce, PowerShell Galerisi API anahtarının hesap sahibine bir uyarı e-postası gönderir. Süre dolduktan sonra anahtar kullanılamaz. API anahtar yönetimi sayfasının üst kısmında hangi anahtarların artık geçerli olmadığını gösteren bir uyarı iletisi görüntülenir. Yeni bir anahtar değeri oluşturabilirsiniz.