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:

​
APNs kimlik doğrulamasını ayarlama

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

Apple’ın tam talimatları için bkz. Bir hizmete erişmek için özel anahtar oluşturma.
  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.
Yeni anahtar oluşturmak için mavi artı simgesini gösteren Apple Developer Anahtarlar sayfası
  1. Apple Push Notifications service (APNs) seçin.
  2. Anahtarı yapılandırırken, Sandbox & Production’ın seçili olduğundan emin olun:
Sandbox ve Production seçili Apple Developer anahtar yapılandırması
  1. Anahtar için bir ad girin ve Continue’ya, ardından Register’a tıklayın.
Continue ve Register düğmelerini gösteren Apple Developer anahtar kayıt sayfası
  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.
Apple iOS APNs ayarlarını gösteren OneSignal Ayarlar sayfası
  1. Kimlik doğrulama yöntemi olarak .p8 Auth Key (Önerilen) seçin.
Önerilen p8 Auth Key seçeneğini gösteren OneSignal APNs kimlik doğrulama yöntemi seçimi
Aşağıdakileri sağlayın:
  • .p8 File – Apple Developer hesabınızdan indirdiğiniz özel anahtar dosyası.
  • Key ID – 10 karakterlik alfanümerik bir dize (örn. ABC123DEFG). Apple Developer hesabınızın Keys bölümünde anahtar adınızın yanında bulunur. İndirilen .p8 dosyasıyla eşleştiğinden emin olun.
  • Team ID – 10 karakterlik alfanümerik bir dize (örn. 9A1B2C3D4E). Apple Developer hesabınızın sağ üst köşesinde ekip adınızın yanında görünür. Bu, Key ID ile aynı değildir.
  • App Bundle ID – Ters etki alanı dizesi (örn. com.example.app). Şurada bulunur:
    • Apple Developer hesabınızın Identifiers bölümü, veya
    • Xcode > Main App Target > Signing & Capabilities
Key ID ve Team ID, Apple Developer hesabınızda bulunan ancak farklı konumlardaki 10 karakterlik dizelerdir. Bunları birbiriyle karıştırmadığınızı iki kez kontrol edin — bu, en yaygın yanlış yapılandırmadır.
Key ID ve Team ID konumlarını gösteren Apple Developer hesabı
Bundle Identifier alanını gösteren Xcode İmzalama ve Yetenekler sekmesi
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

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

  • Apple Developer > Keys bölümüne gidin.
  • Key ID, anahtar adınızın yanında gösterilen 10 karakterlik dizedir (örn. ABC123DEFG).
  • OneSignal’e girdiğiniz Key ID’yi, indirilen .p8 anahtarı için listelenen ile eşleştirin.
  • Team ID ile karıştırmayın — her ikisi de 10 karakterlik dizeler ama farklı yerlerde bulunur.
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.
  • Key ID ile karıştırmayın — Team ID, belirli bir anahtarı değil, geliştirici hesabınızı tanımlar.
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.

​
Yardıma mı ihtiyacınız var?

  • 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.

​
Sonraki adımlar

iOS SDK kurulumu

OneSignal SDK’yı yükleyin, uygulamanızda başlatın ve test bildirimi gönderin.

Mobil SDK kurulumu

Platformunuzu seçin ve Android, iOS veya çapraz platform çerçeveleri için tam SDK entegrasyon kılavuzunu izleyin.

​
FAQ

​
.p8 ve .p12 arasındaki fark nedir?

.p8 anahtarı, süresi dolmayan ve Apple Developer hesabınızdaki tüm uygulamalar için çalışan token tabanlı bir kimlik doğrulama anahtarıdır. .p12 sertifikası uygulamaya özgüdür ve bir yıl sonra sona erecek, yıllık yenileme gerektirecektir. OneSignal, basitliği ve düşük bakım maliyeti nedeniyle .p8’i önermektedir. Alternatif yöntem için .p12 sertifika kılavuzuna bakın.

​
.p8 anahtarım sona erer mi?

Hayır. .p12 sertifikalarının aksine, .p8 anahtarlarının sona erme tarihi yoktur. Bir kez oluşturulduktan sonra, Apple Developer hesabınızda iptal edene kadar .p8 anahtarı geçerli kalır.

​
Birden fazla uygulama için tek bir .p8 anahtarı kullanabilir miyim?

Evet. Tek bir .p8 anahtarı aynı Apple Developer hesabı altındaki tüm uygulamalar için çalışır. Aynı .p8 dosyasını birden fazla OneSignal uygulamasına yükleyebilirsiniz — her uygulamanın yalnızca kendi benzersiz Bundle ID’sine ihtiyacı vardır.

​
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.
Otomatik imza yönetimi etkin Xcode İmzalama ve Yetenekler sekmesi
Aksi takdirde, ayrıntılar için Apple’ın sağlama profilleri hakkındaki belgelerine bakın.