Variables de entorno

Define estas variables al momento del despliegue. A menos que se indique lo contrario, cambiar una requiere reiniciar. La referencia de configuración BYOC cubre el runtime compartido de Lerian: servidor, datastores, multitenancy, telemetría, autenticación, streaming, outbox y licenciamiento. Esta página enumera la configuración específica de Consignado y las pocas configuraciones compartidas que cambian materialmente el comportamiento de su riel. — significa que no hay valor predeterminado. Las variables que contienen certificados, claves privadas, secretos de OAuth o claves HMAC son sensibles y deben proceder de un gestor de secretos.

Servicio y modo de tenant

Variable	Predeterminado	Propósito
`SERVER_ADDRESS`	`:8080`	Listener HTTP principal para la API y las probes.
`ENV_NAME`	`development`	Activa el endurecimiento de producción cuando se establece en `production`.
`ENVIRONMENT_NAME`	—	Entorno del listener de eventos multitenant; recurre a `ENV_NAME`.
`SYSTEMPLANE_ENABLED`	`false`	Habilita la configuración en tiempo de ejecución en `/system`.
`MULTI_TENANT_ENABLED`	`false`	Selecciona la custodia de credenciales de Dataprev por tenant en lugar de la alternativa estática de tenant único.
`DEFAULT_TENANT_ID`	`default`	Tenant utilizado en modo de tenant único.
`OUTBOX_ENABLED`	`true`	Debe ser `true`; el arranque rechaza un despliegue que no pueda registrar de forma durable los hechos del riel.
`STREAMING_ENABLED`	`true`	Debe ser `true`; el relay de streaming es el único publicador de los hechos del outbox.
`STREAMING_BROKERS`	—	Lista de brokers obligatoria. El arranque rechaza un relay sin destino.
`STREAMING_CLOUDEVENTS_SOURCE`	—	Debe ser exactamente `consignado-gw`. El arranque rechaza cualquier otro valor; una fuente incorrecta significa que ningún hecho llega jamás a un consumidor.

Cliente y autenticación de Dataprev

Variable	Predeterminado	Propósito
`DATAPREV_ENABLED`	`false`	Interruptor maestro para el runtime del riel Dataprev.
`DATAPREV_BASE_URL`	—	URL base de la API principal de Dataprev. HTTPS es obligatorio en despliegues gestionados; local/dev admite HTTP solo para hosts de loopback.
`DATAPREV_TOMBAMENTO_BASE_URL`	—	Endpoint independiente para operaciones de tombamento. Vacío mantiene esas operaciones no disponibles. Sigue la misma política de HTTPS/loopback.
`DATAPREV_OAUTH_TOKEN_URL`	—	Endpoint de token OAuth2. HTTPS es obligatorio en despliegues gestionados; local/dev admite HTTP solo para hosts de loopback.
`DATAPREV_OAUTH_CLIENT_ID`	—	Alternativa de ID de cliente OAuth para tenant único. Sensible.
`DATAPREV_OAUTH_CLIENT_SECRET`	—	Alternativa de secreto de cliente OAuth para tenant único. Sensible.
`DATAPREV_OAUTH_SCOPES`	—	Ámbitos OAuth delimitados por espacios solicitados a Dataprev.
`DATAPREV_CERT_FILE`	—	Ruta local de certificado ICP-Brasil para desarrollo no gestionado de tenant único. Sensible.
`DATAPREV_KEY_FILE`	—	Ruta de clave privada local asociada a `DATAPREV_CERT_FILE`. Sensible.
`DATAPREV_CODIGO_SOLICITANTE`	—	Alternativa de código solicitante de tres dígitos para modo de tenant único.
`DATAPREV_REQUEST_TIMEOUT_SEC`	`30`	Tiempo de espera para una solicitud de Dataprev.
`DATAPREV_REQUESTS_PER_SECOND`	`25`	Límite de operador validado y valor predeterminado de Systemplane para el ritmo del riel.
`DATAPREV_CONSENT_CACHE_HMAC_KEY`	—	Clave HMAC utilizada para indexar entradas de caché de consentimiento del trabajador sin exponer CPF. Obligatoria cuando el riel usa Redis. Sensible.

Los despliegues gestionados deben utilizar custodia de credenciales de tenant. Fallan de forma cerrada en lugar de recurrir a un cliente sin autenticación o sin mTLS.

Ventanas de contrato y portabilidad

Variable	Predeterminado	Propósito
`DATAPREV_AVERBACAO_ENABLED`	`false`	Habilita el runtime de averbação y la ruta de testigo de propuesta.
`DATAPREV_PORTABILIDADE_SOLICITACAO_WINDOW_HOURS`	`72`	Ventana retrospectiva para propuestas de portabilidad.
`DATAPREV_PORTABILIDADE_INCLUSAO_GARANTIAS_PATH`	—	Anulación de la ruta de envío de garantías de portabilidad de Dataprev.
`DATAPREV_PORTABILIDADE_AVERBACAO_WINDOW_DAYS`	`20`	Ventana para completar el registro de portabilidad saliente.
`DATAPREV_REFINANCIAMENTO_REVERSAO_WINDOW_BUSINESS_DAYS`	`7`	Ventana de días hábiles para la reversión de refinanciación.
`DATAPREV_SALDO_DEVEDOR_CLOCK_INTERVAL_SEC`	`86400`	Cadencia para obligaciones de saldo pendiente y alternativa de fin de mes.

Feeds de conciliación y empleo

Variable	Predeterminado	Propósito
`DATAPREV_RECONCILIATION_ENABLED`	`false`	Habilita la conciliación de registros contables de nómina y repasses.
`DATAPREV_RECONCILIATION_INTERVAL_SEC`	`3600`	Cadencia de conciliación.
`DATAPREV_RECONCILIATION_LOOKBACK_MONTHS`	`1`	Competencias de nómina anteriores incluidas en cada pasada.
`DATAPREV_RECONCILIATION_CNPJS`	—	Alcances de empleador separados por comas; vacío lee el feed de todo el riel.
`DATAPREV_RECONCILIATION_TENANT_ID`	—	Tenant utilizado por los feeds programados de tenant único.
`DATAPREV_EMPLOYMENT_REPORT_ENABLED`	`false`	Habilita el feed de terminación laboral.
`DATAPREV_EMPLOYMENT_REPORT_ADAPTER`	`disabled`	`dataprev` para el adaptador real; `fake` es solo local.
`DATAPREV_EMPLOYMENT_REPORT_INTERVAL_SEC`	`3600`	Cadencia de informes laborales.
`DATAPREV_EMPLOYMENT_REPORT_PAGE_SIZE`	`100`	Registros solicitados por página.
`DATAPREV_EMPLOYMENT_REPORT_CONCURRENCY`	`4`	Workers de tenant concurrentes.
`DATAPREV_EMPLOYMENT_REPORT_TENANT_TIMEOUT_SEC`	`300`	Tiempo máximo de procesamiento de un tenant en una pasada.

Exclusión y redireccionamiento

Variable	Predeterminado	Propósito
`DATAPREV_EXCLUSION_ENABLED`	`false`	Habilita la admisión y recuperación de exclusiones.
`DATAPREV_EXCLUSION_PROVIDER_TIMEOUT_SEC`	`30`	Tiempo de espera para una llamada al proveedor de exclusiones.
`DATAPREV_EXCLUSION_CLAIM_DWELL_SEC`	`60`	Permanencia mínima antes de que el trabajo reclamado pueda reintentarse.
`DATAPREV_EXCLUSION_STATUS_CHECK_LEASE_SEC`	`60`	Lease para comprobaciones de estado de exclusión.
`DATAPREV_EXCLUSION_RECOVERY_INTERVAL_SEC`	`30`	Cadencia del ciclo de recuperación.
`DATAPREV_EXCLUSION_RECOVERY_BATCH`	`50`	Operaciones reclamadas por pasada.
`DATAPREV_EXCLUSION_RECOVERY_CONCURRENCY`	`4`	Workers de recuperación concurrentes.
`DATAPREV_EXCLUSION_RECOVERY_TENANT_TIMEOUT_SEC`	`60`	Tiempo máximo de procesamiento de un tenant en una pasada.
`DATAPREV_REDIRECTION_ADAPTER`	`disabled`	Selección de adaptador de redireccionamiento. `fake` solo se acepta para desarrollo local.

DATAPREV_EXCLUSION_ADAPTER y DATAPREV_EXCLUSION_FAKE_BASE_URL están retirados. Elimínalos de los manifiestos de despliegue; los valores heredados no inertes fallan la validación.

Recuperación de resultados

Un comando del riel puede terminar sin que su resultado llegue a establecerse: el proceso murió a mitad de la llamada o Dataprev nunca respondió. Dos ciclos de recuperación resuelven ese estado contra el propio registro del riel. Ambos están deshabilitados de forma predeterminada; habilítalos en cualquier despliegue que envíe averbações o comandos del riel, o un resultado no establecido nunca se resuelve.

Variable	Predeterminado	Propósito
`DATAPREV_AVERBACAO_RECOVERY_ENABLED`	`false`	Habilita la convergencia del resultado de averbação.
`DATAPREV_AVERBACAO_RECOVERY_INTERVAL_SEC`	`60`	Cadencia de convergencia.
`DATAPREV_AVERBACAO_RECOVERY_BATCH`	`50`	Registros reclamados por pasada.
`DATAPREV_AVERBACAO_RECOVERY_CONCURRENCY`	`4`	Workers de tenant concurrentes.
`DATAPREV_AVERBACAO_RECOVERY_TENANT_TIMEOUT_SEC`	`60`	Tiempo máximo de procesamiento de un tenant en una pasada.
`DATAPREV_AVERBACAO_RECOVERY_MINIMUM_DWELL_SEC`	`300`	Permanencia mínima antes de resolver un resultado no establecido.
`DATAPREV_AVERBACAO_RECOVERY_PROVIDER_TIMEOUT_SEC`	`30`	Tiempo de espera para una lectura del registro.
`DATAPREV_RAIL_COMMAND_RECOVERY_ENABLED`	`false`	Habilita la convergencia de refinanciación, reversión, renegociación y exclusión de portabilidad del lado de origen.
`DATAPREV_RAIL_COMMAND_RECOVERY_INTERVAL_SEC`	`60`	Cadencia de convergencia.
`DATAPREV_RAIL_COMMAND_RECOVERY_BATCH`	`50`	Registros reclamados por pasada.
`DATAPREV_RAIL_COMMAND_RECOVERY_CONCURRENCY`	`4`	Workers de tenant concurrentes.
`DATAPREV_RAIL_COMMAND_RECOVERY_TENANT_TIMEOUT_SEC`	`60`	Tiempo máximo de procesamiento de un tenant en una pasada.
`DATAPREV_RAIL_COMMAND_RECOVERY_MINIMUM_DWELL_SEC`	`300`	Permanencia mínima antes de resolver un resultado no establecido.
`DATAPREV_RAIL_COMMAND_RECOVERY_PROVIDER_TIMEOUT_SEC`	`30`	Tiempo de espera para una lectura del registro.

Subastas y ofertas del cliente

Variable	Predeterminado	Propósito
`LEILAO_ENABLED`	`false`	Habilita el descubrimiento programado de solicitudes de préstamo abiertas.
`LEILAO_CLIENT_BID_ENABLED`	`false`	Habilita la superficie de comandos de oferta de cliente autenticado.
`LEILAO_INTERVAL_SEC`	`3600`	Cadencia de descubrimiento de subastas.
`LEILAO_TENANT_ID`	—	Tenant utilizado por los flujos de subasta M001 y descubrimiento de portabilidad M011. Obligatorio cuando cualquiera de los flujos habilitados lo requiere.
`LEILAO_PORTAL_BASE_URL`	—	Alternativa opcional de URL base del portal del trabajador para tenant único. Dejarla sin definir es un despliegue válido: las ofertas viajan entonces con los contactos propios del cliente. Un valor definido se valida en el arranque y uno inseguro hace que el arranque falle de forma cerrada.
`LEILAO_DISCOVERY_LOOKBACK_HOURS`	`8760`	Ventana retrospectiva inicial y de recuperación para solicitudes abiertas.
`LEILAO_DISCOVERY_CLOCK_SKEW_SEC`	`300`	Solapamiento de desfase de reloj aplicado a las ventanas de descubrimiento.
`LEILAO_PORTABILITY_ENABLED`	`false`	Habilita el descubrimiento de portabilidad M011. Es independiente de `LEILAO_ENABLED`.
`LEILAO_PORTABILITY_INTERVAL_SEC`	`3600`	Cadencia de la pasada de descubrimiento de portabilidad M011.
`LEILAO_BID_MANAGER_RPS`	`25`	Presupuesto de solicitudes para el fan-out del gestor de ofertas.
`LEILAO_BID_MANAGER_BURST`	`25`	Presupuesto de ráfaga inmediata para el fan-out del gestor de ofertas.
`LEILAO_DECIDE_DEADLINE_SEC`	`5`	Plazo de decisión por gestor de ofertas.

El descubrimiento de portabilidad M011 requiere LEILAO_PORTABILITY_ENABLED=true, LEILAO_TENANT_ID, 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 de forma predeterminada (DATAPREV_PORTABILIDADE_SOLICITACAO_WINDOW_HOURS); el servicio rechaza el arranque a menos que esa ventana sea mayor que LEILAO_PORTABILITY_INTERVAL_SEC más el margen de 300 segundos de LEILAO_DISCOVERY_CLOCK_SKEW_SEC.

Custodia de credenciales y artefactos

Variable	Predeterminado	Propósito
`CREDENTIALS_STORE_ENABLED`	`false`	Habilita la custodia de credenciales de tenant. Obligatoria cuando el riel Dataprev se ejecuta en un despliegue gestionado.
`CREDENTIALS_CLEANUP_INTERVAL_SEC`	`30`	Cadencia de limpieza de credenciales.
`CREDENTIALS_CLEANUP_BATCH_SIZE`	`50`	Credenciales reclamadas por pasada de limpieza.
`CREDENTIALS_CLEANUP_CONCURRENCY`	`4`	Workers de limpieza concurrentes.
`CREDENTIALS_CLEANUP_LEASE_SEC`	`60`	Lease de limpieza.
`CREDENTIALS_CLEANUP_PERSISTENCE_TIMEOUT_SEC`	`5`	Tiempo de espera de persistencia para una operación de limpieza.
`AVERBACAO_ARTIFACTS_BUCKET`	—	Bucket privado de object store para CCB y artefactos del riel. Obligatorio cuando `DATAPREV_AVERBACAO_ENABLED=true`.
`AVERBACAO_ARTIFACTS_ENDPOINT_URL`	—	Anulación de endpoint compatible con S3 para almacenes de objetos locales o privados.
`AVERBACAO_ARTIFACTS_USE_PATH_STYLE`	`false`	Utiliza direccionamiento S3 de estilo de ruta cuando está habilitado.
`AWS_REGION`	—	Región utilizada por la custodia de credenciales y el almacenamiento de artefactos. Deliberadamente no tiene valor predeterminado: un valor sin definir permite que el SDK de AWS resuelva la región propia de la institución, y uno fijado en el código lo anularía. Defínela explícitamente para la región en la que deben permanecer tus datos.
`AWS_ENDPOINT_URL`	—	Anulación de endpoint compatible con AWS para desarrollo local. No lo definas en producción de AWS gestionada.

Consignado no admite un modo de arranque sin eventos: outbox, streaming y brokers son obligatorios aunque sean configuraciones compartidas de la plataforma. Mantén la fuente de CloudEvent fijada en consignado-gw.

​Servicio y modo de tenant

​Cliente y autenticación de Dataprev

​Ventanas de contrato y portabilidad

​Feeds de conciliación y empleo

​Exclusión y redireccionamiento

​Recuperación de resultados

​Subastas y ofertas del cliente

​Custodia de credenciales y artefactos

Servicio y modo de tenant

Cliente y autenticación de Dataprev

Ventanas de contrato y portabilidad

Feeds de conciliación y empleo

Exclusión y redireccionamiento

Recuperación de resultados

Subastas y ofertas del cliente

Custodia de credenciales y artefactos