Skip to content

Evidence Management

How to upload, tag, validate, and manage evidence files throughout your PCI DSS assessment.

Updated View as Markdown

Every PCI DSS assessment depends on evidence — firewall configurations, policy documents, access control screenshots, scan reports, and more. Kliper provides a structured evidence management pipeline that handles file uploads, malware scanning, integrity hashing, AI-powered validation, and document tagging in a single workflow.

Uploading Evidence Files

Screenshot of the Evidence tab's upload area

Evidence lives in the Evidence tab of the assessment editor. Open an assessment, select a section, then choose Attach File in the gear menu at the left of the editor’s toolbar, or Open full page on the Evidence tab of the right rail. The Evidence entry of the assessment’s sidebar menu opens the same tab. The header names the section you are in and the assessment’s file count. All files opens the assessment’s full file library, and the Files / Coverage toggle switches between the table and the coverage view.

Drop a file

Drag a file onto the upload area, or click it to open a file browser. Files upload one at a time: if you drop several, only the first is uploaded. While a file uploads, it takes the first row of the table with its progress bar.

Check where it will be filed

Under the upload area, a checkbox names the section the file will be cited for — Link to Requirement 12, Link to Contact Information — and is ticked by default. The name is the section you have open, so read it before you drop a file: a file uploaded from the wrong section is filed under that section. Untick the box to upload without citing any section.

Automatic processing

After the upload completes, the file passes through the security pipeline automatically:

  1. SHA-256 hash computed for integrity verification
  2. Malware scan — ClamAV antivirus and VirusTotal hash lookup run in parallel
  3. Metadata extraction — page count, word count, headers, and preview text extracted
  4. Cortex analysis — content summary, requirement matching, and doctag suggestions
1
File uploaded
Drag and drop, or pick from SharePoint, OneDrive, Google Drive or Confluence.
2
SHA-256 hash
Computed for integrity verification and deduplication.
3
ClamAV scan
Antivirus with current signatures. Infected files are quarantined.
3
VirusTotal lookup
The hash, never the file, checked against 70+ engines.
4
Metadata extraction
Page count, word count, headers and preview text.
5
Cortex AI analysis
Content analysis, requirement matching and doctag suggestions.
Results in the file's row
Each step reports as it completes. Nothing for you to do.

No action is required from you. The row’s Scan chip, its Requirements and Tags columns and the Analysed date fill in as each step completes; while Cortex reads the file, the row reads Analysing….

Accepted File Types

Category Formats
Documents PDF, DOCX, DOC, XLSX, XLS, PPTX, PPT, VSDX
Images PNG, JPG, JPEG, GIF, BMP, TIFF, SVG, WebP
Text & Config TXT, CSV, JSON, XML, YAML, LOG, MD, HTML, SQL, CONF, INI
Certificates PEM, CRT, CER, KEY, PUB, CSR, P12, PFX
Archives ZIP
Logs EVTX (Windows Event Logs)

Executables, scripts, and other potentially dangerous file types are blocked at upload. See Security & AI Trust for the full blocklist.

Scanned PDFs

A PDF holds text in one of two ways. Most are text-based: the words are stored as text and can be read directly. A scanned PDF is a photograph of a page — to a computer it is an image, with no text inside it at all.

Kliper detects which kind it has. When a PDF has no text layer, it says so, rather than reporting a successful upload with an empty analysis. This matters for evidence such as a signed policy that was printed, signed, and scanned back in: there is genuinely nothing for Cortex to read, and knowing that is more useful than a blank summary you have to work out for yourself.

If you hit this, run the file through OCR — most scanners and PDF tools offer “make searchable” or “recognise text” — and upload the result. Kliper does not perform OCR itself.


The Attachments Table

Every file of the section appears as a row. Click a row to open the file’s drawer; tick the checkbox at its left to select it for a bulk action.

Column What it shows
File Name, size and who provided it — see below. A file handled under Analyse without retaining also reads Analysed, not stored
Scan The malware scan verdict — see below
Status The evidence validation status, as a dropdown — see below
Requirements The sections and requirements the file is cited for, and +N suggested when Cortex has suggestions you have neither linked with the drawer’s Link nor dismissed
Tags The assigned doctags, and +N suggested when Cortex has tag suggestions you have not assigned
Analysed The date of the Cortex analysis, or –
Row menu Preview, Download, Link to section / Unlink from section, Delete

Above the table, the All / Pending / Open / Closed tabs filter the rows by status group, each with its count, and the search box narrows them by file name. The line under the table reads how many of the section’s files are shown.

Who provided it. A client submission through the portal reads From client · 12.1.1, with the requirement it was requested for. A team upload reads Added by the uploader’s first name and the section it was uploaded for — Added by Sara · Requirement 12, Added by Sara · Contact Information — so a file filed under the wrong section is visible at a glance. A file uploaded without a section link shows only the uploader until a team member links it to a section; Cortex’s Link does not change it.

Malware Scan Status

The Scan chip carries the verdict of the security pipeline the file went through:

Chip Meaning
Clean (green shield) No scanner found a threat. Hover the chip to see what cleared the file: one row per scanner with its result — ClamAV: No threats, VirusTotal: 0 of N engines flagged or Never seen before — and the scan date in the footer. A file with no scanner on record reads Virus scan: Passed, with the date
Threat (red shield) A scanner flagged the file, and it is quarantined: its drawer turns off Preview and Download and shows none of Cortex’s findings. Ask the client for a clean copy, or delete it
Scanning (spinner) The scan is running now
Not scanned (clock) The scan never reached the file, usually because a scanner was unavailable at upload. Kliper retries automatically every five minutes; the drawer offers Scan now to try straight away
Failed (amber triangle) The scan could not run. Hover the chip for the reason; the drawer offers Scan again

A file uploaded in the app is checked by ClamAV (local antivirus) and a VirusTotal hash lookup (70+ antivirus engines) in parallel, after static checks on its type, extension and content. If a scanner is unavailable, the file stays Not scanned rather than being passed. A file the client uploads through the portal is scanned by ClamAV, and its verdict reaches the assessment’s copy of the file: at acceptance, or as soon as the scan finishes if it is still running then.

Evidence Validation Status

Each file has a validation status that tracks the assessor’s review of it. The dropdown sits in the Status column and at the top of the drawer; a change saves immediately.

Status Tab Meaning
Pending Pending File uploaded, not yet reviewed
QSA Review Open Provided by client, awaiting QSA review
Not Provided Open Expected evidence not yet received
Improvements Open Evidence received but needs revisions
To Discuss Open Requires discussion with client
Observe Open Flagged for observation in formal assessment
N/A Closed Not applicable to this requirement
Recommend Closed Accepted with recommendations noted
Accepted Closed Evidence fully accepted

The Pending / Open / Closed tabs above the table group the rows by these statuses. Validating a file against a requirement’s criteria from the drawer sets its status from the result: Accepted when every criterion is met, Improvements when at least half are, Not Provided otherwise — see Criteria Validation.

The Evidence Drawer

Click a row and the file’s drawer slides in from the right. It holds everything about one file:

Section What it holds
Header A pager (n / N, previous and next), Preview, Download and Close. Press Esc to close the drawer and the left and right arrow keys to move between files
Title block The file name; a facts line — type, page, word or row count, size, and the Added or Received date; the status dropdown and the scan verdict
Scan A card for a file that is quarantined, scanning, not scanned (Scan now), failed (Scan again) or missing from storage
Requirements What the file is linked to and what Cortex suggests, with Link and a dismiss action on each suggestion — see Cortex AI Analysis
Tags The assigned doctags and Cortex’s suggestions — see Document Tags
What Cortex read The summary, why the file matters here and the key findings, with Regenerate
Validation against criteria Validate N criteria for each requirement the file’s tags map to, and the results

Preview and Download are disabled on a quarantined file and on a file missing from storage, and absent on a file that was analysed without being stored. A file Cortex has not analysed yet offers Run analysis, or a limit notice once your plan’s monthly allowance of Cortex analyses is spent.


Document Tags (Doctags)

Doctags are standardized reference codes that categorize evidence files by their purpose in the PCI DSS assessment. They map files to specific documentation requirements in the ROC template (e.g., DOCFW for firewall documentation, PENTEST for penetration test reports).

How Doctags Are Assigned

Doctags are assigned in the file’s drawer, in the Tags section. Click the file’s row in the attachments table to open it.

  • Suggested tags are the dashed chips, each with the tag code and Cortex’s confidence (for example DOCFW 92%). Click one to assign it.
  • Assigned tags are the solid chips with a check mark. Click one to remove it.
  • Hover a chip for the tag’s definition.

The table’s Tags column lists each file’s assigned tags and, when Cortex has suggestions you have not acted on, +N suggested. Cortex’s suggestions come from its analysis of the file, so the Tags section appears once Cortex has suggested a tag, or once a tag has been assigned.

A tag Cortex did not suggest is assigned from the file library (All files in the Evidence header): on a wide screen, each file’s row there has a tag selector.

Common Doctags

Tag Description Related Requirements
DOCFW Firewall documentation 1.2.2, 1.2.5, 1.2.6, 1.2.7, 1.5.1
DOCHARD Hardware documentation 1.2.1, 1.4.5, 2.1.1
DOCCRYPTO Cryptography documentation 3.6.1.1
DOCPWD Password policy documentation 8.2.2, 8.2.3, 8.2.4, 8.3.10
DOCPOI Point-of-sale documentation 9.5.1
PENTEST Penetration test reports 11.4.2, 11.4.3, 11.4.4, 11.4.5
CERTINV Certificate inventory 4.2.1.1

Over 100 doctags are available, covering every documentation category defined in the PCI DSS v4.0.1 ROC template.

Automatic Section 6.4 Sync

Section 6.4 of the ROC, Documentation Evidence, is where the PCI ROC template lists every document the assessor reviewed, one row per document. Kliper keeps that table in step with your tagged files: the moment you assign a doctag to a file, the file gets a row of its own in Section 6.4.

Column What the sync writes
Reference Number The tag code, for example DOCFW
Document Name The file’s name
Document Purpose The file’s Cortex summary, when Cortex has analysed the file; otherwise empty
Document Revision Date Nothing. The sync leaves it for you to enter

A file with several tags gets one row under each tag. Removing a tag from the file removes the row the sync created under that tag. Everything else in the table is yours:

  • Rows you typed are never removed. If a row you typed under that reference already names the file, the sync counts the file as listed and adds nothing; removing the tag then only takes the file’s name out of that row’s Document Name.
  • Your edits to a synced row stay. The sync fills Document Purpose only while it is empty, and never touches the other columns of a row that already exists.
  • Deleting a file does not remove its row. Remove the row by hand, or remove the tag before you delete the file.

Everything that reads the table, the ROC export, Evidence Coverage and Cortex’s finding drafts, reads it row by row, so each document carries its own purpose into the report. Rows you typed by hand, including any that list several documents, are read as before.

Sync from Files

A file tagged before this sync existed may have no row yet. To list every tagged file at once, open 6.4 Documentation Evidence in the ROC editor and click Sync from Files in the table’s header (on a phone, on the bar above the list). Kliper walks every file of the assessment, lists each tagged file under each of its tags, and reports the result in a toast: Synced from Files: 3 newly listed, 12 already listed. Files already on a row are left as they are.

The same action tidies the older layout, in which the sync stacked several documents in one row under their reference: each such row is split into one row per document. The first document keeps the row’s purpose and revision date; each of the others takes its own file’s Cortex summary as purpose, when the file has one.

On the laptop

In the Section 6.4 table, rows that sit together under the same reference show the reference once, drawn over the documents listed under it, and the shared reference cell lights up with whichever of its rows you hover. A newly tagged file is placed right after the last row that carries its reference, so it joins its documents instead of landing at the bottom of the table. A reference left empty is never merged.

Add row below the table adds a row of your own. The trash icon at the end of a row removes it, and the toast’s Undo brings it back for eight seconds.

The Reference Number field

The Reference Number cell is a picker as well as a text field. As you type, a list opens with the tag catalogue, every code with its short description, followed by any references this assessment already uses that are not in the catalogue, marked Used in this assessment. The list’s header says how many references it holds and, as you type, how many match. Codes that begin with what you typed come first, then codes that contain it. Use the arrow keys and Enter, or click a code, to fill the cell; Escape closes the list.

A code outside the catalogue still types in. Unless another row of the assessment already uses it, Not in the catalogue appears under it as soon as nothing in the list matches, or once you leave the field, so a typo is caught before it reaches the report. Kliper does not add the code to the catalogue.

On the phone

Section 6.4 folds its documents under their reference: one line per reference with the code, its catalogue description when it has one, and a count of documents. Tap the reference to unfold its documents, and a document to edit it. In the row editor, Reference Number is the same picker, Document Name is a single line, Document Purpose is a text area and Document Revision Date is a date picker. Sync from Files and Add sit on the bar above the list.


Evidence Coverage

The Evidence tab of an assessment has two views — Files (the attachments table) and Coverage, a traceability lens over the control → tag → artifact chain.

How the Chain Works

  1. In a testing-procedure response, cite the evidence tag you relied on (type / to open the tag menu — e.g. DOCFW for firewall documentation).
  2. Section 6.4 resolves each tag to the actual artifacts that were provided.
  3. Coverage cross-references the two and tells you where the chain holds and where it breaks.

By Control

Every control with a finding is classified:

State Meaning
Backed The response cites tags, and every cited tag resolves to registered evidence in Section 6.4
Dangling The response cites at least one tag with no matching Section 6.4 artifact — the citation points at nothing
No proof The control has a finding but its responses cite no evidence tags at all

Controls are grouped by requirement (collapsed by default) with summary chips to filter — No proof and Dangling are the review-day lists. Each row deep-links into the requirement editor.

By Tag

The inverse lens: every cited tag with how many controls cite it and how many Section 6.4 artifacts back it. Dangling tags sort first. A registered-but-never-cited tag shows as Unused — evidence someone collected that no response leans on.

Matrix

A controls-by-tags citation grid: rows are controls, columns are cited tags, cells mark where a citation is backed or dangling. Tag headers are hoverable for definitions, and a Cited rows only toggle hides controls with no citations.


Cortex AI Analysis

Cortex reads each file uploaded in the Evidence tab, and each file you accept from the portal, and writes what it found into the file’s drawer; for a file added another way, click Run analysis there. Click the file’s row to open it. While Cortex reads a file you uploaded here, the row reads Analysing… and the drawer says so; the sections below appear when it finishes.

Requirement Matching

The Requirements section of the drawer lists what the file is linked to and what Cortex suggests, with a count of each in its header (2 linked · 3 suggested).

  • A linked row shows the section or requirement name with a green check. Links made from the section page, the bulk bar or the portal show here; a link made from a suggestion also offers Undo.
  • A suggested row shows the requirement (Req 12.1.1 and its title), a confidence meter with its percentage — green from 80%, amber from 50%, grey below — and Cortex’s reason in one sentence.

Click Link to cite the file for that requirement. The citation is the same one the row menu and the bulk bar make: the file stays where it is in the library, earlier links stay, the table’s Requirements column shows the new one, and the Draft from Evidence drafter sees it. Click the × to dismiss a suggestion you disagree with; a dismissed suggestion leaves the list and the +N suggested count, and nothing else changes.

Criteria Validation

Kliper keeps a checklist of what the ROC template expects a document to contain for a requirement. The Validation against criteria section of the drawer offers Validate N criteria for each requirement the file’s assigned doctags map to, so assign the tag first.

The result opens under the requirement: All criteria met in green, or N of M met in amber, then one line per criterion:

  • A check mark — criterion found, with a short excerpt from the document
  • A cross — criterion not found, with a note on what is missing

The file’s validation status follows the result: Accepted when every criterion is met, Improvements when at least half are, Not Provided otherwise. Re-validate runs the check again.

What Cortex Read

The What Cortex read section holds Cortex’s reading of the file: a summary of its contents, why it matters here for the assessment, and the numbered key findings. Its header names the model and the date of the analysis; Regenerate runs the analysis again.


Analyse Without Retaining

Some clients will not let their documents rest on a third-party platform — a common condition when the evidence contains network diagrams, key-management procedures, or personal data. For those engagements, Kliper can read a file once for analysis and never store it.

The setting is per client, so one client’s documents can be handled this way while the rest of your book of business works normally.

Open the client record

Go to Clients, open the client, and choose Edit.

Set the retention mode

In the PCI section, set Evidence retention to Analyse without retaining. The default is Store uploaded files.

Save

The mode applies to every subsequent upload for that client’s assessments. Files uploaded before the change are unaffected — they remain stored.

What changes

Store uploaded files (default) Analyse without retaining
File body written to storage Yes Never
Malware scan and SHA-256 hash Yes Yes — the file is scanned in memory before anything else happens
Cortex analysis Queued after upload Runs during the upload
Result kept File + analysis Analysis only
Download Available Blocked
Counts against storage allowance Yes No

In the attachments table, files handled this way are labelled Analysed, not stored, and the download action is unavailable.

Every analysed-not-stored upload is recorded in the audit trail, so the engagement file shows what was examined even though the document itself was not kept.


File Integrity Verification

Every file is SHA-256 hashed at the moment of upload. At any time after upload, you can verify that the file has not been altered in storage.

Trigger Verification

Use the Verify action on the file to initiate an integrity check.

Review the Result

The platform re-downloads the file from storage, recomputes the SHA-256 hash, and compares it against the stored original:

Result Meaning
Verified Current hash matches stored hash — file is intact
Tampered Hashes do not match — file has been altered in storage

The verification timestamp is recorded in the file’s metadata for audit purposes.


File Metadata Preview

Kliper extracts metadata from every uploaded file, so an assessor has context without downloading it:

File Type Extracted Preview
PDF Page count, word count, text preview (first 500 characters)
Word (DOCX/DOC) Word count, text preview
Excel (XLSX/XLS) Sheet names, row/column counts, header names
PowerPoint (PPTX) Slide count, text preview from first slide
Visio (VSDX) Page count, text labels from diagram elements
CSV Column headers, row count, first 3 rows as preview
Images Format, file size
Text/Config Line count, word count, text preview
Certificates (PEM) Certificate type (certificate, private key, public key, CSR)

The drawer’s facts line, under the file name, is drawn from it: the type, the page count, word count or row count, the size, and the date the file was Added by the team or Received from the client.


View Modes and Filtering

The Evidence tab shows the evidence of the section you have open. Three controls narrow or widen the list:

Control What it does
All / Pending / Open / Closed Status tabs above the table, each with its count. Pending is a file not yet reviewed; Open and Closed group the open and closed validation statuses
Search Narrows the rows to file names containing the text
Show all files Offered when the section has no evidence of its own: lists every file of the assessment in the same table

The requirement folder browser of earlier versions is no longer part of this tab.

Bulk Operations

Tick the checkbox on one or more rows (the header checkbox selects every visible row) and a bar appears at the bottom of the screen:

  • Set status — applies one validation status to every selected file
  • Link to section — cites every selected file for a section chosen from the assessment’s structure
  • Download — downloads each selected file
  • Clear — drops the selection

The selection resets when you change section, tab or search. On a phone, Select above the list turns the rows into checkboxes, and the bar at the bottom edge offers the status, the section link and Delete for the selected files.


Evidence Requests by Assessment

When working across multiple assessments, the Evidence Requests panel groups requests into collapsible sections — one per assessment. This lets you focus on one engagement at a time without losing sight of the others.

Each section header displays:

  • Assessment name
  • Total request count — all requests in that assessment
  • Accepted badge — number of requests in accepted status
  • Open badge — number of requests still pending or in progress

Click the section header to collapse or expand it. All sections are expanded by default. Badge counts update immediately when a request status changes.


Reviewing submitted evidence

When a client uploads evidence against a request, you review it and record a decision. Open the request and choose one of three actions — each shows the consequence before you confirm, writes to the audit log, and (where relevant) notifies the client:

Action What it does
Accept Marks the request accepted. Logged as EVIDENCE_ACCEPTED.
Request changes Emails your note to all invited clients and reopens the request for re-submission. Logged as EVIDENCE_CHANGES_REQUESTED.
Waive Closes the request as not required, with your rationale. Logged as EVIDENCE_WAIVED.

The expanded request row shows a per-status footer — e.g. Review evidence when something’s awaiting review, Re-review on an already-accepted or waived request, and Nudge client while a request is still open.

Nudge a client

While a request is still open (nothing submitted yet), click Nudge client to email a reminder — the request title, due date, and a portal sign-in link — to every invited (non-revoked) client on the assessment.


Evidence Request Templates

Kliper includes 56 pre-built PCI DSS evidence request templates covering all 12 principal requirements. Templates let assessors create evidence requests in seconds instead of filling forms from scratch.

Using Templates

Open the New Request Dialog

Click New Request in the Evidence Requests panel. A chooser dialog appears with two options: Custom Request (blank form) or From Template (pre-built templates).

Browse and Select Templates

Templates are grouped by PCI DSS requirement (Req 1–12). Use the search bar to filter by title, requirement number, or description. Select individual templates or use the category checkbox to select all templates in a group.

Configure and Create

Optionally override the priority for all selected templates and set a shared due date. Click Create to generate all selected evidence requests at once.

Template Coverage

Category Examples
Req 1 — Network Security Firewall configs, network diagrams, data flow diagrams
Req 2 — Secure Configuration Hardening standards, default credential removal
Req 3 — Account Data Protection Encryption policies, key management procedures
Req 4 — Transmission Encryption TLS certificates, secure transmission policies
Req 5 — Malware Protection Anti-malware deployment, scan reports
Req 6 — Secure Development SDLC documentation, change management, code reviews
Req 7 — Access Restriction Access control policies, role matrices
Req 8 — User Identification Password policies, MFA configuration, account reviews
Req 9 — Physical Security Facility access logs, visitor logs, media handling
Req 10 — Logging & Monitoring Audit log configurations, time sync, log review procedures
Req 11 — Security Testing Vulnerability scans, penetration test reports, IDS/IPS configs
Req 12 — Organizational Policies Information security policy, incident response plan, risk assessments

Downloading and Deleting Files

Download

Open the row’s File actions menu (the three dots at its right) and choose Download, or click Download in the drawer’s header. To download several, tick their rows and click Download in the bulk bar.

The drawer turns Download off for a quarantined file and for a file missing from storage. A file that was analysed without being stored cannot be downloaded at all.

Delete

Open the row’s File actions menu, choose Delete and confirm. The file is removed from the assessment immediately. On a phone, Select and the Delete action at the bottom edge remove several files at once, after one confirmation.

Was this helpful?

Report an issue with this page
Navigation

Type to search…

↑↓ navigate↵ selectEsc close