Skip to content
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
Show all changes
25 commits
Select commit Hold shift + click to select a range
97c2825
Add placeholders for new folder and pages and fill in frontmatter
RebeccaTamachiro Nov 14, 2024
3990553
Add outline for index.mdx and fill in TLS background info
RebeccaTamachiro Nov 14, 2024
a6bfb7f
Apply suggestion: Reword intro to TLS building blocks
RebeccaTamachiro Nov 15, 2024
9a2e327
Fix typo and reword index.mdx meta description
RebeccaTamachiro Nov 15, 2024
691a805
Improve parallelism, refine text, and link out to TLS handshake LC
RebeccaTamachiro Nov 15, 2024
55a8f2a
Fill in hybrid key agreement section
RebeccaTamachiro Nov 15, 2024
7740221
Complete visitor-to-cloudflare intro paragraph
RebeccaTamachiro Nov 15, 2024
7e0b9a1
Add mermaid digram for connections and reword #2
RebeccaTamachiro Nov 15, 2024
8d5d0c8
Fix Internet capitalization
RebeccaTamachiro Nov 15, 2024
f815122
Rename file, fill in, and link to pqc-support
RebeccaTamachiro Nov 18, 2024
501a6d5
Fix capitalization and fill in Intenal connections section
RebeccaTamachiro Nov 18, 2024
769a0df
Fill in Cf to origin and review titles and headings
RebeccaTamachiro Nov 19, 2024
d8a58a8
Fix missing hyphen and touch up pqc-to-origin description
RebeccaTamachiro Nov 19, 2024
8b65760
Add split ClientHello and HRR workaround to pqc-to-origin
RebeccaTamachiro Nov 19, 2024
05fe350
Add setup instructions to pqc-to-origin
RebeccaTamachiro Nov 19, 2024
2fc8ef7
Apply suggestion from code review
RebeccaTamachiro Nov 19, 2024
0e02cc4
Apply suggestions from code review
RebeccaTamachiro Nov 20, 2024
f029142
Replace store by harvest, adjust RFC link cf Style Guide, and split l…
RebeccaTamachiro Nov 20, 2024
66bd9f8
Add reference to PQ signatures and link out to blog
RebeccaTamachiro Nov 20, 2024
e11cab4
Fix origin server section to use fork and bssl for both cases
RebeccaTamachiro Nov 21, 2024
ed2f4c0
Add link to Cloudflare Radar
RebeccaTamachiro Nov 21, 2024
ce59ab9
Text review and move link to Radar higher up in the page
RebeccaTamachiro Nov 21, 2024
cf3fd60
Simplify origin server instructions to use BoringSSL instead of fork
RebeccaTamachiro Nov 22, 2024
7f6dfea
Overall text review and remove previous origin instructions
RebeccaTamachiro Nov 22, 2024
49f5b90
Apply suggestion from code review
RebeccaTamachiro Nov 22, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 41 additions & 0 deletions src/content/docs/ssl/post-quantum-cryptography/index.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
---
pcx_content_type: concept
title: Post-quantum cryptography (PQC)
sidebar:
order: 9
label: About PQC
group:
label: Post-quantum
head: []
description: Consider information about how Cloudflare is implementing post-quantum cryptography to protect you against store now, decrypt later.
---

For years, Cloudflare has been researching and [writing about post quantum](https://blog.cloudflare.com/tag/post-quantum/).

To protect you against the risk of [store now, decrypt later](https://en.wikipedia.org/wiki/Harvest_now,_decrypt_later), and considering all the [connections](#three-connections-in-the-life-of-a-request) that take place when your website or application is on Cloudflare, we have deployed and are actively expanding the use of post-quantum hybrid key agreement.

:::caution[TLS 1.3]
Post-quantum key agreements are only supported in protocols based on TLS 1.3 (including HTTP/3) and are disabled for websites in [FIPS mode](/cloudflare-one/policies/gateway/http-policies/tls-decryption/#fips-compliance).
:::

## Three building blocks of TLS

For a TLS handshake to happen, three types of encryption have to be in place:

- **Symmetric ciphers:** used to encrypt and decrypt data, ensuring confidentiality and integrity (such as `CHACHA20-POLY1305`).
- **Key agreement:** a cryptographic protocol with which client and server can safely agree on a shared key (such as `ECDH`).
- **Signature algorithms:** cryptographic algorithms used to generate the digital signatures in TLS certificates (such as `RSA` and `ECDSA`).

As explained in our [blog post](https://blog.cloudflare.com/pq-2024/#two-migrations), the first, most urgent migration that needs to happen has to do with key agreement.

### Hybrid key agreement

## Three connections in the life of a request

### Visitor to Cloudflare

As of [october 2023](https://blog.cloudflare.com/post-quantum-for-all/), all websites and APIs served through Cloudflare support post-quantum hybrid key agreement.

### Internal services

### Cloudflare to your origin
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
pcx_content_type: how-to
title: Enable PQC to your origin
sidebar:
order: 2
label: PQC to your origin
head: []
description: Learn how to enabled post-quantum cryptography in connections from Cloudflare to your origin servers.
---
8 changes: 8 additions & 0 deletions src/content/docs/ssl/post-quantum-cryptography/reference.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
---
pcx_content_type: reference
title: PQC support
sidebar:
order: 3
head: []
description: Consider information about post-quantum cryptography at Cloudflare - deployed key agreements, software support, protected products, and more.
---
Loading