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.
.p12 Sertifikalarının süresi bir yıl sonra dolar. Bu sertifikanın yenilenmesini yönetmek istemiyorsanız, bunun yerine süresi dolmayan bir .p8 anahtarı oluşturabilirsiniz.
Bu kılavuz, sertifika tabanlı (.p12 dosyası) kurulumunda size yol gösterecektir. Bu önerilmez çünkü her yıl yenilemeniz gerekir. Bu, her yıl yeni sertifikayı oluşturmak için Apple Developer Hesabınıza giriş yapmayı ve OneSignal kontrol panelinize yüklemeyi içerir.

Gereksinimler

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

Push sertifikası oluşturma

Önce macOS’ta bir Sertifika İmzalama İsteği .certSigningRequest Dosyası (CSR) oluşturmanız gerekir.
  1. Anahtarlık Erişimi’ni açın: Uygulamalar > Yardımcı Programlar > Anahtarlık Erişimi
  2. Sertifika Asistanı’nı başlatın
Menü çubuğundan şunu tıklayın: Anahtarlık Erişimi > Sertifika Asistanı > Bir Sertifika Yetkilisinden Sertifika İste…

Mac anahtarlık erişimi

  1. Bilgilerinizi Girin
Gerekli alanları doldurun:
  • Kullanıcı E-posta Adresi: [email protected]
  • Genel Ad: Adınız veya sertifika için ad
  • CA E-posta Adresi: Bunu boş bırakın
  • İstek: Diske kaydedildi’yi seçin

Sertifika Asistanı penceresi

  1. Devam Et’e tıklayın
  • .certSigningRequest dosyasını kaydetmek için bir konum seçin
  • Bitirmek için Kaydet’e tıklayın
Artık kullanıma hazır .certSigningRequest dosyanız var!

Uygulama için push yeteneklerini etkinleştirme

Xcode içinde Otomatik imza yönetimi kullanıyorsanız atlayın.
  1. Apple Developer portalının Tanımlayıcılar bölümüne gidin, listeden uygulamanızın App ID’sini bulun ve seçin.
  1. Kutuyu işaretleyerek Push Notifications yetkisini etkinleştirin. ⚠️ “Configure” üzerine tıklamayın — sadece geçişi etkinleştirin.

Push sertifikası oluşturma

Apple Push Notification service (APNs) SSL sertifikasını oluşturmak için şu adımları izleyin:
  1. Apple Certificates sayfasını ziyaret edin.
  2. Yeni bir sertifika oluşturmak için artı (+) düğmesine tıklayın.
  3. Services altında şunları seçin:
    • Apple Push Notification service SSL (Sandbox & Production)
    • Ardından Continue’ya tıklayın
  4. Listeden App ID’nizi seçin ve Continue’ya tıklayın.
  1. Daha önce oluşturduğunuz .certSigningRequest dosyasını yükleyin.
  1. Continue’ya tıklayın, ardından ortaya çıkan .cer dosyasını bilgisayarınıza kaydetmek için Download’a tıklayın.
Push bildirim hizmetlerini yapılandırmak için bu .cer dosyasını kullanacaksınız.

Özel anahtar oluşturma ve .p12 sertifikasını dışa aktarma

  1. İndirilen .cer dosyasını Anahtarlık Erişimi’ne aktarmak için Çift tıklayın.
  2. Anahtarlık Erişimi’nde şuraya gidin:
    • Anahtarlıklar > Giriş
    • Kategori > Sertifikalarım
  3. Apple Push Services adlı sertifikayı bulun.
  4. Sertifikaya Sağ tıklayın ve Dışa Aktar’ı seçin.

Dışa aktarma, istediğiniz dosya konumunda bir .p12 dosyası oluşturacaktır

  1. Dosyayı kaydetmek için bir konum seçin ve dosya formatını .p12 olarak seçin. İstendiğinde, .p12 dosyası için bir şifre ayarlayabilirsiniz (bu şifre, OneSignal gibi hizmetlere yüklerken gereklidir).

.p12’yi OneSignal’e yükleme

  1. OneSignal kontrol panelinizde, uygulamanıza gidin > Ayarlar > Push & In-App > Apple iOS.
  2. .p12 dosyasını yükleyin (ve bir şifre ayarladıysanız girin). Kaydet’e tıklayın.
OneSignal’de bir .p12 sertifikası kullanarak APNs kimlik doğrulamayı başarıyla kurdunuz.iOS uygulamanız artık push bildirimleri göndermeye ve almaya hazır! 🎉

.p12 sorun giderme

Geçersiz sertifika formatı hatası

Neden

Yüklenen dosya .p12 formatında değil.

Düzeltme

Sertifikayı Anahtarlık Erişimi’nden .p12 olarak dışa aktardığınızdan emin olun (.cer veya .pem değil).

OneSignal’e yüklerken “Yanlış şifre”

Neden

Şifre yanlış girildi veya ayarlanmadı.

Düzeltme

  • Tekrar dışa aktarmayı deneyin ve yeni bir şifre ayarlayın.
  • Yapıştırırken fazladan boşluk eklenmediğinden emin olun.
  • Provisionator kullanıyorsanız, şifre kullanıcı arayüzünde gösterilir.

Dışa aktarılan dosyada eksik özel anahtar

Neden

Sertifika içe aktarıldı ancak özel bir anahtarla eşleştirilmedi.

Düzeltme

  • Aynı makinede Anahtarlık Erişimi’nden CSR’yi oluşturduğunuzdan emin olun.
  • .cer dosyasını indirdikten sonra, kurmak için çift tıklayın ve anahtarın Sertifikalarım altında göründüğünü kontrol edin.

Yüklemeden sonra push bildirimleri çalışmıyor

Neden

Yanlış App ID veya Sağlama Profili eksik yetenekler.

Düzeltme

  • .p12’nin uygulamada kullanılan App ID ile eşleştiğini doğrulayın.
  • Apple Developer Portalı’nda, App ID’nin Push Notifications etkin olduğundan emin olun.
  • Sağlama Profili’nin Push içerdiğinden emin olun.

Süresi dolmuş sertifika

Neden

.p12 sertifikası artık geçerli değil.

Düzeltme

  • Apple Developer > Sertifikalar’a gidin ve son kullanma tarihini kontrol edin.
  • Eski sertifikayı iptal edin ve yeni bir tane oluşturun.

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.