Códigos de error de STIR/SHAKEN (mpbx-stir-shaken)
Los genera la configuración de STIR/SHAKEN (PUT /api/v1/trunks/stir-shaken, W10-TRK-01). Los mensajes
indican el campo y la regla, nunca la clave privada.
| Código | Tipo | Significado | Qué hacer |
|---|---|---|---|
MPBX-STIR-CONFIG-INVALID | invalid_argument | La cadena de certificados, la clave privada o la URL x5u no pasan la verificación: no es PEM, tiene más de 5 certificados o 64 KiB, una clave SEC1 en lugar de PKCS#8, una clave que no es P-256 o no pertenece al primer certificado, un certificado que hoy no es válido, o una URL x5u que no es https. La ruta de configuración los informa como un 400 que indica el campo. | Corrija el campo indicado (convierta una clave SEC1 con openssl pkcs8 -topk8 -nocrypt). |
MPBX-STIR-KEY-UNREADABLE | unavailable | La clave de firma no se puede cifrar ni abrir (no hay llavero en este servidor, o una clave cifrada que la clave maestra no puede abrir). La firma se desactiva hasta corregirlo; el registro del servidor indica por qué. | Revise la clave maestra de la instalación; suba la clave de nuevo. |
Una verificación entrante fallida no es un error de la API: la llamada se marca, se rechaza con el estado
RFC 8224 (436, 437, 438 o 403 Stale Date) o solo se registra, según indique la configuración, y se
cuenta en mpbx_trunk_inbound_total{result="stir_failed"} cuando se rechaza.