Kurz: Odesílání nabízených oznámení do aplikací 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ásledné kurzy Objective C a Swift pro iOS a zahrnuje 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í pomocí informací 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 spolu s 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 tuto 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žije 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 Utility nebo ze složky Jiné na hlavním panelu.

  2. Vyberte Přístup ke svazku klíčů, rozbalte Pomocník s certifikáty a pak vyberte Požádat o certifikát od certifikační autority.

    Snímek obrazovky se zvýrazněnou možností nabídky Vyžádat certifikát z certifikační autority

    Poznámka

    Ve výchozím nastavení vybere přístup řetězce klíčů první položku v seznamu. To může 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 (CERTIFICATE Signing Request) se ujistěte, že máte položku, která není klíčem, nebo že je vybraný klíč certifikační autority Apple Worldwide Developer Relations .

  3. Vyberte adresu Email uživatele, zadejte hodnotu Běžný název, ujistěte se, že jste zadali Možnost Uloženo na disk, a pak vyberte Pokračovat. Adresu Email certifikační autority nechte prázdnou, protože není nutná.

    Požadované informace o certifikátu

  4. Do pole Uložit jako zadejte název souboru CSR, vyberte umístění v části Kam a pak vyberte Uložit.

    Zvolit název souboru

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

Dále zaregistrujte aplikaci u Společnosti Apple, povolte nabízená oznámení a nahrajte exportovanou žádost o podepsání certifikátu, abyste vytvořili certifikát push.

Registrace aplikace pro nabízená oznámení

Pokud chcete odesílat nabízená oznámení do aplikace pro iOS, zaregistrujte aplikaci u společnosti 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í svého Apple ID a vyberte Identifikátory. Pak vyberte + a zaregistrujte novou aplikaci.

    Stránka ID aplikací

  2. Na obrazovce Register a New Identifier (Zaregistrovat nový identifikátor ) vyberte přepínač App ID (ID aplikací ). Potom vyberte Pokračovat.

    Zaregistrovat novou stránku ID

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

    • Popis: Zadejte popisný název aplikace.

    • ID sady prostředků: Zadejte ID sady ve formátu Identifikátor organizace.Název produktu , jak je uvedeno v průvodci distribucí aplikací. Hodnoty Identifikátor organizace a Název produktu se musí shodovat s identifikátorem organizace a názvem produktu, který používáte 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átor sady odpovídá hodnotě v projektu Xcode, aby Xcode používal správný profil publikování.

      Registrace ID aplikace

    • Nabízená oznámení: Zaškrtněte možnost Nabízená oznámení v části Schopnosti .

      Registrace nového ID aplikace

      Tato akce vygeneruje ID aplikace a požádá o potvrzení informací. Vyberte Pokračovat a pak výběrem možnosti Zaregistrovat potvrďte nové ID aplikace.

      Potvrzení nového ID aplikace

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

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

Vytvoření certifikátu pro Notification Hubs

Poznámka

S vydáním iOSu 13 můžete přijímat jenom tichá oznámení pomocí ověřování na základě tokenů. Pokud pro přihlašovací údaje APNS používáte ověřování na základě certifikátu, musíte přepnout na ověřování na základě tokenů.

Aby centrum oznámení fungovalo se službou APNS, vyžaduje se certifikát. Můžete to udělat jedním ze dvou způsobů:

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

  • Vytvořte soubor .p8 , který se dá použít k ověřování na základě tokenů (novější přístup).

Druhá možnost má ve srovnání s používáním certifikátů řadu výhod, jak je popsáno v tématu Ověřování založené na tokenech (HTTP/2) pro APNS. Kroky jsou 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 výběrem možnosti Konfigurovat vytvořte certifikát.

    ID aplikace

  2. Zobrazí se okno Certifikáty SSL služby Apple Push Notification. V části Development SSL Certificate (Vývoj certifikátu SSL) vyberte tlačítko Create Certificate (Vytvořit certifikát SSL).

    Vytvoření certifikátu

    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. Ujistěte se, že při odesílání oznámení používáte stejný typ certifikátu.

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

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

    Stažení certifikátu

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

    Vyhledání souboru certifikátu

    Ve výchozím nastavení má stažený vývojový certifikát název 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:

    Přístup ke svazku klíčů

    I když se název v certifikátu může lišit, bude mít před název 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 certifikátu

    Certifikát můžete chránit heslem, ale tato možnost je volitelná. Pokud chcete obejít vytváření hesla, klikněte na 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ý se dá použít k ověřování na základě tokenů

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

    • Předpona ID aplikace (toto je ID týmu)
    • ID sady prostředků
  2. Zpět v části Certifikáty, 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 si stáhli hned po jeho vytvoření. Pokud ano, můžete kroky 3 až 5 ignorovat.

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

  4. Zadejte vhodnou hodnotu Název klíče , zaškrtněte možnost Služba Nabízených oznámení Apple (APNS) a na další obrazovce klikněte na Pokračovat a pak na Zaregistrovat .

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

    Důležité

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

  6. V části Klíče klikněte na klíč, který jste právě vytvořili (nebo na existující klíč, pokud jste se ho rozhodli použít).

  7. Poznamenejte si hodnotu ID klíče .

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

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

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

Na konci těchto kroků byste měli mít následující informace pro pozdější použití v části Konfigurace centra oznámení s informacemi O 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 pro zřizování iOS, vyberte Certifikáty, Profily identifikátorů&, v nabídce vlevo vyberte Profily a pak výběrem vytvořte + nový profil. Zobrazí se obrazovka Zaregistrovat nový zřizovací profil .

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

    Seznam zřizovacích profilů

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

    Vyberte ID aplikace.

  4. V okně Vybrat certifikáty vyberte certifikát pro vývoj, který používáte k podepisování kódu, a vyberte Pokračovat. Tento certifikát není certifikátem push, 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í Možnost Nejsou k dispozici žá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 certifikát pro vývoj 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 výběrem vytvořte + nový profil. Zobrazí se obrazovka Zaregistrovat nový zřizovací profil .

  6. V okně Vybrat certifikáty vyberte certifikát pro vývoj, 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 Vygenerovat.

    Volba názvu zřizovacího profilu

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

  10. Přejděte do umístění zřizovacího profilu a poklikáním ho nainstalujte 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í 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 vyberte Notification Hubs v části Mobilní . Výběrem ikony hvězdičky vedle názvu služby přidejte službu do části OBLÍBENÉ v nabídce vlevo. Až přidáte Notification Hubs k oblíbeným položkám, vyberte ho.

    Azure Portal

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

    Tlačítko Přidat panel nástrojů

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

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

    Nastavení vlastností

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

    Oznámení na portálu

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

    Důležité

    Nepoužívejte ve své aplikaci zásadu DefaultFullSharedAccessSignature . To se má používat jenom v back-endu.

    Připojovací řetězce

Konfigurace centra oznámení s využitím informací APNS

V části Notification Services vyberte Apple (APNS) a pak postupujte podle postupu, který jste zvolili dříve v části Vytvoření certifikátu pro Notification Hubs .

Poznámka

Produkční režim použijte pro aplikační režim jenom v případě, že chcete odesílat nabízená oznámení uživatelům, kteří si zakoupili vaši aplikaci ze Storu.

Možnost 1: Použití nabízeného 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.

    Konfigurace

  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. Zvolte Sandbox.

  4. Vyberte Uložit.

Právě jste nakonfigurovali centrum oznámení s 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 jste ho tak, aby umožňovalo odesílání oznámení do vaší aplikace prostřednictvím služby Apple Push Notification Service (APNS). V dalším kroku vytvoříme ukázkovou aplikaci pro iOS a integrujeme sadu Azure Notifications Hubs SDK, která bude moct přijímat nabízená oznámení odesílaná prostřednictvím Azure Portal. Přejděte k následujícímu kurzu podle jazyka podle vašeho výběru: