Códigos de error de secretos de instalación (mpbx-installer)
Los genera mpbx init y la verificación previa de secretos de mpbx run (sección 15 de ARCHITECTURE). Ningún
mensaje contiene nunca el valor de un secreto; los mensajes solo nombran la variable. Guía:
secretos de instalación.
| Código | Tipo | Significado | Qué hacer |
|---|---|---|---|
MPBX-SECRETS-MISSING | config | mpbx run encontró un secreto obligatorio sin definir o vacío (el mensaje lista todos), o el archivo de secretos indicado con --secrets-file / MPBX_SECRETS_FILE no existe. mpbx run termina con el código 78. | Ejecute mpbx init y pase los secretos al proceso (entorno, env_file, envFrom o --secrets-file). |
MPBX-SECRETS-WEAK | config | Un secreto es más corto que el mínimo (24 caracteres para contraseñas), tiene baja entropía, es un valor de prueba o predeterminado conocido (changeme, password, ...), es una clave de prueba publicada de RFC 8032, o es el mismo valor que otro secreto. Lo genera mpbx run (salida 78) y mpbx init cuando un destino existente ya contiene ese valor. | Reemplace el valor por uno aleatorio. mpbx init nunca reemplaza por sí solo un valor existente, porque eso podría dejarle sin acceso a datos cifrados con él. |
MPBX-SECRETS-INVALID | config | Un secreto está mal formado (por ejemplo, una clave que no es base64url de 32 bytes) o es inconsistente (una clave pública que no corresponde a su clave privada, un MPBX_MASTER_KEY_ID que no coincide con la clave maestra). | Restaure el valor original desde una copia de seguridad. |
MPBX-SECRETS-PARTIAL | config | Algunos miembros de un grupo están presentes y otros faltan (por ejemplo, MPBX_JWT_PUBLIC_KEY sin MPBX_JWT_SIGNING_KEY), o un Secret de Kubernetes existente no tiene claves. mpbx init se niega a "repararlo". | Restaure los valores faltantes desde una copia de seguridad. Elimine el grupo o el Secret solo en una instalación nueva sin datos. |
MPBX-SECRETS-CONFLICT | conflict | mpbx init --rotate master-key encontró un destino con un valor inesperado de clave maestra, o perdió una carrera de Kubernetes 409 (no se reemplaza nada en ese destino). Dos destinos tienen valores distintos para el mismo secreto, alguien creó un destino mientras mpbx init se ejecutaba (Kubernetes 409 Conflict, o apareció un archivo), o --recovery-key-file ya existe. | En una carrera, vuelva a ejecutar mpbx init (encontrará los secretos y no hará nada). Si los valores son distintos, decida cuál destino es el correcto y corrija el otro a mano. |
MPBX-SECRETS-SINK | unavailable / invalid_argument | No se puede leer o escribir un destino: sintaxis incorrecta de --sink, error de E/S, API de Kubernetes inaccesible, HTTP 401/403 (el mensaje indica el RBAC necesario), base64 incorrecto en un Secret. | Corrija la ruta, los permisos o el RBAC (get y create sobre secrets). |
MPBX-SECRETS-INSECURE-FILE | config | El destino file: existe con permisos de grupo u otros. | chmod 600 <file> (y revise quién pudo haberlo leído). |
MPBX-SECRETS-RNG | internal | Falló el generador de números aleatorios del sistema operativo. mpbx init nunca recurre a una fuente más débil. | Revise el host (fuente de entropía, perfil seccomp) y reintente. |
MPBX-RECOVERY-NOT-CONFIRMED | invalid_argument | mpbx init interactivo: el grupo solicitado de la clave de recuperación no se escribió correctamente tres veces. No se escribió nada. | Ejecute mpbx init de nuevo; se generan una clave maestra y una clave de recuperación nuevas. |
MPBX-RECOVERY-KEY-INVALID | invalid_argument | Una clave de recuperación escrita tiene una longitud incorrecta, un carácter fuera del alfabeto o una suma de verificación que no coincide (error de tipeo). | Vuelva a escribirla. I/L se leen como 1 y O como 0; los guiones, espacios y mayúsculas no importan. |
MPBX-USAGE | invalid_argument | Argumento desconocido o mal formado de mpbx init / mpbx run. Código de salida 2. | Vea mpbx init --help. |