Aller au contenu
Krizaka Java
Skip to Content
Krizaka Java

Référence de configuration

Chaque propriété krizaka.* de Krizaka Java, avec son type, son défaut et sa description — générée depuis les métadonnées de configuration.

Chaque propriété ci-dessous est dans les métadonnées que génère le processeur de configuration de Spring Boot : ton IDE la complète dans application.yml avec la même description et le même défaut. Cette page est générée depuis ces métadonnées — jamais tapée : chaque dépôt garde docs/configuration-metadata.json égal à elles par un test (ConfigurationReferenceTest) qui échoue aussi sur une propriété sans description ou sans défaut.

Une propriété marquée « pas de défaut » n'en a pas exprès : une valeur que seul ton service connaît (son secret, ses noms), ou un choix que le kit refuse de faire à ta place (où dédupliquer les messages, quelles origines peuvent appeler). Les modules qui en ont besoin le disent au démarrage, avec le nom de la propriété.

krizaka:
  observability: { product: acme, service: orders, version: "@project.version@" }
  security.jwt.secret: ${KRIZAKA_JWT_SECRET}
  messaging:
    producer: orders
    dedup.store: jdbc
  idempotency.store: jdbc

krizaka-web · krizaka-service-kit

PropriétéDescription
krizaka.web.cors.allowed-originsList<String>pas de défautExact browser origins (scheme, host, port) allowed to call the service. Empty, the default, allows none and registers no CORS policy; '*' is refused.
krizaka.web.problems.base-typeURIdéfaut https://krizaka.com/problems/Prefix every Problem Details 'type' is resolved against: the type is this base followed by the problem's code. Absolute, ending with '/'.

krizaka-security · krizaka-service-kit

PropriétéDescription
krizaka.security.jwt.audienceStringdéfaut Optional with 'jwk-set-uri': when set, the 'aud' that must be present; empty by default.
krizaka.security.jwt.callersMap<String,String>pas de défautOptional: the public key (SPKI PEM, P-256) of each calling service by the name it puts in 'sub'. A token signed by one of these keys, carrying exactly the SERVICE role, is accepted beside the sessions; a caller cannot speak for another, an unknown name is refused.
krizaka.security.jwt.hs256-cutoffInstantpas de défautOptional, with 'secret': from this instant the shared secret verifies nothing (ISO-8601). Empty keeps it open until the secret is removed.
krizaka.security.jwt.issuerStringdéfaut Required with 'jwk-set-uri': the only 'iss' accepted; empty by default.
krizaka.security.jwt.jwk-set-uriStringdéfaut The issuer's JWKS endpoint ('/.well-known/jwks.json'); empty by default, which leaves this mode off. Only ES256 tokens are accepted in this mode; keys are matched by 'kid', and an unknown 'kid' triggers a (rate limited) refresh so rotation needs no restart.
krizaka.security.jwt.secretStringpas de défautLegacy shared HMAC-SHA256 secret, at least 32 characters (256 bits). Whoever can verify with it can also mint.

krizaka-observability · krizaka-service-kit

PropriétéDescription
krizaka.observability.environmentStringpas de défautName of the deployment environment, e.g. 'dev' (environment variable OBSERVABILITY_ENVIRONMENT), exported as the resource attribute deployment.environment.name. Optional.
krizaka.observability.ingest-tokenStringpas de défautToken sent as a bearer Authorization header to the receiver (environment variable OBSERVABILITY_INGEST_TOKEN). Optional; never printed by toString.
krizaka.observability.otlp-endpointStringpas de défautBase URL of the OTLP receiver (environment variable OBSERVABILITY_OTLP_ENDPOINT). Optional: with none, traces and metrics are not exported at all. Traces go to the endpoint's /v1/traces, metrics to its /v1/metrics.
krizaka.observability.productStringpas de défautProduct the service belongs to, e.g. 'sovkora'. Required: tagged on every meter.
krizaka.observability.serviceStringpas de défautShort name of the service within its product, e.g. 'conversation'. Required: tagged on every meter.
krizaka.observability.versionStringpas de défautVersion of the running build, usually filtered in by the build ('@project.version@'). Required: tagged on every meter.

krizaka-messaging · krizaka-service-kit

PropriétéDescription
krizaka.messaging.consumer.enabledBooleandéfaut trueWhether krizaka-messaging contributes the JSON message converter and the listener container factory (retry with back-off, then <queue>.dlq).
krizaka.messaging.dedup.purge-intervalDurationdéfaut 1hDelay between two purges of the claims older than the retention.
krizaka.messaging.dedup.retentionDurationdéfaut 7dHow long a claim is kept; beyond the broker's longest redelivery window, a claim protects nothing.
krizaka.messaging.dedup.storeStorepas de défautWhere claims are kept: 'jdbc' (durable, shared by the instances) or 'memory' (one instance). Required to get a MessageDedup bean; never inferred from the classpath.jdbcmemory
krizaka.messaging.dedup.tableStringdéfaut processed_messagesTable the claims are kept in when the store is 'jdbc'.
krizaka.messaging.exchanges.dead-letterStringdéfaut krizaka.dlxDirect exchange failed messages are dead-lettered to; must differ from the events exchange.
krizaka.messaging.exchanges.eventsStringdéfaut krizaka.eventsTopic exchange domain events are published to.
krizaka.messaging.outbox.batch-sizeIntegerdéfaut 100Most rows one batch claims and publishes.
krizaka.messaging.outbox.enabledBooleandéfaut trueWhether a relay is scheduled for each OutboxStore bean.
krizaka.messaging.outbox.failure-thresholdIntegerdéfaut 10Consecutive failures (batches that threw, publishes that failed) after which the outbox health indicator reports DOWN; reset by the next success.
krizaka.messaging.outbox.jdbc.enabledBooleandéfaut falseWhether the kit contributes JdbcOutboxStore, its PostgreSQL outbox, instead of a store the application writes. Off by default: a service that has its own keeps it.
krizaka.messaging.outbox.jdbc.max-backoffDurationdéfaut 15mLongest wait before a row whose publish failed is tried again; the waits double from one second up to it.
krizaka.messaging.outbox.jdbc.tableStringdéfaut krizaka_outboxTable of the outbox (schema com/krizaka/messaging/outbox/schema-postgresql.sql).
krizaka.messaging.outbox.leaseDurationdéfaut 2mHow long a row claimed by a leasing store stays invisible to the other relays. Keep it longer than a batch takes to publish, or two relays publish the same row.
krizaka.messaging.outbox.poll-intervalDurationdéfaut 500msDelay between two batches of pending rows.
krizaka.messaging.outbox.purge-intervalDurationdéfaut 1hDelay between two purges of published rows.
krizaka.messaging.outbox.retentionDurationdéfaut 7dHow long published rows are kept before the purge deletes them.
krizaka.messaging.producerStringpas de défautName of this service, stamped on every event it publishes (kz-producer). Required as soon as an EventPublisher is injected; never guessed from the application name.
krizaka.messaging.retry.initialDurationdéfaut 500msWait before the second attempt.
krizaka.messaging.retry.maxDurationdéfaut 10sLongest wait between two attempts, not shorter than the initial wait.
krizaka.messaging.retry.max-attemptsIntegerdéfaut 5How many times the listener runs before the message is dead-lettered, the first delivery included; at least 1.
krizaka.messaging.retry.multiplierDoubledéfaut 2Factor between two consecutive waits; at least 1.

krizaka-app-config · krizaka-service-kit

PropriétéDescription
krizaka.app-config.admin.authorityStringdéfaut ROLE_ADMINAuthority a caller must hold to use the admin API.
krizaka.app-config.admin.enabledBooleandéfaut falseWhether the audited admin API (/api/v1/admin/app-config) is registered.
krizaka.app-config.cache-ttlDurationdéfaut 30sHow long this instance reuses a parameter set it read.
krizaka.app-config.enabledBooleandéfaut trueWhether the app-config endpoint and the version filter are registered.
krizaka.app-config.guard.enabledBooleandéfaut trueWhether the 426 Upgrade Required filter is registered.
krizaka.app-config.guard.excludeList<String>défaut [/api/v1/app-config, /api/v1/admin/app-config/**]Ant patterns the filter never guards: the app-config endpoint itself, so an old client can always learn it must update.
krizaka.app-config.guard.includeList<String>défaut /api/**Ant patterns of the paths the filter guards.
krizaka.app-config.http-max-ageDurationdéfaut 60sMax-age of the public app-config endpoint, for CDNs and clients.
krizaka.app-config.storeStoredéfaut jdbcWhere the parameters are kept: 'jdbc' (the application's database) or 'memory' (tests and demos).jdbcmemory

krizaka-idempotency · krizaka-service-kit

PropriétéDescription
krizaka.idempotency.purge-intervalDurationdéfaut 1hDelay between two purges of the keys older than the time-to-live.
krizaka.idempotency.storeStorepas de défautWhere keys and their responses are kept: 'jdbc' (PostgreSQL, in the action's transaction, shared by every instance) or 'memory' (one instance). Required to get the Idempotency bean; never inferred from the classpath.jdbcmemory
krizaka.idempotency.tableStringdéfaut idempotency_keysTable the keys are kept in when the store is 'jdbc'.
krizaka.idempotency.ttlDurationdéfaut 24hHow long a key replays its response; after it, the same key runs the action again.

krizaka-persistence · krizaka-service-kit

PropriétéDescription
krizaka.persistence.migrations.enabledBooleandéfaut trueWhether the tables of the declared JDBC stores are created and migrated at startup. Turn it off when an operator runs the shipped schemas.
krizaka.persistence.migrations.history-tableStringdéfaut krizaka_schema_historyFlyway history table of the kit's migrations, kept apart from the service's own so their versions never meet.

krizaka-webhooks · krizaka-service-kit

PropriétéDescription
krizaka.webhooks.receiving.secretsList<String>pas de défautSecrets a received webhook may be signed with, the current one first. Setting one contributes the WebhookVerifier.
krizaka.webhooks.receiving.toleranceDurationdéfaut 5mHow far a webhook's timestamp may be from now, either way; an older capture replayed is refused.
krizaka.webhooks.signing.connect-timeoutDurationdéfaut 2sHow long an attempt waits for the receiver's connection.
krizaka.webhooks.signing.previous-secretStringpas de défautSecret being rotated out: during a rotation both sign, and receivers that still hold the old one keep accepting.
krizaka.webhooks.signing.read-timeoutDurationdéfaut 10sHow long an attempt waits for the receiver's answer.
krizaka.webhooks.signing.secretStringpas de défautSecret the webhooks this service sends are signed with ('whsec_' + base64, or plain text). Setting it contributes the WebhookSender.

krizaka-ratelimit · krizaka-service-kit

PropriétéDescription
krizaka.ratelimit.client-ip-headerStringdéfaut Header a trusted proxy sets to the client's address, read before X-Forwarded-For; blank for none.
krizaka.ratelimit.exclude-pathsList<String>défaut /actuator/**Ant patterns of the paths that never are (health checks, probes).
krizaka.ratelimit.include-pathsList<String>défaut /**Ant patterns of the paths that are limited.
krizaka.ratelimit.max-keysIntegerdéfaut 10000How many keys are tracked per instance before idle ones are forgotten; a busy key is never forgotten.
krizaka.ratelimit.modeRateLimitModedéfaut enforceHow the limit is applied: 'enforce' answers 429 once a key's bucket is empty, 'observe' counts and flags but never refuses (roll the limit out with it), 'off' keeps nothing.
krizaka.ratelimit.requests-per-minuteIntegerdéfaut 600Requests per minute a key may make, for a key that brings no limit of its own. A bucket holds one minute's worth, so a client may burst up to it.
krizaka.ratelimit.trusted-proxiesList<String>pas de défautAddresses or CIDR ranges of the proxies in front of the service. Only behind one is the forwarded address of a request trusted as its client; empty, the direct peer is always the client.

krizaka-users-client · krizaka-users

PropriétéDescription
krizaka.users.client.base-urlStringpas de défautBase URL of the users service, e.g. 'http://localhost:8083'. Setting it switches the client on.
krizaka.users.client.cache-ttlDurationdéfaut 60sHow long a user, profile or tier is reused before it is fetched again.
krizaka.users.client.service-keyStringpas de défautThis caller's own P-256 private key (PKCS#8 PEM, from its environment, never committed): the SERVICE token of every call is signed ES256 with it (ADR-001), and the users service holds only the public half. Preferred.
krizaka.users.client.service-key-idStringpas de défautThe kid of serviceKey. Required with it.
krizaka.users.client.service-nameStringpas de défautWho is calling: the subject of the SERVICE token, visible in the users service's logs. Required.
krizaka.users.client.service-secretStringpas de défautLegacy shared HS256 secret, accepted only until the users service's dated cutover. Exactly one of serviceKey and serviceSecret is required.

krizaka-billing-client · krizaka-billing

PropriétéDescription
krizaka.billing.base-urlStringdéfaut http://localhost:8095Internal base URL of the billing service.
krizaka.billing.connect-timeoutDurationdéfaut 500msHow long a call waits for the connection; tight, billing sits on the interactive path.
krizaka.billing.enabledBooleandéfaut falseWhether the HTTP adapters are wired instead of the no-op ones. Off by default: a fresh clone runs the whole stack without billing.
krizaka.billing.read-timeoutDurationdéfaut 2sHow long a call waits for the response; tight, a slow billing service must degrade through the fail modes rather than hold a request open.
krizaka.billing.service-secretStringpas de défautShared HS256 identity secret the SERVICE token of every call is signed with, which /internal/v1/** requires. Required when billing is enabled.