-
Notifications
You must be signed in to change notification settings - Fork 10.4k
[1.1.1.1] Add Oblivious DNS over HTTPS #17906
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
RebeccaTamachiro
merged 8 commits into
production
from
rebecca/1.1.1.1-add-oblivious-dns
Nov 19, 2024
Merged
Changes from all commits
Commits
Show all changes
8 commits
Select commit
Hold shift + click to select a range
564bb4e
Create placeholder page, reorder, and adjust Encryption index
RebeccaTamachiro 6b35cad
Initial outline and fill in intro
RebeccaTamachiro 3aebd71
Fill in defined outline for a first complete version
RebeccaTamachiro d1a5e57
Initial review: experimental status, remove OHTTP ref, and replace Ru…
RebeccaTamachiro 1b892a5
Edit RFC callout, improve how it works section, and fix client link
RebeccaTamachiro 8a4973e
Replace OHTTP blog with HPKE blog
RebeccaTamachiro d2f34aa
Remove information already covered in the blog post
RebeccaTamachiro e852008
Add mention to iCloud Private Relay
RebeccaTamachiro File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
41 changes: 41 additions & 0 deletions
41
src/content/docs/1.1.1.1/encryption/oblivious-dns-over-https.mdx
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,41 @@ | ||
| --- | ||
| pcx_content_type: concept | ||
| title: Oblivious DNS over HTTPS | ||
| slug: 1.1.1.1/encryption/oblivious-dns-over-https | ||
| sidebar: | ||
| order: 6 | ||
| label: Oblivious DoH | ||
| --- | ||
|
|
||
| As announced on [our blog](https://blog.cloudflare.com/oblivious-dns/), since late 2020, Cloudflare 1.1.1.1 supports Oblivious DNS over HTTPS (ODoH). | ||
|
|
||
| :::caution | ||
| ODoH is defined in [RFC 9230](https://www.rfc-editor.org/rfc/rfc9230.html). This RFC is experimental and is not endorsed by the IETF. | ||
| ::: | ||
|
|
||
| ## How ODoH works | ||
|
|
||
| ODoH improves privacy by separating the contents of an HTTP request (and response) from its requester IP address. To achieve this, a proxy and a target are introduced between the client and the upstream DNS resolver: | ||
|
|
||
| - The proxy has no visibility into the DNS messages, with no ability to identify, read, or modify either the query being sent by the client or the answer being returned by the target. | ||
|
|
||
| - The target only has access to the encrypted query and the proxy's IP address, while not having visibility over the client's IP address. | ||
|
|
||
| - Only the intended target can read the content of the query and produce a response, which is also encrypted. | ||
|
|
||
| This means that, as long as the proxy and the target do not collude, no single entity can have access to both the DNS messages and the client IP address at the same time. Also, clients are in complete control of proxy and target selection. | ||
|
|
||
| Additionally, clients encrypt their query for the target using Hybrid Public Key Encryption (HPKE). A target's public key is obtained via DNS, where it is bundled into an HTTPS resource record and protected by DNSSEC. | ||
|
|
||
| ## Cloudflare and third-party products | ||
|
|
||
| Cloudflare 1.1.1.1 supports ODoH by acting as a target that can be reached at `odoh.cloudflare-dns.com`. | ||
|
|
||
| To make ODoH queries you can use open source clients such as [dnscrypt-proxy](https://github.com/DNSCrypt/dnscrypt-proxy). | ||
|
|
||
| Also, [iCloud Private Relay](https://support.apple.com/102602) is based on ODoH and uses [Cloudflare as one of their partners](https://blog.cloudflare.com/icloud-private-relay/). | ||
|
|
||
| ## Related resources | ||
|
|
||
| - [HPKE: Standardizing public-key encryption](https://blog.cloudflare.com/hybrid-public-key-encryption/) blog post | ||
| - [Privacy Gateway](/privacy-gateway/) | ||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Can we include Apple private relay?