Cómo configurar un conector

Comprende los detalles de la configuración de un conector en Tulip.

En este artículo aprenderás* Cómo configurar unconector * Qué significa cada entrada en el modal de configuración

Visión general

Los conectores permiten integraciones entre sistemas externos y bases de datos. Hay dos tipos de conectores que discutiremos en este artículo, HTTP y SQL.

Consulta el artículo "¿Qué son los conectores?" para saber exactamente qué conceptos y detalles engloba un conector.

Cómo configurar un nuevo conector

Configurar un nuevo conector no requiere amplios conocimientos de APIs o bases de datos, pero ayuda estar familiarizado con los tipos de conexión.

Para crear un conector, vaya a la página Conectores en Aplicaciones. Haz clic en + Crear conector en la esquina superior derecha. Dale un nombre y una descripción a tu conector y, a continuación, elige si se trata de una conexión HTTP o SQL. Recuerda: un conector HTTP se integra a un servidor API, mientras que un conector SQL se conecta a una base de datos externa.

Tras hacer clic en el botón Crear del modal Crear conector, accederás a la página de inicio de ese conector en particular.

Aquí, verás una notificación en rojo que indica que este conector está actualmente fuera de línea.

Para que el conector esté en línea, debes hacer clic en el botón Producción, Pruebas y Desarrollo para especificar el servidor al que deseas conectarte.

Lo que hay que saber de antemano

Antes de empezar, es importante tener en cuenta que tanto los conectores HTTP como los SQL tienen parámetros de autenticación para garantizar que cualquiera que realice una solicitud a un endpoint o a una base de datos tiene permiso para hacerlo. Estas medidas están pensadas para proteger tus datos y garantizar un acceso seguro.

En las siguientes secciones se explica cómo configurar los conectores HTTP y SQL.

HTTP

Un conector HTTP se comunica con los servidores API. Los conectores HTTP de Tulip interactúan con la mayoría de los tipos de API, incluyendo REST y SOAP.

Configuración

Para configurar un conector, necesitas tener a mano un par de datos sobre el servidor al que intentas conectarte. Estos datos son

• La URL del host
• Si el servidor utiliza TLS o no
• Cualquier encabezado o Cert necesario para la autenticación

Puedes encontrar esta información en la documentación de la API del servidor al que te estás conectando. Para ello, suele ser necesario buscar "[nombre del servidor] Documentación de la API".

Veamos cómo realizar esta configuración:

Configuración Modal

Running On - Hacer peticiones para el host del conector. El host Cloud Connector es proporcionado por Tulip y realiza peticiones a través de Tulip Cloud. También aparecerá cualquier host de conector local que hayas registrado en tu cuenta.Host - La dirección de red, es decir, un nombre de host o dirección IP, a la que se conecta Tulip.Port - Tu servidor escucha las peticiones en un puerto de red específico, que te proporciona tu proveedor de servidor. El predeterminado casi siempre está bien.TLS (Transport Layer Security) - Tulip utiliza un TLS para encriptar tu tráfico cuando se conecta al servidor. Si la url empieza por https, es TLS.

Autenticación

Certificate - Proporciona autenticación del origen de los datos, integridad de los datos y protección contra repeticiones.Certs (Certificates) - Un certificado de servidor se envía desde el servidor al cliente al inicio de una sesión y es utilizado por el cliente para autenticar el servidor.

Los siguientes tipos de autenticación están disponibles para los conectores HTTP:

No Auth - No se necesita autenticación o la autenticación está dentro de otras cabeceras de petición como x-auth-token.Basic Auth - Autenticación básica, comparte el nombre de usuario y la contraseña.**OAuth 2 (**Bearer token) - Los tokens de portador son el tipo predominante de token de acceso utilizado, consisten en una cadena opaca, sin intención de tener significado para los clientes que lo utilizan.OAuth 2 (Operator) - Se utiliza normalmente para clientes que requieren acceso a un conjunto limitado de recursos en nombre de un usuario. Por ejemplo, una aplicación móvil que requiere acceso a los contactos o eventos del calendario de un usuario. Este rol concede al cliente acceso sólo a un subconjunto específico de recursos, y el usuario debe conceder explícitamente permiso para que el cliente acceda a esos recursos.OAuth 2 (Admin) - Se utiliza para clientes que requieren acceso a una gama más amplia de recursos o funciones administrativas. Este rol concede al cliente un amplio acceso a la cuenta y a los recursos del usuario. Por ejemplo, un cliente con acceso OAuth 2 (Admin) puede gestionar la configuración de la cuenta de un usuario, crear o eliminar recursos o realizar otras tareas administrativas.OAuth 1.0 - Versión anterior de OAuth que gestiona principalmente flujos de trabajo web.

:::(Info) (NOTA) Puede configurar las cabeceras y los certificados más adelante. Las cabeceras también se pueden configurar en la función del conector. :::

Para obtener más información sobre los conectores HTTP, echa un vistazo a Una visión general de los conectores HTTP.

SQL

Un conector SQL se comunica con bases de datos externas. La configuración del conector es bastante sencilla, pero necesitarás tener a mano algunos datos para que sea rápida y sin complicaciones.

Configuración

Para configurar un conector SQL, necesitarás la siguiente información:
* El tipo de base de datos SQL * La URL del servidor * Si el servidor utiliza o no TLS * Tu nombre de usuario y contraseña para la autenticación

Veamos cómo realizar esta configuración:

Configuración Modal

Running On - Hacer peticiones para el host del conector. El Cloud Connector host es proporcionado por Tulip y realiza peticiones a través de Tulip Cloud. También aparecerá cualquier host de conector local que esté registrado en su cuenta.Tipo - El tipo de base de datos SQL a la que desea conectarse. Elija entre Microsoft SQL Server, MySQL, PostgreSQL, o OracleDB.Servidor - La dirección de red, un nombre de host o dirección IP, a la que se conecta Tulip.Puerto - Su servidor escucha las solicitudes en un puerto de red específico, que su proveedor de servidor le proporciona.SSL (Secure Sockets Layer) - Se utiliza para cifrar las conexiones entre sus aplicaciones cliente y sus instancias que ejecutan el servidorBase de datos - El nombre de su base de datosUsuario - Nombre de usuario para la base de datosContraseña - Contraseña para la base de datos

Autenticación

El proceso de autenticación para SQL requiere sus credenciales de usuario y contraseña para la base de datos a la que desea conectarse.

Para más información sobre conectores SQL, consulta [Una visión general de los conectores SQL].

Cómo conectar el conector

Una vez que hayas introducido todos los campos correctamente, haz clic en el botón Probar situado en la parte inferior derecha del módulo de configuración. El conector tardará unos segundos en probar y certificar la conexión con el servidor. Si has introducido información correcta durante la configuración, el estado cambiará a Online.

Si el conector sigue apareciendo como desconectado, revisa la información que has introducido y asegúrate de que es correcta.

También puedes consultar nuestra guía Solución de problemas con conect ores para obtener más información.

Más información

• Introducción a Tulip Connector Hosts

¿Has encontrado lo que buscabas?

También puedes dirigirte a community.tulip.co para publicar tu pregunta o ver si otras personas se han enfrentado a una pregunta similar.