Comment configurer un connecteur

Comprendre les détails de la configuration d'un connecteur dans Tulip.

Dans cet article, vous apprendrez* Comment configurer un connecteur* Ce que signifie chaque entrée dans la modale de configuration

Vue d'ensemble

Les connecteurs permettent des intégrations entre des systèmes externes et des bases de données. Il y a deux types de connecteurs dont nous parlerons dans cet article, HTTP et SQL.

Consultez l'article "Que sont les connecteurs ?", afin de connaître exactement les concepts et les détails qu'un connecteur englobe.

Comment configurer un nouveau connecteur

La configuration d'un nouveau connecteur ne nécessite pas de connaissances approfondies en matière d'API ou de bases de données, mais il est utile de se familiariser avec les types de connexion.

Pour créer un connecteur, accédez à la page Connecteurs sous Apps. Cliquez sur + Créer un connecteur dans le coin supérieur droit. Donnez un nom et une description à votre connecteur, puis choisissez s'il s'agit d'une connexion HTTP ou SQL. N'oubliez pas : un connecteur HTTP s'intègre à un serveur API, tandis qu'un connecteur SQL se connecte à une base de données externe.

Après avoir cliqué sur le bouton Créer dans la fenêtre modale Créer un connecteur, vous accédez à la page d'accueil du connecteur en question.

Vous y verrez une notification rouge indiquant que ce connecteur est actuellement hors ligne.

Pour que le connecteur soit en ligne, vous devez cliquer sur le bouton Production & Test & Développement afin de spécifier le serveur auquel vous souhaitez vous connecter.

Ce qu'il faut savoir avant de commencer

Avant de commencer, il est important de noter que les connecteurs HTTP et SQL ont des paramètres d'authentification pour s'assurer que toute personne faisant une demande à un point de terminaison ou à une base de données a la permission de le faire. Ces mesures sont mises en place pour protéger vos données et garantir un accès sécurisé.

Les sections suivantes vous expliquent comment configurer les connecteurs HTTP et SQL.

HTTP

Un connecteur HTTP communique avec les serveurs API. Les connecteurs HTTP de Tulip s'interfacent avec la plupart des types d'API, y compris REST et SOAP.

Configuration

Pour configurer un connecteur, vous devez avoir à portée de main quelques informations sur le serveur auquel vous essayez de vous connecter. Ces informations sont les suivantes

• L'URL de l'hôte
• L'utilisation ou non d'un TLS par le serveur
• Tout en-tête ou Cert nécessaire à l'authentification

Vous pouvez trouver ces informations dans la documentation de l'API du serveur auquel vous vous connectez. Pour cela, il faut généralement rechercher "[nom du serveur] API documentation".

Voyons maintenant comment procéder à cette configuration :

Configuration Modale

Running On - Effectuer des requêtes pour l'hôte du connecteur. L'hôte du connecteur Cloud est fourni par Tulip et fait des requêtes via Tulip Cloud. Tout hôte de connecteur sur site que vous avez enregistré sur votre compte apparaîtra également.Host - L'adresse réseau, c'est-à-dire un nom d'hôte ou une adresse IP, à laquelle Tulip se connecte.Port - Votre serveur écoute les requêtes sur un port réseau spécifique, que votre fournisseur de serveur vous donne. La valeur par défaut est presque toujours correcte.TLS (Transport Layer Security) - Tulip utilise un TLS pour crypter votre trafic lorsqu'il se connecte au serveur. Si l'url commence par https, c'est TLS.

Authentification

Headers - Assure l'authentification de l'origine des données, l'intégrité des données et la protection contre le rejeu.Certs (Certificates ) - Un certificat de serveur est envoyé par le serveur au client au début d'une session et est utilisé par le client pour authentifier le serveur.

Les types d'authentification suivants sont disponibles pour les connecteurs HTTP :

No Auth - Aucune authentification n'est nécessaire ou l'authentification est incluse dans d'autres en-têtes de requête comme x-auth-token.Basic Auth -Authentification de base, partage de votre nom d'utilisateur et de votre mot de passe.OAuth 2 (Bearer token) - Les Bearer Tokens sont le type prédominant de jeton d'accès utilisé, ils consistent en une chaîne opaque, non destinée à avoir une signification pour les clients qui l'utilisent.OAuth 2 (Operator) - Généralement utilisé pour les clients qui ont besoin d'accéder à un ensemble limité de ressources pour le compte d'un utilisateur. Par exemple, une application mobile qui nécessite l'accès aux contacts ou aux événements du calendrier d'un utilisateur. Ce rôle permet au client d'accéder uniquement à un sous-ensemble spécifique de ressources, et l'utilisateur doit explicitement autoriser le client à accéder à ces ressources.OAuth 2 (Admin) - Utilisé pour les clients qui ont besoin d'accéder à un plus large éventail de ressources ou de fonctions administratives. Ce rôle accorde au client un accès étendu au compte et aux ressources de l'utilisateur. Par exemple, un client disposant d'un accès OAuth 2 (Admin) peut être en mesure de gérer les paramètres du compte d'un utilisateur, de créer ou de supprimer des ressources ou d'effectuer d'autres tâches administratives.OAuth 1.0 - Version précédente d'OAuth qui gère principalement les flux de travail Web.

:::(Info) (NOTE) Vous pouvez configurer les en-têtes et les certificats ultérieurement. Les en-têtes peuvent également être configurés dans la fonction de connecteur :: :

Pour en savoir plus sur les connecteurs HTTP, consultez la page Vue d'ensemble des connecteurs HTTP.

SQL

Un connecteur SQL communique avec des bases de données externes. La configuration du connecteur est assez simple, mais vous aurez besoin de quelques informations à portée de main pour que l'opération soit rapide et transparente.

Configuration

Pour configurer un connecteur SQL, vous aurez besoin des informations suivantes :
* Le type de base de données SQL * L'URL du serveur * Si le serveur utilise ou non TLS * Votre nom d'utilisateur et votre mot de passe pour l'authentification

Voyons comment procéder à cette configuration :

Configuration Modale

Running On - Faire des demandes pour l'hôte du connecteur. L'hôte du connecteur Cloud est fourni par Tulip et fait des requêtes via Tulip Cloud. Tout hôte de connecteur sur site enregistré sur votre compte apparaîtra également.Type - Le type de base de données SQL à laquelle vous souhaitez vous connecter. Choisissez entre Microsoft SQL Server, MySQL, PostgreSQL, ou OracleDB.Serveur - L'adresse réseau, un nom d'hôte ou une adresse IP, à laquelle Tulip se connecte.Port - Votre serveur écoute les requêtes sur un port réseau spécifique, que votre fournisseur de serveur vous donne.SSL (Secure Sockets Layer) - Utilisé pour crypter les connexions entre vos applications clientes et vos instances exécutant le serveurBase de données - Le nom de votre base de donnéesUtilisateur - Nom d'utilisateur pour la base de donnéesMot de passe - Mot de passe pour la base de données

Authentification

Le processus d'authentification pour SQL requiert votre nom d'utilisateur et votre mot de passe pour la base de données à laquelle vous souhaitez vous connecter.

Pour plus d'informations sur les connecteurs SQL, consultez [Présentation des connecteurs SQL].

Mise en ligne du connecteur

Une fois que vous avez saisi tous les champs correctement, cliquez sur le bouton Test en bas à droite de la fenêtre modale de configuration. Le connecteur prend quelques secondes pour tester et certifier la connexion au serveur. Si vous avez saisi des informations exactes lors de la configuration, l'état devient " en ligne".

Si le connecteur apparaît toujours hors ligne, vérifiez les informations que vous avez saisies et assurez-vous qu'elles sont correctes.

Vous pouvez également consulter notre guide de dépannage des connecteurs pour plus d'informations.

Pour en savoir plus

• Introduction aux hôtes des connecteurs Tulip

Vous avez trouvé ce que vous cherchiez ?

Vous pouvez également vous rendre sur community.tulip.co pour poser votre question ou voir si d'autres ont rencontré une question similaire !