Skip to content
Open menuClose menu

Control map · v4.0

PCI DSS

Code evidence for stored and transit card data, secrets, access and secure code, and change approval from every merge.

PCI DSS · v4.026 requirements in scope · as mapped in v1.4.1
  • Code 9
  • Process 1
  • Planned 16

Code evidence

9requirements checked on every pull request

Live (process)

1from merges, approvals, rule changes, and deployments and releases recorded by GitHub

Planned

16can be evidenced from code or GitHub; not built yet

Organisation-level requirements

Policies, people, vendors, physical security and the like, listed below.Managed by your organisation’s workflows

Assessors test secure software and change control from change tickets, code-review records and scan results.

The PCI DSS blueprint gives code evidence for requirements such as stored-data encryption, transit encryption and service-account secrets. Every merged change carries its approval as a sealed record.

Toevan gives evidence for controls; it never certifies them or claims a framework is covered. Whether the evidence is sufficient is your auditor’s judgement. Controls are shown by id with Toevan’s own short names; the official titles and requirement text belong to the framework’s publisher.

Code evidence9

Sealed on every pull request. Always partial: the control also asks for things outside code. Rules in the PCI DSS blueprint check part of each on every pull request.

  • Req.1.3Inbound traffic limitsReq.1 Network boundary rules
  • Req.3.3Authentication secrets retentionReq.3 Stored data safeguards
  • Req.3.5Stored data encryptionReq.3 Stored data safeguards
  • Req.3.6Key protectionReq.3 Stored data safeguards
  • Req.4.2Transit encryptionReq.4 Transit encryption
  • Req.6.3Vulnerability scanningReq.6 Secure software work
  • Req.7.2Role access rightsReq.7 Access limits
  • Req.7.3System access limitsReq.7 Access limits
  • Req.8.6Service account secretsReq.8 User identity

Live (process)1

Merged pull requests, approvals, required checks, branch protection, rulesets and bypasses, and deployments and releases recorded by GitHub, each sealed.

  • Req.6.5Change approvalReq.6 Secure software workProcess evidence: every pull request merged into the default branch is sealed as a change record with its approvals on the final commit, the required checks at merge, who merged it, its signatures and the code verdicts it carried.

Change record rec_5b81d4e

example data
Pull request  payments-api #1921 · Add tenant check to refund handlerReported + sealed
Approvals  9d07…e3a4, c58f…71d0 · both on final commit e81b2d0Reported + sealed
Independent of author  Yes, by GitHub account idRecomputed
Required checks  ci/test ✓ · ci/lint ✓ · toevan/gate ✓Reported + sealed
Rules in force  main-protection: 2 approvals, required checks, signed commitsReported + sealed

Planned16

Can be evidenced from code or GitHub. No rule checks these yet; each is planned, and none counts as evidence today.

  • Req.1.2Network configurationReq.1 Network boundary rules
  • Req.1.4Trusted network edgesReq.1 Network boundary rules
  • Req.2.2System hardening settingsReq.2 Hardened system settings
  • Req.3.2Data retention limitsReq.3 Stored data safeguards
  • Req.3.4Card number maskingReq.3 Stored data safeguards
  • Req.6.2Secure code habitsReq.6 Secure software work
  • Req.6.4Web attack defensesReq.6 Secure software work
  • Req.8.2Account lifecycleReq.8 User identity
  • Req.8.3Strong authenticationReq.8 User identity
  • Req.8.4Second factor useReq.8 User identity
  • Req.8.5Second factor settingsReq.8 User identity
  • Req.10.2Audit log contentReq.10 Audit logging
  • Req.10.3Log tamper protectionReq.10 Audit logging
  • Req.10.5Log retentionReq.10 Audit logging
  • Req.11.3Recurring scansReq.11 Security testing
  • Req.11.6Payment page integrityReq.11 Security testing

Organisation-level requirements

Organisation-level controls (policies, people, vendors, physical security and the like) stay with your organisation’s own process; Toevan does not cover them.

Show the list

Req.1 Network boundary rules

Req.1.1Network policy recordorganisational policy
Req.1.5Endpoint bridging policyorganisational policy

Req.2 Hardened system settings

Req.2.1Hardening policy recordorganisational policy
Req.2.3Wireless reviewan operational process

Req.3 Stored data safeguards

Req.3.1Data protection policyorganisational policy
Req.3.7Key lifecycle processan operational process

Req.4 Transit encryption

Req.4.1Transit policy recordorganisational policy

Req.5 Malware defense

Req.5.1Malware policy recordorganisational policy
Req.5.2Endpoint malware defensean operational process
Req.5.3Malware update monitoringan operational process
Req.5.4Phishing defensesan operational process

Req.6 Secure software work

Req.6.1Development policy recordorganisational policy

Req.7 Access limits

Req.7.1Access policy recordorganisational policy

Req.8 User identity

Req.8.1Sign in policyorganisational policy

Req.9 Physical site access

Req.9.1Physical policy recordorganisational policy
Req.9.2Facility entry controlsphysical security
Req.9.3Visitor access recordsphysical security
Req.9.4Media handling rulesphysical security
Req.9.5Terminal tamper reviewphysical security

Req.10 Audit logging

Req.10.1Logging policy recordorganisational policy
Req.10.4Routine log reviewan operational process
Req.10.6Clock synchronizationan operational process
Req.10.7Failure detection processan operational process

Req.11 Security testing

Req.11.1Testing policy recordorganisational policy
Req.11.2Rogue wireless reviewan operational process
Req.11.4Penetration testingan external assessment
Req.11.5Intrusion detection processan operational process

Req.12 Governance program

Req.12.1Security policy programorganisational policy
Req.12.2Acceptable use rulesorganisational policy
Req.12.3Targeted risk revieworganisational policy
Req.12.4Compliance oversightorganisational policy
Req.12.5Scope definition recordorganisational policy
Req.12.6Awareness trainingpeople and HR
Req.12.7Staff screeningpeople and HR
Req.12.8Provider contractscontracts and vendors
Req.12.9Provider support dutiescontracts and vendors
Req.12.10Incident response planan operational process

Using it in an audit

  1. Take the population from the change records

    Every pull request merged into the default branch and every push to a protected branch that no merged pull request explains, in the period, captured from GitHub as it happened, is a sealed record you can export for sampling. You can re-perform the default branch’s population from git history; designated production branches are planned.

  2. Read the code evidence for the period

    Each pull request carries sealed code results against the blueprint’s rules, pinned to the commit and the rule-set version in force.

  3. Test a sample

    For each sampled record, check its results, then verify it offline against the published key with openssl and the shell: get the evidence, confirm the key, check the record. To replay the whole chain, Toevan provides the toevan command on request; it is not yet public.

    The three steps, with the exact commands

How each fact was obtained6 labels
Recomputed
Toevan computed it from the code or git history itself.
Reported + sealed
GitHub reported it; Toevan captured it at the event and signed it.
Declared + sealed
The organisation declared it, such as a change to what is checked; Toevan signed the declaration and its history.
Toevan record, not sealed
Held in Toevan’s database but not sealed in the ledger, such as a waiver today. Nothing protects it by a signature.
Consumed
Taken from GitHub’s deployment and release records and linked by commit or digest.
Not captured
No reliable source was available. Toevan does not infer it.
Req.6.5Change approvalsTest sheet · example data
Population148 changes: 146 merged pull requests and 2 direct pushes
Recomputed listed from git history and matched to the sealed records
Sample25 drawn by the auditor, each a sealed record
ApprovalsReported + sealed from GitHub at merge, independent of the author
ExceptionsNo PR 2 direct pushes on 19 SepGap review requirement off for 29 minutesBoth are in the record.
Signatures25 / 25 ✓ Verified OK
The sample change evidence report shows the evidence as your auditor receives it, with every fact labelled.Open the sample report

Test the mapping on a real audit.

Bring one repository and an upcoming audit. We’ll set up the blueprint and walk your auditor through verification.

  • One repository, one framework
  • Evidence from the first pull request
  • Verifiable without a Toevan account