Static Deliveries and Subscriptions
Time: 15-30 minutes | Goal: Set up static AMQP 1.0 endpoints for publishing and consuming data
Prerequisites
- Completed Quick Start Guide (actor, capability, policies configured)
- Certificate bundle downloaded and extracted
Overview
Static endpoints provide persistent AMQP 1.0 connections via the web interface using SASL EXTERNAL authentication with client certificates.
Best for: Development, testing, low-moderate volumes
Limitations: Single endpoint per actor/capability, manual setup, less resilient
Step 1: Create Static Delivery (Publishing)
- Go to TLEX Interchange Admin > Deliveries
- Click your actor → "+ CREATE NEW"
- Configure:
- Delivery Name:
CAM-Publisher-Test
- Selector:
messageType = 'CAM'
(required, must match existing capabilities)
- Delivery Name:
- Click "CREATE" and wait 2-5 minutes
- Record endpoint details:
Host: demo-1mb6xz.azure.tlex.cloud Port: 5671 Target: L3D-TEST
Selector Examples:
messageType = 'CAM'
- All CAM capabilitiesmessageType = 'CAM' AND publisherId = 'UK12345'
- Specific publisher
Step 2: Create Static Subscription (Consuming)
- Go to TLEX Interchange Admin > Subscriptions
- Click your actor → "+ CREATE NEW"
- Configure:
- Subscription Name:
CAM-Consumer-Test
- Selector:
messageType = 'CAM'
(required, must match accessible capabilities)
- Subscription Name:
- Click "CREATE" and wait 2-5 minutes
- Record endpoint details (host, port, source address)
Step 3: Implementation
Required Certificate Files
- Client Certificate + Private Key: Combined PEM file ("key_and_certificate.pem")
- CA Certificate: Separate PEM file ("ca.pem")
Connection Details Needed
Host, Port, Target/Source from your endpoints
Implementation Examples
- Publishing: Direct Delivery Example (Full Examples)
- Consuming: Direct Subscription Example (Full Examples)
When publishing, make sure that the required AMQP application properties are also sent:
Property | Example |
---|---|
messageType | "CAM" |
publisherId | "UK12345" |
publicationId | "UK12345:DEV_CAM_02" |
originatingCountry | "UK" |
protocolVersion | "CAM:1.4.1" |
quadTree | ",1004," |
Step 4: Monitor & Verify
- Open TLEX Interchange Dashboard > Message Metrics
- Verify increasing message counts and active endpoint status
- Check for error indicators
Troubleshooting
Issue | Solution |
---|---|
Connection refused | Verify host/port from endpoint details |
SSL/TLS handshake failed | Check client cert + key PEM format |
SASL EXTERNAL failed | Verify actor CN matches certificate subject |
Authorization denied | Check actor has policy access to capability |
Selector not matching | Ensure capabilities exist matching selector criteria |
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article