Ana içeriğe atla
iOS uygulamalarına push bildirimleri göndermek için Apple Push Notification Services (APNs) ile kimliği doğrulanmış bir bağlantı gereklidir. Token tabanlı (.p8 anahtarı) veya sertifika tabanlı (.p12 dosyası) yöntemini kullanarak kimlik doğrulayabilirsiniz — ancak yalnızca biri gereklidir. Bu kılavuz, önerilen yaklaşım olan token tabanlı .p8 anahtarı kurulumunda size yol gösterecektir.

Gereksinimler

Başlamadan önce aşağıdakilere sahip olduğunuzdan emin olun:

Adımlar

Apple Developer Hesabınızda .p8 anahtarınızı oluşturun

  1. Apple Developer Hesabınıza giriş yapın.
  2. Certificates, Identifiers & Profiles > Keys’e gidin.
  3. Mavi artı (+) simgesine tıklayın.
    • Görmüyorsanız, erişim için Yöneticinizle iletişime geçin.
  1. Apple Push Notifications service (APNs) seçin.
  2. Anahtarı yapılandırırken, Sandbox & Production’ın seçili olduğundan emin olun:
  1. Anahtar için bir ad girin ve Continue’ya, ardından Register’a tıklayın.
  1. .p8 anahtarınızı indirin ve güvenli bir şekilde saklayın. Bir daha indiremezsiniz.
Yeni bir .p8 oluşturmanız gerekiyorsa ve zaten ikisi varsa, önce mevcut anahtarlardan birini iptal etmelisiniz — ve artık kullanılamayacaktır.

.p8 anahtarını OneSignal’e yükleyin

  1. OneSignal kontrol panelinizde Ayarlar > Push & In-App > Apple iOS (APNs) Ayarları’na gidin.

OneSignal kontrol paneli push yapılandırma sayfası.

  1. Kimlik doğrulama yöntemi olarak .p8 Auth Key (Önerilen) seçin.

Bir p12 veya başka bir p8'den güncelliyorsanız, 'kimlik doğrulamayı güncelle' seçeneğine sahip olacaksınız

Aşağıdakileri sağlayın:
  • .p8 File – Apple Developer hesabınızdan indirdiğiniz özel anahtar dosyası.
  • Key ID – Apple Developer hesabınızın Keys bölümünde bulunur. İndirilen .p8 dosyasıyla eşleştiğinden emin olun.
  • Team IDApple Developer hesabınızın sağ üst köşesinde bulunur.
  • App Bundle ID – Bunu şurada bulabilirsiniz:

.p8 anahtar ayrıntılarınızı bulma

Xcode'da Bundle ID'nizi bulma

Bittiğinde Save & Continue’ya tıklayın.
OneSignal’de bir .p8 anahtarı kullanarak APNs kimlik doğrulamayı başarıyla kurdunuz.iOS uygulamanız artık push bildirimleri göndermeye ve almaya hazır! 🎉

.p8 sorun giderme

Adım adım kontrol listesi:
1

.p8 dosya formatını kontrol edin

  • .p8 dosyasını bir metin düzenleyicide açın.
  • Şöyle görünmelidir:
    -----BEGIN PRIVATE KEY-----
    64 character line
    64 character line
    64 character line
    8 character line
    -----END PRIVATE KEY-----
    
2

Yanlışlıkla bir .p12 yüklemediğinizden emin olun

  • .p8 anahtarları Apple Developer hesabınızın Keys bölümünden gelir.
  • .p12 sertifikaları Certificates bölümündendir. Bunlar .p8 kimlik doğrulamasıyla uyumlu değildir.
3

Doğru key id'ye sahip olduğunuzu onaylayın

4

Team id'yi doğrulayın

  • Team ID’niz Apple Developer hesabınızın sağ üst köşesinde görünür.
  • Tam olarak kopyalandığından ve anahtarın oluşturulduğu hesapla eşleştiğinden emin olun.
5

Anahtarın apns yetkisine sahip olduğundan emin olun

  • Apple Developer’da anahtarınızı görüntülerken, Apple Push Notifications service (APNs) yetkisi listelenmelidir.
  • Değilse, anahtarı iptal edin ve yeni bir tane oluşturun.
6

Birkaç dakika bekleyin

  • Yeni oluşturulan anahtarların, Apple harici kimlik doğrulamaya izin vermeden önce yayılması 10–15 dakika sürebilir.
  • Oluşturma işleminden hemen sonra doğrulama hataları alırsanız, bekleyin ve tekrar deneyin.

Her şey başarısız olduğunda

  • Mevcut .p8 anahtarını iptal edin ve sıfırdan yeni bir tane oluşturun.
  • Anahtarın oluşturulduğu hesaptan geçerli bir Bundle ID kullandığınızı iki kez kontrol edin.
  • Key ID, Team ID, Bundle ID ve Apple Developer Key yapılandırmanızın redakte edilmiş bir ekran görüntüsü ile support@onesignal.com’a ulaşın.

FAQ

Bir sağlama profiline ihtiyacım var mı ve nasıl oluşturulur?

Evet, Apple geliştirme, test (Ad Hoc) ve App Store’a dağıtım için farklı profil türleri gerektirir. Xcode’da, otomatik olarak bir tane oluşturmak için Automatically manage signing seçeneğini seçebilmelisiniz.
Aksi takdirde, ayrıntılar için Apple’ın sağlama profilleri hakkındaki belgelerine bakın.