Skip to the content
Krizaka Java
Skip to Content
Krizaka Java

Configuration reference

Every krizaka.* property of Krizaka Java, with its type, default and description — generated from the configuration metadata.

Every property below is in the metadata Spring Boot's configuration processor generates, so your IDE completes it in application.yml with the same description and default. This page is generated from that metadata — never typed: each repository holds docs/configuration-metadata.json equal to it with a test (ConfigurationReferenceTest) that also fails on a property without a description or a default.

A property marked « no default » has none on purpose: a value only your service can give (its secret, its names), or a choice the kit refuses to make for you (where messages are deduplicated, which origins may call). The modules that need one say so at startup, with the property's name.

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

PropertyDescription
krizaka.web.cors.allowed-originsList<String>no defaultExact 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-typeURIdefault 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

PropertyDescription
krizaka.security.jwt.audienceStringdefault Optional with 'jwk-set-uri': when set, the 'aud' that must be present; empty by default.
krizaka.security.jwt.callersMap<String,String>no defaultOptional: 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-cutoffInstantno defaultOptional, with 'secret': from this instant the shared secret verifies nothing (ISO-8601). Empty keeps it open until the secret is removed.
krizaka.security.jwt.issuerStringdefault Required with 'jwk-set-uri': the only 'iss' accepted; empty by default.
krizaka.security.jwt.jwk-set-uriStringdefault 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.secretStringno defaultLegacy shared HMAC-SHA256 secret, at least 32 characters (256 bits). Whoever can verify with it can also mint.

krizaka-observability · krizaka-service-kit

PropertyDescription
krizaka.observability.environmentStringno defaultName of the deployment environment, e.g. 'dev' (environment variable OBSERVABILITY_ENVIRONMENT), exported as the resource attribute deployment.environment.name. Optional.
krizaka.observability.ingest-tokenStringno defaultToken sent as a bearer Authorization header to the receiver (environment variable OBSERVABILITY_INGEST_TOKEN). Optional; never printed by toString.
krizaka.observability.otlp-endpointStringno defaultBase 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.productStringno defaultProduct the service belongs to, e.g. 'sovkora'. Required: tagged on every meter.
krizaka.observability.serviceStringno defaultShort name of the service within its product, e.g. 'conversation'. Required: tagged on every meter.
krizaka.observability.versionStringno defaultVersion of the running build, usually filtered in by the build ('@project.version@'). Required: tagged on every meter.

krizaka-messaging · krizaka-service-kit

PropertyDescription
krizaka.messaging.consumer.enabledBooleandefault trueWhether krizaka-messaging contributes the JSON message converter and the listener container factory (retry with back-off, then <queue>.dlq).
krizaka.messaging.dedup.purge-intervalDurationdefault 1hDelay between two purges of the claims older than the retention.
krizaka.messaging.dedup.retentionDurationdefault 7dHow long a claim is kept; beyond the broker's longest redelivery window, a claim protects nothing.
krizaka.messaging.dedup.storeStoreno defaultWhere 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.tableStringdefault processed_messagesTable the claims are kept in when the store is 'jdbc'.
krizaka.messaging.exchanges.dead-letterStringdefault krizaka.dlxDirect exchange failed messages are dead-lettered to; must differ from the events exchange.
krizaka.messaging.exchanges.eventsStringdefault krizaka.eventsTopic exchange domain events are published to.
krizaka.messaging.outbox.batch-sizeIntegerdefault 100Most rows one batch claims and publishes.
krizaka.messaging.outbox.enabledBooleandefault trueWhether a relay is scheduled for each OutboxStore bean.
krizaka.messaging.outbox.failure-thresholdIntegerdefault 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.enabledBooleandefault 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-backoffDurationdefault 15mLongest wait before a row whose publish failed is tried again; the waits double from one second up to it.
krizaka.messaging.outbox.jdbc.tableStringdefault krizaka_outboxTable of the outbox (schema com/krizaka/messaging/outbox/schema-postgresql.sql).
krizaka.messaging.outbox.leaseDurationdefault 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-intervalDurationdefault 500msDelay between two batches of pending rows.
krizaka.messaging.outbox.purge-intervalDurationdefault 1hDelay between two purges of published rows.
krizaka.messaging.outbox.retentionDurationdefault 7dHow long published rows are kept before the purge deletes them.
krizaka.messaging.producerStringno defaultName 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.initialDurationdefault 500msWait before the second attempt.
krizaka.messaging.retry.maxDurationdefault 10sLongest wait between two attempts, not shorter than the initial wait.
krizaka.messaging.retry.max-attemptsIntegerdefault 5How many times the listener runs before the message is dead-lettered, the first delivery included; at least 1.
krizaka.messaging.retry.multiplierDoubledefault 2Factor between two consecutive waits; at least 1.

krizaka-app-config · krizaka-service-kit

PropertyDescription
krizaka.app-config.admin.authorityStringdefault ROLE_ADMINAuthority a caller must hold to use the admin API.
krizaka.app-config.admin.enabledBooleandefault falseWhether the audited admin API (/api/v1/admin/app-config) is registered.
krizaka.app-config.cache-ttlDurationdefault 30sHow long this instance reuses a parameter set it read.
krizaka.app-config.enabledBooleandefault trueWhether the app-config endpoint and the version filter are registered.
krizaka.app-config.guard.enabledBooleandefault trueWhether the 426 Upgrade Required filter is registered.
krizaka.app-config.guard.excludeList<String>default [/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>default /api/**Ant patterns of the paths the filter guards.
krizaka.app-config.http-max-ageDurationdefault 60sMax-age of the public app-config endpoint, for CDNs and clients.
krizaka.app-config.storeStoredefault jdbcWhere the parameters are kept: 'jdbc' (the application's database) or 'memory' (tests and demos).jdbcmemory

krizaka-idempotency · krizaka-service-kit

PropertyDescription
krizaka.idempotency.purge-intervalDurationdefault 1hDelay between two purges of the keys older than the time-to-live.
krizaka.idempotency.storeStoreno defaultWhere 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.tableStringdefault idempotency_keysTable the keys are kept in when the store is 'jdbc'.
krizaka.idempotency.ttlDurationdefault 24hHow long a key replays its response; after it, the same key runs the action again.

krizaka-persistence · krizaka-service-kit

PropertyDescription
krizaka.persistence.migrations.enabledBooleandefault 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-tableStringdefault 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

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

krizaka-ratelimit · krizaka-service-kit

PropertyDescription
krizaka.ratelimit.client-ip-headerStringdefault Header a trusted proxy sets to the client's address, read before X-Forwarded-For; blank for none.
krizaka.ratelimit.exclude-pathsList<String>default /actuator/**Ant patterns of the paths that never are (health checks, probes).
krizaka.ratelimit.include-pathsList<String>default /**Ant patterns of the paths that are limited.
krizaka.ratelimit.max-keysIntegerdefault 10000How many keys are tracked per instance before idle ones are forgotten; a busy key is never forgotten.
krizaka.ratelimit.modeRateLimitModedefault 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-minuteIntegerdefault 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>no defaultAddresses 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

PropertyDescription
krizaka.users.client.base-urlStringno defaultBase URL of the users service, e.g. 'http://localhost:8083'. Setting it switches the client on.
krizaka.users.client.cache-ttlDurationdefault 60sHow long a user, profile or tier is reused before it is fetched again.
krizaka.users.client.service-keyStringno defaultThis 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-idStringno defaultThe kid of serviceKey. Required with it.
krizaka.users.client.service-nameStringno defaultWho is calling: the subject of the SERVICE token, visible in the users service's logs. Required.
krizaka.users.client.service-secretStringno defaultLegacy 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

PropertyDescription
krizaka.billing.base-urlStringdefault http://localhost:8095Internal base URL of the billing service.
krizaka.billing.connect-timeoutDurationdefault 500msHow long a call waits for the connection; tight, billing sits on the interactive path.
krizaka.billing.enabledBooleandefault 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-timeoutDurationdefault 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-secretStringno defaultShared HS256 identity secret the SERVICE token of every call is signed with, which /internal/v1/** requires. Required when billing is enabled.