Oktatóanyag: Az iOS-alkalmazás beállítása az Azure Notification Hubs használatához

Ez az oktatóanyag bemutatja, hogyan állíthatja be az Azure Notification Hubsot, és hogyan konfigurálhat hitelesítő adatokat az értesítések iOS-eszközökre való leküldéséhez az Apple Push Notification szolgáltatáson (APNS) keresztül.

Az oktatóanyag futtatása előfeltétele a későbbi C és Swift iOS-oktatóanyagoknak, és az alábbi lépéseket ismerteti:

• Hozza létre a tanúsítvány-aláírási kérelemfájlt.
• Leküldéses értesítések kérése az alkalmazástól.
• Hozzon létre egy kiépítési profilt az alkalmazáshoz.
• Értesítési központ létrehozása.
• Konfigurálja az értesítési központot APNS-információkkal.

Előfeltételek

Az oktatóanyag elvégzéséhez egy aktív Azure-fiókra lesz szüksége. Ha nincs fiókja, néhány perc alatt létrehozhat egy ingyenes próbafiókot. További információ: Ingyenes Azure-próbafiók létrehozása.

A következőkre is szüksége lesz:

• Aktív Apple Developer-fiók .
• Egy Xcode-ot futtató Mac gép, valamint egy érvényes fejlesztői tanúsítvány, amely telepítve van a kulcskarikába.
• Az iOS 10-es vagy újabb verzióját futtató i Telefon vagy iPad.
• Az Apple Portalon regisztrált és a tanúsítványhoz társított fizikai eszköz.

Ha nem ismeri a szolgáltatást, mindenképpen olvassa el az Azure Notification Hubs áttekintését .

Megjegyzés:

Az értesítési központ úgy lesz konfigurálva, hogy csak a Tesztkörnyezet hitelesítési módját használja. Éles számítási feladatokhoz ne használja ezt a hitelesítési módot.

A tanúsítvány-aláírási kérelemfájl létrehozása

Az Apple Push Notification szolgáltatás (APNS) tanúsítványokat használ a leküldéses értesítések hitelesítéséhez. Kövesse ezeket az utasításokat az értesítések küldéséhez és fogadásához szükséges leküldéses tanúsítvány létrehozásához. További információért lásd az Apple Push Notification szolgáltatás hivatalos dokumentációját.

Hozza létre a tanúsítvány-aláírási kérelem (CSR) fájlt, amelyet az Apple egy aláírt leküldéses tanúsítvány létrehozásához használ:

1. Futtassa a Kulcskarika-elérés eszközt a Mac gépén. Megnyitható a Utilities mappából vagy a Launchpad Másik mappájából.

2. Válassza a Kulcskarika-hozzáférés lehetőséget, bontsa ki a Tanúsítványsegédet, majd válassza a Tanúsítvány kérése hitelesítésszolgáltatótól lehetőséget.

   

   Megjegyzés:

   Alapértelmezés szerint a Keychain Access kiválasztja a lista első elemét. Ez akkor lehet probléma, ha a Tanúsítványok kategóriában van, és az Apple Worldwide Developer Relations hitelesítésszolgáltató nem az első elem a listában. A CSR (tanúsítvány-aláírási kérelem) létrehozása előtt győződjön meg arról, hogy nincs kulcseleme, vagy az Apple Worldwide Developer Relations hitelesítésszolgáltatói kulcs van kiválasztva.

3. Válassza ki a felhasználói e-mail-címét, adja meg a Közös név értékét, győződjön meg arról, hogy a Lemezre mentett értéket adja meg, majd válassza a Folytatás lehetőséget. Hagyja üresen a hitelesítésszolgáltató e-mail-címét , mert nincs rá szükség.

   

4. Adja meg a CSR-fájl nevét a Mentés másként mezőben, válassza ki a helyet a Hol, majd a Mentés lehetőséget.

   

   Ez a művelet a CSR-fájlt a kijelölt helyre menti. Az alapértelmezett hely az Asztal. Jegyezze meg a fájlhoz választott helyet.

Ezután regisztrálja az alkalmazást az Apple-ben, engedélyezze a leküldéses értesítéseket, és töltse fel az exportált CSR-t leküldéses tanúsítvány létrehozásához.

Alkalmazás regisztrálása leküldéses értesítésekhez

Ha leküldéses értesítéseket szeretne küldeni egy iOS-alkalmazásnak, regisztrálja az alkalmazást az Apple-ben, és regisztráljon leküldéses értesítésekre is.

1. Ha még nem regisztrálta az alkalmazást, keresse meg az iOS kiépítési portálját az Apple Developer Centerben. Jelentkezzen be a portálra az Apple ID azonosítójával, és válassza az Azonosítók lehetőséget. Ezután válassza ki + az új alkalmazás regisztrálását.

   

2. Az Új azonosító regisztrálása képernyőn válassza az Alkalmazásazonosítók választógombot. Ezután válassza a Folytatás elemet.

   

3. Frissítse a következő három értéket az új alkalmazáshoz, majd válassza a Folytatás lehetőséget:

   • Leírás: Írja be az alkalmazás leíró nevét.

   • Csomagazonosító: Adja meg a Szervezeti azonosító.Terméknév űrlap csomagazonosítóját az alkalmazásterjesztési útmutatóban leírtak szerint. A szervezetazonosító és a terméknév értékének meg kell egyeznie az Xcode-projekt létrehozásakor használt szervezeti azonosítóval és terméknévvel. Az alábbi képernyőképen a NotificationHubs-érték lesz a szervezet azonosítója, a GetStarted érték pedig a terméknév. Győződjön meg arról, hogy a Csomagazonosító érték megegyezik az Xcode-projektben lévő értékkel, hogy az Xcode a megfelelő közzétételi profilt használja.

     

   • Leküldéses értesítések: Ellenőrizze a Leküldéses értesítések lehetőséget a Képességek szakaszban.

     

     Ez a művelet létrehozza az alkalmazásazonosítót, és kéri, hogy erősítse meg az információkat. Válassza a Folytatás lehetőséget, majd a Regisztráció elemet az új alkalmazásazonosító megerősítéséhez.

     

     Miután kiválasztotta a Regisztráció lehetőséget, az új alkalmazásazonosító sorelemként jelenik meg a Tanúsítványok, azonosítók és profilok lapon.

4. A Tanúsítványok, azonosítók & profilok lap Azonosítók területén keresse meg az imént létrehozott alkalmazásazonosító sorelemet, és válassza ki annak sorát az Alkalmazásazonosító konfigurációjának szerkesztése képernyő megjelenítéséhez.

Tanúsítvány létrehozása a Notification Hubshoz

Megjegyzés:

Az iOS 13 kiadásával csak jogkivonatalapú hitelesítéssel fogadhat csendes értesítéseket. Ha tanúsítványalapú hitelesítést használ az APNS-hitelesítő adataihoz, jogkivonatalapú hitelesítésre kell váltania.

Tanúsítvány szükséges ahhoz, hogy az értesítési központ működjön az APNS-sel. Ez kétféleképpen végezhető el:

• Hozzon létre egy .p12 fájlt, amely közvetlenül a Notification Hubsba tölthető fel.

• Hozzon létre egy .p8 fájlt, amely a jogkivonatalapú hitelesítéshez használható (az újabb módszer).

A második lehetőség számos előnnyel rendelkezik a tanúsítványok használatához képest, ahogyan az APNS tokenalapú (HTTP/2) hitelesítésében dokumentálva van. A lépések azonban mindkét megközelítéshez elérhetők.

1. lehetőség: Hozzon létre egy .p12 leküldéses tanúsítványt, amely közvetlenül feltölthető a Notification Hubsba

1. Görgessen le a leküldéses értesítések jelölőnégyzethez, majd válassza a Tanúsítvány létrehozásához szükséges Konfigurálás lehetőséget.

   

2. Megjelenik az Apple Push Notification szolgáltatás SSL-tanúsítványainak ablaka . Válassza a Tanúsítvány létrehozása gombot a Fejlesztési SSL-tanúsítvány szakaszban.

   

   Megjelenik az Új tanúsítvány létrehozása képernyő.

   Megjegyzés:

   Ez az oktatóprogram fejlesztési tanúsítványt használ. Ugyanez a folyamat használatos a termelési tanúsítvány regisztrálásához is. Győződjön meg arról, hogy ugyanazt a tanúsítványtípust használja az értesítések küldésekor.

3. Válassza a Fájl kiválasztása lehetőséget, keresse meg azt a helyet, ahová az első feladatból mentette a CSR-fájlt, majd kattintson duplán a tanúsítvány nevére a betöltéséhez. Ezután válassza a Folytatás elemet.

4. Miután a portál létrehozta a tanúsítványt, válassza a Letöltés gombot. Mentse a tanúsítványt, és jegyezze meg a mentés helyét.

   

   A rendszer letölti és menti a tanúsítványt a Letöltések mappába.

   

   Alapértelmezés szerint a letöltött fejlesztési tanúsítvány neve aps_development.cer.

5. Kattintson duplán a letöltött aps_development.cer leküldéses tanúsítványra. Ez a művelet telepíti az új tanúsítványt a kulcsláncba, ahogy az alábbi képen látható:

   

   Bár a tanúsítványban szereplő név eltérő lehet, az Apple Development iOS Push Services előtagja lesz.

6. A kulcslánc-hozzáférési oldalon kattintson a jobb egérgombbal az új leküldéses tanúsítványra, melyet a Certificates (Tanúsítványok) kategóriában létrehozott. Válassza az Exportálás lehetőséget, nevezze el a fájlt, válassza a .p12 formátumot, majd válassza a Mentés lehetőséget.

   

   Dönthet úgy, hogy jelszóval védi a tanúsítványt, de ez nem kötelező. Ha meg szeretné kerülni a jelszó létrehozását, kattintson az OK gombra . Jegyezze fel az exportált .p12 tanúsítvány nevét és helyét. Ezek az APNS-hitelesítés engedélyezésére szolgálnak.

   Megjegyzés:

   Előfordulhat, hogy a .p12 fájl neve és helye eltér az oktatóanyagban láthatótól.

2. lehetőség: Jogkivonatalapú hitelesítéshez használható .p8-tanúsítvány létrehozása

1. Jegyezze fel a következő részleteket:

   • Alkalmazásazonosító-előtag (ez egy csapatazonosító)
   • Csomagazonosító

2. A Tanúsítványok, azonosítók és profilok területen kattintson a Kulcsok elemre. Ha már rendelkezik az APNS-hez konfigurált kulccsal, használhatja újra a .p8 tanúsítványt, amelyet közvetlenül a létrehozása után töltött le. Ha igen, figyelmen kívül hagyhatja a 3–5. lépést.

3. Kattintson a + gombra (vagy a Kulcs létrehozása gombra) egy új kulcs létrehozásához.

4. Adjon meg egy megfelelő kulcsnévértéket, ellenőrizze az Apple Push Notifications szolgáltatás (APNS) beállítását, majd kattintson a Folytatás gombra, majd a következő képernyőn a Regisztráció elemre.

5. Kattintson a Letöltés gombra, majd helyezze át a .p8 fájlt (előtaggal) AuthKey_egy biztonságos helyi könyvtárba, majd kattintson a Kész gombra.

   Fontos

   Ügyeljen arra, hogy a .p8 fájl biztonságos helyen maradjon (és mentsen biztonsági másolatot). A kulcs letöltése után nem tölthető le újra; a kiszolgálópéldány el lesz távolítva.

6. A Kulcsok területen kattintson az imént létrehozott kulcsra (vagy egy meglévő kulcsra, ha ezt választotta).

7. Jegyezze fel a kulcsazonosító értékét.

8. Nyissa meg a .p8-tanúsítványt egy tetszőleges alkalmazásban, például a Visual Studio Code-ban, majd jegyezze fel a kulcs értékét. Ez az érték -----BEGIN PRIVATE KEY----- és -----END PRIVATE KEY----- között.

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

   Ez az a tokenérték, amelyet később a Notification Hubs konfigurálásához használunk.

A lépések végén a következő információkkal kell rendelkeznie az értesítési központ APNS-adatokkal való konfigurálásához:

• Csapatazonosító (lásd: 1. lépés)
• Csomagazonosító (lásd: 1. lépés)
• Kulcsazonosító (lásd a 7. lépést)
• Jogkivonat értéke (a .p8 kulcs értéke, lásd a 8. lépést)

Kiépítési profil létrehozása

1. Térjen vissza az iOS kiépítési portálra, válassza a Tanúsítványok, Azonosítók és profilok lehetőséget, válassza a Profilok lehetőséget a bal oldali menüből, majd válasszon + egy új profil létrehozásához. Megjelenik az Új kiépítési profil regisztrálása képernyő.

2. A kiépítési profil típusaként válassza az iOS-alkalmazásfejlesztést a Fejlesztés területen, majd válassza a Folytatás lehetőséget.

   

3. Ezután válassza ki az alkalmazásazonosító legördülő listából létrehozott alkalmazásazonosítót , majd válassza a Folytatás lehetőséget.

   

4. A Tanúsítványok kiválasztása ablakban válassza ki a kódaláíráshoz használt fejlesztési tanúsítványt, és válassza a Folytatás lehetőséget. Ez a tanúsítvány nem a létrehozott leküldéses tanúsítvány. Ha nem létezik, létre kell hoznia. Ha létezik tanúsítvány, ugorjon a következő lépésre. Fejlesztési tanúsítvány létrehozása, ha nem létezik:

   1. Ha azt látja , hogy nem érhetők el tanúsítványok, válassza a Tanúsítvány létrehozása lehetőséget.
   2. A Szoftver szakaszban válassza az Apple Development lehetőséget. Ezután válassza a Folytatás elemet.
   3. Az Új tanúsítvány létrehozása képernyőn válassza a Fájl kiválasztása lehetőséget.
   4. Keresse meg a korábban létrehozott tanúsítvány-aláírási kérelem tanúsítványát, jelölje ki, majd válassza a Megnyitás lehetőséget.
   5. Válassza a Folytatás lehetőséget.
   6. Töltse le a fejlesztési tanúsítványt, és jegyezze meg a mentés helyét.

5. Térjen vissza a Tanúsítványok, Azonosítók &profilok lapra, válassza a Bal oldali menü Profilok elemét, majd válasszon + új profil létrehozásához. Megjelenik az Új kiépítési profil regisztrálása képernyő.

6. A Tanúsítványok kiválasztása ablakban válassza ki az imént létrehozott fejlesztési tanúsítványt. Ezután válassza a Folytatás elemet.

7. Ezután válassza ki a teszteléshez használni kívánt eszközöket, majd válassza a Folytatás lehetőséget.

8. Végül válassza ki a profil nevét a Kiépítési profil neve területen, majd válassza a Létrehozás lehetőséget.

   

9. Az új kiépítési profil létrehozásakor válassza a Letöltés lehetőséget. Jegyezze meg a mentés helyét.

10. Keresse meg a kiépítési profil helyét, majd kattintson rá duplán az Xcode fejlesztői gépére való telepítéshez.

Értesítési központ létrehozása

Ebben a szakaszban egy értesítési központot hoz létre, és a .p12 leküldéses tanúsítvány vagy jogkivonatalapú hitelesítés használatával konfigurálja a hitelesítést az APNS használatával. Ha már létrehozott értesítési központot szeretne használni, ugorjon az 5. lépésre.

1. Jelentkezzen be az Azure Portalra.

2. Válassza a bal oldali menü Minden szolgáltatás elemét, majd a Mobil szakaszban válassza a Notification Hubs lehetőséget. A szolgáltatás neve melletti csillag ikonnal felveheti a szolgáltatást a kedvencek szakaszba a bal oldali menüben. Miután hozzáadta a Notification Hubsot a KEDVENCekhez, jelölje ki.

   

3. A Notification Hubs lapon válassza a Hozzáadás lehetőséget az eszköztáron.

   

4. A Notification Hubs lapon hajtsa végre a következő lépéseket:

   1. Adjon meg egy nevet a Notification Hubban.
   2. Adjon meg egy nevet az Új névtér létrehozása mezőben. A névtér egy vagy több értesítési központot tartalmaz.
   3. Válasszon egy értéket a Hely legördülő listából. Ez az érték határozza meg azt a helyet, ahol létre szeretné hozni az értesítési központot.
   4. Válasszon ki egy meglévő erőforráscsoportot az Erőforráscsoportban, vagy hozzon létre egy új erőforráscsoportot.
   5. Select Create.

   

5. Válassza az Értesítések (a harang ikon), majd az Erőforrás megnyitása lehetőséget. A Notification Hubs lapon is frissítheti a listát, és kiválaszthatja a központot.

   

6. A listáról válassza a Hozzáférési szabályzatok lehetőséget. Vegye figyelembe, hogy a két kapcsolati sztring elérhetők. Később szüksége lesz rájuk a leküldéses értesítések kezeléséhez.

   Fontos

   Ne használja a DefaultFullSharedAccessSignature házirendet az alkalmazásban. Ez csak a háttérrendszerben használható.

   

Az értesítési központ konfigurálása APNS-adatokkal

A Notification Services területen válassza az Apple (APNS) lehetőséget, majd kövesse a megfelelő lépéseket a Korábban a Tanúsítvány létrehozása a Notification Hubshoz szakaszban kiválasztott módszer alapján.

Megjegyzés:

A Production for Application Mode csak akkor használható, ha leküldéses értesítéseket szeretne küldeni az alkalmazás áruházból vásárolt felhasználóknak.

1. lehetőség: .p12 leküldéses tanúsítvány használata

1. Válassza a Tanúsítvány elemet.

2. Válassza a fájl ikont.

3. Válassza ki a korábban exportált .p12 fájlt, majd válassza a Megnyitás lehetőséget.

4. Ha szükséges, adja meg a megfelelő jelszót.

5. Válassza a Védőfal módot.

   

6. Válassza a Mentés parancsot.

2. lehetőség: Jogkivonatalapú hitelesítés használata

1. Válassza a Jogkivonat lehetőséget.

2. Adja meg a korábban beszerzett alábbi értékeket:

   • Kulcsazonosító
   • Csomagazonosító
   • Csapatazonosító
   • Jogkivonat

3. Tesztkörnyezet kiválasztása

4. Válassza a Mentés parancsot.

Most már konfigurálta az értesítési központot az APNS-sel. Az alkalmazás regisztrálásához és leküldéses értesítések küldéséhez szükséges kapcsolati sztring is rendelkezik.

További lépések

Ebben az oktatóanyagban létrehozott és konfigurált egy értesítési központot az Azure-ban, és úgy konfigurálta, hogy lehetővé tegye az értesítések küldését az alkalmazásnak az Apple Push Notification Service (APNS) használatával. Ezután létrehozunk egy iOS-mintaalkalmazást, és integráljuk az Azure Notification Hubs SDK-t, hogy fogadni tudja az Azure Portalon keresztül küldött leküldéses értesítéseket. Lépjen tovább a következő oktatóanyagra a választott nyelv alapján:

• Oktatóanyag: Leküldéses értesítések küldése iOS-alkalmazásokba az Azure Notification Hubs használatával