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: jdbckrizaka-web · krizaka-service-kit
| Property | Description |
|---|---|
krizaka.web.cors.allowed-originsList<String>no default | Exact 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
| Property | Description |
|---|---|
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 default | Optional: 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 default | Optional, 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 default | Legacy shared HMAC-SHA256 secret, at least 32 characters (256 bits). Whoever can verify with it can also mint. |
krizaka-observability · krizaka-service-kit
| Property | Description |
|---|---|
krizaka.observability.environmentStringno default | Name of the deployment environment, e.g. 'dev' (environment variable OBSERVABILITY_ENVIRONMENT), exported as the resource attribute deployment.environment.name. Optional. |
krizaka.observability.ingest-tokenStringno default | Token sent as a bearer Authorization header to the receiver (environment variable OBSERVABILITY_INGEST_TOKEN). Optional; never printed by toString. |
krizaka.observability.otlp-endpointStringno default | Base 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 default | Product the service belongs to, e.g. 'sovkora'. Required: tagged on every meter. |
krizaka.observability.serviceStringno default | Short name of the service within its product, e.g. 'conversation'. Required: tagged on every meter. |
krizaka.observability.versionStringno default | Version of the running build, usually filtered in by the build ('@project.version@'). Required: tagged on every meter. |
krizaka-messaging · krizaka-service-kit
| Property | Description |
|---|---|
krizaka.messaging.consumer.enabledBooleandefault true | Whether krizaka-messaging contributes the JSON message converter and the listener container factory (retry with back-off, then <queue>.dlq). |
krizaka.messaging.dedup.purge-intervalDurationdefault 1h | Delay between two purges of the claims older than the retention. |
krizaka.messaging.dedup.retentionDurationdefault 7d | How long a claim is kept; beyond the broker's longest redelivery window, a claim protects nothing. |
krizaka.messaging.dedup.storeStoreno default | Where 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_messages | Table the claims are kept in when the store is 'jdbc'. |
krizaka.messaging.exchanges.dead-letterStringdefault krizaka.dlx | Direct exchange failed messages are dead-lettered to; must differ from the events exchange. |
krizaka.messaging.exchanges.eventsStringdefault krizaka.events | Topic exchange domain events are published to. |
krizaka.messaging.outbox.batch-sizeIntegerdefault 100 | Most rows one batch claims and publishes. |
krizaka.messaging.outbox.enabledBooleandefault true | Whether a relay is scheduled for each OutboxStore bean. |
krizaka.messaging.outbox.failure-thresholdIntegerdefault 10 | Consecutive 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 false | Whether 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 15m | Longest 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_outbox | Table of the outbox (schema com/krizaka/messaging/outbox/schema-postgresql.sql). |
krizaka.messaging.outbox.leaseDurationdefault 2m | How 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 500ms | Delay between two batches of pending rows. |
krizaka.messaging.outbox.purge-intervalDurationdefault 1h | Delay between two purges of published rows. |
krizaka.messaging.outbox.retentionDurationdefault 7d | How long published rows are kept before the purge deletes them. |
krizaka.messaging.producerStringno default | Name 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 500ms | Wait before the second attempt. |
krizaka.messaging.retry.maxDurationdefault 10s | Longest wait between two attempts, not shorter than the initial wait. |
krizaka.messaging.retry.max-attemptsIntegerdefault 5 | How many times the listener runs before the message is dead-lettered, the first delivery included; at least 1. |
krizaka.messaging.retry.multiplierDoubledefault 2 | Factor between two consecutive waits; at least 1. |
krizaka-app-config · krizaka-service-kit
| Property | Description |
|---|---|
krizaka.app-config.admin.authorityStringdefault ROLE_ADMIN | Authority a caller must hold to use the admin API. |
krizaka.app-config.admin.enabledBooleandefault false | Whether the audited admin API (/api/v1/admin/app-config) is registered. |
krizaka.app-config.cache-ttlDurationdefault 30s | How long this instance reuses a parameter set it read. |
krizaka.app-config.enabledBooleandefault true | Whether the app-config endpoint and the version filter are registered. |
krizaka.app-config.guard.enabledBooleandefault true | Whether 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 60s | Max-age of the public app-config endpoint, for CDNs and clients. |
krizaka.app-config.storeStoredefault jdbc | Where the parameters are kept: 'jdbc' (the application's database) or 'memory' (tests and demos).jdbcmemory |
krizaka-idempotency · krizaka-service-kit
| Property | Description |
|---|---|
krizaka.idempotency.purge-intervalDurationdefault 1h | Delay between two purges of the keys older than the time-to-live. |
krizaka.idempotency.storeStoreno default | Where 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_keys | Table the keys are kept in when the store is 'jdbc'. |
krizaka.idempotency.ttlDurationdefault 24h | How long a key replays its response; after it, the same key runs the action again. |
krizaka-persistence · krizaka-service-kit
| Property | Description |
|---|---|
krizaka.persistence.migrations.enabledBooleandefault true | Whether 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_history | Flyway history table of the kit's migrations, kept apart from the service's own so their versions never meet. |
krizaka-webhooks · krizaka-service-kit
| Property | Description |
|---|---|
krizaka.webhooks.receiving.secretsList<String>no default | Secrets a received webhook may be signed with, the current one first. Setting one contributes the WebhookVerifier. |
krizaka.webhooks.receiving.toleranceDurationdefault 5m | How far a webhook's timestamp may be from now, either way; an older capture replayed is refused. |
krizaka.webhooks.signing.connect-timeoutDurationdefault 2s | How long an attempt waits for the receiver's connection. |
krizaka.webhooks.signing.previous-secretStringno default | Secret being rotated out: during a rotation both sign, and receivers that still hold the old one keep accepting. |
krizaka.webhooks.signing.read-timeoutDurationdefault 10s | How long an attempt waits for the receiver's answer. |
krizaka.webhooks.signing.secretStringno default | Secret the webhooks this service sends are signed with ('whsec_' + base64, or plain text). Setting it contributes the WebhookSender. |
krizaka-ratelimit · krizaka-service-kit
| Property | Description |
|---|---|
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 10000 | How many keys are tracked per instance before idle ones are forgotten; a busy key is never forgotten. |
krizaka.ratelimit.modeRateLimitModedefault enforce | How 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 600 | Requests 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 default | Addresses 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
| Property | Description |
|---|---|
krizaka.users.client.base-urlStringno default | Base URL of the users service, e.g. 'http://localhost:8083'. Setting it switches the client on. |
krizaka.users.client.cache-ttlDurationdefault 60s | How long a user, profile or tier is reused before it is fetched again. |
krizaka.users.client.service-keyStringno default | This 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 default | The kid of serviceKey. Required with it. |
krizaka.users.client.service-nameStringno default | Who is calling: the subject of the SERVICE token, visible in the users service's logs. Required. |
krizaka.users.client.service-secretStringno default | Legacy 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
| Property | Description |
|---|---|
krizaka.billing.base-urlStringdefault http://localhost:8095 | Internal base URL of the billing service. |
krizaka.billing.connect-timeoutDurationdefault 500ms | How long a call waits for the connection; tight, billing sits on the interactive path. |
krizaka.billing.enabledBooleandefault false | Whether 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 2s | How 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 default | Shared HS256 identity secret the SERVICE token of every call is signed with, which /internal/v1/** requires. Required when billing is enabled. |