Saltar al contenido principal
Configura estas variables en el momento del despliegue. A menos que se indique lo contrario, cambiar una requiere un reinicio. La referencia de configuración de BYOC cubre el runtime compartido de Lerian: servidor, almacenes de datos, telemetría, autenticación, streaming y outbox. Esta página enumera los ajustes específicos de Consignado y los pocos ajustes compartidos que cambian materialmente el comportamiento de este riel. — 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 usa PLUGIN_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.