IT documentation security for the map of your network — OC Security Audit
Securing your documentation

IT documentation security for the map of your network

Your documentation shows every system, address and admin account. Protect it at least as well as the systems it describes.

Ask your documentation vendor the right questions — OC Security Audit
Platform vendor risk

Ask your documentation vendor the right questions

SOC 2 report, data location, export rights and what happens when you leave. Know the answers before you rely on the platform.

Your documentation belongs to you, even when the MSP changes — OC Security Audit
MSP offboarding

Your documentation belongs to you, even when the MSP changes

Agree on the export format and handover terms now, so a change of provider never leaves you starting from nothing.

25+ yearsIT & cybersecurity experience
Certified expertsCISSP · C|CISO · Microsoft · Cisco
Southern CaliforniaLocal and on-site, based in Irvine
NationwideRemote documentation & audits
Why it is a target

Why IT documentation security matters

IT documentation security starts with an uncomfortable fact: good documentation is a map of your network. It lists every server and firewall, their IP addresses, which accounts hold admin rights, where the backups live and how remote access works. That is the information an attacker would otherwise have to discover piece by piece.

So the documentation needs the same controls as the systems it describes: strong sign-in, limited access, logging and a recovery copy. The platform that holds it is also a vendor with some of your most sensitive data, and it deserves the same review as any other vendor.

OC Security Audit builds and reviews protected documentation for businesses in Irvine, across Orange County and Southern California, and remotely nationwide.

Two IT specialists reviewing who can access documentation in a data center
Platform controls

Six controls for the documentation platform

Whatever platform you use, these are the settings to confirm and record.

01

MFA and single sign-on

Users sign in through Entra ID or your identity provider with MFA enforced. No local accounts, except one documented break-glass account.

02

Role-based access

Access scoped per site, or per client for MSPs. Most people need read-only. Vault access is granted separately, entry by entry.

03

No secrets in open text pages

Passwords, keys and recovery codes live only in the vault. Pages and attachments are checked for pasted secrets.

04

Audit logs

Views and edits are logged with name and time, and the log is reviewed, so you can answer who opened the firewall page at 2 a.m.

05

Encrypted offline export

A scheduled export to encrypted media kept off-site, so procedures and diagrams are available when the platform or the internet is not.

06

Backup of the documentation

Version history, retention set by you, and a restore test, so a deleted page or a damaged database can be recovered.

Credentials follow their own rules, set out in IT password documentation: the documentation holds a reference, the vault holds the secret.

Least privilege

Who should see what

A practical access model for a small firm with an outside MSP.

RoleDocumentation accessVault access
Owner or practice managerRead everything; approves access changesBreak-glass entries only
Internal IT leadEdit everythingEntries they administer
MSP techniciansEdit the sites or clients assigned to themEntries for those sites, every reveal logged
External auditorRead-only, selected sections, with an expiry dateNone
Vendor support engineersNo standing access; send a specific export when neededNone
Sample

Sample documentation access review

SAMPLE · Harborview Dental Group (fictional company) · illustrative data
Platform
Documentation platform in a Harborview-owned account · SSO through Entra ID · MFA enforced
Local accounts
1 break-glass account · vault reference VLT-0021 · last validated 2026-10-15
Review date
2026-10-15 · reviewed by practice manager and IT lead
AccountRoleScopeLast sign-inDecision
J. OrtegaEditorAll sites2 days agoKeep
Practice managerReaderAll sites9 days agoKeep
MSP technician AEditorIrvine office1 day agoKeep
msp-legacyEditorAll sites143 days agoRemove (former MSP)
External auditorReader, expires 2026-11-30Compliance sectionNot yetKeep until expiry

The same review found two pages with a password pasted into the text. Each password was moved to the vault and changed, and the old page versions were removed, because revision history keeps whatever was once typed into a page.

Vendor risk

Questions to ask your documentation platform vendor

We do not rate vendors. We help you ask the right questions and record the answers.

  • Do you have a current SOC 2 Type II report or ISO/IEC 27001 certificate, and will you share it under NDA?
  • Where is our data stored, in which country and region, and where are backups kept?
  • Is our data encrypted at rest and in transit, and who holds the keys?
  • Can we enforce SSO and MFA for every user, including your support staff?
  • Which actions are logged, how long are logs kept, and can we export them?
  • Can we export everything (pages, attachments, relationships and vault entries) in a documented format at any time?
  • What happens to our data when we cancel, and when is it deleted?
  • How and how quickly will you tell us about a security incident that affects our data?

NIST CSF 2.0 ID.AM-04 calls for inventories of services provided by suppliers, and your documentation platform belongs on that list. Self-hosting is an option with some platforms: Hudu offers cloud and self-hosted deployment, and ITFlow is open source and self-hosted. Self-hosting moves the security work to you. Compare platforms in IT documentation software compared.

MSP offboarding

Getting your documentation back from an MSP

STEP 1

Put it in the contract

State that the documentation is your property and that a full export is delivered on request and at the end of the contract.

STEP 2

Know where it lives

Find out which platform holds it and whose account it sits in: yours or the MSP’s.

STEP 3

Export before notice

Take a full export of pages, attachments, diagrams and configuration backups, and arrange the vault handover.

STEP 4

Check the export

Open it, compare a sample of records with the live systems, and confirm the configuration backups restore.

STEP 5

Revoke and rotate

Remove MSP accounts from the platform and your systems, then change every credential their technicians could reach.

If your documentation sits in the MSP’s own platform account, ask today how a handover works. It is an easier conversation before you need it.
Exports and backups

Configuration backups and exports are documentation too

Firewall, switch and router configuration backups often contain password hashes, VPN pre-shared keys and SNMP community strings. Treat them like the vault: encrypted, access-limited and logged. The same applies to the offline export of your documentation. Keep its passphrase under your break-glass process, store it apart from the platform, and test that you can open it. See configuration backup and change tools and runbooks and disaster-recovery documentation.

CIS Controls v8.1 added documentation as an asset class, so the documentation itself belongs in your IT asset inventory, with an owner, a location and a backup like any other system.

How we help

Documentation that is useful and protected

The IT Documentation Build is delivered in your own platform, with the controls above checked and recorded, or in OC Security Audit’s encrypted documentation package. The IT Documentation Audit reviews your existing documentation and vault use against all 13 domains, and reports the access and protection issues it finds.

Both are $3,500 fixed, one-time. See the IT documentation audit or IT documentation pricing. A quarterly access review can be part of our virtual CISO service.

IT professionals in a data center aisle reviewing who can access the documentation platform
Related

Where to go next

IT password documentation

Keep every secret in an encrypted vault, with a credential index anyone can review.

IT documentation software compared

Cloud and self-hosted documentation platforms, side by side.

Ali Hassani, CISO, OC Security Audit
CISO-led

Guided by Ali Hassani, CISO

Certified CISO (C|CISO) and CISSP with 25+ years in IT, cybersecurity, compliance and infrastructure, and dozens of Microsoft and Cisco certifications, including MCSE, MCITP, MCSA Security, CCNP and CCNA. Ali treats a client’s documentation the way he treats a domain controller: few accounts, strong sign-in and a log of every visit.

FAQ

Documentation security questions

Is a cloud-hosted documentation platform safe to use?

It can be, depending on the controls you turn on and the vendor’s own practices. Enforce SSO and MFA, scope access, review the vendor’s SOC 2 report and keep your own encrypted export.

Should our MSP’s technicians see all of our documentation?

Only the sites and systems they support. Access should be scoped, logged and removed the day the relationship ends.

Someone pasted a password into a documentation page. What now?

Move it to the vault, change the password, and remove the old page versions, because revision history keeps the original text.

How do we reach our documentation during a ransomware incident?

From the encrypted offline copy, stored apart from your network and the platform, and tested on a schedule so you know it opens.

How often should we review who has access?

We suggest every quarter and whenever a person or provider leaves.

Implementation partner

OC Security Audit documents and audits; it stays independent of the administration of your systems. If you want hands-on work, IT Perfection can fix what the documentation uncovers and keep the records current as part of managed IT.

IT Perfection managed IT
Sources

Sources and references

  1. NIST Cybersecurity Framework 2.0 Core (NIST, 2024)
  2. CIS Controls v8.1 Safeguard 1.1 (CIS, 2024)
  3. CIS Controls v8.1 Safeguard 12.4 (CIS, 2024)
  4. Hudu vs IT Glue (Hudu)
  5. IT Glue alternatives (Flamingo)

Hudu, ITFlow and Microsoft Entra are trademarks of their respective owners. OC Security Audit is independent and not affiliated with or endorsed by any vendor named on this page.

Two engineers reviewing firewall rules on a laptop in a server room

Protect the map of your network

We will review who can reach your documentation today and what to tighten first. Schedule a consultation.

Irvine, Orange County and Southern California on-site; remote nationwide. Fixed one-time price: $3,500.