Tendrl

Docs / Strand / connectors/azure-service-bus

Azure Service Bus

Direction: Write Only | Type: azure.servicebus

Azure Service Bus connector for sending messages to queues or topics. This is a forward-only connector.

Required Permissions

The connection string's Shared Access Policy must include the following claims, or the service principal must have the corresponding RBAC role:

Operation Required Claim / Azure Role
send Send claim, or Azure Service Bus Data Sender role
Tip: Assign at the namespace or individual queue/topic level. Avoid using the Manage claim unless you need administrative access.

Operations

Operation Direction Description
send Write Send a message to a queue or topic

Connector Configuration

Field Required Default Description
Authentication Type No api_key api_key for explicit credentials, role to use Azure Managed Identity / DefaultAzureCredential
Connection String Conditional - Azure Service Bus connection string (encrypted). Required when Authentication Type is api_key
Namespace Conditional - Fully qualified namespace (e.g., myns.servicebus.windows.net). Required when Authentication Type is role
Tenant ID Conditional - Your Azure AD tenant ID. Required when Authentication Type is role. The Tendrl app must be registered/consented in this tenant.
Queue Name No - Default queue name (use for queue-based messaging)
Topic Name No - Default topic name (use for topic/subscription messaging)
Role-Based Authentication

When using role authentication, the connector authenticates via Azure Managed Identity / DefaultAzureCredential. You must still supply both Namespace and Tenant ID; no explicit keys or connection strings are needed.

Tip

Specify either a Queue Name or Topic Name, not both. The connector routes the message to the appropriate destination.

Node Configuration

Field Required Description
Queue Name No Queue name (overrides connector default)
Topic Name No Topic name (overrides connector default)

Output

json

{
  "success": true,
  "status": "sent",
  "data": {
    "queue": "my-queue"
  },
  "service": "azure.servicebus",
  "operation": "send"
}

Example

Connector Setup:

json

{
  "connection_string": "Endpoint=sb://mynamespace.servicebus.windows.net/;SharedAccessKeyName=...",
  "queue_name": "order-processing"
}

Connector Setup (role-based):

json

{
  "auth_type": "role",
  "namespace": "mynamespace.servicebus.windows.net",
  "tenant_id": "00000000-0000-0000-0000-000000000000",
  "queue_name": "order-processing"
}

← Back to Strand docs