nano v2.0.13
nano v2.0.13 makes detections, entities, prevalence and AI prompts correct on OCSF, makes OCSF the default for new installs and adds SCIM 2.0 provisioning.
v2.0.13 includes everything in v2.0.12. It includes no security fixes.
To upgrade, follow Upgrade a self-hosted deployment. On Docker Compose, scripts/nano upgrade upgrades v2.0.10, v2.0.11 and v2.0.12 to v2.0.13 directly. Before you upgrade a single-server install, read the upgrade notes about .env sizing overrides.
New
- SCIM 2.0 provisioning. Okta and Microsoft Entra ID can create, update, deactivate and delete nano users and sync their groups over SCIM. See SCIM provisioning.
- OCSF is the default schema for new installs. A fresh Docker Compose install or a bare
docker compose upwith noNANO_SCHEMA_PROFILEuses OCSF. Existing installs keep their schema: the installer andscripts/nano upgradewriteNANO_SCHEMA_PROFILE=udminto an.envthat has no value, and the ClickHouse migrator refuses to start, naming the fix, if it finds a UDM install with the value unset. Helm already defaulted to OCSF.
Fixes and improvements
- OCSF correctness.
- Prevalence counts hosts from the host field that's correct for each OCSF class, so rarity is right on OCSF events.
- SOAR playbooks, real-time rules and cases resolve entities by OCSF class, for example
user.nameon authentication events andactor.user.nameon endpoint events. - Concept searches such as
action=blocked, logons and authentication results match OCSF events. - pivt, the investigator and every AI prompt and built-in query use OCSF field paths.
- The search Rarity view and
POST /api/prevalence/query-artifactsread every OCSF artifact column. Known issue: on OCSF they return artifacts only for*. Any filtered query (a field such asclass_uid=1007, or a keyword) returns nothing, because the filter is built for UDM fields and the error is answered as an empty result. Fixed in v2.0.15. - Hunt reconnaissance, the case audit mirror, cloud enrichment and playbook paths work on OCSF.
- IOC and geo field buckets, the process tree and the result source label are correct on OCSF in the web app.
- Rule editor. The validator checks fields against the rule's dataset. On OCSF it accepts OCSF fields and their aliases and suggests only OCSF fields, and the risk rule's
score_24hquery no longer reports an unknown field. - Risk rule renamed. The default risk rule is now
accumulated_risk_threshold_exceeded. It's renamed only if it still has its original name. Everything that refers to it uses its ID, so nothing else changes. - Search commands.
| assetand| baselineaccept OCSF entity fields such asdevice.hostnameanduser.name.timechart … by <field>with more than 10 series no longer fails.isnull()andisnotnull()treat an empty OCSF field as null.| aiis bounded: a 90-second timeout (SEARCH_AI_PIPE_TIMEOUT_SECS), one call per user at a time, and four per search service. Rows always come back, markedSKIPPEDorERRORif the call doesn't finish. A search with| aiis no longer moved to a background job.
- Web app. A page that fails to load shows an error panel with a Reload button and keeps the navigation, instead of a blank screen. After an upgrade, a tab running the old build reloads once by itself.
- Docker Compose:
scripts/nano upgrade. These fix the v2.0.12 known issues.- It renders each server's configuration again from the new bundle and your inventory, shows the difference in the dry run, and recreates every service whose configuration changed, including the ingest proxy. Rollback restores the earlier configuration.
- The nginx edges look up container addresses at request time, so an app server reboot no longer leaves the ingest servers marking it
DOWN.scripts/nano cluster-healthhas anedge:internalrow. - The SIEM Health check waits for a report made after the upgrade (
NANO_UPGRADE_SIEM_HEALTH_WAIT_SECONDS, default 600). - The drain and rejoin hooks use the new
nano-lb-haproxyforced-command wrapper and confirm HAProxy's state. The dry run runs a real drain and rejoin on every server the upgrade drains, one at a time. - It prints each step as it happens, also over
sshwithout a terminal. - A log source deploy that's still installing reports
pending, not a failure.
- Docker Compose: installer.
install.shno longer moves or drops.envoverrides you set below its sizing block. See Upgrade notes. - Helm.
helm upgradewith--reuse-valuesor--reset-then-reuse-valuesnow gets the new release's images: the chart pins its own images and the ClickHouse operator digest.--reuse-valuesstill ignores new defaults, so pass your-ffiles. See Kubernetes: Upgrades. - Removed: Sigma conversion.
POST /api/sigma/convertand Sigma-format rule repositories are gone; converted rules targeted UDM fields and never matched on OCSF. An existing Sigma repository stays listed and can be deleted, but its sync and import return400. - Open edition. The public
nano-rs/nanorepository no longer contains source for modules that aren't in the open-source edition. - Documentation. Updated SCIM, Kubernetes on AWS, high-availability and upgrade guides.
Upgrade notes
-
Docker Compose: check your
.envsizing overrides. If you set sizing overrides below the installer's sizing block in.env, v2.0.11 or v2.0.12 may have moved them into the block. Check your.envoverrides before rerunninginstall.sh.- On a single-server install, rerunning
install.shon v2.0.11 or v2.0.12 could drop an override placed below the block. scripts/nano upgradeto v2.0.11 or v2.0.12 moved such an override into the block, where the next installer run overwrote it.- Role-split clusters (several servers) are not affected.
Open
.env, compare the values in the# BEGIN NANOblock with the ones you meant to pin, and put any you want to keep below the block again, as Sizing details and overrides describes. From v2.0.13 the installer andscripts/nano upgradeleave overrides below the block alone. - On a single-server install, rerunning
-
Sigma repositories. If you imported rules from a Sigma-format repository, its sync stops with
Sigma-format repositories are no longer supported. Rules already imported stay as they are. -
Risk rule name. If a search, dashboard or script refers to the default risk rule by its old name,
Accumulated risk threshold exceeded, change it toaccumulated_risk_threshold_exceeded.
nano v2.0.15
nano v2.0.15 runs custom enrichments and collectors in a WebAssembly sandbox, makes an ingest 2xx mean synced to disk and speeds up PostgreSQL HA failover.
nano v2.0.12
nano v2.0.12 adds optional Self-run monitoring, fixes the Compose upgrade tool, checks managed PostgreSQL permissions first and fixes Helm and OTLP.