Configurer les fournisseurs de téléphonie via l'Admin Console

Envoyez un code d'accès à usage unique (OTP) à vos utilisateurs en connectant un fournisseur de téléphonie externe dans l'Admin Console. Cette section vous explique comment ajouter et gérer des fournisseurs de services de téléphonie via l'Admin Console.

Fonctionnement

Vous pouvez configurer Twilio ou Telesign ou les deux comme fournisseurs de services de téléphonie. Lorsqu'ils sont configurés via l'Admin Console, Okta gère la communication entre votre org et votre fournisseur de téléphonie. Pour personnaliser vos fournisseurs de téléphonie, rendez-vous sur votre fournisseur de services de téléphonie et ajustez les différents paramètres.

Si d'autres méthodes de téléphonie sont actives, comme l'utilisation de l'appel incorporé de téléphonie, vous devez désactiver ces autres méthodes avant de pouvoir activer un fournisseur de téléphonie externe.

Vous pouvez configurer jusqu'à deux fournisseurs de téléphonie dans Admin Console et en désigner un comme fournisseur principal et l'autre comme fournisseur secondaire. Si votre fournisseur principal subit une panne ou une interruption de service, Okta achemine automatiquement les codes d'accès à usage unique (OTP) vers votre fournisseur secondaire afin d'assurer un service d'authentification continu.

Important :

Okta ne bascule pas automatiquement vers la téléphonie gérée par Okta si votre fournisseur de téléphonie subit une panne. Pour éviter les interruptions d'authentification ou les blocages pendant les interruptions de service, configurez et activez un fournisseur principal et un fournisseur secondaire (pour le basculement), ou assurez-vous qu'une autre authentification est accessible à vos utilisateurs.

Avant de commencer

Choisissez Twilio ou Telesign comme fournisseur de services de téléphonie. Créez ensuite un compte avec eux et configurez vos paramètres de téléphonie.

Collectez les informations suivantes auprès de votre fournisseur :

ID de chaîne de compte (SID)

Pour Telesign, le SID est votre ID client.
Jeton d'authentification
Un numéro de téléphone qui vous appartient. Utilisez le numéro de téléphone pour envoyer des SMS et effectuer des appels vocaux.

Ajouter un fournisseur de téléphonie

Remarque :

Sélectionnez le fournisseur de téléphonie que vous souhaitez activer, puis cliquez sur Actions > Activer. Reportez-vous à la documentation de votre fournisseur lorsque vous sélectionnez les différentes options SMS et Appel vocal.

Dans l'Admin Console, accédez à Personnalisations > Fournisseurs de téléphonie.
À côté du fournisseur que vous souhaitez ajouter, cliquez sur Ajouter.
Configurez les options suivantes, puis cliquez sur Enregistrer.

Champ	Description
Compte SID	Saisissez l'identifiant unique du compte de votre fournisseur de téléphonie.
Jeton d'authentification	Saisissez le jeton d'authentification utilisé pour authentifier les demandes adressées au fournisseur de téléphonie. Telesign désigne le jeton d'authentification sous le nom de clé d'API.
SMS	En fonction du fournisseur téléphonique que vous configurez, vous pouvez choisir entre deux ou trois options pour l'envoi de SMS à vos utilisateurs. Pour Twilio, vous avez trois options. Twilio Verify SID : utilise l'API Verify de Twilio. Veillez à configurer votre service Twilio Verify de manière à ce qu'il accepte un code OTP personnalisé, afin qu'il puisse valider le code généré par Okta. Numéro de téléphone Twilio : utilise l'API Programmable Messaging de Twilio. Twilio Message SID : utilise l'API Programmable Messaging de Twilio. Pour Telesign, vous avez deux options : Telesign Verify Service : utilise les API Verify de Telesign. Telesign Messaging Service : utilise les API SMS et Messaging de Telesign. Vous devez configurer les paramètres de votre fournisseur de téléphonie, puis sélectionnez l'option SMS correspondante. Consultez la documentation de votre fournisseur de téléphonie.
Numéro de téléphone ou SID	Saisissez un numéro de téléphone dont vous disposez pour envoyer des SMS. Vous pouvez obtenir des numéros de téléphone auprès de votre fournisseur de téléphonie afin de les utiliser pour l'envoi de SMS.
Voix	En fonction du fournisseur téléphonique que vous configurez, vous pouvez choisir entre deux ou trois options pour déterminer comment vous souhaitez acheminer les appels vocaux vers vos utilisateurs. Pour Twilio, vous avez trois options. Twilio Verify SID : utilise l'API Verify de Twilio. Veillez à configurer votre service Twilio Verify de manière à ce qu'il accepte un code OTP personnalisé, afin qu'il puisse valider le code généré par Okta. Numéro de téléphone Twilio : utilise l'API Programmable Voice de Twilio. Twilio Caller ID : utilise l'API Programmable Voice de Twilio. Pour Telesign, vous avez deux options : Telesign Verify Service : utilise les API Verify de Telesign. Telesign Voice Service : utilise l'API Voice de Telesign. Vous devez configurer les paramètres de votre fournisseur de téléphonie puis sélectionner l'option SMS qui lui correspond. Consultez la documentation de votre fournisseur de téléphonie.
Numéro de téléphone, SID ou ID de l'appelant	Saisissez un numéro de téléphone qui vous appartient pour les appels vocaux. Vous pouvez obtenir des numéros de téléphone auprès de votre fournisseur de téléphonie afin de les utiliser pour les appels vocaux.

Rappels d'état

Lorsque vous utilisez un fournisseur téléphonique personnalisé, Okta reçoit de ce dernier des mises à jour concernant l'état de livraison et les consigne dans le journal système. Vous pouvez utiliser ces événements pour vérifier si les SMS et les appels vocaux parviennent bien à vos utilisateurs. Consultez Afficher ou consulter les SMS ou les événements liés aux appels vocaux.

Okta enregistre les événements suivants lorsqu'il reçoit une mise à jour de l'état de livraison de la part de votre fournisseur téléphonique personnalisé :

system.sms.receive_status : enregistré lorsque Okta reçoit une mise à jour de l'état d'un SMS.
system.voice.receive_status : enregistré lorsque Okta reçoit une mise à jour de l'état d'un appel vocal.

Okta enregistre un événement d'état de réception pour les SMS et les messages vocaux réels envoyés via votre fournisseur téléphonique personnalisé (p. ex., MFA, challenges, enrôlement, remise en état de compte et déverrouillage). Les messages et appels de test envoyés à partir de la fonctionnalité Envoyer un message ou passer un appel de test ne génèrent pas d'événement d'état de réception. Si Okta ne parvient pas à vérifier un rappel d'état (p. ex., en raison d'une incompatibilité des identifiants), il ignore ce rappel sans l'enregistrer. Cela diffère des échecs de livraison de messages classiques, qu'Okta consigne toujours avec un état d'échec.

Okta insère automatiquement les URL de rappel requises lors de l'envoi de messages via les services des fournisseurs suivants. Vous n'avez pas besoin de configurer manuellement ces services :

Messagerie programmable Twilio
Twilio Voice
Messagerie Telesign
Telesign Voice
Telesign Verify

Important :

Si vous utilisez l'option SID Twilio Verify, vous devez configurer manuellement un webhook Événements dans la console Twilio et activer l'envoi d'événements provenant des vérifications effectuées par ce service Twilio Verify vers votre abonnement aux flux d'événements. Cela vous permet de recevoir des notifications par SMS concernant l'état de livraison. Le webhook ne prend en charge que les SMS. Twilio n'émet pas d'événement d'état de livraison pour les appels vocaux Twilio Verify.

Configurer les webhooks Twilio Verify

Si vous utilisez Twilio Verify pour les SMS, vous devez configurer un webhook Événements dans la console Twilio pour renvoyer les états de livraison à Okta. Consultez le Guide d'intégration du webhook Événements Twilio Verify.

Lors de la configuration du webhook dans Twilio, veuillez utiliser les paramètres propres à Okta indiqués ci-dessous.

URL du webhook : configurez le webhook pour qu'il dirige vers votre domaine Okta en utilisant le format suivant : https://<your-okta-domain>/api/v1/internal/telephonystatus/customtwilio
Abonnements à des événements : sélectionnez les événements suivants :
- com.twilio.accountsecurity.verify.message.delivered
- com.twilio.accountsecurity.verify.message.undelivered
- com.twilio.accountsecurity.verify.message.failed

Envoyer un message ou un appel de test

Remarque :

Dans l'Admin Console, accédez à Personnalisations > Fournisseurs de téléphonie.
Sélectionnez le fournisseur téléphonique que vous souhaitez tester, puis cliquez sur Envoyer le test.
Dans Tester avec, sélectionnez la méthode de téléphonie que vous souhaitez tester.
Dans Pays, sélectionnez le code pays pour le numéro de téléphone que vous utilisez pour le test.
Dans Numéro de téléphone, saisissez le numéro de téléphone que vous souhaitez utiliser pour le test. Si vous envoyez un test vocal, vous pouvez saisir l'extension du numéro de téléphone que vous utilisez, le cas échéant.
Pour les tests par SMS, cliquez sur Envoyer le test par SMS. Pour les tests d'appels vocaux, cliquez sur Envoyer un test par appel vocal.

Activer un fournisseur de téléphonie

Après avoir configuré votre fournisseur de téléphonie, activez-le afin de l'utiliser pour la téléphonie.

Dans l'Admin Console, accédez à Personnalisations > Fournisseurs de téléphonie.
À côté du fournisseur que vous souhaitez activer, cliquez sur Actions > Activer.

Remarque :
Sélectionnez le fournisseur de téléphonie que vous souhaitez activer, puis cliquez sur Actions > Activer. Reportez-vous à la documentation de votre fournisseur lorsque vous sélectionnez les différentes options SMS et Appel vocal.

Désactiver un fournisseur de téléphonie

Passez en revue les exigences et les limitations suivantes avant de désactiver un fournisseur :

Si vous avez configuré deux fournisseurs de téléphonie et que les deux sont actifs, vous ne pouvez désactiver que le fournisseur secondaire. Vous ne pouvez pas désactiver le fournisseur principal.
Vous ne pouvez pas désactiver un fournisseur de téléphonie si l'authentificateur téléphonique est actif sans qu'un appel incorporé de téléphonie soit actif. Pour désactiver le fournisseur, effectuez d'abord l'une des actions suivantes :
- Supprimez l'authentificateur téléphonique.
- Configurez et activez un appel incorporé de téléphonie.

Dans l'Admin Console, accédez à Personnalisations > Fournisseurs de téléphonie.
Sélectionnez le fournisseur téléphonique que vous souhaitez désactiver, cliquez sur Actions > Désactiver.

Définir le fournisseur de téléphonie principal

Dans l'Admin Console, accédez à Personnalisations > Fournisseurs de téléphonie.
À côté du fournisseur que vous souhaitez définir comme fournisseur principal, cliquez sur Actions > Définir comme principal.

Supprimer un fournisseur de téléphonie

Avant de supprimer un fournisseur de téléphonie, assurez-vous d'être prêt. Configurez un nouveau fournisseur de téléphonie, une nouvelle méthode de téléphonie ou un plan pour ne pas utiliser l'authentificateur par téléphone pour l'authentification. Voir Configurer un fournisseur de téléphonie externe pour connaître les différentes façons de configurer la téléphonie dans votre organisation.

Si vous supprimez complètement la téléphonie en tant qu'option d'authentification ou de récupération, assurez-vous de mettre à jour vos politiques de connexion aux apps.

Si le fournisseur de téléphonie que vous souhaitez supprimer est actif, vous devez le désactiver avant de pouvoir le supprimer.

Dans l'Admin Console, accédez à Personnalisations > Fournisseurs de téléphonie.
À côté du fournisseur que vous souhaitez supprimer, cliquez sur Actions > Supprimer.
Examinez l'avertissement de la case à cocher, puis vérifiez-le.
Cliquez sur Supprimer.

Modifier un fournisseur de téléphonie

Dans l'Admin Console, accédez à Personnalisations > Fournisseurs de téléphonie.
À côté du fournisseur que vous souhaitez modifier, cliquez sur Actions > Modifier.
Effectuez les modifications nécessaires aux paramètres du fournisseur de téléphonie.
Cliquez sur Enregistrer.

Dépannage des identifiants du fournisseur

Si les événements d'état ne s'affichent pas dans le journal système, il se peut que les identifiants de votre fournisseur ne soient pas validés.

Telesign : si votre compte possède plusieurs clés API, Telesign utilise celle dont la date d'expiration est la plus récente pour authentifier les rappels. Une clé sans date d'expiration est considérée comme la clé la plus récente. Si plus d'une clé n'a pas de date d'expiration, Telesign sélectionne la clé de manière imprévisible. Assurez-vous que la clé saisie dans Okta correspond à la clé active dans Telesign. Sinon, Okta ne peut pas vérifier le rappel, et les événements relatifs à l'état de la livraison ne s'affichent pas.
Twilio : vous devez utiliser le SID du compte et le jeton d'authentification. N'utilisez pas les clés API Twilio. Twilio utilise toujours le jeton d'authentification principal du compte pour authentifier les rappels, et non une paire clé API et secret.