Skip to content

Handle ECH Retry - #9611

Open
yschimke wants to merge 6 commits into
lysine-dev:mainfrom
yschimke:retry_config
Open

Handle ECH Retry#9611
yschimke wants to merge 6 commits into
lysine-dev:mainfrom
yschimke:retry_config

Conversation

@yschimke

@yschimke yschimke commented Jul 26, 2026

Copy link
Copy Markdown
Collaborator

A few assorted changes

  • grab the ech retry config and use it to retry when we get a mismatch
  • avoid ech retry more than once
  • avoid downgrading from ech to non ech

@yschimke
yschimke requested a review from swankjesse July 26, 2026 17:18
@yschimke

Copy link
Copy Markdown
Collaborator Author

Comment thread android-test/src/androidTest/java/okhttp/android/test/EchTest.kt
@yschimke

Copy link
Copy Markdown
Collaborator Author

I'll ask at work tomorrow.

@yschimke
yschimke marked this pull request as draft July 26, 2026 17:38

@swankjesse swankjesse left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I’d like to be particularly careful with landing this as it introduces new attack vectors and is not yet possible to test with MockWebServer + JVM Conscrypt.

I think it’s definitely good to have special recovery code for ECH handshake failures. But my first instinct is that special recovery code should mostly be about reducing the opportunity for downgrade attacks.

This is attempting to do something else, and I would like to understand the problem it solves before we land this.

Comment thread okhttp/src/commonJvmAndroid/kotlin/okhttp3/internal/dns/-DnsMessage.kt Outdated
Comment thread okhttp/src/commonJvmAndroid/kotlin/okhttp3/internal/connection/ConnectPlan.kt Outdated
Comment thread okhttp/src/commonJvmAndroid/kotlin/okhttp3/internal/connection/ConnectPlan.kt Outdated
Comment thread okhttp/src/commonJvmAndroid/kotlin/okhttp3/internal/connection/ConnectPlan.kt Outdated
@bjiang7

bjiang7 commented Jul 27, 2026

Copy link
Copy Markdown

Just chiming in here to state that the ECH recovery flow is a pretty important part of the spec, and so should be implemented if OkHttp is to say it supports ECH.

The reason why is because there's no other way to recover from a mismatch in ECH config between the client and server (i.e. synchronization issues). It's a performance hit to have to fall into this codepath (and shouldn't be happening in most cases), but it is needed so the consequences of things being out of sync is latency rather than outages.

I also asked BoringSSL a long time ago about this when doing the Android implementation, because I had the same question of how important the recovery flow was. Their stance was "This behavior is pretty crucial to allow servers to safely deploy ECH because DNS records can be stale and we need to make it possible for servers to recover from mismatches. The existence of any client that gets this wrong means a server now cannot deploy ECH in a rollback-safe way."

@swankjesse

Copy link
Copy Markdown
Collaborator

Making it safer for server operators to confidently deploy ECH is good.

@yschimke
yschimke marked this pull request as ready for review July 27, 2026 19:43
Comment thread okhttp/src/jvmTest/kotlin/okhttp3/InterceptorOverridesTest.kt

@swankjesse swankjesse left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is excellent. Some feedback and I’d like another look before merge. I promise to not make you wait so long on followups

val routePlanner = factory.newRoutePlanner(client, address)
val route = factory.newRoute(address)
val connectionSpecs = listOf(ConnectionSpec.MODERN_TLS, ConnectionSpec.COMPATIBLE_TLS)
val socket = createSocketWithEnabledProtocols(TlsVersion.TLS_1_2, TlsVersion.TLS_1_1)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This one’s curious 'cause it’s missing TLS 1.3

.planConnect()
.planWithCurrentOrInitialConnectionSpec(connectionSpecs, socket)

// A new DNS result must not influence a retry of the previous ECH configuration.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great test

assertThat(retryTlsHandshake(retryableException)).isTrue()
}

@Test fun echRetryConfigIsUsedOnceWithoutTlsFallback() {

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe another test, echRetryConfigIsNotRecursive() ?

socket.close()
}

@Test fun untrustedEchRetryConfigIsNotRetried() {

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I believe the spec wants us to retry if the public name verifies

}

/** https://www.rfc-editor.org/rfc/rfc9848.html#section-5.1 */
@Test fun echAddressesDoNotFallBackToNonEch() {

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I believe they do fall back to non-ech, if the public name from DNS verifies

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think Conscrypt tells us that? Unless we check the session that just failed a handshake?

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Rather, we fall back to no ECH if there's no retry config and our hostname verification succeeds.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

3 participants