— significa que no hay un valor predeterminado. Las variables que contienen certificados, claves privadas, secretos de OAuth o claves HMAC son sensibles y deben provenir de un gestor de secretos.
Un despliegue es gestionado cuando DEPLOYMENT_MODE es byoc o saas, cuando ENV_NAME es production, o cuando MULTI_TENANT_ENABLED es true.
Modo de servicio y tenant
El apagado sigue el ciclo de vida compartido del servidor (
SHUTDOWN_DRAIN_DELAY, SHUTDOWN_TIMEOUT). Consulta la configuración de BYOC.
Al arrancar, el gateway reintenta, con backoff, una base de datos, un cache, una lista de tenants o un Access Manager que no está disponible, hasta que responda. Mientras espera, el puerto de salud responde /health y /readyz responde 503. La licencia es una de las verificaciones de arranque que /readyz informa.
Declaración a Access Manager
La autorización de las solicitudes usaPLUGIN_AUTH_ENABLED (predeterminado true) y PLUGIN_AUTH_HOST, como se describe en Autenticación de plugins. Con la autorización activa, el gateway publica su manifiesto de permisos en Access Manager durante el arranque, y una configuración malformada del cliente de Access Manager o una publicación que Access Manager rechaza detiene el arranque. El error nombra la variable. Una publicación que falla porque Access Manager no es alcanzable se reintenta. AUTH_REQUIRED, AUTH_BREAKER_ENABLED, AUTH_M2M_PRODUCT_FORWARD_ENABLED y AUTH_PRINCIPAL_REQUIRED_WHEN_DISABLED aceptan solo true o false. AUTH_TIMEOUT y AUTH_CACHE_TTL necesitan una duración con unidad, como 30s. AUTH_RETRY_MAX debe ser un entero. AUTH_JWT_VERIFY_CERT y el archivo en AUTH_JWT_VERIFY_CERT_PATH deben contener claves públicas RSA o certificados en PEM.
Cliente de Dataprev y autenticación
Los despliegues gestionados deben usar la custodia de credenciales por tenant. Fallan en modo cerrado en lugar de recurrir a un cliente no autenticado o no mTLS.
Ventanas de contrato y portabilidad
Conciliación y feeds de empleo
Exclusión
Deja
DATAPREV_EXCLUSION_ADAPTER y DATAPREV_EXCLUSION_FAKE_BASE_URL sin establecer.
Recuperación de resultado
Un comando del riel puede terminar con su resultado sin establecer: el proceso murió a mitad de la llamada, o Dataprev nunca respondió. Dos bucles de recuperación convergen ese estado contra el propio registro del riel. Un tercer bucle reenvía una oferta cuya respuesta del riel se perdió. Los tres bucles están desactivados por defecto. Habilítalos en cualquier despliegue que envíe averbações, comandos del riel, u ofertas. De lo contrario, nada converge automáticamente un resultado sin establecer.Subastas y ofertas de clientes
El descubrimiento de portabilidad requiere
LEILAO_PORTABILITY_ENABLED=true, DATAPREV_ENABLED=true, STREAMING_ENABLED=true, una base de datos primaria y el outbox canónico. No requiere LEILAO_ENABLED=true. La ventana de listado de portabilidad es de 72 horas por defecto (DATAPREV_PORTABILIDADE_SOLICITACAO_WINDOW_HOURS). El servicio se niega a arrancar a menos que esa ventana sea más amplia que LEILAO_PORTABILITY_INTERVAL_SEC más el margen de 300 segundos de LEILAO_DISCOVERY_CLOCK_SKEW_SEC.
Custodia de credenciales y artefactos
Consignado no tiene ningún modo de arranque no orientado a eventos: el outbox, el streaming y los brokers son obligatorios aunque la plataforma comparta esos ajustes. Mantén el source de CloudEvent fijado en
consignado-gw.
