Skip to content

[SSL] expand PCI DSS compliance guide - #33160

Open
ngayerie wants to merge 3 commits into
productionfrom
dee-3623-pci-dss-compliance-guide
Open

[SSL] expand PCI DSS compliance guide#33160
ngayerie wants to merge 3 commits into
productionfrom
dee-3623-pci-dss-compliance-guide

Conversation

@ngayerie

@ngayerie ngayerie commented Sep 1, 2026

Copy link
Copy Markdown
Collaborator

Expands the PCI DSS compliance documentation to address a gap identified in the SSL/TLS Clarity Report (theme 11).

DEE-3623

Changes

  • /ssl/reference/compliance-and-vulnerabilities/: rewritten as a complete how-to guide covering minimum TLS 1.2, PCI DSS cipher suite profile, TLS 1.3, configuration verification, Cloudflare Pages limitation, PCI DSS v4 client-side requirements (req 6.4.3 and 11.6.1), ASV scan behaviour, and known scanner false positives
  • /client-side-security/reference/pci-dss/: expanded from a one-paragraph stub to a full requirements mapping table for PCI DSS v4.0 req 6.4.3 and 11.6.1, with setup steps and cross-links

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Sep 1, 2026

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://dee-3623-pci-dss-compliance-guide.previews.developers.cloudflare.com (commit d6c67d0)

This URL reflects your latest Preview deployment

Preview Deployments by commit

Status Deployment URL Commit Updated (UTC) See this deployment's details
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://cb4c3fd6.previews.developers.cloudflare.com d6c67d0 2026-09-05T09:58:52.735Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://77b1402b.previews.developers.cloudflare.com 2d1e82b 2026-09-04T12:02:11.411Z Visit the dashboard ↗
  • Build: Failed ❌

View logs ↗
be54822 2026-09-04T11:35:41.462Z View logs ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://641a99ee.previews.developers.cloudflare.com 40e0d35 2026-09-03T06:37:16.211Z Visit the dashboard ↗
  • Build: In progress 🔵

View logs ↗
f4dccf3 2026-09-03T06:17:36.579Z View logs ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://85fd0956.previews.developers.cloudflare.com 52e1f49 2026-09-01T13:24:20.586Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://439c4358.previews.developers.cloudflare.com 504df72 2026-09-01T11:04:57.672Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://4da580d2.previews.developers.cloudflare.com 31595e3 2026-09-01T10:35:59.553Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://13213614.previews.developers.cloudflare.com 6ee1e17 2026-09-01T09:57:51.751Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://2b20f69b.previews.developers.cloudflare.com a4fec20 2026-09-01T09:09:37.272Z Visit the dashboard ↗

View all previews: View all previews ↗

@github-actions

github-actions Bot commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/docs/ssl/ @baubuchon-cf, @lgarofalo, @cloudflare/appsec-reviewers, @cloudflare/product-owners

@ngayerie ngayerie changed the title docs(ssl): expand PCI DSS compliance guide [SSL] expand PCI DSS compliance guide Sep 1, 2026
@github-actions

github-actions Bot commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

@ngayerie
ngayerie marked this pull request as ready for review September 1, 2026 09:25
@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

Review

⚠️ 1 warning, 💡 1 suggestion found in commit d6c67d0.

👉 Fix in your agent 👈
Fix the following review findings in PR #33160 (https://github.com/cloudflare/cloudflare-docs/pull/33160).

Before making changes, review each finding and present a brief summary table:
- For each finding, state whether you agree, disagree, or need clarification
- If you disagree (e.g. the fix requires disproportionate effort for minimal benefit,
  or the finding is factually incorrect), explain why
- If you need clarification before deciding, ask those questions
- Then share your plan for which issues to tackle and in what order

After triaging, follow this order:
1. Post a comment on this PR for any findings you are skipping, with the finding ID and your reasoning.
2. Then commit the fixes for the legitimate findings.

The comment must come before the commit — the bot reads PR comments when a new
push triggers a review, so skip comments posted after the push will be missed.

---

## Code Review

### Suggestions (1)

#### CR-9930d0289cce · Duplicate/leftover content
- **File:** `src/content/docs/ssl/reference/compliance-and-vulnerabilities.mdx` line 210
- **Issue:** The added paragraph 'Cloudflare's WAF may block attack-pattern traffic used by ASV scanners...' restates the opening paragraph of the same 'WAF and DDoS blocking ASV scanners' section ('ASV scanners send attack-pattern traffic ... Cloudflare's WAF blocks many of these probes, which is correct WAF behavior, but it can prevent the scanner from completing its assessment.'), and it sits after the section's numbered instructions and caution as a trailing sentence.
- **Fix:** Remove this trailing paragraph — the section intro already covers the WAF-blocking-ASV-scanners point, and the numbered steps give the concrete remediation. If the ASV/QSA coordination point is meant to stay, fold it into the section intro instead of duplicating it at the end.

---

## Conventions

### Warnings (1)

#### CV-05dd3639321e · Scope accuracy
- **File:** PR-level finding
- **Issue:** The description states that `/client-side-security/reference/pci-dss/` was "expanded from a one-paragraph stub to a full requirements mapping table", but the PR's changed files only include `src/content/docs/ssl/reference/compliance-and-vulnerabilities.mdx` (+227/-41). The described scope does not match the actual diff.
- **Fix:** Align the description with the diff: either include the client-side-security/pci-dss change in this PR or remove that bullet from the description.

Code Review

This code review is in beta and may not always be helpful — use your judgment.

Suggestions (1)
File Issue
ssl/reference/compliance-and-vulnerabilities.mdx line 210 Duplicate/leftover content — The added paragraph 'Cloudflare's WAF may block attack-pattern traffic used by ASV scanners...' restates the opening paragraph of the same 'WAF and DDoS blocking ASV scanners' section ('ASV scanners send attack-pattern traffic ... Cloudflare's WAF blocks many of these probes, which is correct WAF behavior, but it can prevent the scanner from completing its assessment.'), and it sits after the section's numbered instructions and caution as a trailing sentence. Fix: Remove this trailing paragraph — the section intro already covers the WAF-blocking-ASV-scanners point, and the numbered steps give the concrete remediation. If the ASV/QSA coordination point is meant to stay, fold it into the section intro instead of duplicating it at the end.

Conventions

Warnings (1)
File Issue
PR Scope accuracy — The description states that /client-side-security/reference/pci-dss/ was "expanded from a one-paragraph stub to a full requirements mapping table", but the PR's changed files only include src/content/docs/ssl/reference/compliance-and-vulnerabilities.mdx (+227/-41). The described scope does not match the actual diff. Fix: Align the description with the diff: either include the client-side-security/pci-dss change in this PR or remove that bullet from the description.

Style Guide Review

No style-guide issues found.

Commands

Only codeowners can run commands. Post a comment with the command to trigger it.

Command Description
/review Runs a review now. Incremental if a prior review exists, full if not.
/full-review Re-reviews the entire PR diff from scratch, ignoring incremental history. Useful after a rebase, when you want a fresh review, or if the bot gets out of sync and reports issues that no longer exist.
/ignore-review-limit Permanently lifts the 2-review automatic limit for this PR. Future pushes will trigger reviews as normal.
/disable-auto-review Stops automatic reviews from triggering on future pushes to this PR. Codeowners can still run /review or /full-review manually.
/rebase Rebases the PR branch against production. On conflict, attempts to resolve automatically using AI. Stops with an explanation if confidence is not high enough.

ngayerie commented Sep 1, 2026

Copy link
Copy Markdown
Collaborator Author

Skipping CR-31043405b1be (Incorrect technical claim about certificate redeployment).

The claim that "Updating cipher suites triggers certificate redeployment" is not an error introduced by this PR — it is sourced verbatim from the existing /ssl/edge-certificates/additional-options/cipher-suites/customize-cipher-suites/api.mdx documentation, which states: "Updating the cipher suites will result in certificates being redeployed." This PR preserves that established fact. If the underlying product behaviour has changed, a separate PR against api.mdx would be the right place to correct it.

Comment thread src/content/docs/ssl/reference/compliance-and-vulnerabilities.mdx Outdated
Comment thread src/content/docs/ssl/reference/compliance-and-vulnerabilities.mdx
Comment thread src/content/docs/client-side-security/reference/pci-dss.mdx Outdated
Comment thread src/content/docs/client-side-security/reference/pci-dss.mdx Outdated
@ngayerie
ngayerie force-pushed the dee-3623-pci-dss-compliance-guide branch from 40e0d35 to be54822 Compare September 4, 2026 11:34
DEE-3623

- SSL Labs: describe what to verify (rejected protocols, passing ciphers)
  rather than pointing to a specific grade
- Shared responsibility table: add ACM subscription requirement to
  cipher suite row
- WAF/ASV section: remove unverified PCI requirement citation;
  replace with neutral guidance to work with ASV and QSA
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants