Vous pouvez personnaliser l'expéditeur du courrier électronique et le fournisseur de SMS pour les messages de notification " IBM® Verify
Avant de commencer
Les clients qui souhaitent intégrer leur propre fournisseur de SMS pour les notifications OTP de IBM Verify doivent configurer un point de terminaison webhook externe qui accepte les requêtes POST de IBM Verify.
Exigences relatives à la configuration du webhook externe
- Le fournisseur de SMS externe doit exposer un point de terminaison HTTP POST webhook pour recevoir les demandes de notification OTP de IBM Verify.
- Le point d'accès doit immédiatement mettre les demandes en file d'attente et renvoyer une réponse à l'adresse HTTP.
Exemple de charge utile de requête JSON{
"destinationPhoneNumber": "18005551212",
"content": "Your passcode is 6439-123456. It expires in 5 minutes.",
"category": "OTP",
"language": "en-US",
"otp": "123456",
"correlation": "6439",
"expiry": 5
}
Descriptions au niveau du terrain
destinationPhoneNumber- Le numéro de téléphone du destinataire au format E.164.
content- Le texte complet du SMS affiché à l'utilisateur.
category- mot de passe à utilisation unique
language- Le code de la langue locale ou de la langue, par exemple en-US.
otp- Valeur du code d'accès à usage unique.
correlation- L'identifiant permettant de corréler l'OTP avec un flux de vérification; il est généralement indiqué dans le message.
expiry- La durée de validité en minutes.
Exigences en matière de réponse au webhook
- 202 Accepté
- Demande mise en file d'attente avec succès.
- 400 Demande incorrecte
- Le format de la charge utile n'est pas valide.
- 500 Erreur de serveur interne
- Le fournisseur n'a pas pu traiter la demande.
Exemple de réponse positive{
"status": "accepted",
"statusMessage": "Message accepted by provider"
}
Exemple de réponse à un échec{
"status": "failed",
"statusMessage": "The destination phone number is invalid."
}
A propos de cette tâche
IBM est l'expéditeur d'e-mails et le fournisseur de SMS par défaut de 'Verify.
Procédure
- Accédez à et sélectionnez l'onglet Expéditeurs.
- Pour modifier l'expéditeur de l'e-mail, cliquez sur
l'icône dans la vignette E-mail.
- Modifiez les valeurs par défaut des options de messagerie suivantes.
Tableau 1. Le tableau décrit les attributs des notifications par courrier électronique.
| Attribut |
Descriptif |
| A partir de l'adresse de l'émetteur |
Changez la valeur de cette zone pour indiquer l'adresse électronique de
l'émetteur de la notification. |
| A partir du nom de messagerie électronique |
Changez la valeur de cette zone pour indiquer la personne ou l'organisation
qui
envoie la notification, par exemple, votre société. |
- Facultatif : cochez la case Utiliser un serveur de messagerie SMTP personnalisé.
Pour votre serveur SMTP personnalisé, indiquez les informations suivantes :
- Hôte SMTP
- Port
- Nom d'utilisateur
- Mot de passe
- Sélectionnez le protocole de connexion, TLS ou SSL.
- Cliquez sur Enregistrer.
- Si votre locataire utilise les services IBM SMS et que vous souhaitez modifier l'identifiant de l'expéditeur des SMS, cliquez sur l'icône sur la vignette Fournisseur SMS.
Vous pouvez modifier l'attribut pour qu'il reflète votre entreprise ou votre organisation.
- Modifier la valeur par défaut de l'option suivante.
Tableau 2. Le tableau décrit les attributs des notifications par SMS.
| Attribut |
Descriptif |
| ID d'émetteur alphanumérique |
Changez la valeur de cette zone pour indiquer l'identificateur alphanumérique
(A-Z, a-z, 0-9) qui identifie l'émetteur du message. La valeur doit commencer par un
caractère alphabétique, ne peut pas comporter d'espace ni de caractère spécial, et ne
doit pas contenir plus de 11 caractères. Note : " Verify ne prend pas en charge la messagerie SMS. |
- Cliquez sur Enregistrer les modifications.
- Si votre locataire n'utilise pas les services IBM SMS et que vous souhaitez utiliser un fournisseur de SMS externe, cliquez sur Ajouter un fournisseur de SMS externe sur la tuile Fournisseur de SMS.
- Indiquez le nom du fournisseur de SMS.
Vous pouvez également indiquer un propriétaire et des informations de contact par courrier électronique.
- Spécifiez l' URL la requête.
L' URL pointe vers le point de terminaison du fournisseur de SMS externe que l'organe de notification appelle pour envoyer un SMS.
- Sélectionnez le type d'authentification.
- Basique
- Indiquez le nom d'utilisateur et le mot de passe.
- En-tête
- Indiquez le nom d'en-tête et le secret d'authentification. Si le secret est sensible à la casse, cochez la case Sensible.
- Aucune
- Aucune information d'authentification n'est requise.
- protocole d"autorisation OAuth
- Spécifiez le point de terminaison du jeton. Sélectionnez si le secret du client est de type post ou basique. Saisissez l'identifiant et le secret du client.
Note : Le message du client indique que le secret est stocké en tant qu'attribut. Client basic signifie que le secret est stocké dans l'en-tête.
- Jeton Web JSON (JWT)
- Spécifiez la valeur de l'en-tête HTTP, la sous-revendication, la durée de vie maximale du JWT et l'algorithme de signature. Si vous le souhaitez, vous pouvez également spécifier un préfixe de valeur d'en-tête JWT, des clés d'en-tête JWT et des noms de revendications.
- TLS mutuelmTLS
- Spécifiez l'étiquette du certificat MTLS.
- Cliquez sur Enregistrer.
Le fournisseur de SMS est créé, mais désactivé par défaut.
- Testez si votre locataire est connecté à votre fournisseur de SMS, cliquez sur Tester la connexion.
Vous pouvez envoyer une charge utile de test à votre fournisseur de SMS pour tester la connexion.
- Après un test de connexion réussi et lorsque vous êtes prêt à utiliser votre fournisseur de SMS externe, cliquez sur la case à cocher Configuration pour l'activer.
- Facultatif : pour vérifier l'état de votre fournisseur SMS, cliquez sur Afficher les statistiques de santé.
L'état de santé fournit un résumé de la connexion et un historique de la connexion ainsi que des statistiques pour l' URL du fournisseur de SMS