Configurer Okta Workflows pour un opérateur téléphonique externe

ATTENTION :

Ce cas d'utilisation Workflows Okta tombe dans la zone jaune comme décrit dans les Limites système de Workflows. Il requiert une attention particulière à l'architecture et aux bonnes pratiques, car il comporte un risque plus élevé de se heurter aux limites du système ou d'autres mises en garde.

Utilisez l'API Okta à la place. Consultez la documentation destinée aux développeurs Référentiels concernant les crochet incorporés de téléphonie.

Cette tâche explique comment créer un flux dans Workflows Okta pour envoyer le code d'accès à usage unique (OTP) à vos utilisateurs finaux via l'opérateur téléphonique de votre choix. Le flux ressemble à ceci :

Avant de commencer

Consultez la documentation Téléphonie pour comprendre les exigences réglementaires, la fraude téléphonique et les considérations techniques.
Configurez Workflows Okta.
- Configurez une connexion depuis l'org Okta. Consultez Autoriser le connecteur Okta.
- Configurez une connexion pour le connecteur API. Consultez S'authentifier à l'aide de cartes Connecteur API.
Configurez l'opérateur téléphonique de votre choix. Prenez note des informations suivantes :
- Compte SID
- Jeton d'authentification
- Numéro de téléphone
- URL du message SMS pour envoyer des requêtes POST. Par exemple, l'URL Twilio est la suivante :
  https://api.twilio.com/2010-04-01/Accounts/{yourtwilioaccountid}/Messages.json
  
  Dans cet exemple, {yourtwilioaccountid} est l'identifiant de votre compte Twilio.

Créer un flux

Dans l'Admin Console, accédez à Workflow > Console des workflows.
Dans la Workflows Console, cliquez sur Flux > Nouveau flux.

Créer la carte d'événement du point de terminaison de l'API

Cliquez sur Ajouter un événement. Recherchez et sélectionnez l'application Okta pour le point de terminaison de l'API.
Dans la fenêtre Paramètres du point de terminaison de l'API, définissez le Niveau de sécurité sur Sécurisé avec le jeton client.
Laissez le champ Jeton client vide, puis cliquez sur Fermer.
Dans la section Corps, créez les champs suivants. Cliquez sur le menu déroulant du champ pour modifier son type.

Champ	Type
données	Objet
> userProfile	Objet
> > userId	Texte
> messageProfile	Objet
> > msgTemplate	Texte
> > phoneNumber	Texte
> > otp	Texte

Créer une carte de fonction Composer

Cliquez sur Ajouter une fonction. Recherchez et sélectionnez la carte de fonction Composer.
Dans la carte, saisissez le texte suivant : To=phoneNumber&From={yourphonenumber}&Body=msgTemplate
Pour mapper les champs phoneNumber et msgTemplate, faites glisser et déposez ces champs depuis la carte d'événement Point de terminaison de l'API.
Remplacez {yourphonenumber} par votre numéro de téléphone, y compris l'indicatif du pays. Il s'agit du numéro que votre opérateur téléphonique vous a affecté.

Créer une carte de fonction Construire

Cliquez sur Ajouter une fonction. Recherchez et ajoutez la carte de fonction Construction d'objet.
Dans la carte, ajoutez les champs de texte de saisie suivants : Accepter et Content-Type.
Saisissez ces valeurs dans les champs :
- Accepter : application/json
- Content-Type: application/x-www-form-urlencoded

Créer une carte de fonction En cas d'erreur

Cliquez sur Ajouter une fonction. Recherchez et sélectionnez la carte de fonction En cas d'erreur.
Assurez-vous que la carte de fonction En cas d'erreur est en mode Essayer.

À l'intérieur de cette carte, créez les cartes suivantes.

Créer une carte Connecteur API

Dans le menu + , cliquez sur l'icône de nuage. Recherchez et sélectionnez la carte Connecteur API.
Sélectionnez le type Publier.
Dans la carte Publier, saisissez l'URL du SMS pour votre opérateur téléphonique.
Faites glisser le champ Sortie de la carte de fonction Construire vers le champ Demande > En-têtes.
Faites glisser le champ Sortie de la carte de fonction Composer vers le champ Demande > Corps.
Dans le champ Demande > Corps, créez le champ de texte sid.

Créer une carte de fonction Composer pour réussir

À côté de la carte Publier, dans le menu +, cliquez sur l'icône de la calculatrice. Recherchez et sélectionnez la carte de fonction Composer.

Dans la carte, saisissez le code suivant :

{
 "commands":[
   {
     "type":"com.okta.telephony.action",
     "value":[
       {
         "status":"SUCCESSFUL",
         "provider":"<YOURPROVIDER>",
         "transactionId":"sid"
       }
     ]
   }
 ]
}

Remplacez <YOURPROVIDER> par le nom de votre opérateur téléphonique, par exemple Twilio.
Faites glisser le champ sid depuis la carte Publier.
Cliquez sur le menu déroulant du champ Sortie et renommez-le Success.
Cliquez sur Afficher sorties pour la carte En cas d'erreur.
Créez un champ d'objet de sortie appelé Response.
Dans ce champ Réponse, faites glisser et déposez le champ Réussite depuis la carte Composer.

Ajouter des champs d'erreur

Dans la carte En cas d'erreur, basculez le mode Essai vers le mode En cas d'erreur.
Dans la sortie Erreur, créez les champs suivants. Cliquez sur le menu déroulant du champ pour modifier son type.

Champ	Type
body	Objet
> code	Texte
> status	Texte
> message	Texte

Créer une carte de fonction Composer pour l'erreur

À côté des champs de résultat Erreur, dans le menu +, cliquez sur l'icône de la calculatrice. Recherchez et sélectionnez la carte de fonction Composer.

Dans la carte, saisissez le code suivant :

{
  "error":{
    "errorSummary":"Failed to deliver SMS to phoneNumber",
    "errorCauses":[
      {
        "errorSummary":"Couldn't deliver OTP",
        "reason":"message"
      }
    ]
  }
}

Faites glisser le champ phoneNumber depuis la carte d'événement Point de terminaison de l'API.
Faites glisser le champ message de la sortie Erreur.
Cliquez sur le menu déroulant du champ Sortie et renommez-le Error.
Faites glisser et déposez le champ Erreur sous la section Réponse de la carte En cas d'erreur.

La carte dans le mode En cas d'erreur ressemble à ceci :

La carte de fonction En cas d'erreur est maintenant terminée.

Créer une carte Retour brut

Dans le flux, cliquez sur Ajouter une fonction. Recherchez et sélectionnez la carte de fonction Retour brut.
Faites glisser et déposez le champ Sortie de la carte Construction vers le champ En-têtes.
Faites glisser et déposez le champ Réponse de la carte En cas d'erreur vers le champ Corps.
Enregistrez le flux et activez-le.

Copier les informations pour le crochet incorporé de téléphonie

Accédez à la carte d'événement Point de terminaison API, puis cliquez sur l'icône </> pour ouvrir les paramètres Point de terminaison API.
Dans la boîte de dialogue des paramètres, copiez les informations suivantes : Invoquer URL, Aliaset Jeton client. Vous aurez besoin de ces informations lors de la prochaine étape de la création d'un crochet incorporé de téléphonie.

Étape suivante

Se connecter à un prestataire de services téléphoniques externe