Personnalisation des fournisseurs de services de messagerie électronique et de SMS
Vous pouvez personnaliser l'expéditeur des e-mails et le fournisseur de SMS pour les IBM® Verify messages de notification.
Avant de commencer
Si vous souhaitez intégrer votre propre fournisseur de SMS pour les notifications OTP d' IBM Verify, vous devez configurer un point de terminaison webhook externe capable d'accepter les requêtes POST provenant de IBM Verify. Si vous souhaitez également personnaliser l'adresse de l'expéditeur afin que les notifications semblent provenir de votre propre domaine, vous devez faire authentifier votre domaine de messagerie.
Pour authentifier votre domaine de messagerie, utilisez les Email Domain Authentication API. Pour plus d'informations sur les API, consultez la section « Authentification des domaines de messagerie ».
- Enregistrez votre domaine de messagerie. https://{tenanturl}/config/v1.0/email-domain-authExemple
curl --request POST \ --url https://tenant_url/config/v1.0/email-domain-auth \ --header 'accept: application/json' \ --header 'content-type: application/json' - Récupérez les enregistrements DNS de votre domaine de messagerie. https://{tenanturl}/config/v1.0/email-domain-auth/{domain}Exemple
curl --request GET \ --url https://tenant_url/config/v1.0/email-domain-auth/domain \ --header 'accept: application/json' - Vérifiez le statut de votre domaine de messagerie. https://{tenanturl}/config/v1.0/email-domain-auth/{domain}/verifyExemple
curl --request POST \ --url https://tenant_url/config/v1.0/email-domain-auth/domain/verify \ --header 'accept: application/json' - Pour modifier ou mettre à jour votre domaine de messagerie personnalisé, vous devez d'abord supprimer le domaine existant dans les paramètres de notification, puis enregistrer le nouveau.
Supprimez votre domaine d'authentification de messagerie. https://{tenanturl}/config/v1.0/email-domain-auth/{domain}
Exemplecurl --request DELETE \ --url https://tenant_url/config/v1.0/email-domain-auth/domain \ --header 'accept: application/json'
- Le fournisseur de SMS externe doit mettre à disposition un point de terminaison webhook POST de type HTTP afin de recevoir les demandes de notification d'OTP provenant de IBM Verify.
- Le point de terminaison doit immédiatement mettre les requêtes en file d'attente et renvoyer une réponse « HTTP ».
{
"destinationPhoneNumber": "18005551212",
"content": "Your passcode is 6439-123456. It expires in 5 minutes.",
"category": "OTP",
"language": "en-US",
"otp": "123456",
"correlation": "6439",
"expiry": 5
}destinationPhoneNumber- Le numéro de téléphone du destinataire au format « E.164 ».
content- Le texte complet du SMS tel qu'il s'affiche à l'écran.
category- mot de passe à utilisation unique
language- Le code de langue ou de paramètres régionaux, par exemple en-US.
otp- La valeur du code d'accès à usage unique.
correlation- L'identifiant permettant d'associer l'OTP à un processus de vérification; il figure généralement dans le message.
expiry- La durée de validité en minutes.
- 202 Accepté
- La demande a été mise en file d'attente avec succès.
- 400 Demande incorrecte
- Format de la charge utile non valide.
- 500 Erreur de serveur interne
- Le fournisseur n'a pas pu traiter la demande.
{
"status": "accepted",
"statusMessage": "Message accepted by provider"
}{
"status": "failed",
"statusMessage": "The destination phone number is invalid."
}A propos de cette tâche
IBM est le service de messagerie électronique et le fournisseur de SMS par défaut pour Verify.
Procédure
- Pour modifier l'expéditeur de l'e-mail, cliquez sur
l'icône située sur la vignette « E-mail ». - Si votre locataire utilise les services SMS d' IBM et que vous souhaitez modifier l'identifiant de l'expéditeur des SMS, cliquez sur l'icône située sur la vignette du fournisseur de SMS.Vous pouvez modifier cet attribut pour l'adapter à votre entreprise ou à votre organisation.