Webhooks de BPM¶
BPM llama a DMS a través de los endpoints /bpm. Estos endpoints están exentos de
CSRF y usan una firma HMAC en lugar de una sesión de navegador.
Firma¶
BPM envía:
X-BPM-Signature: t=<unix_timestamp>,v1=<hmac_sha256_hex>
El HMAC usa la BPM_API_KEY compartida y una ventana de tiempo de unos cinco
minutos. Las solicitudes fuera de la ventana se rechazan.
Endpoints¶
| Endpoint | Propósito |
|---|---|
POST /bpm/ingest |
Ingresar un documento de caso |
POST /bpm/bulk-ingest |
Ingresar un lote de documentos de caso |
POST /bpm/delete |
Eliminar los documentos de un caso |
POST /bpm/reclassify |
Actualizar tipo, grupo, repositorio, ruta o metadatos |
PUT /bpm/refresh-case/{app_number} |
Refrescar los documentos de un caso |
PUT /bpm/sync-case-metadata |
Sincronizar metadatos del caso |
POST /bpm/sync-error |
Notificar a los superadministradores un fallo de sincronización |
POST /bpm/attachments/discard |
Descartar adjuntos huérfanos |
DMS guarda el caso como luranaBPM-{APP_NUMBER} y conserva el APP_UID de BPM como
referencia del proceso.
Protege el espacio de nombres de webhooks
El espacio de nombres de webhooks de BPM no debe exponerse a clientes no confiables. Mantén la clave compartida en secreto, usa TLS y restringe el acceso en la puerta de enlace. Algunos endpoints heredados de importación de BPM son internos y no forman parte de esta guía.