Saltar al contenido principal

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ódigoTipoSignificadoQué hacer
MPBX-STIR-CONFIG-INVALIDinvalid_argumentLa 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-UNREADABLEunavailableLa 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.