Service bus provider

Service Bus Provider enables Drupal applications to publish messages to Azure Service Bus queues using reusable connection configurations and secure Microsoft authentication. It provides a Drupal-native transport for Service Queue, making it easy to connect Drupal workflows to cloud-based messaging systems.

Features

Service Bus Provider adds Azure Service Bus connectivity to Drupal through a reusable provider architecture.

Features include:

• Azure Service Bus transport for Service Queue.
• Reusable Azure Service Bus connection configurations.
• Secure authentication using Microsoft Entra application credentials.
• Integration with OAuth Provider for token acquisition and management.
• JSON message publishing to Azure Service Bus queues.
• Support for multiple Service Bus connections.
• Encrypted callback token validation.
• Separation of queue configuration from authentication configuration.

Typical use cases include:

• Publishing business events to Azure Service Bus.
• Triggering downstream systems from Drupal workflows.
• Supporting asynchronous processing architectures.
• Integrating Drupal with enterprise applications.
• Connecting mailbox-processing workflows to external systems.
• Building scalable cloud-native integrations.

Post-Installation

After installing and enabling the module:

1. Install and configure the Key module.
2. Install and configure OAuth Provider.
3. Create a Microsoft OAuth account under Configuration > OAuth Service Accounts.
4. Configure a Microsoft Entra application with Azure Service Bus access.
5. Assign the Azure Service Bus Data Sender role to the application.
6. Create a Service Bus connection under Configuration > Service Bus Connections.
7. Select the OAuth account and configure the Azure Service Bus namespace.
8. Create a Service Queue connection and select the Service Bus provider connection.

Once configured, Service Queue and custom modules can publish messages directly to Azure Service Bus queues using the configured connection.

Additional Requirements

Required:

• Drupal 11
• Key module
• OAuth Provider
• Service Queue
• Azure Service Bus
• A Microsoft Entra application with Azure Service Bus permissions

The Microsoft application must be granted Azure Service Bus Data Sender access to the target namespace or queue.

Recommended Modules/Libraries

Service Bus Provider is designed to work alongside:

• OAuth Provider for Microsoft authentication and token management.
• Service Queue for provider-neutral queue publishing.
• Mailbox Provider for email-driven integration workflows.
• Workflow and automation solutions that generate asynchronous events.
• Custom enterprise integration modules.

Similar Projects

Various Drupal modules support queues, messaging, and asynchronous processing.

Service Bus Provider focuses specifically on Azure Service Bus integration and provides a secure, reusable connection layer built around Microsoft authentication and Drupal configuration entities.

Unlike custom one-off integrations, it enables multiple Drupal components to share Azure Service Bus connections and authentication settings through a consistent API.

Supporting this Module

Issues, bug reports, feature requests, and merge requests are welcome through the Drupal.org issue queue.

Community testing and feedback help improve Azure integration capabilities and support additional enterprise messaging scenarios.

Community Documentation

Documentation currently includes:

• Installation and configuration guidance.
• Azure Service Bus connection setup.
• Microsoft Entra application configuration guidance.
• Service Queue integration examples.
• Developer examples for publishing messages.

Additional tutorials, sample architectures, and integration walkthroughs will be added as the project evolves.

Developer Notes

Service Bus Provider integrates with the Service Queue API, allowing modules to publish messages without requiring direct knowledge of Azure Service Bus SDKs or authentication flows.

The module automatically manages Service Bus-scoped access tokens using OAuth Provider and publishes payloads as JSON messages to configured queues. This enables Drupal developers to build scalable event-driven integrations while keeping queue, authentication, and application logic cleanly separated.