App Store Connect API Anahtarı Nasıl Alınır: Issuer ID, Key ID ve .p8

App Store Connect API anahtarı (Issuer ID, Key ID, .p8) nasıl alınır: ekip ve bireysel anahtar farkı, rol seçimi ve analitik için Admin şartı.

Yazan: App Store Operator7 dk okumaEnglish sürümü de var

Bu yazıda
  1. API anahtarı nedir: üç parça ne işe yarar?
  2. Ekip anahtarı mı, bireysel anahtar mı?
  3. Ekip anahtarı nasıl oluşturulur?
  4. Hangi rol seçilmeli?
  5. Bu yazının kapsamadığı konular
  6. SSS

App Store Connect API anahtarını Users and Access (Kullanıcılar ve Erişim) › Integrations (Entegrasyonlar) ekranından alırsın. Kasım 2026 itibarıyla önce Account Holder erişim izni ister, sonra Account Holder ya da Admin ekip anahtarı üretir; tek başına çalışıyorsan profilinden bireysel anahtar da üretebilirsin. Her kurulumda üç değer gerekir: Issuer ID, Key ID ve bir kez indirilen .p8 dosyası.

Bu yazı, bir araca (analitik, CI, metadata yönetimi) API ile bağlanmak için anahtar çıkarması gereken iOS geliştiriciler içindir. Üç parçanın ne olduğunu, ekip ve bireysel anahtarın farkını, adım adım oluşturmayı, rol seçimini ve anahtarı güvenli saklamayı anlatır.

API anahtarı nedir: üç parça ne işe yarar?

API anahtarı, bir aracın senin adına App Store Connect API ile konuşmasını sağlayan kimliktir. Kurulum ekranları hep aynı üç değeri ister; üçü birlikte anahtarı tanımlar.

Kurulumda istenen üç değer ve her birini nerede bulacağın.
DeğerNedirNerede bulunur
Issuer IDEkibinin API kimliğiAnahtar sayfasının üstünde, Copy düğmesiyle
Key IDAnahtarın kimliğiAnahtar tablosunda, anahtarın satırında
.p8İmza atan gizli dosyaDownload API Key ile bir kez indirilir

Araç, bu üç değerle her API isteğini imzalayan kısa ömürlü bir token üretir (Apple'ın token sayfası). Token alanlarında kid anahtarın Key ID'sidir, iss Issuer ID'dir; bireysel anahtar iss yerine sub kullanır.

İki sınır baştan bilinir. Anahtar yalnızca App Store Connect API içindir, başka bir Apple servisinde kullanılamaz. Gizli dosyanın kopyası Apple'da durmaz; indirme bağlantısı tek seferliktir (Apple'ın anahtar sayfası).

Ekip anahtarı mı, bireysel anahtar mı?

Apple'ın iki anahtar türü vardır ve seçim, anahtarın kaç uygulamaya dokunacağını belirler. Kısa cevap: ekip için ekip anahtarı, tek kişi için bireysel anahtar.

Seçimden önce iki tür arasındaki doğrulanmış farklar.
KonuEkip anahtarıBireysel anahtar
KapsamTüm uygulamalar; uygulama kısıtı konamazÜreten kullanıcının erişimi ve rolleri
Kim üretirAccount Holder veya AdminHesaptaki her kullanıcı (izni varsa)
SayıBirden çok üretilebilirKullanıcı başına tek aktif anahtar
Rapor uçlarıRolle belirlenirSales and Finance uçlarına erişemez

Bireysel anahtarın yasağı açıktır: Provisioning uçlarını, Sales and Finance'i ve notaryTool'u kullanamaz (Apple'ın anahtar sayfası). O yüzden rapor indirecek bir kurulumda ekip anahtarı kullanılır; deneme yapan tek geliştirici, kendi yetkisiyle bireysel anahtarla başlar.

Ekip anahtarı nasıl oluşturulur?

Önce bir önkoşul vardır: API erişimini Account Holder ister. Users and Access › Integrations ekranında Request Access düğmesine basar, koşulu kabul eder ve gönderir. Apple başvuruyu tek tek inceler (Apple'ın başlangıç sayfası).

Erişim açıldıktan sonra adımlar şöyledir:

  1. Users and Access › Integrations ekranını aç; solda App Store Connect API seçili olsun.
  2. Üstte Team Keys sekmesine geç, Generate API Key düğmesine bas (aktif anahtarın varsa + ile yenisi eklenir).
  3. Anahtara yalnızca senin göreceğin bir ad ver; ad, anahtarın parçası değildir.
  4. Access altında rolü seç (rol seçimi bir sonraki bölümde) ve Generate düğmesine bas.
  5. Sayfanın üstündeki Issuer ID'yi Copy ile, tablodaki Key ID'yi satırındaki bağlantıyla kopyala.
  6. Anahtarın yanındaki Download API Key ile .p8 dosyasını indir ve güvenli bir yere kaydet.

Üretilen anahtarın adı ve rolü sonradan değişmez. Değişiklik gerekirse anahtar iptal edilir ve yenisi üretilir. İptal için Users and Access › Integrations ekranında Individual Keys ya da Team Keys sekmesine geç, sağ üstte Edit düğmesine bas, anahtarı seç ve Revoke Key ile onayla. İptal geri alınamaz; son 30 günün iptalleri Revoked bölümünde görünür. Bir kullanıcının bireysel anahtar üretmesini kapatmak için, o kullanıcının ayarındaki Generate Individual API Keys izni kaldırılır.

Hangi rol seçilmeli?

Rol, anahtarın API'de ne yapabileceğini belirler ve kullanıcı rolleriyle aynı rollerdir. Aşağıdaki tablo, bu yazının dayandığı Apple sayfalarında yazan kuralları toplar.

Rol seçiminde geçerli doğrulanmış kurallar (Kasım 2026 itibarıyla).
DurumKural
Ekip anahtarı üretmeGerekli rol: Account Holder veya Admin
Yeni bir analitik raporu türünü ilk kez istemeGerekli rol: Admin; sonrasında Sales and Reports veya Finance rolü indirebilir, ilk rapor 24-48 saatte gelir
Bireysel anahtar üretmeAccount Holder, Admin, App Manager, Customer Support, Developer veya Marketing
Bireysel anahtarla rapor indirmeSales and Finance uçlarına erişemez, o yüzden rapor işleri ekip anahtarıyla yapılır

Analitik raporlarını indirdiğinde göreceğin impression ve conversion rate tanımlarını conversion rate yazısında açıkladık. Rolün rapor içeriğine değil, raporu isteme ve indirme iznine baktığını unutma: içerik aynı kalır, kapı değişir.

Bu yazının kapsamadığı konular

Google Play bu yazıda yok; anahtar yalnızca App Store Connect API içindir. Token imzalama kodu (JWT) detayı yok; araçlar imzayı senin için üretir, sana üç değer yeter. Enterprise Program hesapları ayrıdır: bu akışlar Enterprise Program API için geçerli değildir. Hangi aracın hangi rolü istediği de burada yok; her aracın kendi dokümanı, ihtiyacı olan minimum rolü yazar.

Her hafta yeni ASO notları

SSS

API anahtarını kaç kez indirebilirim?

Bir kez. İndirme bağlantısı, gizli dosyayı ilk indirişinden sonra kaybolur ve Apple kopya tutmaz. Dosyayı kaybettiysen yenisini indiremezsin; eski anahtarı iptal edip yeniden üretirsin.

Issuer ID'yi nerede bulurum?

Anahtar sayfasının üstünde. Users and Access › Integrations › App Store Connect API ekranında ID, sayfanın üst kısmında yazar ve yanındaki Copy düğmesiyle kopyalanır. Key ID ise anahtar tablosunda, anahtarın satırındadır.

Bireysel anahtarla analitik raporu indirebilir miyim?

Rapor işleri için ekip anahtarı kullan. Bireysel anahtarlar Sales and Finance uçlarına erişemez ve yeni bir analitik raporu türünü ilk kez istemek Admin rolü ister. O yüzden rapor kurulumunu Admin rolünde bir ekip anahtarıyla yap.

Anahtarım sızdıysa ne yapmalıyım?

Hemen iptal et. Users and Access › Integrations ekranında ilgili sekmeye geç, anahtarı seç ve Revoke Key ile onayla. İptal geri alınamaz; ardından yeni anahtar üretip üç değeri araca yeniden girersin.

Kaynaklar