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: jdbckrizaka-web · krizaka-service-kit
| Propriété | Description |
|---|---|
krizaka.web.cors.allowed-originsList<String>pas de défaut | 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-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éfaut | 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-cutoffInstantpas de défaut | 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.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éfaut | Legacy 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éfaut | Name 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éfaut | Token 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éfaut | 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.productStringpas de défaut | Product the service belongs to, e.g. 'sovkora'. Required: tagged on every meter. |
krizaka.observability.serviceStringpas de défaut | Short name of the service within its product, e.g. 'conversation'. Required: tagged on every meter. |
krizaka.observability.versionStringpas de défaut | Version 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 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-intervalDurationdéfaut 1h | Delay between two purges of the claims older than the retention. |
krizaka.messaging.dedup.retentionDurationdéfaut 7d | How long a claim is kept; beyond the broker's longest redelivery window, a claim protects nothing. |
krizaka.messaging.dedup.storeStorepas de défaut | 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.tableStringdéfaut processed_messages | Table the claims are kept in when the store is 'jdbc'. |
krizaka.messaging.exchanges.dead-letterStringdéfaut krizaka.dlx | Direct exchange failed messages are dead-lettered to; must differ from the events exchange. |
krizaka.messaging.exchanges.eventsStringdéfaut krizaka.events | Topic exchange domain events are published to. |
krizaka.messaging.outbox.batch-sizeIntegerdéfaut 100 | Most rows one batch claims and publishes. |
krizaka.messaging.outbox.enabledBooleandéfaut true | Whether a relay is scheduled for each OutboxStore bean. |
krizaka.messaging.outbox.failure-thresholdIntegerdéfaut 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.enabledBooleandéfaut 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-backoffDurationdéfaut 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.tableStringdéfaut krizaka_outbox | Table of the outbox (schema com/krizaka/messaging/outbox/schema-postgresql.sql). |
krizaka.messaging.outbox.leaseDurationdéfaut 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-intervalDurationdéfaut 500ms | Delay between two batches of pending rows. |
krizaka.messaging.outbox.purge-intervalDurationdéfaut 1h | Delay between two purges of published rows. |
krizaka.messaging.outbox.retentionDurationdéfaut 7d | How long published rows are kept before the purge deletes them. |
krizaka.messaging.producerStringpas de défaut | 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.initialDurationdéfaut 500ms | Wait before the second attempt. |
krizaka.messaging.retry.maxDurationdéfaut 10s | Longest wait between two attempts, not shorter than the initial wait. |
krizaka.messaging.retry.max-attemptsIntegerdéfaut 5 | How many times the listener runs before the message is dead-lettered, the first delivery included; at least 1. |
krizaka.messaging.retry.multiplierDoubledéfaut 2 | Factor between two consecutive waits; at least 1. |
krizaka-app-config · krizaka-service-kit
| Propriété | Description |
|---|---|
krizaka.app-config.admin.authorityStringdéfaut ROLE_ADMIN | Authority a caller must hold to use the admin API. |
krizaka.app-config.admin.enabledBooleandéfaut false | Whether the audited admin API (/api/v1/admin/app-config) is registered. |
krizaka.app-config.cache-ttlDurationdéfaut 30s | How long this instance reuses a parameter set it read. |
krizaka.app-config.enabledBooleandéfaut true | Whether the app-config endpoint and the version filter are registered. |
krizaka.app-config.guard.enabledBooleandéfaut true | Whether 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 60s | Max-age of the public app-config endpoint, for CDNs and clients. |
krizaka.app-config.storeStoredéfaut jdbc | Where 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 1h | Delay between two purges of the keys older than the time-to-live. |
krizaka.idempotency.storeStorepas de défaut | 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.tableStringdéfaut idempotency_keys | Table the keys are kept in when the store is 'jdbc'. |
krizaka.idempotency.ttlDurationdéfaut 24h | How 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 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-tableStringdéfaut 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
| Propriété | Description |
|---|---|
krizaka.webhooks.receiving.secretsList<String>pas de défaut | Secrets a received webhook may be signed with, the current one first. Setting one contributes the WebhookVerifier. |
krizaka.webhooks.receiving.toleranceDurationdéfaut 5m | How far a webhook's timestamp may be from now, either way; an older capture replayed is refused. |
krizaka.webhooks.signing.connect-timeoutDurationdéfaut 2s | How long an attempt waits for the receiver's connection. |
krizaka.webhooks.signing.previous-secretStringpas de défaut | Secret being rotated out: during a rotation both sign, and receivers that still hold the old one keep accepting. |
krizaka.webhooks.signing.read-timeoutDurationdéfaut 10s | How long an attempt waits for the receiver's answer. |
krizaka.webhooks.signing.secretStringpas de défaut | Secret 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 10000 | How many keys are tracked per instance before idle ones are forgotten; a busy key is never forgotten. |
krizaka.ratelimit.modeRateLimitModedéfaut 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-minuteIntegerdéfaut 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>pas de défaut | 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
| Propriété | Description |
|---|---|
krizaka.users.client.base-urlStringpas de défaut | Base URL of the users service, e.g. 'http://localhost:8083'. Setting it switches the client on. |
krizaka.users.client.cache-ttlDurationdéfaut 60s | How long a user, profile or tier is reused before it is fetched again. |
krizaka.users.client.service-keyStringpas de défaut | 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-idStringpas de défaut | The kid of serviceKey. Required with it. |
krizaka.users.client.service-nameStringpas de défaut | Who is calling: the subject of the SERVICE token, visible in the users service's logs. Required. |
krizaka.users.client.service-secretStringpas de défaut | 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
| Propriété | Description |
|---|---|
krizaka.billing.base-urlStringdéfaut http://localhost:8095 | Internal base URL of the billing service. |
krizaka.billing.connect-timeoutDurationdéfaut 500ms | How long a call waits for the connection; tight, billing sits on the interactive path. |
krizaka.billing.enabledBooleandéfaut 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-timeoutDurationdéfaut 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-secretStringpas de défaut | Shared HS256 identity secret the SERVICE token of every call is signed with, which /internal/v1/** requires. Required when billing is enabled. |