4 Connectors

Connectors provide a centralized way to define and manage integration details for external systems used by MicroTx Workflows. A connector can capture connection information such as endpoint URLs, authentication details, credentials, and other configuration parameters required to access an external service.

By defining connectors once, you can reference the same integration from multiple task definitions and AI agent profiles. This avoids duplicating connection details or credentials across workflows and helps keep integrations consistent, easier to maintain, and easier to update.

Credentials stored in connectors are protected through the MicroTx Workflows secret management mechanism. Sensitive values are stored as encrypted secrets using the encryption keys configured during installation, and are masked when connector details are retrieved through the APIs.

What this means for you as a developer:

  • Centralized integration management: Manage external service connection details and credentials in one place.
  • Credential reuse without duplication: Reference configured connectors from workflows, tasks, and AI agent profiles without embedding credentials in each definition.
  • Improved security: Sensitive connector fields are encrypted at rest and masked in API responses.
  • Simpler workflow development: Workflows can use existing connector definitions instead of requiring each task to carry its own integration configuration.
  • Easier maintenance: If an endpoint, credential, or integration parameter changes, update the connector once instead of updating every workflow or task that uses it.

Let's understand this with an example. Suppose a workflow needs to call an AI model or access a database. Instead of placing the service URL, credentials, and related configuration directly in the workflow task, you can define the connection as a connector profile. The workflow or AI agent profile references that connector by name, and MicroTx Workflows uses the stored configuration to perform the integration.

Topics