Générer un flux de révocation

Un flux de révocation est un flux système qui permet à un générateur de révoquer un jeton OAuth 2.0 (ou toute autre authentification basée sur les jetons).

La méthode revoke d'un connecteur est invoquée lorsqu'une connexion est supprimée de la plateforme ou lorsqu'un utilisateur demande la suppression de ses données. Cela peut être nécessaire, par exemple, pour se conformer à la réglementation générale sur la protection des données.

Les flux de révocation ne sont pas affichés à l'utilisateur final et sont exclusivement utilisés par la plateforme. Le flux de révocation n'a pas de champs d'options ou de saisie.

Commencer cette tâche

1. Sous l'onglet Flux, créez un flux en cliquant sur + Nouveau flux dans le coin supérieur droit de la page.

2. À l'extrême gauche de la page, cliquez sur Révoquer.

3. Cliquez sur le bouton Enregistrer dans la barre d'outils et nommez le flux.

4. Dans le champ de description du flux , saisissez Revoke an access token from the {your service} service. Sélectionnez l'option Enregistrer toutes les données qui passent par le flux, et cliquez sur Enregistrer.

5. Ajoutez une carte Gestion des erreurs en cas d'erreur comme première carte dans le flux.

6. Ajoutez la carte de contrôle de flux Flux d'appel dans la section Essai de la carte.

7. Cliquez sur le bouton Choisir le flux et sélectionnez le flux httpHelper que vous avez créé précédemment. La carte se remplit automatiquement avec les entrées définies dans le flux httpHelper.

8. Saisissez l'URL liée du point de terminaison de révocation.

9. Saisissez la méthode de requête. Il s'agit très probablement d'une opération POST.

10. Faites glisser l'objet auth de la carte connecteur authping vers le champ de saisie Connexion de la carte Flux d'appel.

11. Saisissez toute information supplémentaire requise pour l'appel dans le champ requête, en-têtes ou corps. Vous devrez peut-être ajouter une carte Construction d'objets avant la carte Flux d'appel pour générer les objets nécessaires.

12. Pour les sorties de la carte Flux d'aide, définissez les mêmes clés que pour les sorties du flux httpHelper :

    • status_code, Number

    • headers, Object

      body, Object

13. Ajoutez une carte Affecter un contrôle de flux à droite de la carte Flux d'appel qui se trouve à l'intérieur de la fonction Si erreur. Cliquez sur Cliquer ou déposer ici pour créer et nommez le champ message.

14. Ajoutez manuellement un message de réussite dans le nouveau champ. Par exemple, The access token was successfully revoked.

15. Cliquez sur le lien Afficher les sorties en haut à droite de la carte Si erreur pour développer la section des sorties de la carte.

16. Dans la section des sorties, cliquez sur Cliquer ou faire glisser pour créer et saisissez status_code. Deux entrées affichent le message Faire glisser la sortie ici.

17. Faites glisser le champ de résultat status_code de la carte Flux d'appel en haut des deux entrées sous le champ status_code.

18. Dans la section des sorties, cliquez sur Cliquer ou faire glisser pour créer et saisissez message.

19. Faites glisser le champ de résultat message de la carte Affecter en haut des deux entrées sous le champ message.

20. Sélectionnez le menu déroulant en haut de la carte Si erreur et sélectionnez Si erreur. C'est ici qu'il est possible de gérer les erreurs propres au service.

21. En fonction du service, vous pouvez avoir besoin de clés supplémentaires pour l'objet Erreur dans le panneau de gauche de la carte Si erreur pour extraire le code de statut et les messages d'erreur de l'objet renvoyé par le service. Pour ajouter des clés, cliquez sur Saisir le nom de la clé.

22. Faites glisser ces nouvelles clés dans les sorties correspondantes de la carte Si erreur.

23. Ajoutez une carte de branche Affecter si à droite de la carte de fonction Si erreur.

24. Faites glisser le champ status_code des sorties de la carte Si erreur dans le champ value a de la carte Affecter si. Assurez-vous que la comparaison est définie sur equal to.

25. Dans le champ value b, saisissez le code de statut d'une requête réussie. En général, cette valeur est 200.

26. Modifiez le type de données du champ valeur si true à True/False et définissez la valeur sur True.

27. Modifiez le type de données du champvaleur si false à True/False et définissez la valeur sur False.

28. Modifiez le type de données du champ de sortie en True/False, ainsi que le nom du champ en revoked.

29. Faites glisser le champ révoqué depuis la carte Affecter si vers le champ de saisie révoquéde la carte Renvoyer.

30. Ajoutez une carte Construction à la fin du flux.

31. Cliquez sur Cliquer ou déposer ici pour créer et ajouter une étiquette nommée unregisterURL.

32. Saisissez l'URL où peut se rendre l'utilisateur pour supprimer manuellement l'accès au service. Par exemple, https://www.spotify.com/us/account/apps/.

33. Cliquez sur Cliquer ou déposer ici pour créer et ajouter une étiquette nommée text. Il s'agit du texte apparaissant à l'utilisateur final si la révocation du jeton échoue pour quelque raison que ce soit. Saisissez un message dans ce champ. Par exemple, Unable to completely revoke access to Spotify. Visit your account page to manually remove access.

34. Renommez la sortie de cette carte Construire en message, puis faites-la glisser vers le champ d'entrée message sur la carte Renvoyer.

35. Ajoutez une carte Construction.

36. Cliquez sur Cliquer ou déposer ici pour créer et ajouter une étiquette nommée statusCode.

37. Faites glisser le champ status_code des sorties de la carte Si erreur vers le nouveau champ statusCode de la carte Construire.

38. Ajoutez un autre champ d'entrée à la carte Construire et nommez-le body.

39. Faites glisser le champ de sortie message depuis les sorties de la carte Si erreur vers le champ body de la carte Construire.

40. Sur la carte d'objet Construire, renommez le champ de sortie serviceResponse.

41. Faites glisser le champ de résultat serviceResponse depuis la carte Construire vers le champ serviceResponse de la carte Renvoyer.

67. Cliquez sur Enregistrer et Exécuter.

Étapes suivantes

Tester vos flux

Consulter l'historique des exécutions

Déployer vos flux