SpringBoot MVC - Warning: org.apache.tomcat.util.net.SSLUtilBase : The JSSE TLS 1.3 implementation does not support authentication

Question

A question about Spring Boot MVC with Tomcat and TLSv1.3

I used to have a Spring Boot MVC, Tomcat based web app, with very simple business logic, over ssl HTTPS.

Per security team review, I had to bump the TLS version from TLSv1.2 to TLSv1.3.

Thought is was very simple and could easily complete this task, I went to change my property:

server.ssl.enabled-protocols=TLSv1.2

to

server.ssl.enabled-protocols=TLSv1.3

However, since then, I am getting this on each application start up:

org.apache.tomcat.util.net.SSLUtilBase : The JSSE TLS 1.3 implementation does not support authentication after the initial handshake and is therefore incompatible with optional client authentication

What does it mean please?

Is it "dangerous"?

How to fix it please?

Thank you

Answer 1

Post-Handshake Client Authentication is a TLSv1.3 extension defined in RFC8446. But OpenJDK doesn't implement it and will not implement it. The corresponding issue is marked as "Won't fix".

The warning is emitted by Tomcat in SSLUtilBase.java

if (enabledProtocols.contains(Constants.SSL_PROTO_TLSv1_3) &&
        sslHostConfig.getCertificateVerification() == CertificateVerification.OPTIONAL &&
        !isTls13RenegAuthAvailable() && warnTls13) {
    log.warn(sm.getString("sslUtilBase.tls13.auth"));
}

The isTls13RenegAuthAvailable() method is defined in JSSEUtil.java

@Override
protected boolean isTls13RenegAuthAvailable() {
    // TLS 1.3 does not support authentication after the initial handshake
    return false;
}

To remove this warning you can either set CertificateVerification in Tomcat's SSLHostConfig to NONE or to REQUIRED. You can do it through the Spring Boot property server.ssl.client-auth which take the values NONE, WANT and NEED.

If you don't use client certificates, set it to NONE. If you use client certificates, check that each client can authenticate itself correctly with the NEED value. If you leave it as it, the only risk is that client that use post-handshake authentication will not be able to authenticate.

If you really need post-handshake client authentication, you will have to use another TLS implementation than JSSE. You can either use a reverse proxy such as Apache, NGINX, Traefik or use Tomcat’s native bindings for APR/OpenSSL. There is an interesting article you can read about this: Tomcat Native / OpenSSL in Spring Boot 2.0