Générer une authentification personnalisée

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 d'une clé API qui est gérée dans un système tiers. Elle est transmise dans une requête HTTP, avec d'autres clés et valeurs d'objet d'en-tête. Vous pouvez générer ces paires clé-valeur à l'aide de la section des champs de paramètres facultatifs.

Pour ajouter une authentification personnalisée :

Cliquez sur l'onglet Vue d'ensemble.
Cliquez sur Configurer l'authentification si aucune méthode authentification n'existe. Sinon, cliquez sur Ajouter une authentification.
Dans la boîte de dialogue Authentification, saisissez un nom d'affichage et sélectionnez Custom dans la liste déroulante Type d'authentification.
Ajoutez les champs obligatoires pour votre authentification personnalisée.

Champ Définition

Champ	Définition
Paramètres (facultatif)	Les paramètres vous permettent de recueillir auprès de l'utilisateur du connecteur des informations supplémentaires qui peuvent s'avérer nécessaires à l'authentification, comme leur instance ou leur sous-domaine. Ces champs sont présentés à l'utilisateur lorsqu'il crée une connexion pour la première fois. Ils sont obligatoires. Étiquette : le nom du paramètre qui s'affiche dans la boîte de dialogue Nouvelle connexion lors de la configuration du connecteur. Clé : valeur textuelle dans la paire clé-valeur qui est utilisée par le service. Par exemple, `api_key`, `application_key`ou `authentication`. Type : vous pouvez sélectionner trois types de champ différents : `Text` : affichez un champ en texte brut à l'utilisateur. Il s'agit d'un champ de texte ouvert, sans édition. `Password` : affichez un champ de texte expurgé. L'utilisateur ne peut pas voir le texte qui a été saisi dans ce champ. `Dropdown List` : affichez une liste déroulante de valeurs créée manuellement que l'utilisateur peut sélectionner.
Valeurs de configuration (facultatif)	D'autres valeurs de configuration peuvent être nécessaires pour définir la manière dont un utilisateur s'authentifie auprès de votre connecteur. Cliquez sur Ajouter une valeur de configuration. Étiquette : le nom affiché pour la valeur de configuration dans la boîte de dialogue Nouvelle connexion lors de la configuration du connecteur. Définition : indiquez si ce champ sera rempli avec une valeur statique ou une valeur provenant d'un flux d'aide. Pour `Static Value`, saisissez la valeur dans le champ Valeur. Pour `Value from Helper Flow`, sélectionnez un flux dans la boîte de dialogue Choisir le flux. Type : vous pouvez sélectionner deux types de champ différents : `Text` : affichez un champ en texte brut à l'utilisateur. Il s'agit d'un champ de texte ouvert, sans édition. `Password` : affichez un champ de texte expurgé. L'utilisateur ne peut pas voir le texte qui a été saisi dans ce champ. Le bouton à bascule Visible détermine si la valeur de configuration apparaîtra dans la boîte de dialogue d'authentification du connecteur.

Paramètres (facultatif)

Les paramètres vous permettent de recueillir auprès de l'utilisateur du connecteur des informations supplémentaires qui peuvent s'avérer nécessaires à l'authentification, comme leur instance ou leur sous-domaine. Ces champs sont présentés à l'utilisateur lorsqu'il crée une connexion pour la première fois. Ils sont obligatoires.

Étiquette : le nom du paramètre qui s'affiche dans la boîte de dialogue Nouvelle connexion lors de la configuration du connecteur.

Clé : valeur textuelle dans la paire clé-valeur qui est utilisée par le service. Par exemple, api_key, application_keyou authentication.

Type : vous pouvez sélectionner trois types de champ différents :

Text : affichez un champ en texte brut à l'utilisateur. Il s'agit d'un champ de texte ouvert, sans édition.
Password : affichez un champ de texte expurgé. L'utilisateur ne peut pas voir le texte qui a été saisi dans ce champ.
Dropdown List : affichez une liste déroulante de valeurs créée manuellement que l'utilisateur peut sélectionner.

Valeurs de configuration (facultatif)

D'autres valeurs de configuration peuvent être nécessaires pour définir la manière dont un utilisateur s'authentifie auprès de votre connecteur. Cliquez sur Ajouter une valeur de configuration.

Étiquette : le nom affiché pour la valeur de configuration dans la boîte de dialogue Nouvelle connexion lors de la configuration du connecteur.

Définition : indiquez si ce champ sera rempli avec une valeur statique ou une valeur provenant d'un flux d'aide.

Pour Static Value, saisissez la valeur dans le champ Valeur.
Pour Value from Helper Flow, sélectionnez un flux dans la boîte de dialogue Choisir le flux.

Type : vous pouvez sélectionner deux types de champ différents :

Text : affichez un champ en texte brut à l'utilisateur. Il s'agit d'un champ de texte ouvert, sans édition.
Password : affichez un champ de texte expurgé. L'utilisateur ne peut pas voir le texte qui a été saisi dans ce champ.

Le bouton à bascule Visible détermine si la valeur de configuration apparaîtra dans la boîte de dialogue d'authentification du connecteur.

Étapes suivantes

Après avoir créé cette méthode d'authentification, vous devez créer un flux httpHelper pour gérer les appels via cette méthode d'authentification. Consultez Générer un flux httpHelper.

Ajouter des champs d'option aux cartes du connecteur