Version History
- Changes
Read the outcomes and fixes in this release.
- Upgrade
Check migration guidance before changing an existing deployment.
Find the relevant version below and check breaking changes before scheduling an upgrade.
Next: Upgrade guidance
Version v3.3.3 (2026-10-18)
Bearer tokens and token claims no longer reach logs or traces, access rules match their values literally, and a stopped LDAP listener now restarts on its own; upgrades with renamed entries finish, very large groups load again while oversized entries are refused when written, and two quick changes to an entry keep the newer value. Four changes need action, listed under Breaking: heap dumps need a directory only the service account can read, Observe actions sent from other websites are refused, HTTPS sessions need the protected session cookie, and identity providers must report their configured issuer; bearer sign-in also uses the auth.http trust store now. Logs written by earlier releases may contain tokens and personal data, so delete or restrict them.
Breaking
- Heap dumps need a private directory. BREAKING:
POST /observe/memory/heap-dumpnow refuses with503unlessmonitoring.memory.heap-dump.directoryis owned by the service account and grants no access to anyone else, because a dump holds credentials and personal data; point the setting at such a directory or let Scribe create it. Filesystems without POSIX permissions or ACLs are refused as well. - Other websites cannot trigger Observe actions. BREAKING: Inbox actions, the plan-mode kill switch and heap dumps now answer
403and change nothing when a browser session sends them from another website, including another host of the same domain, or without origin information, so a page elsewhere can no longer act with a signed-in operator’s rights; Inbox actions and the kill switch also answer415unless the body is sent withContent-Type: application/json. The Observe pages keep working. All 3.x releases up to and including 3.3.2 are affected; see Sign-in form protection. Migration: switch scripts that call these actions with a session cookie to a bearer token or HTTP Basic credentials, which are not affected, and send JSON bodies withContent-Type: application/json. - HTTPS sessions need the protected session cookie. BREAKING: Over HTTPS, Scribe now reads only the session cookie it sets over HTTPS, which no other host and no plain-HTTP page can set; a session cookie left over from a plain-HTTP sign-in, or one hidden inside another cookie’s value, is ignored. Behind a reverse proxy that terminates TLS, a request counts as HTTPS when the proxy is listed in
http.requested-uri-discoveryand reportshttps; Scribe then sets the protected cookie withSecure, and access rules onrequest.securematch. Migration: sign in again after moving a deployment from HTTP to HTTPS; behind a TLS-terminating proxy, enablehttp.requested-uri-discoverywith the proxy as a trusted proxy so sessions get the protected cookie. - Identity providers must report their configured issuer — BREAKING: Scribe now rejects a provider whose discovery document names an issuer other than its
issuerorpublic-issuer— bearer tokens, password sign-in and token introspection through that provider fail. Migration: setpublic-issuerto the issuer your identity provider reports. See Authentication.
Security
- Access rules match values literally. Underscores, percent signs and backslashes in a starts-with, ends-with, contains or wildcard value acted as wildcards, so a rule could match request paths, hosts or accounts it did not name; they now match only themselves, and only
*in a wildcard value matches any text, as documented. All 3.x releases up to and including 3.3.2 are affected; see Access rules. - Bearer tokens kept out of logs. A rejected LDAP bearer bind could write the client’s complete bearer token into the operation log, where anyone with log access could reuse it; the log now records only the reason. Delete or restrict logs from earlier releases, and treat tokens that were still valid at the time as exposed.
- Token claims kept out of logs. A token rejected by a claim check, such as issuer, expiry or audience, wrote its decoded claims, including subject and e-mail address, into the operation log, and introspection failures logged audience values; the log now names the failed checks and claims, the token’s issuer and the expected value, and no claim values. With
SCRIBE_LOG_JOSE4J = debug, token headers no longer reach the library log. Delete or restrict logs from earlier releases according to your personal-data retention rules. - Rejected opaque tokens kept out of traces. With a UserInfo endpoint configured, an opaque token containing characters not allowed in an HTTP header was written in full into the trace and the operation log; both now record only the reason.
- Bearer sign-in honours identity provider settings. Bearer tokens are now checked with signing keys and provider details fetched through the
auth.httptrust store and timeouts, so identity providers with a private certificate authority work without changing the system trust store. While the identity provider is unreachable, Scribe retries it at most every few seconds, backing off to once a minute, instead of on every request, and keeps using the last signing keys it fetched. A provider’sCache-Control: max-agenow counts as at least one minute and at most one day, and provider answers larger than 512 KiB are refused. A failed token request now logs only the provider’s status, the kind of answer (such as JSON or HTML) and its size, no longer the start of its answer or its full content type, which could echo a password or authorization code.
Changed
- Token rejections report their actual reason. Rejection codes no longer depend on words inside the token: expired tokens report
AUTH_TOKEN_EXPIRED, tokens for another audienceAUTH_TOKEN_INVALID_AUDIENCE, and a token with an unknown signing algorithmAUTH_TOKEN_INVALID_SIGNATUREwith LDAP result 49 and HTTP 401 instead ofAUTH_JWKS_ERRORwith 52 and 503. All other rejections keep their LDAP result and HTTP status.
Fixed
- Upgrades with renamed entries finish. An upgrade that rebuilds stored entries failed on every start when an entry had been renamed, including entries deleted later; renamed entries now come back with their new name and last change time.
- Groups with very many members are stored and read again. An entry with more than 65,536 values in one attribute, such as a large group’s members, was stored but then failed to load, so later changes to it, directory reads of it and restores failed; such entries, including those stored by earlier releases, now load normally. An entry beyond the supported size (more than 4,096 attributes, more than about four million values, an attribute name over 1,024 bytes, a value over 16 MiB or 64 MiB of values in total) is now refused when it is written, with an error naming the exceeded limit, and the previously stored version and its history stay unchanged.
/observe/health/readyfails while searches are stalled. Like/readyz, it and the combined/observe/healthnow return503with aquery-stallcheck while every query permit stays in use, unlessmonitoring.readiness.fail-on-query-stallisfalse; see Kubernetes probes.- Stopped LDAP listeners restart. When an error such as running out of threads stopped an LDAP or IdentityHub listener, it stayed down until Scribe was restarted while the channel reported healthy; it now restarts as set by
retry.services, and the channel reports unhealthy until it accepts connections again. On Linux withuse-reuse-address = false, the restart retries while an old connection still holds the port and logsldap_listener_rebind_failedfor each attempt. - Shutdown no longer waits for stalled clients. Stopping Scribe or a listener no longer waits for a client that has stopped reading its responses.
- Reconciliation counts only recorded entries. When the database could not record that a page of entries was verified, reconciliation still counted the page and searched the same entries again; it now retries briefly and otherwise stops the run without counting that page.
- A slow directory no longer ties up database connections. When a change notification arrived without the entry’s object classes, Scribe re-read the entry from the directory while holding a database connection and the entry’s row lock; it now holds them only for the write.
- Two quick changes keep the newer value. When the directory changed the same entry twice in quick succession, Scribe could store the older values last and add a change back to them to the entry’s history, although the directory still held the newer values; the newer values now stay stored and the history shows no such change. Entries already affected are corrected by their next change or a resync.
- Later queries keep their settings. A session setting that failed to apply or restore could change plan choice or timeouts for unrelated later queries on the same pooled connection.
- Transient errors retry under every system locale. Database, LDAP and HTTP operations now also retry temporary I/O failures under Turkish or Azerbaijani system locales.
- A missing license file is named. When
license.filepoints at a file that does not exist or cannot be read, verification now fails withLicense file not found or not readable: <path>and where the setting came from. - The production template starts.
config/production.conffailed startup validation; it now serves the Operator UI and REST admin on the internal socket together with Observe, and all templates note that production needsSCRIBE_AUTH_SESSION_KEYS. See Network isolation. - Missing session keys stop startup at once. With
auth.enabled = falseand browser sessions on, the default when any UI is enabled, a production start withoutauth.session.cookie-keysnow fails validation withAUTH_SESSION_KEYS_REQUIREDinstead of retrying untilretry.services.max-attemptsruns out. - The Helm stack serves monitoring on port 9001. The chart exposed port
9001, but Scribe never opened it; the chart now configures health and/observeon9001, matching the Docker bundle, and its probes check that port. - The Helm stack’s Grafana reaches Prometheus and Tempo. The stack now serves Prometheus on
9090and points the Tempo datasource at its HTTP port, so dashboards and trace lookups work after install. - Health endpoints answer
HEAD./livez,/readyz,/startedzand/healthzansweredHEADwith404, so probes such aswget --spidersaw a running instance as failed; they now return the same status asGET, without a body. - Delegated searches keep the client’s attribute spelling. Since 3.0, searches forwarded to the directory, such as those under
ldap.ignore-contexts, sent unmapped attribute names in lowercase, so a client asking forworkforceIDcould receiveworkforceidand find no values; Scribe now forwards them as the client spells them. - Sorted searches by position return each entry once. A sorted search that starts at a numbered position, such as an LDAP virtual list view request by offset, could repeat and skip entries when some had no value for the sort attribute; each position now matches the complete sorted result. All 3.x releases up to and including 3.3.2 are affected.
- Paged sorted searches return long values once. With the default
database.query.sort.long-value-tiebreaker = deterministic, paging through values that share their first 256 characters could repeat some entries and skip others; each page now continues exactly where the previous one ended. - Case-only changes replace the old spelling. When the directory changed only the letter case of one value of a multi-valued attribute, Scribe kept both spellings in searchable data and recorded only an addition; it now keeps the new spelling and records the old one as removed. Values recorded before this release are not corrected.
- Per-transcribe task limit takes effect. The documented
max-task-concurrencysetting of a transcribe was ignored in favour of the database pool size; it now applies, capped atconcurrency. See Transcribes. - Browser sign-in works behind a proxied identity provider. When
public-issuerdiffered fromissuer, as is usual behind a reverse proxy, every browser sign-in was rejected; it now succeeds, and sign-ins from other identity providers are still refused. - Failed MCP tool calls count as failures. A tool call that returned an error, such as an invalid argument, was recorded as
okin the per-tool metrics and the audit log; it is now recorded asunknown, so error rates show. - Scheduled maintenance stops at shutdown. Scheduled and interval maintenance runs now stop at their next safe point when Scribe shuts down, as manual runs already did, instead of delaying shutdown until the sweep ends.
- Entry views show the current state. In the Operator UI, returning to an entry or to a relative time such as “1 hour ago” showed the state from your first visit, and a deleted entry reappeared; the view now checks for the latest state and says when that check failed, with a “Try again” button.
- Entry history shows the time you chose. In the Operator UI, choosing a time before the entry existed or older than the loaded history jumped to a later change; the view now shows the entry at that time, or says it did not exist then.
- Entry comparisons show loading and errors. In the Operator UI, comparing two states of an entry showed every value as added or removed while one side was loading or had failed; it now shows that it is loading, or an error with a “Try again” button.
- The Browse Hub says when its data is missing. When monitoring data failed to load or refresh, Browse Hub cards showed zeros, “None”, “All clear” or old values as if current, also after a reload; they now show “Loading” or “Unavailable”, with a “Try again” button when nothing loaded or a refresh failed.
- Observe views work with hints off. With
monitoring.hints.enabled = false, the Doctor, Services, Build Queue, Ingest, JVM, LDAP Forwarding and Pipeline views showed only an error; they now show their data and mark values that did not refresh as unavailable. - The Changes feed shows the right hourly rate. In the Operator UI, the Changes summary rate read 3,600 times too low; 3,600 changes in one hour now show as
3.6k/h.