Skip to content

AA Docs Update - #1525

Merged
jtviolet merged 21 commits into
mainfrom
dev
Sep 10, 2026
Merged

AA Docs Update#1525
jtviolet merged 21 commits into
mainfrom
dev

Conversation

@jtviolet

@jtviolet jtviolet commented Sep 10, 2026

Copy link
Copy Markdown
Contributor

Closes #1526

thobed and others added 20 commits September 9, 2026 09:56
Add update-cert and rollback-cert to the installer reference (flags,
exit codes) and a new task page walking through rotating an expiring
or untrusted certificate without reinstalling.
Fix the exit-code cross-reference and its accuracy around --no-rollback
and unreachable ingresses, add a maintenance-window note and a
reverse-proxy pointer before the procedure, name the dspm-tls Secret,
document the --hostname override, use placeholder hostnames in the
verification command, align exit-code and heading style with the rest
of the reference, and fix sidebar ordering between the post-install
task pages and the installer reference.
Fix a dropped relative pronoun, qualify the rollback claim against
--no-rollback and unreachable-ingress cases, align boolean flag
defaults and the rollback-cert exit codes with the rest of the
reference, cross-link the two docs for exit codes and cleanup steps,
define platform-service and trust anchor on first use, clarify that
the rotation timeout is a configurable default, and spell out what a
healthy CA bundle check looks like.
Verified against the actual implementation (netwrix-corp/access-analyzer
commit d2ef453). rollback-cert has no exit code 72 — its real codes are
0, 1, 73, and 74. It also accepts --hostname, --port, --timeout,
--kubeconfig, and --argocd-namespace like update-cert does; only
--list, --latest, and --snapshot were documented. Also note that
update-cert's exit code 72 is reused for --no-rollback runs and for a
snapshot that couldn't be loaded, not only a successful rollback.
Add --log-path (env LOG_PATH, default /var/log/dspm-installer.log) to
the flags table and update the Logs section to describe its fatal-vs-
fallback write-failure behavior: unwritable at the default path falls
back to stderr, but the same failure on an explicitly set path stops
the installer.
Per PR feedback, --snapshot examples used a literal timestamp from
when the doc was written. Use <timestamp>, matching the placeholder
already used for this path elsewhere on the page.
…ation docs

The 26.1 KB section held a StealthAUDIT/Access Analyzer 12 migration guide
written against a pre-release product model (scanner nodes, source groups)
that the shipping-product rewrite no longer matches, plus an article
template and an upgrade how-to. Delete the version-pinned KB source folder
outright and give 26.1 no KB section at all: add a `kb: false` opt-out on
the version entry so the copy script skips it (and removes any stale copied
folder) instead of falling back to the 12.0/11.6 knowledge base.

Fold the upgrade article's unique steps, checking the installed version
with `dspmctl version` before and after the upgrade, into the existing
Installation > Upgrade to a New Version page rather than keeping a second
page on the same procedure. No redirects: the docs are not yet in use.

Generated with AI

Co-Authored-By: Claude Code <ai@netwrix.com>
docs(accessanalyzer): remove the 26.1 Knowledge Base section and migration docs
…rotation-docs

Document TLS certificate rotation for the installer
npm normalized the lockfile by dropping the `libc` fields on optional
platform packages. Follow-up to #1522, where this change was left out.

Generated with AI

Co-Authored-By: Claude Code <ai@netwrix.com>
…and 10.8 (AUD-336) (#1521)

* docs(auditor): port WSA/User Activity content-accuracy fixes to 10.7 and 10.8 (AUD-336)

Apply the same content-accuracy and formatting fixes made to 10.9 in the
Windows Server and User Activity docs, adapted for 10.7/10.8: consolidate
duplicated content into single canonical topics, fix broken/flattened bullet
lists, restore the correct three-level Component/Object type/Attributes table
structure (previously collapsed by AI migration), split DNS Who-value notes
out of the table into proper admonitions, fix broken links and duplicated
rows, and correct Windows Server 2008 references (unsupported in 10.7/10.8).
OS-version content that remains supported in 10.7/10.8 (e.g. Windows
Server 2012, Windows 7) is intentionally left untouched.

Generated with AI

Co-Authored-By: Claude Code <ai@netwrix.com>

* fix(vale): auto-fix style issues (Vale + Dale)

* docs(auditor): apply editorial review fixes to 10.7/10.8 WSA and User Activity docs (AUD-336)

Address findings from the PR editorial review: split the combined Windows
Server/User Activity item row in datasources.md into two correctly-linked
rows, add missing anchors and <br/> separators for scannability, fix broken
NOTE-block scoping and misplaced Video Recording group description, correct
"when upon" grammar, rename the Containers and Computers option cell and
align "Exclude Monitored Objects" link/heading text with its destination's
actual name, remove a duplicated Install Core Service section in favor of a
single pointer, align gMSA prerequisite phrasing, fix an undefined triple-
asterisk table marker, de-link a heading-less cross reference, disambiguate
the Configure Advanced Audit Policy section heading from the page H1, match
removablestorage.md link text casing to its target headings, and give the
Install Core Service manual procedure its own heading with note formatting.

Generated with AI

Co-Authored-By: Claude Code <ai@netwrix.com>

* fix(vale): auto-fix style issues (Vale + Dale)

---------

Co-authored-by: Claude Code <ai@netwrix.com>
Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>
@jtviolet
jtviolet merged commit 22ef844 into main Sep 10, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants