Variables de entorno

Lerian CCS lee su configuración desde el entorno del proceso al arrancar. Configuras estas variables en tiempo de despliegue. Un reinicio del servicio hace que tomen efecto. Fundamentos de configuración de BYOC documenta la base común que comparte todo servicio Go de Lerian. En las tablas siguientes, la columna Predeterminado / Obligatorio muestra el valor que el servicio aplica cuando dejas la variable sin configurar. Un calificador en negrita marca una variable que debes configurar, como Obligatorio o Obligatorio en producción. — significa que el servicio no aplica ningún valor predeterminado. Una variable marcada Sensitive. lleva material de credenciales o de claves. Inyéctala desde tu gestor de secretos en tiempo de despliegue. Nunca hagas commit de un valor. Cuando un valor del archivo de ejemplo publicado difiere del valor que aplica el código, esta página publica el valor del código.

Servicio y runtime

Variable	Predeterminado / Obligatorio	Descripción
`APPLICATION_NAME`	Nombre del servicio	Nombre de la aplicación del proceso que aparece en los logs y la telemetría.
`ENV_NAME`	`—`	Etiqueta del entorno de despliegue, normalizada a minúsculas. El valor `production` activa todos los controles de producción de esta página.
`LOG_LEVEL`	`info`	Nivel del logger estructurado: `debug`, `info`, `warn` o `error`.
`DEPLOYMENT_MODE`	`local`	Postura operativa: `local`, `byoc` o `saas`. Otro valor detiene el arranque.
`CCS_RUN_MODE`	`all`	Selecciona los subsistemas que ejecuta este proceso: `manager` solo para la API HTTP, `worker` solo para los workers en segundo plano, o `all` para ambos. Un valor inválido detiene el arranque.
`SERVER_ADDRESS`	`—`	Dirección de escucha HTTP principal. Un valor sin configurar hace que el servidor se enlace a un puerto que asigna el sistema operativo, por lo que los despliegues la configuran.
`HTTP_BODY_LIMIT_BYTES`	`104857600`	Tamaño máximo del cuerpo de una solicitud entrante, en bytes.
`DEFAULT_TENANT_ID`	`—`	Identificador de tenant de reserva para las rutas sin contexto de tenant por solicitud.
`MIGRATIONS_PATH`	`—`	Ruta del sistema de archivos a los archivos de migración SQL. Los binarios de migración la leen directamente. El servicio nunca aplica las migraciones por sí mismo.
`INFRA_CONNECT_TIMEOUT_SEC`	`30`	Presupuesto general de conexión a la infraestructura, en segundos. El servicio limita un valor de cero o menor a 30 segundos.

Licencia

Variable	Predeterminado / Obligatorio	Descripción
`LICENSE_KEY`	Obligatorio	Credencial de licencia emitida por Lerian. `Sensitive.`
`ORGANIZATION_IDS`	Obligatorio	Ámbito de organización que cubre la licencia. Lerian CCS ejecuta la librería de licencias en modo global, por lo que el valor es el literal `global`.

CORS, TLS y proxies

Variable	Predeterminado / Obligatorio	Descripción
`CORS_ALLOWED_ORIGINS`	Obligatorio en producción	Lista separada por comas de los orígenes de navegador permitidos. Un arranque en producción rechaza una lista vacía y rechaza un comodín.
`CORS_ALLOWED_METHODS`	`—`	Lista separada por comas de los métodos HTTP permitidos.
`CORS_ALLOWED_HEADERS`	`—`	Lista separada por comas de los headers de solicitud permitidos.
`CORS_EXPOSE_HEADERS`	`—`	Lista separada por comas de los headers de respuesta que el navegador puede leer.
`CORS_ALLOW_CREDENTIALS`	`false`	Permite solicitudes cross-origin con credenciales.
`ALLOW_CORS_WILDCARD`	`false`	Aplica cuando `CORS_ALLOWED_ORIGINS` está vacío o es `*`: `true` permite cualquier origen sin credenciales, y `false` rechaza toda solicitud cross-origin.
`SERVER_TLS_CERT_FILE`	`—`	Ruta al certificado TLS cuando el servicio termina el TLS por sí mismo. Configúrala junto con el archivo de la clave.
`SERVER_TLS_KEY_FILE`	`—`	Ruta a la clave privada TLS. Configúrala junto con el archivo del certificado.
`TLS_TERMINATED_UPSTREAM`	`false`	Marca la ruta de la solicitud como terminada en TLS por un proxy delante del servicio.
`TRUSTED_PROXIES`	Obligatorio en producción	Rangos CIDR separados por comas de los proxies de capa 7 cuyo header `X-Forwarded-For` respeta el servicio. Un arranque en producción rechaza una lista vacía y rechaza un rango comodín.

PostgreSQL

Variable	Predeterminado / Obligatorio	Descripción
`POSTGRES_HOST`	`—`	Host de la base de datos primaria. La identidad de la conexión no lleva valores predeterminados, por lo que un bloque incompleto hace fallar la conexión en el arranque.
`POSTGRES_PORT`	`—`	Puerto de la base de datos primaria.
`POSTGRES_USER`	`—`	Usuario de la base de datos primaria.
`POSTGRES_PASSWORD`	Obligatorio en producción	Contraseña de la base de datos primaria. `Sensitive.`
`POSTGRES_NAME`	`—`	Nombre de la base de datos primaria.
`POSTGRES_SSLMODE`	Obligatorio	Modo TLS de la base de datos primaria. Un arranque en producción rechaza el valor `disable`.
`POSTGRES_REPLICA_HOST`	`—`	Host de la réplica de lectura para escalar las consultas. Los demás campos de la réplica toman el valor de la primaria cuando no están definidos.
`POSTGRES_REPLICA_PORT`	`—`	Puerto de la réplica de lectura.
`POSTGRES_REPLICA_USER`	`—`	Usuario de la réplica de lectura.
`POSTGRES_REPLICA_PASSWORD`	`—`	Contraseña de la réplica de lectura. `Sensitive.`
`POSTGRES_REPLICA_NAME`	`—`	Nombre de la base de datos de la réplica de lectura.
`POSTGRES_REPLICA_SSLMODE`	`—`	Modo TLS de la réplica de lectura. Un arranque en producción rechaza el valor `disable`.
`POSTGRES_MAX_OPEN_CONNS`	`25`	Máximo de conexiones abiertas por pool.
`POSTGRES_MAX_IDLE_CONNS`	`—`	Máximo de conexiones inactivas por pool. El servicio no aplica ningún valor predeterminado aquí.
`POSTGRES_CONN_MAX_LIFETIME_MINS`	`30`	Vida máxima de la conexión, en minutos.
`POSTGRES_CONN_MAX_IDLE_TIME_MINS`	`5`	Tiempo máximo de inactividad de la conexión, en minutos.
`POSTGRES_CONNECT_TIMEOUT_SEC`	`—`	Tiempo de espera de conexión, en segundos.
`POSTGRES_POOL_FANOUT_ACK`	`—`	Consentimiento del operador para superar el fan-out seguro de conexiones entre los pools de conexión. Acepta `true`, `1`, `yes` u `on`. Sin él, el arranque rechaza un fan-out excesivo.

Redis

Variable	Predeterminado / Obligatorio	Descripción
`REDIS_HOST`	`localhost:6379`	Dirección de Redis como `host:port`. Un valor no vacío también activa el control de la postura TLS en modo `saas`.
`REDIS_MASTER_NAME`	`—`	Nombre del master de Sentinel cuando el despliegue usa Redis Sentinel.
`REDIS_PASSWORD`	`—`	Contraseña de Redis. `Sensitive.`
`REDIS_DB`	`0`	Número de base de datos lógica de Redis.
`REDIS_PROTOCOL`	`3`	Versión del protocolo de red de Redis.
`REDIS_TLS`	`false`	Activa TLS para el cliente de Redis.
`REDIS_CA_CERT`	`—`	Autoridad certificadora en PEM codificado en Base64 para el handshake de Redis. El cliente solo la lee cuando `REDIS_TLS=true`.
`REDIS_POOL_SIZE`	`10`	Tamaño máximo del pool de Redis. El cliente limita un valor superior a 1000.
`REDIS_MIN_IDLE_CONNS`	`—`	Mínimo de conexiones inactivas de Redis mantenidas activas. El cliente no precalienta ninguna de forma predeterminada.
`REDIS_READ_TIMEOUT`	`3`	Tiempo de espera de lectura de Redis, en segundos.
`REDIS_WRITE_TIMEOUT`	`3`	Tiempo de espera de escritura de Redis, en segundos.
`REDIS_DIAL_TIMEOUT`	`5`	Tiempo de espera de conexión de Redis, en segundos.
`REDIS_POOL_TIMEOUT`	`2`	Tiempo de espera para obtener una conexión del pool de Redis, en segundos.
`REDIS_MAX_RETRIES`	`3`	Presupuesto de reintentos de comandos de Redis.
`REDIS_MIN_RETRY_BACKOFF`	`8`	Backoff mínimo de reintento de Redis, en milisegundos.
`REDIS_MAX_RETRY_BACKOFF`	`1`	Backoff máximo de reintento de Redis, en segundos.

Mensajería y circuit breaker

Variable	Predeterminado / Obligatorio	Descripción
`CIRCUIT_BREAKER_ENABLED`	`false` (Obligatorio como `true`)	Conecta el gestor de circuit breaker. Tanto la integración con Reporter como los adaptadores de almacenamiento de objetos lo necesitan, por lo que el arranque rechaza un valor de `false`.
`RABBITMQ_ENABLED`	`false`	Activa el cableado del message broker.
`RABBITMQ_URL`	`—`	URL completa de conexión al broker. `Sensitive.` Configura esta variable o el host, porque el arranque rechaza que ambas estén vacías cuando el broker está activado.
`RABBITMQ_HOST`	`—`	Host del broker.
`RABBITMQ_PORT_AMQP`	`—`	Puerto de mensajes del broker.
`RABBITMQ_DEFAULT_USER`	`—`	Usuario del broker.
`RABBITMQ_DEFAULT_PASS`	`—`	Contraseña del broker. `Sensitive.`
`RABBITMQ_VHOST`	`—`	Host virtual del broker.
`RABBITMQ_QUEUE`	`—`	Nombre de la cola predeterminada.
`RABBITMQ_EXCHANGE`	Obligatorio con el broker activo	Exchange de los eventos de negocio. El servicio lo declara en el broker, que rechaza un nombre vacío.
`RABBITMQ_HEALTH_CHECK_URL`	`—`	Endpoint HTTP que llama el probe de readiness para comprobar el broker.
`RABBITMQ_HEALTH_CHECK_ALLOWED_HOSTS`	`—`	Lista de permitidos, separada por comas, de los hosts que puede apuntar el probe de salud.
`RABBITMQ_REQUIRE_HEALTH_ALLOWED_HOSTS`	`false`	Obliga a que la lista de permitidos del probe de salud no esté vacía.
`RABBITMQ_ALLOW_INSECURE_HEALTH_CHECK`	`false`	`true` permite que el health check del broker envíe las credenciales del broker a un `RABBITMQ_HEALTH_CHECK_URL` `http://`, y limita el check solo por `RABBITMQ_HEALTH_CHECK_ALLOWED_HOSTS`. Un arranque en producción rechaza `true`.
`RABBITMQ_PUBLISHER_CONFIRM_TIMEOUT_MS`	`5000`	Tiempo de espera de confirmación del publisher, en milisegundos.
`RABBITMQ_PUBLISHER_RECOVERY_INITIAL_MS`	`1000`	Primer backoff de recuperación del publisher, en milisegundos.
`RABBITMQ_PUBLISHER_RECOVERY_MAX_MS`	`30000`	Backoff máximo de recuperación del publisher, en milisegundos.
`RABBITMQ_PUBLISHER_MAX_RECOVERIES`	`10`	Máximo de intentos de recuperación del publisher antes de que se rinda.
`CCS_CONSUMER_MAX_REDELIVERIES`	`5`	Máximo de ciclos de reintento que puede tomar un mensaje con fallo transitorio antes de que el consumidor lo mueva a la dead-letter queue terminal.

Outbox

Lerian CCS escribe el trabajo saliente en un outbox transaccional, dentro de la misma transacción de base de datos que el cambio de estado. La familia OUTBOX_ de abajo configura el dispatcher que ejecuta la librería de plataforma compartida.

Variable	Predeterminado / Obligatorio	Descripción
`OUTBOX_ENABLED`	`false` (Obligatorio como `true`)	Activa el worker del outbox. La integración con Reporter lo necesita, así que el arranque rechaza `false`.
`OUTBOX_TABLE_NAME`	`—`	Nombre de la tabla del outbox. El arranque rechaza un valor vacío cuando el outbox está activado.
`OUTBOX_DISPATCH_INTERVAL_SEC`	`2`	Intervalo en segundos entre ciclos de despacho.
`OUTBOX_BATCH_SIZE`	`50`	Máximo de eventos drenados por ciclo de despacho.
`OUTBOX_PUBLISH_MAX_ATTEMPTS`	`3`	Máximo de intentos de publicación por evento dentro de un ciclo.
`OUTBOX_PUBLISH_BACKOFF_MS`	`200`	Backoff de reintento de publicación, en milisegundos.
`OUTBOX_RETRY_WINDOW_SEC`	`300`	Antigüedad mínima en segundos antes de que un evento fallido pueda reintentarse.
`OUTBOX_MAX_DISPATCH_ATTEMPTS`	`10`	Máximo de intentos de despacho por evento antes de que el dispatcher deje de reintentarlo.
`OUTBOX_PROCESSING_TIMEOUT_SEC`	`600`	Tiempo de espera en segundos tras el cual el dispatcher recupera un evento atascado.
`OUTBOX_MAX_FAILED_PER_BATCH`	`25`	Máximo de eventos fallidos que el dispatcher recupera para un reintento en un ciclo.
`OUTBOX_INCLUDE_TENANT_METRICS`	`false`	Agrega etiquetas por tenant a las métricas del outbox.
`OUTBOX_PRIORITY_EVENT_TYPES`	`—`	Tipos de evento separados por comas que el dispatcher envía primero.
`OUTBOX_ALLOW_EMPTY_TENANT`	`false`	Acepta un evento sin contexto de tenant.

Anulaciones del outbox de CCS

Variable	Predeterminado / Obligatorio	Descripción
`CCS_OUTBOX_OVERRIDES_ENABLED`	`false`	Aplica las tres anulaciones de abajo. Mientras es `false`, el servicio las ignora.
`CCS_OUTBOX_DISPATCH_INTERVAL_MS`	`1000`	Intervalo de despacho en milisegundos. Tiene precedencia sobre el intervalo basado en segundos, lo que preserva la precisión de menos de un segundo.
`CCS_OUTBOX_BATCH_SIZE`	`50`	Máximo de eventos que procesan los handlers registrados por ciclo.
`CCS_OUTBOX_MAX_ATTEMPTS`	`10`	Máximo de intentos de despacho antes de que el dispatcher marque un evento como no entregable de forma permanente.

Streaming

La librería de streaming de Lerian lee la familia STREAMING_, no la configuración del servicio. Lerian Streaming Hub entrega los eventos publicados.

Variable	Predeterminado / Obligatorio	Descripción
`STREAMING_ENABLED`	`false`	Interruptor maestro para la emisión de eventos de negocio. Mientras está desactivado, el servicio conecta un emisor sin operación y no publica nada. También necesita `OUTBOX_ENABLED=true`.
`STREAMING_BROKERS`	Obligatorio cuando el streaming está habilitado	Lista de arranque de brokers separada por comas. Una configuración habilitada con una lista vacía rechaza el arranque.
`STREAMING_CLOUDEVENTS_SOURCE`	Fijo	Fuente de CloudEvents de este servicio. Define el espacio de nombres del topic y el prefijo del tipo de evento. Déjala sin configurar. Cualquier valor distinto de la fuente integrada rechaza el arranque, incluso cuando el streaming está desactivado.
`STREAMING_CLIENT_ID`	El nombre de destino del servicio	Identificador de cliente del broker usado para diagnósticos del lado del broker.
`STREAMING_CB_FAILURE_RATIO`	`0.5`	Relación de fallos que abre el circuit breaker del productor.
`STREAMING_CB_MIN_REQUESTS`	`10`	Mínimo de solicitudes antes de que el circuit breaker del productor evalúe la relación de fallos.
`STREAMING_CB_TIMEOUT_S`	`30`	Tiempo de enfriamiento en estado abierto, en segundos, para el circuit breaker del productor.
`STREAMING_CLOSE_TIMEOUT_S`	`30`	Ventana máxima de drenaje y vaciado, en segundos, cuando el productor se cierra.
`STREAMING_TLS_ENABLED`	`false` (Obligatorio como `true` en `saas`)	Activa TLS para la conexión al broker. La versión mínima es TLS 1.2. En modo `saas`, una conexión al broker en texto claro rechaza el arranque.
`STREAMING_TLS_CA_CERT`	`—`	Autoridad certificadora PEM codificada en base64 para un broker privado o on-premises. Un valor vacío usa el almacén de confianza del host. Un valor malformado rechaza el arranque.
`STREAMING_SASL_MECHANISM`	`—`	Mecanismo de autenticación del broker: `PLAIN`, `SCRAM-SHA-256` o `SCRAM-SHA-512`. Un valor vacío desactiva la autenticación del broker. Un mecanismo sin sus credenciales rechaza el arranque.
`STREAMING_SASL_USERNAME`	`—`	Usuario de autenticación del broker.
`STREAMING_SASL_PASSWORD`	`—`	Contraseña de autenticación del broker. `Sensitive.`
`STREAMING_SASL_ALLOW_PLAINTEXT`	`false`	Permite la autenticación del broker sobre una conexión en texto claro, lo que envía las credenciales sin cifrar. El servicio rechaza esa combinación a menos que configures este flag.

Integración con STA

Lerian CCS envía cada archivo saliente a BACEN a través de Lerian STA y recibe de vuelta las respuestas.

Variable	Predeterminado / Obligatorio	Descripción
`STA_ENABLED`	`false`	Conecta el cliente de STA, el handler de envío y el probe de readiness de STA. También necesita `STA_BASE_URL`, `CIRCUIT_BREAKER_ENABLED=true` y `OUTBOX_ENABLED=true`.
`STA_BASE_URL`	Obligatorio cuando STA está habilitado	URL base del servicio STA. Un valor vacío rechaza el arranque.
`STA_HTTP_TIMEOUT_SEC`	`30`	Tiempo de espera por solicitud, en segundos, en el cliente de STA. El servicio recurre a 30 segundos para un valor de cero o menor.
`STA_FILE_HASH_VERIFY_ENABLED`	`false`	Verifica el digest SHA-256 de un archivo entrante descargado contra el digest del evento del archivo.
`STA_EVENT_HMAC_VERIFY_ENABLED`	`false`	Autentica los eventos de negocio entrantes de STA contra el esquema de firma compartido. Un arranque con la verificación activada y un catálogo de claves incompleto falla de forma explícita.
`STA_EVENT_HMAC_MASTER_KEYS`	`—`	Catálogo de claves maestras `version:hex` compartidas con el servicio STA. `Sensitive.`
`STA_EVENT_HMAC_MASTER_KEY_VERSION`	`—`	Versión del catálogo que el verificador trata como activa.
`STA_EVENT_HMAC_TOLERANCE_SECONDS`	`300`	Ventana en segundos fuera de la cual un evento auténtico se registra en el log como tardío o adelantado.

Integración con Reporter

Lerian Reporter renderiza el archivo diario ACCS001, por lo que es un upstream obligatorio. El probe de readiness lo trata como una dependencia obligatoria. Inicia Lerian Reporter antes de esperar que Lerian CCS quede listo.

Variable	Predeterminado / Obligatorio	Descripción
`REPORTER_URL`	Obligatorio	URL base del servicio Reporter. Un valor vacío rechaza el arranque.
`REPORTER_HTTP_TIMEOUT_SEC`	`30`	Tiempo de espera por solicitud, en segundos, en el cliente de Reporter. El servicio recurre a 30 segundos para un valor de cero o menor.
`REPORTER_TEMPLATE_ID_ACCS001`	`—`	Identificador de la plantilla de Reporter a la que apunta el render de ACCS001. Reporter acuña este identificador por entorno cuando registras la plantilla. Un identificador vacío junto con un nombre de plantilla vacío rechaza la aprobación del lote con el error `MYS-0008` y HTTP 503.
`REPORTER_TEMPLATE_NAME_ACCS001`	`—`	Descripción de la plantilla ACCS001 en Reporter. El servicio resuelve la plantilla por esta descripción cuando dejas el identificador sin configurar.
`DETAIL_RENDER_MODE`	`inline`	Ruta de render para una respuesta de detalle. Solo `inline` inicia el servicio. Cualquier otro valor rechaza el arranque.
`CCS_REPORTER_POLL_INITIAL_DELAY_MS`	`2000`	Primer retraso de backoff, en milisegundos, en el ciclo de sondeo del render.
`CCS_REPORTER_POLL_MAX_DELAY_MS`	`30000`	Retraso máximo de backoff, en milisegundos, en el ciclo de sondeo del render.
`CCS_REPORTER_POLL_TOTAL_TIMEOUT_SEC`	`1800`	Presupuesto total de sondeo, en segundos. Un render más antiguo que este presupuesto termina en tiempo de espera agotado.
`CCS_REPORTER_POLL_BACKOFF_MULTIPLIER`	`2.0`	Multiplicador aplicado al retraso después de cada sondeo. El arranque rechaza un valor menor que `1.0`.

Autenticación

Variable	Predeterminado / Obligatorio	Descripción
`PLUGIN_AUTH_ENABLED`	Obligatorio: `true` o `false`. Un valor vacío u otro valor detiene el arranque. Un `ENV_NAME` de desarrollo es `development`, `develop`, `dev`, `local` o `test`	`true` envía cada solicitud `/v1` protegida a Lerian Access Manager para una decisión. `false` omite esa llamada; un bearer token que nombra un principal sigue siendo obligatorio. Solo un `ENV_NAME` de desarrollo fuera de `saas` acepta `false`. El valor también decide si el servicio acuña tokens salientes.
`PLUGIN_AUTH_HOST`	Obligatorio cuando la autenticación está habilitada	URL base de Lerian Access Manager.
`AUTH_JWT_VERIFY_CERT`	`—`	Una o más claves públicas RSA o certificados X.509 en PEM, separados por saltos de línea. Con un certificado cargado, el servicio verifica la firma RS256 y la expiración de cada bearer token antes de llamar a Access Manager, y responde 401 cuando la verificación falla. Tiene precedencia sobre `AUTH_JWT_VERIFY_CERT_PATH`. Solo tiene efecto con `PLUGIN_AUTH_ENABLED=true`.
`AUTH_JWT_VERIFY_CERT_PATH`	`—`	Ruta de un archivo con el mismo contenido. El servicio lo lee solo cuando `AUTH_JWT_VERIFY_CERT` está vacía.
`AUTH_JWT_ISSUER`	`—`	Con un certificado cargado, el servicio responde 401 a todo token cuyo claim `iss` difiere de este valor.

Credenciales máquina a máquina

Lerian CCS acuña un token saliente por upstream a través de Lerian Access Manager. Cada upstream lleva su propio par de credenciales.

Variable	Predeterminado / Obligatorio	Descripción
`REPORTER_CLIENT_ID`	Obligatorio cuando la autenticación está habilitada fuera de `saas`	Identificador de cliente para el upstream de Reporter.
`REPORTER_CLIENT_SECRET`	Obligatorio cuando la autenticación está habilitada fuera de `saas`	Secreto de cliente para el upstream de Reporter. `Sensitive.`
`STA_CLIENT_ID`	Obligatorio cuando la autenticación está habilitada fuera de `saas`	Identificador de cliente para el upstream de STA.
`STA_CLIENT_SECRET`	Obligatorio cuando la autenticación está habilitada fuera de `saas`	Secreto de cliente para el upstream de STA. `Sensitive.`
`REPORTER_M2M_TARGET_SERVICE`	`—`	Etiqueta de métricas para el upstream de Reporter. Un valor vacío recurre al nombre canónico del upstream.
`STA_M2M_TARGET_SERVICE`	`—`	Etiqueta de métricas para el upstream de STA. Un valor vacío recurre al nombre canónico del upstream.

Cifrado e idempotencia

Variable	Predeterminado / Obligatorio	Descripción
`CCS_CRYPTO_MASTER_KEY`	Obligatorio	Clave maestra AES-256 de 32 bytes codificada en hexadecimal que cifra los valores de documento que el servicio mantiene cifrados. `Sensitive.` El arranque falla cuando el valor está ausente, es más corto o más largo que 64 caracteres hexadecimales, o no es hexadecimal.
`IDEMPOTENCY_KEY_PREFIX`	`idempotency:`	Prefijo base de cada clave de caché de idempotencia.
`IDEMPOTENCY_KEY_TTL_HRS`	`168`	Ventana de retención en horas para una respuesta en caché.

Documentación de la API

Variable	Predeterminado / Obligatorio	Descripción
`SWAGGER_ENABLED`	`false`	Monta la ruta interactiva de documentación de la API. Producción la mantiene desactivada.
`SWAGGER_TITLE`	Nombre del servicio	Título mostrado en la especificación de la API.
`SWAGGER_DESCRIPTION`	`—`	Descripción mostrada en la especificación de la API.
`SWAGGER_VERSION`	`1.0.0`	Etiqueta de versión de la API mostrada en la especificación.
`SWAGGER_HOST`	`—`	Anulación de host para la especificación de la API.
`SWAGGER_SCHEMES`	`https`	Esquemas de URL separados por comas que acepta la especificación.

Telemetría y métricas

Variable	Predeterminado / Obligatorio	Descripción
`ENABLE_TELEMETRY`	`false`	Conecta el exportador de OpenTelemetry. Consulta Observabilidad para la vista de plataforma.
`OTEL_LIBRARY_NAME`	`—`	Nombre de la librería de instrumentación.
`OTEL_RESOURCE_SERVICE_NAME`	Nombre del servicio	Atributo de recurso del nombre del servicio.
`OTEL_RESOURCE_DEPLOYMENT_ENVIRONMENT`	`—`	Atributo de recurso del entorno de despliegue.
`OTEL_EXPORTER_OTLP_ENDPOINT`	`—`	Dirección del collector para el exportador de OpenTelemetry.

Rate limits

Lerian CCS aplica tres niveles de rate limit a las rutas /v1: el nivel predeterminado, el nivel agresivo en las solicitudes de escritura y el nivel de exportación en las lecturas pesadas como las consultas de auditoría.

Variable	Predeterminado / Obligatorio	Descripción
`RATE_LIMIT_ENABLED`	`false`	Activa el subsistema de rate limit. Producción lo fuerza a `true`.
`RATE_LIMIT_MAX`	`500`	Techo de solicitudes por ventana del nivel predeterminado.
`RATE_LIMIT_WINDOW_SEC`	`60`	Ventana en segundos del nivel predeterminado.
`AGGRESSIVE_RATE_LIMIT_MAX`	`100`	Techo de solicitudes por ventana del nivel agresivo.
`AGGRESSIVE_RATE_LIMIT_WINDOW_SEC`	`60`	Ventana en segundos del nivel agresivo.
`EXPORT_RATE_LIMIT_MAX`	`60`	Techo de solicitudes por ventana del nivel de exportación.
`EXPORT_RATE_LIMIT_WINDOW_SEC`	`60`	Ventana en segundos del nivel de exportación.

Endpoints de salud

Lerian CCS expone GET /health para liveness y GET /readyz para readiness en el puerto principal, además de GET /version y GET /metrics. Consulta Salud y readiness para el contrato del probe y Operar Lerian CCS para la lista de probes.

Almacenamiento de objetos

Lerian CCS lee los archivos entrantes de un bucket y escribe los archivos salientes en otro. Ambos aceptan cualquier almacén compatible con S3. Un nombre de bucket vacío marca la comprobación de readiness correspondiente como omitida.

Variable	Predeterminado / Obligatorio	Descripción
`OBJECT_STORAGE_STA_ENDPOINT`	`—`	Endpoint del bucket entrante. Un valor vacío selecciona el endpoint predeterminado de la nube.
`OBJECT_STORAGE_STA_REGION`	`us-east-1`	Región del bucket entrante.
`OBJECT_STORAGE_STA_BUCKET`	`—`	Nombre del bucket entrante de solo lectura.
`OBJECT_STORAGE_STA_ACCESS_KEY`	`—`	Clave de acceso para el bucket entrante. `Sensitive.` Déjala sin configurar cuando un rol de nube adjunto proporcione las credenciales.
`OBJECT_STORAGE_STA_SECRET_KEY`	`—`	Clave secreta para el bucket entrante. `Sensitive.`
`OBJECT_STORAGE_STA_USE_PATH_STYLE`	`false`	Usa direccionamiento de estilo de ruta en el bucket entrante.
`OBJECT_STORAGE_STA_DISABLE_SSL`	`false`	Desactiva TLS en la conexión del bucket entrante.
`OBJECT_STORAGE_STA_MAX_OBJECT_BYTES`	`536870912`	Tamaño máximo de un objeto entrante, en bytes.
`OBJECT_STORAGE_STA_SSE_ALGORITHM`	Obligatorio cuando el bucket entrante está configurado	Cifrado en reposo del bucket entrante: `AES256`, `aws:kms` o `none`. Un valor vacío u otro valor detiene el arranque. `none` solo arranca con un `ENV_NAME` de desarrollo fuera de `saas`.
`OBJECT_STORAGE_STA_SSE_KMS_KEY_ID`	Obligatorio con `aws:kms`	Identificador de la clave de `aws:kms` en el bucket entrante.
`OBJECT_STORAGE_CCS_ENDPOINT`	`—`	Endpoint del bucket saliente. Un valor vacío selecciona el endpoint predeterminado de la nube.
`OBJECT_STORAGE_CCS_REGION`	`us-east-1`	Región del bucket saliente.
`OBJECT_STORAGE_CCS_BUCKET`	`—`	Nombre del bucket saliente que contiene los archivos regulatorios renderizados.
`OBJECT_STORAGE_CCS_ACCESS_KEY`	`—`	Clave de acceso para el bucket saliente. `Sensitive.` Déjala sin configurar cuando un rol de nube adjunto proporcione las credenciales.
`OBJECT_STORAGE_CCS_SECRET_KEY`	`—`	Clave secreta para el bucket saliente. `Sensitive.`
`OBJECT_STORAGE_CCS_USE_PATH_STYLE`	`false`	Usa direccionamiento de estilo de ruta en el bucket saliente.
`OBJECT_STORAGE_CCS_DISABLE_SSL`	`false`	Desactiva TLS en la conexión del bucket saliente.
`OBJECT_STORAGE_CCS_SSE_ALGORITHM`	Obligatorio cuando el bucket saliente está configurado	Cifrado en reposo del bucket saliente: `AES256`, `aws:kms` o `none`. Un valor vacío u otro valor detiene el arranque. `none` solo arranca con un `ENV_NAME` de desarrollo fuera de `saas`.
`OBJECT_STORAGE_CCS_SSE_KMS_KEY_ID`	Obligatorio con `aws:kms`	Identificador de la clave de `aws:kms` en el bucket saliente.

Retención y ajustes regulatorios

Variable	Predeterminado / Obligatorio	Descripción
`CCS_OUTBOUND_RETENTION_DAYS`	`30`	Vida útil en días de un archivo saliente subido al bucket. El servicio aplica 30 días para un valor de cero o menor.
`CCS_ACCS009_RETENTION_DAYS`	`30`	Vida útil en días de un informe de penalidad ACCS009 almacenado.
`CCS_NON_SUBMISSION_SCAN_INTERVAL_SEC`	`3600`	Intervalo en segundos entre los escaneos de no envío. El arranque rechaza un valor de cero o menor y un valor superior a 86400.
`CCS_BACEN_DESTINATARIO_CNPJ_BASE`	`00000000`	Destinatario BACEN de ocho dígitos estampado en el envelope del archivo. Configura el valor real antes de salir a producción.
`CCS_ACCS010_DTFIM_MODE`	`transfer_date`	Regla que resuelve la fecha de fin obligatoria en una transferencia de relación.

Integrar con Lerian CCS cubre la superficie de la API, los códigos de error y los eventos publicados.

​Servicio y runtime

​Licencia

​CORS, TLS y proxies

​PostgreSQL

​Redis

​Mensajería y circuit breaker

​Outbox

​Anulaciones del outbox de CCS

​Streaming

​Integración con STA

​Integración con Reporter

​Autenticación

​Credenciales máquina a máquina

​Cifrado e idempotencia

​Documentación de la API

​Telemetría y métricas

​Rate limits

​Endpoints de salud

​Almacenamiento de objetos

​Retención y ajustes regulatorios

Servicio y runtime

Licencia

CORS, TLS y proxies

PostgreSQL

Redis

Mensajería y circuit breaker

Outbox

Anulaciones del outbox de CCS

Streaming

Integración con STA

Integración con Reporter

Autenticación

Credenciales máquina a máquina

Cifrado e idempotencia

Documentación de la API

Telemetría y métricas

Rate limits

Endpoints de salud

Almacenamiento de objetos

Retención y ajustes regulatorios