Distributed Workflow Orchestration Platform  ·  View 06 of 31  ·  Structure

Integration & Interface Catalogue

Every way something enters or leaves the platform, with protocol, direction and cadence.

Editable source SVG draw.io All views
Inbound — consumers and triggers
Inbound — consumers and triggers
Business applications
REST · OAuth2 client creds
Business applications...
Authoring CLI / CI
REST · OIDC
Authoring CLI / CI...
Operations console
REST + SSE
Operations console...
Domain event publishers
Event Grid CloudEvents
Domain event publishers...
Partner webhooks
HMAC signed
Partner webhooks...
Platform edge
Platform edge
API Management
Premium v2 · private
API Management...
Orchestration Platform
control + execution planes
Orchestration Platform...
Egress policy
Azure Firewall FQDN rules
Egress policy...
Outbound — systems the platform calls
Outbound — systems the platform calls
Customer 360 platform
REST · 400 rps cap
Customer 360 platform...
Identity verification SaaS
REST · 50 rps cap
Identity verification SaaS...
Enterprise HTTP services
180 registered endpoints
Enterprise HTTP services...
LLM gateway
token budget per tenant
LLM gateway...
Notification providers
queued
Notification providers...
Enterprise data warehouse
nightly extract
Enterprise data warehouse...
Azure Monitor / Sentinel
OTLP + diagnostic settings
Azure Monitor / Sentinel...
POST /executions
POST /executions
publish version
publish version
status stream
status stream
event trigger
event trigger
inbound callback
inbound callback
enrich
enrich
verify
verify
generic http task
generic http task
rag task
rag task
notify
notify
execution facts
execution facts
telemetry
telemetry
Integration & Interface Catalogue
Integration & Interface Catalogue
External / third party
External / third party
Interface / broker
Interface / broker
Application we own
Application we own
Security / platform
Security / platform
synchronous
synchronous
event / async
event / async
batch
batch
Every outbound call carries the task's own managed identity or a Key Vault-resolved credential, plus the correlationId and taskExecutionId headers that make a downstream retry recognisable.
Every outbound call carries the task's own managed identity or a Key Vault-resolved credential, plus the correlationId and taskExecutionId headers that make a downstream retry recognisable.
v 1.0 · owner Data & AI Global Practice · date 2026-08
v 1.0 · owner Data & AI Global Practice · date 2026-08
Text is not SVG - cannot display

Interface contracts

  • Inbound is REST plus CloudEvents; there is no third path. A partner webhook is normalised into a CloudEvent by the trigger service, so the execution path never learns about partner-specific formats.
  • Every outbound call carries correlationId and taskExecutionId as headers, and the taskExecutionId doubles as the Idempotency-Key where the downstream supports one. That header is the entire duplicate-suppression contract (view 17).
  • Outbound credentials are managed identity first, Key Vault second. A downstream that requires a static credential is an exception recorded against the integration, not the default.

Numbers that constrain the design

  • Customer 360 accepts 400 rps, the identity SaaS 50 rps, the LLM gateway is token-budgeted per tenant per hour. These ceilings, not the worker fleet, determine real throughput.
  • Scaling workers past a downstream ceiling converts throughput into 429s and retry storms. That is why view 24 stops scaling when a circuit opens, rather than continuing to add pods.
  • 180 registered HTTP endpoints share one generic handler, distinguished only by configuration held in the workflow definition.

Risks

  • Downstreams that cannot honour an idempotency key force the handler into non-retryable mode, so a transient failure becomes a dead-letter. Which systems these are is an open item for the client to confirm.
  • The nightly warehouse extract is a batch coupling that will age badly. It is V1 pragmatism, with the change feed already in place to replace it with a stream.
  • Partner webhook HMAC keys are the only long-lived shared secrets in the design. They are in Key Vault with a 90-day rotation, and rotation is an operational process rather than an automated one.