Kurz: Odesílání nabízených oznámení aplikacím pro iOS pomocí Azure Notification Hubs

V tomto kurzu se dozvíte, jak nastavit Azure Notification Hubs a nakonfigurovat přihlašovací údaje pro nabízená oznámení do zařízení s iOSem prostřednictvím služby Apple Push Notification Service (APNS).

Spuštění tohoto kurzu je předpokladem pro následující kurzy Objective C a Swift pro iOS a popisuje následující kroky:

  • Vygenerujte soubor žádosti o podepsání certifikátu.
  • Požádejte aplikaci o nabízená oznámení.
  • Vytvořte pro aplikaci zřizovací profil.
  • Vytvoříte centrum oznámení.
  • Nakonfigurujte centrum oznámení s informacemi o službě APNS.

Požadavky

K dokončení tohoto kurzu potřebujete mít aktivní účet Azure. Pokud účet nemáte, můžete si během několika minut vytvořit bezplatný zkušební účet. Podrobnosti najdete v článku Bezplatná zkušební verze Azure.

Budete také potřebovat následující:

  • Aktivní účet Apple Developer .
  • Počítač Mac se systémem Xcode a platným certifikátem vývojáře nainstalovaným do klíčenky.
  • IPhone nebo iPad se systémem iOS verze 10 nebo novější.
  • Vaše fyzické zařízení zaregistrované na portálu Apple Portal a přidružené k vašemu certifikátu.

Pokud službu neznáte, nezapomeňte si přečíst přehled služby Azure Notification Hubs .

Poznámka

Centrum oznámení bude nakonfigurováno tak, aby používalo pouze režim ověřování sandboxu. Tento režim ověřování byste neměli používat pro produkční úlohy.

Vygenerování souboru žádosti o podepsání certifikátu

Služba Apple Push Notification Service (APNS) používá k ověřování nabízených oznámení certifikáty. Pokud chcete vytvořit nabízený certifikát pro odesílání a přijímání oznámení, postupujte podle těchto pokynů. Další informace o těchto konceptech najdete v oficiální dokumentaci ke službě Apple Push Notification Service.

Vygenerujte soubor žádosti o podepsání certifikátu (CSR), který Apple používá k vygenerování podepsaného nabízeného certifikátu:

  1. V Macu spusťte nástroj Keychain Access. Můžete ho otevřít ze složky Nástroje nebo z jiné složky na Launchpadu.

  2. Vyberte Přístup ke klíčence, rozbalte Certificate Assistant a pak vyberte Vyžádat certifikát od certifikační autority.

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

    Poznámka

    Ve výchozím nastavení vybere Access řetězce klíčů první položku v seznamu. Může to být problém, pokud jste v kategorii Certifikáty a Certifikační autorita apple Worldwide Developer Relations Certifikační autorita není první položkou v seznamu. Před vygenerováním žádosti o podepsání certifikátu se ujistěte, že máte neklíčovou položku nebo je vybraný klíč certifikační autority apple Worldwide Developer Relations.

  3. Vyberte svoji e-mailovou adresu uživatele, zadejte hodnotu Společného jména , ujistěte se, že jste zadali Uložené na disk, a pak vyberte Pokračovat. E-mailová adresa certifikační autority ponechte prázdnou, protože není nutná.

    Required certificate information

  4. Zadejte název souboru CSR v části Uložit jako, vyberte umístění v umístění Kde a pak vyberte Uložit.

    Choose file name

    Tato akce uloží soubor CSR do vybraného umístění. Výchozí umístění je Desktop. Zapamatujte si umístění tohoto souboru.

Dále zaregistrujte aplikaci v Apple, povolte nabízená oznámení a nahrajte exportovanou CSR a vytvořte certifikát push.

Registrace aplikace pro nabízená oznámení

Pokud chcete odesílat nabízená oznámení do aplikace pro iOS, zaregistrujte aplikaci v Apple a také zaregistrujte nabízená oznámení.

  1. Pokud jste aplikaci ještě nezaregistrovali, přejděte na portál zřizování pro iOS v Centru pro vývojáře Apple. Přihlaste se k portálu pomocí Apple ID a vyberte Identifikátory. Pak vyberte + , že chcete zaregistrovat novou aplikaci.

    App IDs page

  2. Na obrazovce Zaregistrovat nový identifikátor vyberte přepínač ID aplikací . Potom vyberte Pokračovat.

    Register new ID page

  3. Aktualizujte pro novou aplikaci následující tři hodnoty a pak vyberte Pokračovat:

    • Popis: Zadejte popisný název aplikace.

    • ID sady: Zadejte ID sady formuláře Název produktu Organization Identifier.Product Name , jak je uvedeno v průvodci distribucí aplikací. Hodnoty Identifikátor organizace a název produktu musí odpovídat identifikátoru organizace a názvu produktu, který použijete při vytváření projektu Xcode. Na následujícím snímku obrazovky se hodnota NotificationHubs používá jako identifikátor organizace a hodnota GetStarted se používá jako název produktu. Ujistěte se, že hodnota identifikátoru svazku odpovídá hodnotě v projektu Xcode, aby Xcode používal správný profil publikování.

      Register app ID

    • Nabízená oznámení: V části Možnosti zkontrolujte možnost Nabízená oznámení.

      Register new app ID

      Tato akce vygeneruje ID aplikace a žádosti, které potvrdíte. Vyberte Pokračovat a pak výběrem možnosti Zaregistrovat potvrďte nové ID aplikace.

      Confirm new App ID

      Po výběru možnosti Zaregistrovat se nové ID aplikace zobrazí jako položka řádku na stránce Certifikáty, Profily identifikátorů&.

  4. Na stránce Certifikáty, Profily identifikátorů & v části Identifikátory vyhledejte položku řádku ID aplikace, kterou jste právě vytvořili, a výběrem jejího řádku zobrazte obrazovku Upravit ID aplikace.

Vytvoření certifikátu pro Notification Hubs

Poznámka

S vydáním iOS 13 můžete přijímat jenom bezobslužná oznámení pomocí ověřování na základě tokenu. Pokud pro přihlašovací údaje služby APNS používáte ověřování na základě certifikátu, je nutné přepnout na ověřování na základě tokenů.

K tomu, aby centrum oznámení fungovalo s APNS, je vyžadován certifikát. Můžete to provést jedním ze dvou způsobů:

  • Vytvořte soubor .p12 , který lze nahrát přímo do Notification Hubs.

  • Vytvořte soubor .p8 , který lze použít pro ověřování na základě tokenu (novější přístup).

Druhá možnost má v porovnání s použitím certifikátů řadu výhod, jak je uvedeno v ověřování pomocí tokenů (HTTP/2) pro APNS. Postup je však k dispozici pro oba přístupy.

Možnost 1: Vytvoření nabízeného certifikátu .p12, který se dá nahrát přímo do Notification Hubs

  1. Posuňte se dolů na zaškrtnutou možnost Nabízená oznámení a pak vyberte Konfigurovat pro vytvoření certifikátu.

    App ID

  2. Zobrazí se okno Certifikáty SSL služby Apple Push Notification. V části Vývojový certifikát SSL vyberte tlačítko Vytvořit certifikát.

    Create certificate

    Zobrazí se obrazovka Vytvořit nový certifikát .

    Poznámka

    Tento kurz používá vývojový certifikát. Stejný postup se používá při registraci produkčního certifikátu. Při odesílání oznámení se ujistěte, že používáte stejný typ certifikátu.

  3. Vyberte Zvolit soubor, přejděte do umístění, do kterého jste soubor CSR uložili z první úlohy, a potom poklikejte na název certifikátu a načtěte ho. Potom vyberte Pokračovat.

  4. Po vytvoření certifikátu portálu vyberte tlačítko Stáhnout . Uložte certifikát a zapamatujte si umístění, do kterého se uloží.

    Download certificate

    Certifikát se stáhne a uloží do složky Stažené soubory .

    Locate certificate file

    Ve výchozím nastavení se stažený vývojový certifikát jmenuje aps_development.cer.

  5. Poklikejte na stažený nabízený certifikát aps_development.cer. Tato akce nainstaluje nový certifikát do Klíčenky, jak je znázorněno na následujícím obrázku:

    Keychain access

    I když se název v certifikátu může lišit, bude mít předponu Apple Development iOS Push Services.

  6. V nástroji Keychain Access, klikněte pravým tlačítkem na nový nabízený certifikát, který jste vytvořili v kategorii Certifikáty. Vyberte Exportovat, pojmenujte soubor, vyberte formát .p12 a pak vyberte Uložit.

    Export certificate

    Certifikát můžete chránit heslem, ale je to volitelné. Chcete-li obejít vytváření hesel, klikněte na tlačítko OK . Poznamenejte si název souboru a umístění exportovaného certifikátu .p12. Používají se k povolení ověřování pomocí APNS.

    Poznámka

    Název a umístění vašeho souboru .p12 se může lišit od toho, co je znázorněno v tomto kurzu.

Možnost 2: Vytvoření certifikátu .p8, který lze použít pro ověřování na základě tokenu

  1. Poznamenejte si následující podrobnosti:

    • Předpona ID aplikace (toto je ID týmu)
    • ID sady prostředků
  2. Zpátky v certifikátech, profily identifikátorů &klikněte na klíče. Pokud už máte klíč nakonfigurovaný pro APNS, můžete znovu použít certifikát .p8, který jste stáhli hned po jeho vytvoření. Pokud ano, můžete ignorovat kroky 3 až 5.

  3. Kliknutím na + tlačítko (nebo tlačítko Vytvořit klíč ) vytvořte nový klíč.

  4. Zadejte vhodnou hodnotu názvu klíče , zaškrtněte možnost Služba nabízených oznámení Apple (APNS) a potom klikněte na Pokračovata potom na další obrazovce zaregistrujte.

  5. Klepněte na tlačítko Stáhnout a přesuňte soubor .p8 (s předponou AuthKey_) do zabezpečeného místního adresáře a potom klikněte na tlačítko Hotovo.

    Důležité

    Nezapomeňte uložit soubor .p8 na bezpečném místě (a uložit zálohu). Po stažení klíče jej nelze znovu stáhnout; kopie serveru se odebere.

  6. Na klávesách klikněte na klíč, který jste právě vytvořili (nebo existující klíč, pokud jste se rozhodli místo toho použít).

  7. Poznamenejte si hodnotu ID klíče .

  8. Otevřete certifikát .p8 v vhodné aplikaci podle vašeho výběru, například Visual Studio Code, a poznamenejte si hodnotu klíče. Toto je hodnota mezi -----BEGIN PRIVATE KEY----- a -----END PRIVATE KEY----- .

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

    Toto je hodnota tokenu, která se použije později ke konfiguraci Notification Hubs.

Na konci těchto kroků byste měli mít následující informace pro pozdější použití v centru oznámení s informacemi o službě APNS:

  • ID týmu (viz krok 1)
  • ID sady prostředků (viz krok 1)
  • ID klíče (viz krok 7)
  • Hodnota tokenu (hodnota klíče .p8, viz krok 8)

Vytvoření zřizovacího profilu

  1. Vraťte se na portál zřizování pro iOS, vyberte Certifikáty, Profily identifikátorů&, v levé nabídce vyberte Profily a pak vyberte + vytvořit nový profil. Zobrazí se obrazovka Zaregistrovat nový profil zřizování .

  2. Jako typ zřizovacího profilu vyberte Vývoj aplikací pro iOS a pak vyberte Pokračovat.

    Provisioning profile list

  3. Potom v rozevíracím seznamu ID aplikace vyberte ID aplikace, které jste vytvořili, a pak vyberte Pokračovat.

    Select App ID

  4. V okně Vybrat certifikáty vyberte vývojový certifikát, který používáte pro podepisování kódu, a vyberte Pokračovat. Tento certifikát není certifikát nabízených oznámení, který jste vytvořili. Pokud neexistuje, musíte ho vytvořit. Pokud certifikát existuje, přejděte k dalšímu kroku. Vytvoření vývojového certifikátu, pokud neexistuje:

    1. Pokud se zobrazí žádné certifikáty, vyberte Vytvořit certifikát.
    2. V části Software vyberte Vývoj apple. Potom vyberte Pokračovat.
    3. Na obrazovce Vytvořit nový certifikát vyberte Zvolit soubor.
    4. Přejděte na certifikát žádosti o podepsání certifikátu , který jste vytvořili dříve, vyberte ho a pak vyberte Otevřít.
    5. Vyberte Pokračovat.
    6. Stáhněte si vývojový certifikát a zapamatujte si umístění, ve kterém je uložený.
  5. Vraťte se na stránku Certifikáty, Profily identifikátorů&, v nabídce vlevo vyberte Profily a pak vyberte + vytvořit nový profil. Zobrazí se obrazovka Zaregistrovat nový profil zřizování .

  6. V okně Vybrat certifikáty vyberte vývojový certifikát, který jste právě vytvořili. Potom vyberte Pokračovat.

  7. Dále vyberte zařízení, která chcete použít k testování, a vyberte Pokračovat.

  8. Nakonec zvolte název profilu v části Název zřizovacího profilu a pak vyberte Generovat.

    Choose provisioning profile name

  9. Po vytvoření nového zřizovacího profilu vyberte Stáhnout. Zapamatujte si umístění, ve kterém je uloženo.

  10. Přejděte do umístění zřizovacího profilu a poklikejte na něj a nainstalujte ho na vývojový počítač Xcode.

Vytvoříte centrum oznámení.

V této části vytvoříte centrum oznámení a nakonfigurujete ověřování pomocí služby APNS pomocí nabízeného certifikátu .p12 nebo ověřování založeného na tokenech. Pokud chcete použít centrum oznámení, které jste už vytvořili, můžete přeskočit ke kroku 5.

  1. Přihlaste se k webu Azure Portal.

  2. V nabídce vlevo vyberte Všechny služby a pak v části Mobilní služba vyberte Notification Hubs. Výběrem ikony hvězdičky vedle názvu služby přidáte službu do části OBLÍBENÉ V levé nabídce. Po přidání centra oznámení do oblíbených položek ji vyberte.

    Azure portal

  3. Na stránce Notification Hubs vyberte Přidat na panelu nástrojů.

    Add toolbar button

  4. Na stránce Notification Hubs proveďte následující kroky:

    1. Zadejte název v Centru oznámení.
    2. Do pole Vytvořit nový obor názvů zadejte název. Obor názvů obsahuje jedno nebo více center oznámení.
    3. V rozevíracím seznamu Umístění vyberte hodnotu. Tato hodnota určuje umístění, ve kterém chcete centrum oznámení vytvořit.
    4. Vyberte existující skupinu prostředků ve skupině prostředků nebo vytvořte novou skupinu prostředků.
    5. Vyberte Vytvořit.

    Set properties

  5. Vyberte Oznámení (ikona zvonku) a pak vyberte Přejít k prostředku. Seznam můžete také aktualizovat na stránce Notification Hubs a vybrat centrum.

    Portal notifications

  6. Vyberte ze seznamu Zásady přístupu. Všimněte si, že jsou vám k dispozici dva připojovací řetězce. Později je budete potřebovat ke zpracování nabízených oznámení.

    Důležité

    Nepoužívejte ve své aplikaci zásady DefaultFullSharedAccessSignature . To je určené jenom pro použití v back-endu.

    Connection strings

Konfigurace centra oznámení s informacemi o službě APNS

V části Notification Services vyberte Apple (APNS) a pak postupujte podle příslušných kroků na základě přístupu, který jste zvolili dříve v části Vytvoření certifikátu pro Notification Hubs .

Poznámka

Produkční režim pro režim aplikace používejte jenom v případě, že chcete odesílat nabízená oznámení uživatelům, kteří si aplikaci koupili ve Storu.

Možnost 1: Použití certifikátu push certifikátu .p12

  1. Vyberte Certifikát.

  2. Vyberte ikonu souboru.

  3. Vyberte soubor .p12, který jste vyexportovali dříve, a pak vyberte Otevřít.

  4. V případě potřeby zadejte správné heslo.

  5. Vyberte režim Izolovaný prostor.

    Configure

  6. Vyberte Uložit.

Možnost 2: Použití ověřování na základě tokenů

  1. Vyberte token.

  2. Zadejte následující hodnoty, které jste získali dříve:

    • ID klíče
    • ID sady prostředků
    • ID týmu
    • Token
  3. Volba sandboxu

  4. Vyberte Uložit.

Teď jste nakonfigurovali centrum oznámení pomocí APNS. Máte také připojovací řetězce potřebné k registraci aplikace a odesílání nabízených oznámení.

Další kroky

V tomto kurzu jste vytvořili a nakonfigurovali centrum oznámení v Azure a nakonfigurovali ho tak, aby se oznámení odesílala do vaší aplikace prostřednictvím služby Apple Push Notification Service (APNS). Dále vytvoříme ukázkovou aplikaci pro iOS a integrujeme sadu Azure Notification Hubs SDK, aby mohl přijímat nabízená oznámení odeslaná prostřednictvím Azure Portal. Přejděte k následujícímu kurzu na základě zvoleného jazyka: