Passer au contenu principal
Les SDKs Guardian pour iOS et Android vous permettent d’utiliser une application conçue sur mesure avec des services de notifications push propres à chaque fournisseur. Vous pouvez configurer les notifications push pour la plateforme AWS Simple Notification Service (SNS) ou utiliser les services Direct to Vendor pour ajouter directement dans Auth0 les identifiants Firebase Cloud Messaging (FCM) et Apple Push Notification (APN).

Configuration d’AWS SNS

Avant de configurer les notifications push, suivez les prérequis ci-dessous :
  1. Créez une Platform Application SNS à l’aide de la console de gestion AWS et notez son ARN.
  2. Créez un AWS Access Key ID autorisé à créer des points de terminaison de Platform Application. Guardian crée automatiquement un point de terminaison de Platform Application avec le jeton d’appareil approprié dans le cadre d’une inscription réussie.

Configurer les notifications push avec AWS SNS

Pour recevoir des notifications push de Guardian, vous devez d’abord remplacer les paramètres SNS par défaut de Guardian. Vous pourrez ensuite configurer les notifications push pour Android et iOS.
  1. Dans l’Auth0 Dashboard, accédez à Sécurité > Authentification multifacteur et sélectionnez Push via Auth0 Guardian. Si la méthode est inactive, sélectionnez la bascule en haut à droite pour l’activer.
  2. Sélectionnez Custom pour afficher des paramètres supplémentaires.
  3. Dans la section Service de notifications push, choisissez Amazon SNS.
Auth0 Dashboard > Sécurité > Authentification multifacteur > Guardian > Custom > Amazon SNS
  1. Dans la section Configuration d’Amazon SNS, renseignez les champs suivants :
  2. Sélectionnez Save pour enregistrer vos modifications.

Configurer les notifications push pour Android avec FCM

Pour configurer les notifications push Android dans votre Auth0 Dashboard, commencez par récupérer les identifiants de votre serveur FCM. Pour plus de détails, consultez la documentation Firebase de Google.
  1. Accédez à la console Firebase et sélectionnez le projet approprié.
  2. Ouvrez le menu Settings et choisissez Service Accounts.
  3. Sélectionnez Generate New Private Key pour télécharger votre fichier d’identifiants.
Une fois vos identifiants récupérés, vous pouvez configurer les notifications push dans votre Auth0 Dashboard.

Configurer les notifications push pour iOS à l’aide d’APNs

Pour configurer les notifications push iOS dans votre Auth0 Dashboard, commencez par récupérer votre certificat APN, puis convertissez-le à un chiffrement moderne.Trousseau d’accès (Keychain Access) exporte les fichiers P12 avec un ancien chiffrement (RC2 et Triple DES). Comme Auth0 n’accepte pas les fichiers P12 qui utilisent un ancien chiffrement, vous devez convertir le fichier vers un chiffrement moderne (AES-256-CBC) avant de le téléverser. Pour effectuer la conversion, il vous faut OpenSSL 3.0 ou une version ultérieure. La commande openssl fournie avec macOS est en fait LibreSSL, qui ne prend pas en charge les options utilisées dans les étapes suivantes. Sur macOS, vous pouvez installer OpenSSL avec Homebrew :
  1. Générez un nouveau certificat APN à partir de votre compte de développeur Apple. Choisissez le type Apple Push Notification service SSL (Sandbox & Production). Pour le développement et les tests seulement, vous pouvez plutôt choisir Apple Push Notification service SSL (Sandbox).
  2. Installez le certificat en local.
  3. Repérez le certificat dans votre application Trousseau d’accès (Keychain Access). Son nom dépend du type de certificat :
    • Apple Push Notification service SSL (Sandbox & Production) : Apple Push Services: {AppId}
    • Apple Push Notification service SSL (Sandbox) : Apple Sandbox Push Services: {AppId}
  4. Exportez le certificat et la clé privée associée dans un fichier P12 (nom par défaut : Certificates.p12). Lorsque Trousseau d’accès vous demande un mot de passe pour protéger les éléments exportés, laissez le champ du mot de passe vide.
  5. Convertissez Certificates.p12 pour utiliser un chiffrement moderne. Dans un terminal, accédez au dossier qui contient le fichier, puis exécutez les commandes suivantes :
    1. Définissez la variable shell OPENSSL sur la commande openssl installée par Homebrew, afin que les commandes suivantes n’utilisent pas LibreSSL. Si vous avez installé OpenSSL 3.0 ou une version ultérieure sans Homebrew, indiquez plutôt le chemin complet de son binaire openssl.
      La commande $OPENSSL version affiche votre version d’OpenSSL. La sortie doit indiquer OpenSSL 3.0 ou une version ultérieure, et non LibreSSL.
    2. Extrayez le certificat et la clé privée dans un fichier intermédiaire apns.pem. OpenSSL a besoin de l’option -legacy pour lire l’ancien chiffrement.
    3. Créez un fichier apns.p12 doté d’un chiffrement moderne et sans mot de passe. Le nouveau fichier utilise le schéma de chiffrement par mot de passe 2 (PBES2) avec AES-256-CBC et un code d’authentification de message (MAC) SHA-256.
    4. Supprimez apns.pem, puisqu’il contient votre clé privée non chiffrée :
  6. Avant de téléverser apns.p12, vérifiez son chiffrement. Exécutez la commande suivante dans la même session de terminal, pour que la variable OPENSSL soit toujours définie :
    Vérifiez les trois lignes suivantes dans la sortie :
    1. La ligne MAC affiche sha256.
    2. Pour le certificat, la ligne PKCS7 Encrypted data affiche PBES2, PBKDF2, AES-256-CBC.
    3. Pour la clé privée, la ligne Shrouded Keybag affiche PBES2, PBKDF2, AES-256-CBC.
    La sortie devrait ressembler à ceci :
  7. Supprimez Certificates.p12 et utilisez apns.p12 comme certificat APN dans l’Auth0 Dashboard. Pour téléverser plutôt le certificat au moyen de la Management API d’Auth0, encodez apns.p12 en base64 :
    Utilisez le résultat comme valeur p12 lorsque vous appelez le terminal Update APNS Configuration. Comme ce terminal remplace l’ensemble de la configuration APNs, incluez aussi les valeurs bundle_id et sandbox. Pour obtenir les valeurs actuelles, appelez le terminal Get APNS Push Notification Configuration.
Après avoir récupéré vos informations d’identification, vous pouvez configurer les notifications push dans votre Auth0 Dashboard.

En savoir plus