Portal Webhook Infrastructure
Component Detail
Infrastructure
medium complexity
backend
0
Dependencies
0
Dependents
0
Entities
0
Integrations
Description
Supabase Edge Function endpoint that receives inbound webhook payloads from the HLF Dynamics portal, validates HMAC signatures to authenticate the source, and enqueues events for processing by the Portal Sync Service. Acts as the secure boundary between the external Dynamics system and the internal Supabase backend, ensuring only authenticated and structurally valid payloads are forwarded.
portal-webhook-infrastructure
Responsibilities
- Expose a public HTTPS endpoint for Dynamics portal webhook delivery
- Validate HMAC signatures on all inbound payloads
- Parse and validate payload schema before enqueuing
- Enqueue valid events for async processing by the sync service
- Return appropriate HTTP response codes to the portal for retry logic
Interfaces
handleWebhookRequest(request)
validateHmacSignature(payload, signature, secret)
parsePortalEvent(rawPayload)
enqueueForProcessing(event)
respondToPortal(statusCode, message)
logInboundRequest(requestMeta)
rejectInvalidPayload(reason)