Ir al contenido

Creación y administración de una conexión

Una conexión es una configuración guardada que permite a PlaidCloud acceder a un sistema externo: una base de datos, un data lake, un ERP, una API REST, un servicio en la nube o un proveedor de Git. Los pasos de los flujos de trabajo hacen referencia a la conexión por su nombre, de modo que los detalles del punto de conexión y las credenciales se mantienen en un solo lugar y se reutilizan en cada paso y proyecto que los necesite.

Las conexiones se administran desde Tools > Connections.

  1. Abra Tools > Connections
  2. Haga clic en New Connection en la barra de herramientas y elija en el menú el sistema al que desea conectarse
  3. Complete el formulario de conexión (las pestañas y los campos varían según el tipo; consulte Formulario de conexión más abajo)
  4. Haga clic en Create para guardar

La nueva conexión aparece en la lista, con usted como propietario.

Las conexiones de Acumatica, Bill.com, Dynamics, Eclipse, HFM/FCCS, NetSuite, Workday y Workday Financials se guardan como conexiones REST, y la columna Tipo de la lista muestra el tipo propio del servicio. Cada una se abre en su propio formulario para crearla, editarla y elegirla en los pasos. Los encabezados, la autenticación y la paginación están en Edit REST settings, a los que se accede desde el menú contextual (consulte Edición de una conexión).

La mayoría de las conexiones abren un formulario con varias pestañas. Las pestañas exactas dependen del tipo, pero normalmente verá:

  • Configuración de la conexión (o Detalles de la conexión para REST): el Name de la conexión, un Memo opcional, el host, el puerto y la base de datos (o el host y el tipo de autenticación para REST), el conmutador Usage (Active) y el Security Model. En una conexión de base de datos, las credenciales están aquí, en un grupo Credenciales de autenticación; en una conexión REST tienen su propia pestaña Autenticación.
  • Configuración de SSL: Use SSL más el modo SSL y los certificados opcionales de cliente y raíz para una conexión cifrada.
  • Configuración de SSH: Use SSH más el host bastión, el puerto, el usuario y la clave para canalizar la conexión a través de un host intermedio SSH.

Los campos de contraseña, token y otras credenciales son de solo escritura: aparecen en blanco cuando vuelve a abrir una conexión guardada, y dejarlos en blanco al guardar conserva el secreto almacenado. Vuelva a escribir un valor solo cuando desee cambiarlo. Esto abarca la clave de API, el secreto de cliente de OAuth y el token de actualización de OAuth de una conexión REST. Las credenciales de varias líneas (un certificado privado de NetSuite, un certificado y una clave privada de Anaplan, una clave de API de Postman, una URL de webhook entrante de Slack o Teams) son de solo escritura de la misma manera y se enmascaran mientras las escribe o las pega. Un reemplazo formado solo por espacios se rechaza en lugar de guardarse sobre la credencial almacenada; borre el campo para conservar el valor guardado. La clave de cliente SSL y la clave privada SSH de una conexión SQL o Git también son de solo escritura, pero permanecen visibles mientras las escribe. Todos los demás campos muestran su valor real guardado en todos los lugares donde se muestra la conexión, en el editor y a través de la API, incluidos los campos que por su nombre parecen confidenciales (el indicador de solo lectura de una base de datos, un identificador de cuenta, un esquema, un nombre de host): solo se enmascara u oculta una credencial real.

A través de la API REST y MCP, un campo de credencial sigue la misma regla que el editor: envíe una cadena vacía y PlaidCloud conserva el valor almacenado; envíe null para borrarlo. Todos los campos que no son credenciales siguen borrándose cuando los envía en blanco.

Los campos obligatorios se validan al guardar; si falta algo, el formulario cambia a la pestaña que contiene el primer campo no válido y lo señala.

El Security Model de una conexión controla quién del espacio de trabajo puede usarla:

Opción Quién puede usar la conexión
Privado (solo propietarios) Solo los propietarios.
Solo miembros específicos Los propietarios más una lista explícita de miembros.
Solo grupos de seguridad específicos Los propietarios más los miembros de los grupos de seguridad indicados.
Todos los miembros del espacio de trabajo Todas las personas del espacio de trabajo.

Cuando elige Specific Members Only o Specific Security Groups Only, conceda el acceso desde el menú Actions de la lista: Members para Specific Members Only o Groups para Specific Security Groups Only, además de Agents y Owners, abren cada uno una lista de verificación filtrable en la que marca quién tiene acceso (consulte Asignación con el selector). Solo un propietario de la conexión, o un administrador del espacio de trabajo, puede cambiar el acceso allí. Cualquier otra persona que pueda editar conexiones puede abrirlas para ver quién tiene acceso, en una lista de solo lectura de las personas ya asignadas. Un administrador del espacio de trabajo puede cambiar el acceso a una conexión que no le pertenece, para transferirla cuando sus propietarios se han marchado.

Cualquier persona que pueda usar una conexión puede abrirla y ver su configuración, y explorar los repositorios, las ramas y los archivos de una conexión de Git. Las contraseñas, los tokens y las claves de una conexión nunca se devuelven a una persona, sean cuales sean sus permisos: a través de la API REST y MCP se devuelven enmascarados, como __redacted__ en REST y <redacted> en MCP. Solo las cuentas de servicio los reciben: los agentes de PlaidLink y la propia cuenta de servicio de un proyecto, que usan el ejecutor de flujos de trabajo y el código que ejecuta un flujo de trabajo, como una función definida por el usuario. El inicio de sesión de una persona nunca los recibe. Si devuelve __redacted__ sin cambios, se conserva el valor almacenado.

Cambiar el lugar al que una conexión envía sus credenciales, como su host o la URL de su token, requiere volver a introducir esas credenciales. De lo contrario, al guardar el cambio se detiene con un mensaje que indica las credenciales que debe volver a introducir, y una prueba de la configuración modificada se rechaza de la misma manera.

Cuando explore una conexión de Git con una URL de servidor distinta de la guardada, introduzca un token para ese servidor.

Una conexión puede contener una configuración distinta por entorno (por ejemplo, un host de desarrollo y un host de producción bajo un mismo nombre de conexión). El selector de entorno de la barra de herramientas elige la configuración de qué entorno está viendo y editando.

  • New Environment: agrega un entorno de conexión
  • Edit Environment: cambia el nombre del entorno seleccionado
  • Delete Environment: elimina el entorno seleccionado, siempre que ningún proyecto lo use, ningún paso lo tenga como entorno fijo y ningún agente lo atienda. En caso contrario, el mensaje indica qué lo sigue usando. El entorno predeterminado no se puede eliminar.

La columna Available de la lista muestra si la conexión seleccionada está configurada para el entorno elegido.

Los entornos se comparten con los agentes de PlaidLink, de modo que el entorno de un proyecto puede cambiar el agente que ejecuta sus pasos remotos además de las conexiones que lee. Consulte Entornos de agentes.

  1. Seleccione la conexión en la lista
  2. Haga clic en Edit en la barra de herramientas (o haga clic con el botón derecho en la fila)
  3. Cambie los campos y haga clic en Update

En una conexión de Acumatica, Bill.com, Dynamics, Eclipse, HFM/FCCS, NetSuite, Workday o Workday Financials, Edit abre el formulario propio de ese servicio. Para cambiar los encabezados, la autenticación o la paginación de la conexión REST subyacente, haga clic con el botón derecho en la conexión y elija Edit REST settings.

La forma de probar depende del tipo:

  • Las conexiones de base de datos (Databricks, Snowflake, PostgreSQL y Redshift) tienen un botón Probar conexión en el editor. Abre la conexión con las credenciales que introdujo e informa del éxito (con la versión del servidor a la que llegó) o del motivo del fallo, sin cerrar el editor, de modo que pueda corregir y reintentar en el mismo lugar.
  • Las conexiones de base de datos con SSH también ofrecen una prueba del túnel SSH en la pestaña SSH Config.
  • La conexión REST genérica tiene una pestaña Testing que envía una solicitud ad hoc a través de la conexión guardada.

Guarde la conexión antes de probarla: las pruebas se ejecutan con la configuración almacenada.

Direcciones a las que una conexión no puede acceder

Sección titulada «Direcciones a las que una conexión no puede acceder»

Una conexión no puede apuntar a una dirección de loopback, de enlace local ni de metadatos de la nube. PlaidCloud comprueba la dirección a la que se resuelve un nombre de host cuando prueba la conexión y cuando un paso la usa, y una dirección que no cumple los requisitos falla con un error que nombra el host y la dirección a la que se resolvió. Las direcciones de su red privada no se ven afectadas.

  • Clonar: duplica la configuración de una conexión como base para una nueva. Consulte Clonación de una conexión.
  • Eliminar: quita la conexión seleccionada desde la barra de herramientas (se le pide confirmación).
  • Dónde se usa…: enumera los pasos de flujos de trabajo que hacen referencia a la conexión, para que pueda ver el impacto antes de editarla o eliminarla.

Lo mismo se aplica a través de la API REST, JSON-RPC y el asistente de IA o MCP: cambiar la configuración de una conexión requiere que usted sea uno de sus propietarios, o un administrador del espacio de trabajo para una conexión sin propietario. Habilitar, deshabilitar, bloquear y desbloquear una conexión requiere un propietario o un administrador del espacio de trabajo. Una solicitud que nombra varias conexiones se aplica solo cuando usted puede cambiarlas todas.