Avec le connecteur HTTP Request, vous pouvez utiliser les commandes dans une chaîne pour effectuer des requêtes de protocole de transfert hypertexte (HTTP) GET, POST, PUT, et DELETE à une URL donnée. Par exemple, vous pouvez utiliser ce connecteur dans une chaîne pour connecter et automatiser d'autres solutions via leurs connecteurs respectifs.
Pour voir comment une requête HTTP est structurée, consultez notre liste d'exemples HTTP Connector.
Note : Bien qu’il s’agisse d’une requête HTTP, le protocole HTTPS (Secure HTTP) est pris en charge (et recommandé).
Exigences
- Bien que la connexion n'ait pas de caractéristiques spécifiques à OData, vous pouvez ajouter tous les composants nécessaires à la requête via les paramètres Headers ou Query string.
- Pour que le connecteur puisse être utilisé dans les chaînes de votre organisation, un administrateur de sécurité de org doit d'abord l'activer.
Mise en place du connecteur HTTP Request
- À partir de Chain Builder, cliquez sur Connections , puis sur Create en haut à droite.
- Sous Connector Connection, sélectionnez HTTP Request et le CloudRunner par défaut.
- Sous Informations de base, entrez un nom et une description uniques pour aider à identifier le connecteur.
- Sélectionnez les environnements qui utiliseront la connexion et cliquez sur Enregistrer.
- Pour tester la connexion, créez et exécutez une chaîne avec la commande GET du connecteur et vérifiez qu'elle renvoie une sortie valide.
Gérer les informations d'identification pour les requêtes HTTP sécurisées
Pour sécuriser les requêtes HTTP du connecteur, vous pouvez configurer ses commandes avec :
- Authentification de base par nom d'utilisateur et mot de passe
-
Certificats codés PEM (Privacy-Enhanced Mail), par exemple pour l’authentification mutuelle mTLS (Transport Layer Security).
Note : Workiva ne pas génère des certificats pour les requêtes HTTP. Pour utiliser des certificats codés PEM, il faut fournir la paire de clés publique/privée à envoyer avec les demandes et un certificat d'autorité de certification (CA) facultatif.
Pour configurer une commande avec des informations d'identification :
- Dans Chain Builder, téléchargez les certificats en tant que ressources de l'espace de travail.
- Lorsque vous configurez la commande du connecteur, sélectionnez les certificats comme propriétés :
- Pour l'authentification de base, entrez ou sélectionnez les informations d'identification dans Nom d'utilisateur et Mot de passe.
- Pour la paire de clés publiques/privées, sélectionnez leurs ressources dans Certificate et Certificate private key, respectivement.
- Pour un certificat CA optionnel, sélectionnez sa ressource dans CA certificate.
Dépannage
- Si une erreur est renvoyée, vérifiez l'URL source et la structure de votre demande. Notre article HTTP connector examples détaille chaque composant requis.
- Vérifiez que votre chaîne de requête est encodée.