Asset Integration Reference
Summary
The asset-service is a hub with several inbound and outbound integrations: identity and tenant context on the way in, workflow and document services on the way out, an event bus feeding notification, and a gateway that fronts both the native and compatibility surfaces. This page presents them as a matrix with direction, protocol, ownership, data exchanged, auth evidence, failure boundary, and maturity.
Audience
Solution architects mapping the system context, developers wiring integrations, and support engineers diagnosing cross-service failures.
Reference Content
Integration context
Integration matrix
| Integration | Direction | Protocol | Ownership | Data exchanged | Auth | Failure boundary | Maturity |
|---|---|---|---|---|---|---|---|
| Employee/user | Reference | (payload only) | asset-service | Identifier-only reference | n/a | No client; no FK | Identifier-only |
| Identity | Inbound | HTTP | Identity | JWT (multi-key) | JWT multi-key | Auth rejection | Implemented |
| Tenant | Inbound | HTTP | Gateway/service | Forwarded headers/claims | Claims | 400 if missing | Implemented |
| Workflow | Outbound + inbound | HTTP | Workflow | Requests + callback | Feature-flagged | Flag-gated; 409 on direct while managed | Transitional |
| Document | Outbound | HTTP | Document | Bytes external, references local | Service call | 503 fail-safe | Transitional |
| Notification | Downstream | Event | Notification | Lifecycle payloads | Event bus | At-least-once | Implemented consumer |
| Gateway | Fronting | HTTP | Gateway | Reverse proxy + compat slice + ESS by labor id | Forwarded | Feature-flagged slice | Transitional |
| Messaging | Outbound | Event | asset-service | Outbox-relayed events | n/a | Unbounded retry, no DLQ | Transitional |
| Database | Owned | DB | asset-service | Persisted aggregate + logs | Connection | Application-level tenant isolation | Implemented |
| Compatibility UI | Fronting | HTTP | asset-service | Monolith-shaped requests | Tenant-scoped | Mapping errors | Transitional |
Source References
microservices/src/asset-service/Api/AssetEndpoints.csmicroservices/src/contracts/Events/AssetLifecycleEvents.csmicroservices/src/gateway-api/Program.cs
Related Articles
See Also
Keywords
asset integrations, workflow, document, notification, gateway, messaging
Revision Information
- Status: Draft
- Last reviewed: 2026-07-17
- Review cycle: Quarterly