Tutorial: Menyiapkan aplikasi iOS Anda agar berfungsi dengan Azure Notification Hubs

  • Artikel

Tutorial ini menunjukkan kepada Anda cara menyiapkan Azure Notification Hubs dan mengkonfigurasi mandat untuk mendorong pemberitahuan ke perangkat iOS melalui layanan Pemberitahuan Push Apple (APNS).

Menjalankan tutorial ini adalah prasyarat untuk tutorial Objective C dan Swift iOS berikutnya, dan mencakup langkah-langkah berikut:

  • Membuat file permintaan penandatanganan sertifikat.
  • Meminta aplikasi Anda untuk pemberitahuan push.
  • Membuat profil penyebaran untuk aplikasi.
  • Membuat hub pemberitahuan.
  • Mengkonfigurasikan hub pemberitahuan dengan informasi APNS.

Prasyarat

Untuk menyelesaikan tutorial ini, Anda harus memiliki akun Azure yang aktif. Jika Anda tidak memiliki akun, Anda dapat membuat akun uji coba gratis hanya dalam beberapa menit. Untuk detailnya, lihat Uji Coba Gratis Azure.

Anda juga memerlukan:

  • Akun Pengembang Apple aktif.
  • Mac yang menjalankan Xcode, bersama dengan sertifikat pengembang valid yang diinstal ke rantai kunci Anda.
  • iPhone atau iPad yang menjalankan iOS versi 10 atau lebih baru.
  • Perangkat fisik Anda terdaftar di Portal Apple dan terkait dengan sertifikat Anda.

Pastikan untuk membaca Azure Gambaran umum Notification Hubs jika Anda tidak terbiasa dengan layanan ini.

Catatan

Hub pemberitahuan akan dikonfigurasi untuk menggunakan mode autentikasi Sandbox saja. Anda tidak boleh menggunakan mode autentikasi ini untuk beban kerja produksi.

Membuat file permintaan penandatanganan sertifikat

Layanan Pemberitahuan Push Apple (APNS) menggunakan sertifikat untuk mengautentikasi pemberitahuan push Anda. Ikuti instruksi ini untuk membuat sertifikat push yang diperlukan untuk mengirim dan menerima pemberitahuan. Untuk informasi selengkapnya tentang konsep-konsep ini, lihat dokumentasi Layanan Pemberitahuan Push Apple resmi.

Buat file Permintaan Penandatanganan Sertifikat (CSR), yang digunakan Apple untuk menghasilkan sertifikat push yang ditandatangani:

  1. Di Mac Anda, jalankan alat Akses Rantai Kunci. Ini dapat dibuka dari folder Utilitas atau folder Lainnya di Launchpad.

  2. Pilih Keychain Access, perluas Asisten Sertifikat , lalu pilih Minta Sertifikat dari Otoritas Sertifikat.

    Screenshot that highlights the Request a Certificate from a Certificate Authority menu option.

    Catatan

    Secara default, Akses Rantai Kunci memilih item pertama dalam daftar. Ini bisa menjadi masalah jika Anda berada dalam kategori Sertifikat dan Otoritas Sertifikasi Hubungan Pengembang Seluruh Dunia Apple bukan item pertama dalam daftar. Pastikan Anda memiliki item non-kunci, atau kunci Otoritas Sertifikasi Hubungan Pengembang Seluruh Dunia Apple dipilih, sebelum membuat CSR (Permintaan Penandatanganan Sertifikat).

  3. Pilih Alamat Email Pengguna Anda, masukkan nilai Nama Umum Anda, pastikan Anda menentukan Disimpan ke disk, lalu pilih Lanjutkan. Biarkan Alamat Email CA kosong karena tidak diperlukan.

    Required certificate information

  4. Masukkan nama untuk file CSR di Simpan Sebagai, pilih lokasi di Di mana, lalu pilih Simpan.

    Choose file name

    Tindakan ini menyimpan file CSR di lokasi yang dipilih. Lokasi default adalah di Desktop. Ingat lokasi yang dipilih untuk file.

Selanjutnya, daftarkan aplikasi Anda dengan Apple, aktifkan pemberitahuan push, dan unggah CSR yang diekspor untuk membuat sertifikat push.

Daftarkan aplikasi Anda untuk pemberitahuan push

Untuk mengirim pemberitahuan push ke app iOS, daftarkan aplikasi Anda dengan Apple, dan juga daftarkan untuk pemberitahuan push.

  1. Jika Anda belum mendaftarkan aplikasi, telusuri ke Portal Provisi iOS di Pusat Pengembang Apple. Masuk ke portal dengan ID Apple Anda, dan pilih Pengidentifikasi. Lalu pilih + untuk mendaftarkan aplikasi baru.

    App IDs page

  2. Pada layar Daftarkan Pengidentifikasi Baru, pilih tombol radio App ID. Lalu Pilih Lanjutkan.

    Register new ID page

  3. Perbarui tiga nilai berikut untuk aplikasi baru Anda, lalu pilih Lanjutkan:

    • Deskripsi: Ketikkan nama deskriptif untuk aplikasi Anda.

    • ID Bundel: Masukkan ID Bundel formulir Nama Identifier.Product Organisasi seperti yang disebutkan dalam Panduan Distribusi Aplikasi. Nilai Pengidentifikasi Organisasi dan Nama Produk harus cocok dengan pengidentifikasi organisasi dan nama produk yang Anda gunakan saat membuat proyek Xcode. Dalam cuplikan layar berikut, nilaiNotificationHubs digunakan sebagai pengidentifikasi organisasi dan nilai GetStarted digunakan sebagai nama produk. Pastikan nilai Pengidentifikasi Bundel cocok dengan nilai dalam project Xcode Anda, sehingga Xcode menggunakan profil penerbitan yang benar.

      Register app ID

    • Pemberitahuan Push: Periksa opsi Pemberitahuan Push di bagian Kapabilitas.

      Register new app ID

      Tindakan ini menghasilkan ID Aplikasi Anda dan meminta Anda mengonfirmasi informasi tersebut. Pilih Lanjutkan, lalu pilih Daftar untuk mengonfirmasi ID Aplikasi baru.

      Confirm new App ID

      Setelah Anda Daftar, Anda akan melihat ID Aplikasi baru sebagai item baris pada halaman Sertifikat, Pengidentifikasi & Profil.

  4. Di halaman Sertifikat, Pengidentifikasi, & Profil, di Pengidentifikasi, temukan item baris ID Aplikasi yang baru saja Anda buat, dan pilih barisnya untuk menampilkan layar Edit Konfigurasi ID Aplikasi Anda.

Membuat sertifikat untuk Notification Hubs

Catatan

Dengan rilisnya iOS 13, Anda hanya dapat menerima pemberitahuan senyap menggunakan autentikasi berbasis token. Jika Anda menggunakan autentikasi berbasis sertifikat untuk kredensial APNS, Anda harus beralih menggunakan autentikasi berbasis token.

Sertifikat diperlukan untuk mengaktifkan hub pemberitahuan agar berfungsi dengan APNS. Ini dapat dilakukan dengan salah satu dari dua cara:

  • Buat file .p12 yang dapat diunggah langsung ke Notification Hubs.

  • Buat file .p8 yang dapat digunakan untuk autentikasi berbasis token (pendekatan yang lebih baru).

Opsi kedua memiliki sejumlah keuntungan dibandingkan dengan menggunakan sertifikat, seperti yang didokumentasikan dalam autentikasi berbasis Token (HTTP/2) untuk APNS. Namun, langkah-langkah disediakan untuk kedua pendekatan.

Opsi 1: Buat sertifikat push .p12 yang dapat diunggah langsung ke Notification Hubs

  1. Gulir ke bawah ke opsi Pemberitahuan Push yang dicentang, lalu pilih Konfigurasikan untuk membuat sertifikat.

    App ID

  2. Jendela Sertifikat SSL layanan Pemberitahuan Push Apple muncul. Pilih tombol Buat Sertifikat di bagian Sertifikat SSL Pengembangan.

    Create certificate

    Layar Buat Sertifikat Baru ditampilkan.

    Catatan

    Tutorial ini menggunakan sertifikat pengembangan. Proses yang sama digunakan saat mendaftarkan sertifikat produksi. Pastikan Anda menggunakan tipe sertifikat yang sama saat mengirim pemberitahuan.

  3. Klik Pilih File,telusuri ke lokasi tempat Anda menyimpan file CSR dari tugas pertama, lalu klik ganda nama sertifikat untuk memuatnya. Lalu Pilih Lanjutkan.

  4. Setelah portal membuat sertifikat, pilih tombol Unduh. Simpan sertifikat, dan ingat lokasi penyimpanannya.

    Download certificate

    Sertifikat diunduh dan disimpan di folder Unduhan Anda.

    Locate certificate file

    Secara default, sertifikat pengembangan yang diunduh dinamai aps_development.cer.

  5. Klik dua kali pada sertifikat push yang diunduh aps_development.cer. Tindakan ini menginstal sertifikat baru di Rantai Kunci, seperti yang diperlihatkan dalam gambar berikut:

    Keychain access

    Meskipun nama dalam sertifikat Anda mungkin berbeda, nama tersebut akan diawali dengan Layanan Push iOS Pengembangan Apple.

  6. Di Keychain Access, klik kanan sertifikat push baru yang Anda buat di kategori Sertifikat. Pilih Ekspor, beri nama file, pilih format .p12 lalu pilih Simpan.

    Export certificate

    Anda dapat memilih untuk melindungi sertifikat dengan kata sandi, tetapi ini opsional. Klik OK jika Anda ingin melewati pembuatan kata sandi. Catat nama file dan lokasi sertifikat .p12 yang diekspor. Mereka digunakan untuk mengaktifkan autentikasi dengan APNS.

    Catatan

    Nama dan lokasi file .p12 Anda mungkin berbeda dari apa yang digambarkan dalam tutorial ini.

Opsi 2: Buat sertifikat .p8 yang dapat digunakan untuk autentikasi berbasis token

  1. Catat hal-hal berikut ini:

    • Awalan ID Aplikasi (ini adalah ID Tim)
    • ID Bundel

  2. Kembali ke Sertifikat, Pengidentifikasi, & Profil, klik Tombol. Jika Anda sudah memiliki kunci yang dikonfigurasi untuk APNS, Anda dapat menggunakan kembali sertifikat .p8 yang Anda unduh tepat setelah dibuat. Jika demikian, Anda dapat mengabaikan langkah 3 sampai 5.

  3. Klik + tombol (atau tombol Buat tombol) untuk membuat kunci baru.

  4. Berikan nilai Nama Kunci yang sesuai, centang opsi Layanan Pemberitahuan Push Apple (APNS), lalu klik Lanjutkan, diikuti dengan Daftar di layar berikutnya.

  5. Klik Unduh lalu pindahkan file .p8 (diawali AuthKey_ dengan) ke direktori lokal yang aman, lalu klik Selesai.

    Penting

    Pastikan untuk menyimpan file .p8 Anda di tempat yang aman (dan simpan cadangan). Setelah mengunduh kunci Anda, kunci tersebut tidak dapat diunduh ulang; salinan server dihapus.

  6. Pada Kunci, klik kunci yang baru saja Anda buat (atau kunci yang ada jika Anda telah memilih untuk menggunakannya sebagai gantinya).

  7. Catat nilai ID Kunci.

  8. Buka sertifikat .p8 Anda dalam aplikasi pilihan Anda yang sesuai, seperti Visual Studio Code, lalu catat nilai kuncinya. Ini adalah nilai antara -----BEGIN PRIVATE KEY----- dan -----END PRIVATE KEY----- .

    -----BEGIN PRIVATE KEY-----
<key_value>
-----END PRIVATE KEY-----

    Ini adalah nilai token yang akan digunakan nanti untuk mengonfigurasi Notification Hubs.

Di akhir langkah-langkah ini Anda harus memiliki informasi berikut untuk digunakan nanti di Mengkonfigurasi hub pemberitahuan Anda dengan informasi APNS:

  • ID Tim (lihat langkah 1)
  • ID Bundel (lihat langkah 1)
  • ID Kunci (lihat langkah 7)
  • Nilai token (nilai kunci .p8, lihat langkah 8)

Membuat profil penyebaran

  1. Kembali ke Portal Provisi iOS, pilih Sertifikat, Pengidentifikasi, & Profil, pilih Profil dari menu kiri, lalu pilih + untuk membuat profil baru. Layar Mendaftarkan Profil Provisi Baru muncul.

  2. Pilih Pengembangan Aplikasi iOS di Pengembangan sebagai jenis profil provisi, lalu pilih Lanjutkan.

    Provisioning profile list

  3. Berikutnya, pilih ID aplikasi yang Anda buat dari daftar drop-down ID Aplikasi, lalu pilih Lanjutkan.

    Select App ID

  4. Di jendela Pilih sertifikat, pilih sertifikat pengembangan yang Anda gunakan untuk penandatanganan kode, dan pilih Lanjutkan. Sertifikat ini bukan sertifikat push yang Anda buat. Jika tidak ada, Anda harus membuatnya. Jika sertifikat memang ada, lewati ke langkah berikutnya. Untuk membuat sertifikat pengembangan jika sertifikat tidak ada:

    1. Jika Tidak ada Sertifikat yang tersedia, pilih Buat Sertifikat.
    2. Di bagian Perangkat Lunak, pilih Pengembangan Apple. Lalu Pilih Lanjutkan.
    3. Di layar Buat Sertifikat Baru, klik Pilih File.
    4. Telusuri ke sertifikat Permintaan Penandatanganan Sertifikat yang Anda buat sebelumnya, pilih sertifikat tersebut, lalu pilih Buka.
    5. Pilih Lanjutkan.
    6. Unduh sertifikat pengembangan, dan ingat lokasi tempat sertifikat disimpan.

  5. Kembali ke halaman Sertifikat, Pengidentifikasi & Profil, pilih Profil dari menu sebelah kiri, lalu pilih + untuk membuat profil baru. Layar Mendaftarkan Profil Provisi Baru muncul.

  6. Di jendela Pilih sertifikat, pilih sertifikat pengembangan yang baru saja Anda buat. Lalu Pilih Lanjutkan.

  7. Selanjutnya, pilih perangkat yang akan digunakan untuk pengujian, dan pilih Lanjutkan.

  8. Terakhir, pilih nama untuk profil di Nama Profil Penyebaran, lalu pilih Buat.

    Choose provisioning profile name

  9. Saat profil penyebaran baru dibuat, pilih Unduh. Ingat lokasi tempat disimpan.

  10. Telusuri ke lokasi profil provisi, lalu klik dua kali untuk menginstalnya di mesin pengembangan Xcode Anda.

Membuat hub pemberitahuan

Di bagian ini, Anda membuat hub pemberitahuan dan mengkonfigurasi autentikasi dengan APNS dengan menggunakan sertifikat push .p12 atau autentikasi berbasis token. Jika Anda ingin menggunakan hub pemberitahuan yang sudah Anda buat, Anda bisa langsung melangkah ke langkah 5.

  1. Masuk ke portal Azure.

  2. Pilih Semua layanan di menu sebelah kiri, lalu pilih Notification Hubs di bagian Seluler. Pilih ikon bintang di samping nama layanan untuk menambahkan layanan ke bagian FAVORITE di menu sebelah kiri. Setelah Anda menambahkan Notification Hubs ke FAVORITE, pilih hub tersebut.

    Azure portal

  3. Pada halaman Notification Hubs, pilih Tambahkan pada toolbar.

    Add toolbar button

  4. Pada halaman Notification Hubs, lakukan langkah-langkah berikut ini:

    1. Masukkan nama di Hub Pemberitahuan.
    2. Masukkan nama di Buat namespace baru. Namespace berisi satu atau beberapa hub pemberitahuan.
    3. Pilih nilai dari daftar menurun Lokasi. Nilai ini menentukan lokasi tempat Anda ingin membuat hub pemberitahuan.
    4. Pilih grup sumber daya yang sudah ada di Grup Sumber Daya, atau buat grup sumber daya baru.
    5. Pilih Buat.

    Set properties

  5. Pilih Pemberitahuan (ikon bel), lalu pilih Buka sumber daya. Anda juga dapat menyegarkan daftar di halaman Notification Hubs dan memilih hub Anda.

    Portal notifications

  6. Pilih Kebijakan Akses dari daftar. Perhatikan bahwa dua string koneksi tersedia untuk Anda. Anda akan membutuhkannya nanti untuk menangani pemberitahuan push.

    Penting

    Jangan gunakan kebijakan DefaultFullSharedAccessSignature di aplikasi Anda. Ini dimaksudkan untuk digunakan di ujung belakang Anda saja.

    Connection strings

Mengkonfigurasikan hub pemberitahuan dengan informasi APNS

Di bawah Notification Services, pilih Apple (APNS), lalu ikuti langkah-langkah yang sesuai berdasarkan pendekatan yang Anda pilih sebelumnya di bagian Membuat Sertifikat untuk Notification Hubs.

Catatan

Gunakan Produksi untuk Mode Aplikasi hanya jika Anda ingin mengirim notifikasi push kepada pengguna yang membeli aplikasi Anda dari toko.

Opsi 1: Gunakan sertifikat pendorongan .p12

  1. Pilih Sertifikat.

  2. Pilih ikon file.

  3. Pilih file .p12 yang Anda ekspor sebelumnya, lalu pilih Buka.

  4. Jika diperlukan, tentukan kata sandi yang benar.

  5. Pilih mode Kotak pasir.

    Configure

  6. Pilih Simpan.

Opsi 2: Gunakan autentikasi berbasis token

  1. Pilih Token.

  2. Masukkan nilai berikut yang Anda peroleh sebelumnya:

    • ID Kunci
    • ID Bundel
    • ID tim
    • Token

  3. Pilih Kotak pasir

  4. Pilih Simpan.

Sekarang Anda telah mengkonfigurasi hub pemberitahuan dengan APNS. Anda juga memiliki string koneksi yang diperlukan untuk mendaftarkan aplikasi Anda dan mengirim pemberitahuan push.

Langkah berikutnya

Dalam tutorial ini, Anda membuat dan mengkonfigurasi hub pemberitahuan di Azure dan mengkonfigurasinya untuk memungkinkan pemberitahuan dikirim ke aplikasi Anda melalui Layanan Pemberitahuan Push Apple (APNS). Selanjutnya, kita akan membuat contoh aplikasi iOS dan mengintegrasikan Azure Notifications Hubs SDK sehingga dapat menerima pemberitahuan push yang dikirim melalui portal Azure. Lanjutkan ke tutorial berikut berdasarkan bahasa pilihan Anda: