Portal Webhook Listener
Component Detail
Infrastructure
medium complexity
backend
1
Dependencies
0
Dependents
1
Entities
0
Integrations
Description
HTTP endpoint receiving inbound push events from the external Dynamics portal. Validates payload signatures, acknowledges delivery immediately, and enqueues events for asynchronous processing by the integration service.
portal-webhook-listener
Responsibilities
- Expose a secured webhook endpoint for external portal callbacks
- Validate HMAC or signature-based authentication on every inbound payload
- Return fast acknowledgment responses to prevent portal retry storms
- Enqueue validated events for processing by the portal integration service
Interfaces
handleWebhook(req: Request, res: Response): Promise<void>
validateSignature(payload: Buffer, signature: string, secret: string): boolean
enqueueEvent(event: PortalEvent): Promise<void>
Relationships
Related Data Entities (1)
Data entities managed by this component