Authentification par jeton apns

Cet

article explique comment utiliser le nouveau protocole HTTP/2 APNS avec l’authentification basée sur les jetons.

Les principaux avantages de l’utilisation du nouveau protocole sont les suivants :

• La génération de jetons est relativement simple (par rapport aux certificats)
• Plus de dates d’expiration - vous avez le contrôle de vos jetons d’authentification et de leur révocation
Les
• charges utiles peuvent désormais atteindre jusqu’à 4 Ko
• Commentaires synchrones
• Vous utilisez le dernier protocole d’Apple - les certificats utilisent toujours le protocole binaire, qui est marqué pour être obsolète

L’utilisation de ce nouveau mécanisme peut être effectuée en deux étapes :

• Obtenez les informations nécessaires à partir du portail du compte Apple Developer.
• Configurez votre hub de notification avec les nouvelles informations.

Notification Hubs est désormais configuré pour utiliser le nouveau système d’authentification avec APNS.

Notez que si vous avez migré à partir de l’utilisation des informations d’identification de certificat pour APNS, les propriétés du jeton remplacent votre certificat dans notre système, mais votre application continue de recevoir des notifications de manière transparente.

Obtention d’informations d’authentification auprès d’Apple

Pour activer l’authentification basée sur un jeton, vous avez besoin des propriétés suivantes de votre compte Apple Developer : Identificateur de

clé L’identificateur de clé peut être obtenu à partir de la page Clés , sous Certificats, identifiants et profils , dans votre compte Apple Developer :

Le

nom et l’identificateur de l’application sont également disponibles dans la section Certificats, identificateurs et profils dans le compte développeur.

Configurer via le SDK .NET ou le portail Azure

Vous pouvez configurer votre hub pour utiliser l’authentification basée sur des jetons à l’aide de notre dernier SDK client ou dans le portail Azure. Pour activer l’authentification basée sur un jeton dans le portail, connectez-vous au portail Azure et accédez au panneau Paramètres > Apple (APNS) de votre hub de notification. Sélectionnez Jeton dans la propriété Mode d’authentification pour mettre à jour votre hub avec toutes les propriétés de jeton pertinentes.

• Entrez les propriétés que vous avez récupérées à partir de votre compte Apple Developer.
• Choisissez le mode d’application ( Production ou Sandbox ).
• Cliquez sur le bouton Enregistrer pour mettre à jour vos informations d’identification APNS.

Les informations d’identification basées sur des jetons sont les suivantes composé des champs suivants :

• Key ID : Identifiant de la clé privée générée dans l’Apple Developer portal ; par exemple, .
• ID d’équipe : également appelé « préfixe » ou « préfixe d’application ». Il s’agit de l’identificateur de l’organisation dans le portail Apple Developer. par exemple.
• Bundle ID : Aussi appelé « App ID ». Il s’agit de l’identificateur de bundle de l’application ; par exemple. Notez que vous ne pouvez utiliser qu’une seule clé pour une seule application. Cette valeur est mappée à l’en-tête HTTP lors de l’envoi d’une notification et est utilisée pour cibler l’application spécifique. Vous ne pouvez pas définir la valeur de explicitement.
• Token : Aussi appelé « Clé » ou « Clé Privée ». Ceci est obtenu à partir du fichier .p8 généré sur le portail Apple Developer. L’APNS doit être activé sur la clé (qui est sélectionné sur l’Apple Developer lors de la génération de la clé). L’en-tête/pied de page PEM de la valeur doit être supprimé lorsque vous la fournissez au portail/API NH.
• Point de terminaison : il s’agit d’une bascule dans le panneau du portail Notification Hubs et d’un champ de chaîne dans l’API. Les valeurs valides sont ou . Notification Hubs utilise cette valeur pour l’environnement de production ou de sandbox, pour l’envoi de notifications. Cela doit correspondre au droit dans l’application, sinon les jetons d’appareil APNS générés ne correspondent pas à l’environnement et les notifications ne sont pas envoyées.

Voici un exemple de code illustrant l’utilisation correcte :

Étapes suivantes