Génération de blocs d'un connecteur

Connecteurs

Les connecteurs définissent des opérations qui peuvent être exécutées par Okta Workflows dans des applications tierces ou par Okta lui-même. Un connecteur peut avoir des événements ou des actions, ou les deux, qui contiennent jusqu'à quatre composants principaux :

  • Connexions

  • Paramètres (options dans l'interface de la carte)

  • Entrées

  • Sorties

Pour obtenir une liste complète des connecteurs disponibles dans Workflows, consultez Connecteurs.

Cartes

Les cartes (ou « méthodes ») sont les principaux composants de tout connecteur. Les cartes peuvent être des événements ou des actions. Par exemple, SalesForce (le connecteur) possède des méthodes pour Nouvel enregistrement (un événement) et Transférer des leads (une action).

Authentification

Pour tester ou exécuter un flux, un utilisateur doit créer une connexion au service tiers d'un connecteur pour toute nouvelle carte ajoutée au concepteur Workflows. Le processus de création d'une connexion dépend de l'application et du type d'authentification requis par le service. Les utilisateurs peuvent créer plusieurs connexions au même service.

Basic

L'authentification Basic est un schéma simple composé d'un nom d'utilisateur et d'un mot de passe intégré au protocole HTTP. Workflows envoie des requêtes HTTP avec l'en-tête Autorisation contenant le mot Basic suivi d'un espace et d'une chaîne encodée en base64 username:password.

OAuth 2.0

OAuth 2.0 est un protocole qui vous permet d'accorder un accès limité aux ressources d'un site tiers sans devoir exposer vos identifiants à Workflows.

Personnalisé

L'authentification personnalisée vous permet de recueillir auprès de l'utilisateur toute information qui doit être incluse dans une requête d'API. Un exemple courant est l'utilisation de clés d'API qui sont gérées dans un système tiers et sont transmises dans une requête HTTP avec d'autres clés et valeurs d'objet d'en-tête.

Options

Les options sont des valeurs sélectionnées au moment de la conception (par opposition à leur modification au moment de l'exécution) qui sont incluses dans chaque appel au service, indépendamment de la modification des entrées.

Options statiques

Les options statiques sont des champs qui acceptent une entrée du concepteur de flux au moment de la conception. Il peut s'agir de valeurs textuelles, numériques ou booléennes de base, de champs déroulants, etc., dont le remplissage ne nécessite pas d'appel distinct au service.

Entrées

Entrées statiques

Les entrées statiques sont définies par le développeur et sont « codées en dur » dans la définition du connecteur. Ces champs peuvent être marqués comme obligatoires, ce qui les affichera en rouge et empêchera l'utilisateur d'enregistrer un flux tant qu'ils ne sont pas remplis.

Types de données

Les types de données sur les cartes d'entrée sont indiqués par une petite icône en haut à droite du champ. En cliquant sur cette icône, le type de données s'affiche sous forme de texte. Les types de données disponibles sont les suivants : Texte, Nombre, True/False, Date et heure, Objet et Fichier. Ceci s'applique également aux sorties.

Personnalisation

Pour modifier la chaîne Nom d'affichage ou pour ajouter ou modifier du texte dans le champ Texte d'aide, cliquez sur le lien Personnaliser dans la liste déroulante du type de données d'un champ. Vous pouvez également effectuer la même modification pour n'importe quel champ de résultat.

Texte d'aide

Le développeur peut ajouter du texte d'aide, mais il n'a pas été régulièrement utilisé dans la plateforme. Lorsque du texte d'aide est ajouté, un indicateur d'aide s'affiche à gauche de la saisie. En survolant cet indicateur, le message s'affiche. Ceci s'applique également aux sorties.

Sorties

Sorties statiques

Les sorties statiques sont définies par le développeur et sont « codées en dur » dans la définition du connecteur. Les valeurs renvoyées peuvent être utilisées lors de l'interaction avec les fonctions ou actions suivantes.

Champs dynamiques

Les champs dynamiques renvoient des valeurs différentes en fonction du compte utilisé lors de la création de la connexion. Ces fonctions sont souvent utilisées lorsque les utilisateurs finaux d'une application peuvent ajouter leurs propres types d'enregistrement ou leurs champs. Ils sont différents et beaucoup plus flexibles que les champs statiques, étant donné qu'ils ne sont pas liés à la définition d'un connecteur et qu'ils varieront en fonction des ensembles de données personnalisés propres à un compte de service tiers. Dans l'exemple de SalesForce, les types d'enregistrement peuvent être définis par instance et différer par compte.