Changelog
User-visible changes to ScaiVault, newest first. Versioning is API-path based — breaking changes ship under a new path version (v2) and don't disturb v1 callers.
2026-11-12 — Source-address restriction for service accounts#
Service accounts take a new setting, allowed_source_ranges: IPv4/IPv6 prefixes that every call with the account's API keys must come from, signing included. Other calls get 403 source_address_not_allowed and are audited. Set it through POST/PATCH /v1/service-accounts or the admin console. See Source-address restriction.
Security: source address can no longer be spoofed#
ScaiVault used to take the first entry of X-Forwarded-For as the caller's address, and that entry is whatever the caller sends. A caller could therefore pass the ip_ranges condition of a secret policy from any address. ScaiVault now uses the address its front end received the connection from, so ip_ranges and the new source-address restriction can't be bypassed with headers. If you set up ip_ranges for an address you don't actually call from, those calls will now be refused. Audit-log source addresses are also accurate from today, and signing operations now record theirs.
2026-11-12 — Exclude signing keys from a role#
Roles take a new constraint, sign_path_excludes: signing keys at or under the listed paths are refused for every signing operation and hidden from the key list, even when sign_path_prefixes would allow them. Exclusions from all of a credential's roles are combined and always win. The admin console's role editor has a field for it. See Resource constraints.
2026-11-09 — Rust SDK 1.10.0#
The Rust SDK can now set a key's rate_limit_per_min, description and hsm_backed at creation, with Signing::create_key_with(path, suite, &CreateKeyOptions). The API and the other SDKs already accepted these settings. create_key(path, suite, name) is unchanged. Only the Rust SDK has a new release.
2026-11-09 — SDK security releases, sign:destroy#
Security: SDKs no longer follow redirects#
The JavaScript, .NET and Rust SDKs followed HTTP redirects and re-sent X-API-Key to the redirect target — even another host. They now refuse every redirect and report it as an error. Python never followed redirects and is unchanged.
| SDK | Fixed in | A redirect now raises |
|---|---|---|
| JavaScript / TypeScript | 1.9.1 | ScaiVaultError, code REDIRECT_NOT_FOLLOWED |
| .NET | 1.9.1 | ScaiVaultException with the 3xx StatusCode |
| Rust | 1.9.1 | Error::Api with the 3xx status |
Upgrade from scailabs.ai/downloads. The Rust SDK also gains default timeouts (10 s connect, 30 s per request), refuses http:// base URLs, and percent-encodes paths and query values. If you pass your own HTTP client or handler to an SDK, disable redirects on it.
Breaking: destroying a signing key needs sign:destroy#
DELETE /api/v1/sign/keys/{path} now requires the new sign:destroy scope. sign:manage covers rotate, disable and enable only, so a credential can manage keys without being able to destroy them. See Signing.
Changed: no trailing-slash redirects#
The API no longer redirects a path with a trailing slash; it returns 404. The redirects pointed at the web UI instead of the API.
2026-11-08 — Signing engine, Rust SDK, SDK releases#
Signing engine#
A new API for signing raw bytes with keys that never leave ScaiVault. Create a key per path, sign single messages or batches of up to 100, verify, fetch public keys, and rotate without breaking older signatures. Three suites: Ed25519, ECDSA P-384 (also over a precomputed SHA-384 digest) and the post-quantum ML-DSA-65 (FIPS 204). Every signature is audited with a SHA-256 digest of the message. See Signing, the guide and the reference.
New scopes: sign:create, sign:use, sign:read and sign:manage. A role can pin a credential to its own keys with the new sign_path_prefixes constraint — see Resource constraints.
SDKs#
| SDK | Version | What's new |
|---|---|---|
| Python | 1.7.0 | client.signing; structured error responses now fill error_code and details |
| JavaScript / TypeScript | 1.9.0 | client.signing |
| .NET | 1.9.0 | client.Signing |
| Rust | 0.1.0 | New SDK: every domain, plus a typed signing client — see Rust SDK |
Download them from scailabs.ai/downloads.
Fixed#
- API keys created with an expiry date failed every request with
500. They now work until they expire, then return401.
2026-08-11 — Authorization hardening, certificate agent, enrollment, fleet#
Breaking: PKI, ACME, DNS and identity endpoints now enforce scopes#
Previously these routers authenticated the caller but never checked a scope, so any valid token reached them — including POST /pki/certificates/{path}/private-key, which returns a stored private key. 74 of 197 routes were in this state.
They now require the scope their operation implies. A service account that worked yesterday will get 403 insufficient_scope if it lacks the right grant.
| Router | Scopes now required |
|---|---|
| PKI | pki:read / pki:write / pki:delete, plus pki:export-key for private-key export |
| ACME | acme:read / acme:write / acme:delete |
| DNS | dns:read / dns:write / dns:delete |
| Identity (reads) | identity:read |
acme:* and dns:* are new. pki:* already existed and was offered when creating service accounts, but nothing enforced it — so a least-privilege account was not actually least-privilege.
What to do: review your service accounts and add the scopes they now need. GET /v1/service-accounts/scopes lists the full vocabulary. Human users signed in through the admin UI are unaffected, because scope checks exempt them.
Private-key export is additionally gated behind an administrator role for human callers, and every attempt — allowed or refused — is audited.
Certificate Agent#
A new client that keeps certificates current on a host: renews before expiry, writes the bundle where the service expects it, and reloads only when something changed. Profiles for nginx, Apache, HAProxy, Postfix and Dovecot, each validating configuration before reloading.
By default the private key is generated on the host and never crosses the network — the agent sends only a CSR. Download it from scailabs.ai/downloads; see Certificate Agent.
Enrollment tokens#
Short-lived, single-use tokens that let a new host obtain its own service account and API key, instead of copying a long-lived credential to every machine. Each redemption is recorded with the hostname and source IP. See Enrollment.
Fleet visibility#
GET /v1/fleet/status answers "which hosts are about to break?", separating hosts that have gone silent, hosts reporting failures, and certificates approaching expiry. See Fleet.
Also fixed#
PUT/GET /v1/secrets/{path}now returnid, matching the list endpoint. Its absence broke typed SDK deserialization on write — the secret was created and the client then raised, so callers' cleanup never ran.POST /v1/federation/proxy/readand/proxy/writenow enforce the secret path policy. They read and write secrets by path but never consulted the policy the secrets router applies to those same paths, so an identity deniedprod/**could reach it through the proxy.- Path policies extended to PKI and dynamic credentials, in monitor mode by default — denials are audited as
policy.violationwithout blocking, so enforcement can be rolled out deliberately. Promote per resource type withSCAIVAULT_POLICY_ENFORCED_RESOURCES. GET /v1/health/detailednow requiresadmin:readand reports measured values. It previously required no authentication and returned hardcoded ones, so it claimedhealthyduring a total dependency outage.GET /v1/health/readyhad the same defect in its Redis and encryption checks and could never detect an outage.- Rate limiting on
POST /v1/auth/tokenand/auth/refresh, which were public and unthrottled. - CORS no longer defaults to
*; wildcard origins combined with credentials are refused outright.
SDK releases — 2026-06-01#
Three rounds of SDK work landed this release. See the per-language CHANGELOGs in each SDK package for the full detail.
API-key authentication. All three SDKs now accept ScaiVault key_… API keys in addition to ScaiKey JWTs. The SDK auto-detects the key_ prefix on token and routes to X-API-Key; you can also pass the credential as the explicit api_key / apiKey / ApiKey argument. Before this release, passing an API key as the bearer token would 401 (the server tried to JWT-parse it).
Response-shape audit. Every SDK response type was re-validated against the API's Pydantic response models. 73 missing-field gaps were closed across the three SDKs (notably on Certificate, IssuedCertificate, Subscription, FederationBackend, DynamicEngine/Role, Lease, ACMEAccount/Order, AuditSummary, GeneratedSecret). The SDK no longer silently drops fields on deserialize.
Feature parity. The JavaScript and .NET SDKs are now at full parity with the Python SDK — all 127 endpoints covered. New operation clients: acme, federation, identity, subscriptions, webhooks, batch, plus dynamic.testEngine, pki.renewCertificate, and pki.deleteCA. JS/.NET PKI CSR endpoints moved from the deprecated /pki/csr/... alias to the canonical /pki/csrs/....
Server fix. SecretResponse (returned by PUT/GET /secrets/{path}) now includes id, matching the list-endpoint shape. The asymmetry had caused the SDK's typed Secret model to crash on deserialize when used via client.secrets.write() / .read().
Package downloads — scailabs.ai/downloads:
| SDK | Version |
|---|---|
Python (scaivault-sdk) |
1.6.1 |
JavaScript / TypeScript (@scaivault/sdk) |
1.8.0 |
.NET (ScaiVault.Sdk) |
1.8.0 |
1.0.0 — 2026-05-17#
Public launch.
Available API surfaces. Secrets (CRUD, versioning, expiration, soft-delete with recovery, batch read), Policies (path-pattern rules with IP/MFA/time-window conditions), Rotation (auto and event-driven, with grace periods and warn-before notifications), PKI (internal CA hierarchy + ACME via Let's Encrypt/ZeroSSL/BuyPass/Google + CSR workflow + trust anchors + CRL/OCSP), Dynamic Secrets (Postgres/MySQL/MongoDB/Redis/AWS/Azure/GCP/SSH), Federation (HashiCorp Vault, AWS Secrets Manager, Azure Key Vault, GCP Secret Manager — proxy or sync mode), Webhooks and Subscriptions, Audit log with export to S3/GCS/Azure.
Clients shipped. Python, JavaScript/TypeScript, .NET. Python and .NET fully cover the API; JavaScript covers everything except a handful of admin-only operations. CLI (scaivault) and MCP server (67 tools) for shell and agent integration.
Identity. Authentication delegated to ScaiKey. Three-level tenancy (partner / tenant / identity). Identity cache synced from ScaiKey, kept fresh by webhooks plus a 15-minute background reconciliation.
Crypto. Envelope encryption with per-row data keys wrapped by a KMS-held root. AWS KMS, GCP KMS, Azure Key Vault, HashiCorp Vault Transit, and PKCS#11 HSMs (including TPM 2.0) supported.
Limits. Default rate limits per identity per endpoint category — see Rate Limiting. Quotas per tenant — see Multi-tenancy.
Public docs. This site.
What's next#
We track upcoming work in our public roadmap. The shape and content of the API is stable; ongoing work is operational (more DNS providers, more dynamic engines, more federation backends).