Connecteurs

Présentation

Connectez vos systèmes logiciels existants à Tulip

Tulip est une plateforme ouverte conçue pour s’intégrer de manière transparente à votre infrastructure informatique existante. Cette intégration est facilitée par les connecteurs.

Les connecteurs sont une fonctionnalité de Tulip qui permet l’échange de données entre les API HTTP, MQTT, les bases de données SQL et Tulip. Ils sont essentiels pour se connecter à des serveurs et systèmes externes, y compris l’API Table. La configuration d’un connecteur vous permet d’importer des informations externes dans vos applications Tulip, ce qui rationalise vos processus.

Types de connecteurs

1. HTTP: accédez aux données provenant d’API externes.
2. MQTT: écriture dans votre espace de noms MQTT.
3. SQL: accédez à des bases de données externes à Tulip.

Pour accéder aux connecteurs, survolez l'onglet « Apps » et sélectionnez « Connectors ».

Sur la page « Connecteurs », vous pouvez consulter le statut, la description et la date de la dernière mise à jour de vos connecteurs.

En cliquant sur la ligne correspondante à ce connecteur et en faisant défiler la page vers le bas, vous pouvez voir à quel niveau de développement les applications ou les automatisations utilisent ce connecteur.}

En passant la souris sur la bulle d’état, vous obtenez des informations supplémentaires sur l’état de chaque Environment.

Chaque connecteur peut comporter plusieurs fonctions de connecteur ou requêtes qui sont déclenchées au sein d’une application.
Voici un exemple de fonction de connecteur :

Comment utiliser les connecteurs

Les connecteurs peuvent être utilisés dans des déclencheurs ou dans des Automation Action Block.

Exemple 1

1. « Lorsque l'opérateur scanne un code-barres »
2. « Rechercher ce code-barres dans ma base de données SQL »
3. « Passer ensuite à l'une des trois étapes différentes en fonction de ces données. »

Exemple 2

1. « Lorsque l'opérateur appuie sur ce bouton »
2. « Envoie une requête à mon API HTTP qui suit les problèmes de production dans mon atelier. »

Ces deux exemples relèvent du libre-service. Si vous pouvez interroger une base de données SQL ou un service logiciel externe (comme un MES ou un ERP), vous pouvez écrire la requête directement dans Tulip.

L’image ci-dessous illustre la logique de l’éditeur de déclencheurs permettant d’exécuter une fonction de connecteur :

Environnements de connecteurs

L'onglet « Environnements » vous permet de configurer plusieurs serveurs pour chaque fonction de connecteur. Les environnements vous permettent de segmenter les informations concernées, en fonction du cycle de vie de vos applications et de vos automatisations.

Vous trouverez plus de détails sur les environnements ici.

Détails techniques

Étant donné que les connecteurs communiquent avec des systèmes externes, il est essentiel de comprendre comment les configurer pour qu’ils s’adaptent à votre environnement informatique spécifique. L’hôte de connecteur est un composant de la plateforme Tulip qui gère ces connexions.

Pour les bases de données et les API librement accessibles depuis votre Tulip Cloud, aucune configuration supplémentaire n’est nécessaire. Toutefois, si des problèmes surviennent ou si vous devez vous connecter à une base de données, une API ou une machine qui n’est pas librement accessible depuis le Tulip Cloud, consultez cet article sur les hôtes de connecteurs.

Créer un 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 une bonne maîtrise des types de connexion est utile.

Pour créer un connecteur, accédez à la page « Connecteurs » dans la section « Applications ». Cliquez sur « + Créer un connecteur » dans le coin supérieur droit. Vous pouvez soit sélectionner un connecteur rapide existant, soit cliquer sur « Créer un connecteur personnalisé ».

Configuration d’un nouveau connecteur

Informations de base

1. Ajoutez un nom et une description pour votre connecteur. Ceux-ci peuvent être modifiés à tout moment.
2. Sélectionnez un type de connecteur. Ce choix ne peut plus être modifié une fois le connecteur créé.
3. [facultatif] L'activation des sous-domaines personnalisés vous permet de configurer des sous-domaines uniques pour chaque fonction, ce qui facilite l'intégration avec des architectures de services plus complexes.

Par exemple, si l'adresse du serveur est tulip.co, la fonction 1 pourrait utiliser community.tulip.co et la fonction 2 pourrait utiliser support.tulip.co.

Lorsque les sous-domaines personnalisés sont activés, un sous-domaine par défaut doit être fourni pour vérifier l'état du connecteur.

Exécution sur : hôte du connecteur

Sélectionnez l’hôte du connecteur qui exécutera vos requêtes. L’hôte du Cloud Connector, fourni par Tulip, effectue les requêtes via le Tulip Cloud. Tout hôte de connecteur sur site enregistré sur votre compte apparaîtra également.

Pour en savoir plus sur les hôtes de connecteurs, cliquez ici.

Configuration du connecteur HTTP

Découvrez ici comment configurer les fonctions du connecteur HTTP.

Autoriser les sous-domaines personnalisés

Lorsque cette option est activée, des sous-domaines peuvent être ajoutés au niveau des fonctions. Dans ce cas, un sous-domaine par défaut doit être ajouté ; il servira à vérifier l'état de connexion du connecteur.

**Exemple :**le serveur est acme.co, et certaines de vos fonctions interrogent sales.acme.co, d’autres accèdent à shipping.acme.co, etc.

Adresse du serveur

Spécifiez l’adresse réseau, c’est-à-dire un nom d’hôte ou une adresse IP, à laquelle Tulip se connecte.

TLS

Le protocole TLS (Transport Layer Security) est un protocole cryptographique conçu pour assurer la sécurité des communications sur un réseau informatique. Il garantit la confidentialité et l'intégrité des données en chiffrant les données transmises entre les parties. Le protocole TLS succède au protocole SSL (Secure Sockets Layer) et est largement utilisé pour sécuriser les connexions Internet.

Port

Votre serveur écoute les requêtes sur un port réseau spécifique fourni par votre hébergeur. Le port 443 est le plus couramment utilisé pour les services HTTPS, et le port 80 pour les services HTTP.

Authentification

• Sans authentification: aucune authentification n'est requise, ou l'authentification s'effectue via d'autres en-têtes de requête tels que x-auth-token.
• Authentification de base – Authentification de base, qui utilise un nom d’utilisateur et un mot de passe.
• OAuth 2.0 (jeton « Bearer »): les jetons « Bearer » constituent le type de jeton d’accès le plus couramment utilisé. Ils se présentent sous la forme d’une chaîne de caractères opaque, qui n’a aucune signification pour les clients qui l’utilisent.
• OAuth 2.0 (identifiants de l’utilisateur) – Généralement utilisé pour les clients qui ont besoin d’accéder à un ensemble limité de ressources pour le compte d’un utilisateur, comme une application mobile nécessitant l’accès aux contacts ou aux événements du calendrier d’un utilisateur. L’utilisateur doit accorder explicitement l’autorisation.
• OAuth 2.0 (identifiants du client) – Les identifiants du client constituent un type d’autorisation utilisé par Tulip pour obtenir un jeton d’accès en s’authentifiant auprès du serveur d’autorisation à l’aide des identifiants du client (ID client et secret client), généralement pour accéder à des ressources en son propre nom plutôt qu’au nom d’un utilisateur.
• OAuth 2.0 (compte de service) – Utilisé pour les clients qui ont besoin d’accéder à un éventail plus large de ressources ou de fonctions administratives. Ce rôle accorde un accès étendu au compte et aux ressources de l’utilisateur, notamment pour gérer les paramètres du compte, créer ou supprimer des ressources, ou effectuer des tâches administratives.
• OAuth 1.0 – Une version antérieure d’OAuth qui gère principalement les flux de travail Web.

Pour en savoir plus sur OAuth, cliquez ici.

En-têtes (facultatifs)

Les en-têtes assurent l’authentification de l’origine des données, l’intégrité des données et la protection contre la relecture. Ces en-têtes seront ajoutés à chaque fonction du connecteur.

Extension des autorités de certification

Des fichiers au format.pem peuvent être téléchargés pour étendre les autorités de certification TLS par défaut de Node.js. Ce champ met à jour le champ « ca » de la bibliothèque TLS de Node.js.

« Remplacez éventuellement les certificats d'autorités de certification (CA) de confiance. Par défaut, le système fait confiance aux CA reconnues sélectionnées par Mozilla. Les CA de Mozilla sont entièrement remplacées lorsque des CA sont explicitement spécifiées à l'aide de cette option. La valeur peut être une chaîne de caractères, un Buffer ou un tableau de chaînes de caractères et/ou de Buffers. Toute chaîne de caractères ou tout Buffer peut contenir plusieurs autorités de certification au format PEM concaténées. Le certificat du pair doit pouvoir être chaîné à une autorité de certification (CA) de confiance pour le serveur afin que la connexion soit authentifiée. Lorsque vous utilisez des certificats qui ne peuvent pas être chaînés à une autorité de certification bien connue, l’autorité de certification du certificat doit être explicitement spécifiée comme étant de confiance, sinon l’authentification de la connexion échouera. Si le pair utilise un certificat qui ne correspond pas ou ne s’enchaîne pas à l’une des autorités de certification par défaut, utilisez l’option ca pour fournir un certificat d’autorité de certification auquel le certificat du pair peut correspondre ou s’enchaîner. Pour les certificats auto-signés, le certificat fait office de son propre certificat d'autorité de certification et doit être fourni. Pour les certificats encodés au format PEM, les types pris en charge sont « TRUSTED CERTIFICATE », « X509 CERTIFICATE » et « CERTIFICATE ». Voir également tls.rootCertificates. »

Voici un exemple de CA valide :

-----BEGIN CERTIFICATE-----MIIDXTCCAkWgAwIBAgIJALaEfh0WW6ZcMA0GCSqGSIb3DQEBCwUAMEUxCzAJBgNVBAYTAlVTMRYwFAYDVQQIDA1TYW4gRnJhbmNpc2NvMRIwEAYDVQQHDAlTYW4gSm9zZTEPMA0GA1UECgwGQ29tcGFueTAeFw0xNzA1MjUyMDE2NDRaFw0xNzA2MjQyMDE2NDRaMEUxCzAJBgNVBAYTAlVTMRYwFAYDVQQIDA1TYW4gRnJhbmNpc2NvMRIwEAYDVQQHDAlTYW4gSm9zZTEPMA0GA1UECgwGQ29tcGFueTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAK9b+GVsTsmP7z9T2sh79uI/57pI1DBYNyOlwC0lfn8SebVKRg0qAsaF3V4rQ/RPZFGkTb2G7IKnWQZ6VB8AFLF6A9xuGe7vSG9ZcJ1AKM2uOwYXzWQNWRFiW1XPOEIOXB+N7kMFTF6ZzE6RkV68hVqVn7Kx4s0RYAKM4ESJIMyF64IHo5Rf6k3UtrOzy6M3LXM3axgUPHkHZh6/Pi3hecaF7w0qDhlS8UJLA4Gn1I6nrFt1URVd7aSIEiOQhs7wAGDzCjNYMEQK9ih0GLd9ybCm0flYo5fJqfOhWiCFm2z3SuGH9MSnVdrzxY6x23J/gE3spPvBopF6bRjQl0qiw1ZAgMBAAGjUDBOMB0GA1UdDgQWBBRZtdl2jSWpITThx8JZL4Jx0zCBdTAfBgNVHSMEGDAWgBRZtdl2jSWpITThx8JZL4Jx0zCBdTAMBgNVHRMEBTADAQH/MA0GCSqGSIb3DQEBCwUAA4IBAQARzA8ydRMOfbU0QLOEp9V4B6nO8XBpe9uvtYwQjmb5ZX1bR2/P71bzeJwHK6v4RZl6V5fwGzFdsMFI8JAlLJChM1BpsU7a5R+U/X6XJpCzjErhZ68Z3G+TQ4Bk9LhRlQTH5ld9lR8aWpVPvPIqMtkJhbvWn9P4ysc8q3WYfILy9m9J8Hz3i3AaAEjS5WWm4BjKUMvOFOxaxHHh+ZjNTVrpePyPDrWBkMKn9CF1lwVItJf2JdSYvX1kH5P/M5bsKdwZ95O6d5xUl5Q09gxz/P0j4/QU+fTYhh8RUjKo4vvear9kKxQ2b/8IoQ6A54WHeFzG+h

Configuration du connecteur SQL

Configuration du connecteur MQTT

Découvrez ici comment créer des connecteurs MQTT.

Pour en savoir plus

• Instantanés de connecteurs
• Comment configurer des connecteurs rapides
• Dépannage des connecteurs