Variables de entorno

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, multi-tenancy, telemetría, autenticación, streaming, outbox y licenciamiento. 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.

Modo de servicio y tenant

Variable	Predeterminado	Propósito
`SERVER_ADDRESS`	`:8080`	Listener HTTP principal para la API y los probes.
`ENV_NAME`	`development`	Activa el endurecimiento de producción cuando se establece en `production`.
`ENVIRONMENT_NAME`	—	Entorno del listener de eventos multi-tenant; recurre a `ENV_NAME`.
`SYSTEMPLANE_ENABLED`	`false`	Habilita la configuración en tiempo de ejecución bajo `/system`.
`MULTI_TENANT_ENABLED`	`false`	Selecciona la custodia de credenciales de Dataprev por tenant en lugar del fallback estático single-tenant.
`DEFAULT_TENANT_ID`	`default`	Tenant usado en modo single-tenant.
`OUTBOX_ENABLED`	`true`	Debe ser `true`; el arranque rechaza un despliegue que no puede registrar los hechos del riel de forma duradera.
`STREAMING_ENABLED`	`true`	Debe ser `true`; el relay de streaming es el único publisher 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; un source incorrecto significa que ningún hecho llega jamás a un consumidor.

Cliente de Dataprev y autenticación

Variable	Predeterminado	Propósito
`DATAPREV_ENABLED`	`false`	Interruptor maestro para el runtime del riel de Dataprev.
`DATAPREV_BASE_URL`	—	URL base para la API principal de Dataprev. Se requiere HTTPS en los despliegues gestionados; local/dev permite HTTP solo para hosts loopback.
`DATAPREV_TOMBAMENTO_BASE_URL`	—	Endpoint separado para las 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 de OAuth2. Se requiere HTTPS en los despliegues gestionados; local/dev permite HTTP solo para hosts loopback.
`DATAPREV_OAUTH_CLIENT_ID`	—	Fallback de ID de cliente OAuth single-tenant. Sensible.
`DATAPREV_OAUTH_CLIENT_SECRET`	—	Fallback de secreto de cliente OAuth single-tenant. Sensible.
`DATAPREV_OAUTH_SCOPES`	—	Ámbitos de OAuth solicitados a Dataprev, delimitados por espacios.
`DATAPREV_CERT_FILE`	—	Ruta local del certificado ICP-Brasil para desarrollo single-tenant no gestionado. Sensible.
`DATAPREV_KEY_FILE`	—	Ruta local de la clave privada emparejada con `DATAPREV_CERT_FILE`. Sensible.
`DATAPREV_CODIGO_SOLICITANTE`	—	Fallback del código de solicitante de tres dígitos para el modo single-tenant.
`DATAPREV_REQUEST_TIMEOUT_SEC`	`30`	Timeout para una solicitud a Dataprev.
`DATAPREV_REQUESTS_PER_SECOND`	`25`	Techo de operador validado y valor predeterminado de Systemplane para el ritmo del riel.
`DATAPREV_CONSENT_CACHE_HMAC_KEY`	—	Clave HMAC usada para indexar las entradas de caché de consentimiento del trabajador sin exponer el CPF. Obligatoria cuando el riel usa Redis. Sensible.

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

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 las propuestas de portabilidad.
`DATAPREV_PORTABILIDADE_INCLUSAO_GARANTIAS_PATH`	—	Anulación de la ruta de envío de garantía 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 en días hábiles para la reversión de refinanciamiento.
`DATAPREV_SALDO_DEVEDOR_CLOCK_INTERVAL_SEC`	`86400`	Cadencia para las obligaciones de saldo pendiente y el fallback de fin de mes.

Conciliación y feeds de empleo

Variable	Predeterminado	Propósito
`DATAPREV_RECONCILIATION_ENABLED`	`false`	Habilita la contabilidad de nómina y la conciliación de repasse.
`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 usado por los feeds programados single-tenant.
`DATAPREV_EMPLOYMENT_REPORT_ENABLED`	`false`	Habilita el feed de terminación de empleo.
`DATAPREV_EMPLOYMENT_REPORT_ADAPTER`	`disabled`	`dataprev` para el adaptador real; `fake` es solo local.
`DATAPREV_EMPLOYMENT_REPORT_INTERVAL_SEC`	`3600`	Cadencia del informe de empleo.
`DATAPREV_EMPLOYMENT_REPORT_PAGE_SIZE`	`100`	Registros solicitados por página.
`DATAPREV_EMPLOYMENT_REPORT_CONCURRENCY`	`4`	Workers concurrentes por tenant.
`DATAPREV_EMPLOYMENT_REPORT_TENANT_TIMEOUT_SEC`	`300`	Tiempo máximo de procesamiento para un tenant en una pasada.

Exclusión y redirección

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

DATAPREV_EXCLUSION_ADAPTER y DATAPREV_EXCLUSION_FAKE_BASE_URL están retiradas. Elimínalas de los manifiestos de despliegue. Los valores heredados que no sean inertes fallan la validación.

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. Ambos bucles están desactivados por defecto. Habilítalos en cualquier despliegue que envíe averbações o comandos del riel. De lo contrario, un resultado sin establecer nunca se resuelve.

Variable	Predeterminado	Propósito
`DATAPREV_AVERBACAO_RECOVERY_ENABLED`	`false`	Habilita la convergencia de 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 concurrentes por tenant.
`DATAPREV_AVERBACAO_RECOVERY_TENANT_TIMEOUT_SEC`	`60`	Tiempo máximo de procesamiento para un tenant en una pasada.
`DATAPREV_AVERBACAO_RECOVERY_MINIMUM_DWELL_SEC`	`300`	Antigüedad mínima antes de conciliar un resultado sin establecer.
`DATAPREV_AVERBACAO_RECOVERY_PROVIDER_TIMEOUT_SEC`	`30`	Timeout para una lectura del registro.
`DATAPREV_RAIL_COMMAND_RECOVERY_ENABLED`	`false`	Habilita la convergencia para el refinanciamiento, la reversión, la renegociación y la 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 concurrentes por tenant.
`DATAPREV_RAIL_COMMAND_RECOVERY_TENANT_TIMEOUT_SEC`	`60`	Tiempo máximo de procesamiento para un tenant en una pasada.
`DATAPREV_RAIL_COMMAND_RECOVERY_MINIMUM_DWELL_SEC`	`300`	Antigüedad mínima antes de conciliar un resultado sin establecer.
`DATAPREV_RAIL_COMMAND_RECOVERY_PROVIDER_TIMEOUT_SEC`	`30`	Timeout para una lectura del registro.

Subastas y ofertas de clientes

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 comando de oferta de cliente autenticada.
`LEILAO_INTERVAL_SEC`	`3600`	Cadencia de descubrimiento de subastas.
`LEILAO_TENANT_ID`	—	Tenant usado por los flujos de subasta M001 y de descubrimiento de portabilidad M011. Obligatorio cuando alguno de los flujos habilitados lo necesita.
`LEILAO_PORTAL_BASE_URL`	—	Fallback opcional de la URL base del portal del trabajador single-tenant. Dejarla sin establecer es un despliegue válido: las ofertas viajan entonces con los contactos propios del cliente. Un valor establecido se valida en el arranque; uno inseguro hace que el arranque falle en modo cerrado.
`LEILAO_DISCOVERY_LOOKBACK_HOURS`	`8760`	Ventana retrospectiva inicial y de recuperación para las solicitudes abiertas.
`LEILAO_DISCOVERY_CLOCK_SKEW_SEC`	`300`	Superposición de desfase de reloj aplicada a las ventanas de descubrimiento.
`LEILAO_PORTABILITY_ENABLED`	`false`	Habilita el descubrimiento de portabilidad M011. Esto 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 bid manager.
`LEILAO_BID_MANAGER_BURST`	`25`	Presupuesto de ráfaga inmediata para el fan-out del bid manager.
`LEILAO_DECIDE_DEADLINE_SEC`	`5`	Plazo de decisión por bid manager.

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 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

Variable	Predeterminado	Propósito
`CREDENTIALS_STORE_ENABLED`	`false`	Habilita la custodia de credenciales por tenant. Obligatoria cuando el riel de 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 concurrentes de limpieza.
`CREDENTIALS_CLEANUP_LEASE_SEC`	`60`	Lease de limpieza.
`CREDENTIALS_CLEANUP_PERSISTENCE_TIMEOUT_SEC`	`5`	Timeout de persistencia para una operación de limpieza.
`AVERBACAO_ARTIFACTS_BUCKET`	—	Bucket privado de almacén de objetos para el CCB y los 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`	Usa direccionamiento S3 de estilo de ruta cuando está habilitado.
`AWS_REGION`	—	Región usada por la custodia de credenciales y el almacenamiento de artefactos. Deliberadamente no tiene valor predeterminado: un valor sin establecer permite que el SDK de AWS resuelva la propia región de la institución, y uno codificado la anularía. Establécela explícitamente para la región en la que deben permanecer tus datos.
`AWS_ENDPOINT_URL`	—	Anulación de endpoint compatible con AWS para el desarrollo local. No la establezcas en producción gestionada de AWS.

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.

​Modo de servicio y tenant

​Cliente de Dataprev y autenticación

​Ventanas de contrato y portabilidad

​Conciliación y feeds de empleo

​Exclusión y redirección

​Recuperación de resultado

​Subastas y ofertas de clientes

​Custodia de credenciales y artefactos

Modo de servicio y tenant

Cliente de Dataprev y autenticación

Ventanas de contrato y portabilidad

Conciliación y feeds de empleo

Exclusión y redirección

Recuperación de resultado

Subastas y ofertas de clientes

Custodia de credenciales y artefactos