Cipher suite · 0x13,0x03
TLS_CHACHA20_POLY1305_SHA256
TLS_CHACHA20_POLY1305_SHA256 (0x13,0x03) is a TLS 1.3 cipher suite: ChaCha20-Poly1305 authenticated encryption with SHA256 as the HKDF hash. In TLS 1.3 the key exchange and authentication are negotiated separately, so the suite name doesn't contain them. ssl.sh rates it Recommended.
Details
- IANA name
TLS_CHACHA20_POLY1305_SHA256- Hex code
0x13,0x03(4867)- OpenSSL
TLS_CHACHA20_POLY1305_SHA256- GnuTLS
TLS_CHACHA20_POLY1305_SHA256(min. TLS 1.3)- Key exchange
- any (negotiated separately)
- Authentication
- any (negotiated separately)
- Encryption
- ChaCha20-Poly1305 AEAD
- MAC
- AEAD · hash SHA256
- TLS versions
- TLS 1.3
- IANA "Recommended"
- Y — recommended by the IETF · DTLS-OK: Y
- References
- RFC 9846
What each component means
A cipher suite names the algorithms a client and server agree on in one handshake. TLS_CHACHA20_POLY1305_SHA256 combines the ChaCha20-Poly1305 AEAD with the SHA256 hash. Each part is explained below with its known weaknesses; for the bigger picture see how cipher suites work.
TLS 1.3 suites only describe the symmetric part. The TLS 1.3 specification (RFC 9846) says its suites specify only the symmetric ciphers and cannot be used with TLS 1.2. Key exchange is negotiated separately through the supported_groups and key_share extensions (for example X25519, P-256 or the hybrid X25519MLKEM768) and is always ephemeral (EC)DHE unless a client resumes in the PSK-only psk_ke mode, so a full handshake always has forward secrecy. The certificate signature algorithm (for example RSA-PSS, ECDSA or Ed25519) is negotiated with signature_algorithms. In TLS_CHACHA20_POLY1305_SHA256, SHA256 is the hash behind the HKDF key schedule and the handshake transcript hash.
Encryption: ChaCha20-Poly1305, an AEAD pairing the ChaCha20 stream cipher (256-bit key) with the Poly1305 authenticator and a 16-byte tag. It is fast and constant-time in plain software, so clients without AES instructions often put it first. The TLS 1.3 specification lists it among the suites an implementation SHOULD support, next to the mandatory TLS_AES_128_GCM_SHA256.
Why this rating
ssl.sh rating: Recommended. The reasons:
- A TLS 1.3 suite marked "Recommended" by IANA; TLS 1.3 always uses ephemeral key exchange and AEAD.
Which TLS libraries support it
Support for TLS_CHACHA20_POLY1305_SHA256 as read from each library's own source code or official documentation on 2026-11-10. “Enabled by default” means the library negotiates it with no configuration; “off by default” means it is implemented but has to be switched on.
| Library | Status | Details |
|---|---|---|
| OpenSSL 3.5 | Implemented | cipher string TLS_CHACHA20_POLY1305_SHA256 |
| GnuTLS | Implemented | name TLS_CHACHA20_POLY1305_SHA256; minimum protocol TLS 1.3 |
| BoringSSL | Enabled by default | |
| Go crypto/tls | Enabled by default | returned by tls.CipherSuites() |
| NSS 3.133 | Enabled by default | NSS library default |
| Firefox | Enabled by default | about:config pref security.tls13.chacha20_poly1305_sha256 |
| Java 21 (SunJSSE) | Enabled by default | |
| Windows Schannel (Windows 11 / Server 2022) | Supported, off by default | |
| rustls 0.23.46 | Enabled by default | dropped from the defaults in builds with the fips feature |
Enabled by default in 6 of the 9 libraries tracked here: BoringSSL, Go crypto/tls, NSS 3.133, Firefox, Java 21 (SunJSSE) and rustls 0.23.46. Supported but off by default in: Windows Schannel (Windows 11 / Server 2022). Also implemented by: OpenSSL 3.5 and GnuTLS.
NSS shows the library's own defaults; Firefox switches every NSS suite off at start-up and re-enables only those with a security.ssl3.* or security.tls13.* preference. Java defaults are derived from the jdk.tls.disabledAlgorithms value Oracle documents for JDK 21, which later updates may extend. The OpenSSL and GnuTLS rows only show whether the suite is implemented.
History and standards status
TLS_CHACHA20_POLY1305_SHA256 (0x13,0x03) is registered in the IANA TLS Cipher Suites registry with RFC 9846, “The Transport Layer Security (TLS) Protocol Version 1.3” (July 2026, Standards Track) as its specification. TLS 1.3 was first published as RFC 8446 (2018) and republished as RFC 9846 (2026), which obsoletes RFC 8446. Section 9.1 of the specification makes TLS_AES_128_GCM_SHA256 mandatory to implement and says implementations SHOULD also support TLS_AES_256_GCM_SHA384 and TLS_CHACHA20_POLY1305_SHA256. The registry marks it Recommended (Y).
Enable or disable it in Nginx and Apache
Enable
Both servers use OpenSSL names. The snippet keeps a modern list and adds this suite; TLS 1.3 suites are configured separately from the TLS 1.2 list.
# Nginx
ssl_protocols TLSv1.2 TLSv1.3;
# nginx 1.19.4+ with OpenSSL 1.1.1+
ssl_conf_command Ciphersuites TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256;
# Apache httpd (mod_ssl)
SSLProtocol -all +TLSv1.2 +TLSv1.3
SSLCipherSuite TLSv1.3 TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256
Disable
Either leave the suite out of your list or exclude it explicitly with a leading "!". Reload the server afterwards (nginx -s reload, apachectl graceful).
# Nginx
ssl_conf_command Ciphersuites TLS_AES_256_GCM_SHA384:TLS_AES_128_GCM_SHA256;
# Apache httpd (mod_ssl)
SSLCipherSuite TLSv1.3 TLS_AES_256_GCM_SHA384:TLS_AES_128_GCM_SHA256
How to test whether a server accepts it
Offer only TLS_CHACHA20_POLY1305_SHA256 with openssl s_client; if the handshake completes, the server accepts it:
openssl s_client -connect example.com:443 -tls1_3 -ciphersuites TLS_CHACHA20_POLY1305_SHA256 </dev/null
If the handshake succeeds, the server accepts the suite; "no cipher match" or a handshake failure means it doesn't.
nmap's ssl-enum-ciphers script connects repeatedly, trying one suite at a time, and lists every suite the server accepts with a grade from A to F. Look for TLS_CHACHA20_POLY1305_SHA256 in its output:
nmap --script ssl-enum-ciphers -p 443 example.com
If your nmap build doesn't print a TLS 1.3 section, rely on the openssl command instead.
To decode a name or hex code, use the cipher suite lookup; the SSL checker shows which protocol versions a live server accepts and the cipher suite it negotiates.
FAQ
Is TLS_CHACHA20_POLY1305_SHA256 secure?
Yes. ssl.sh rates it recommended. A TLS 1.3 suite marked "Recommended" by IANA; TLS 1.3 always uses ephemeral key exchange and AEAD. Section 9.1 of the specification makes TLS_AES_128_GCM_SHA256 mandatory to implement and says implementations SHOULD also support TLS_AES_256_GCM_SHA384 and TLS_CHACHA20_POLY1305_SHA256.
Can TLS_CHACHA20_POLY1305_SHA256 be used with TLS 1.3?
Yes. It is a TLS 1.3 suite, so it only works with TLS 1.3; a TLS 1.2 handshake cannot negotiate it. OpenSSL enables it by default (TLS_CHACHA20_POLY1305_SHA256 is in OpenSSL's default TLS 1.3 list).
How do I enable TLS_CHACHA20_POLY1305_SHA256 in Nginx or Apache?
TLS 1.3 suites are not controlled by ssl_ciphers. List TLS_CHACHA20_POLY1305_SHA256 in ssl_conf_command Ciphersuites in Nginx (1.19.4+ with OpenSSL 1.1.1+) or in SSLCipherSuite TLSv1.3 in Apache httpd, then reload.
Which clients and libraries still support TLS_CHACHA20_POLY1305_SHA256?
Out of the box: BoringSSL, Go crypto/tls, NSS 3.133, Firefox, Java 21 (SunJSSE) and rustls 0.23.46. Only after explicit configuration: Windows Schannel (Windows 11 / Server 2022). Implemented, default state not tracked here: OpenSSL 3.5 and GnuTLS.
Sources
- IANA — TLS Cipher Suites registry
- OpenSSL 3.5 — openssl-ciphers(1)
- GnuTLS — lib/algorithms/ciphersuites.c
- BoringSSL — ssl/ssl_cipher.cc (main) (2026-11-10)
- Go — src/crypto/tls/cipher_suites.go (master) (2026-11-10)
- Go — src/crypto/tls/defaults.go (master) (2026-11-10)
- NSS — lib/ssl/ssl3con.c (as vendored in Firefox) (2026-11-10)
- NSS — TAG-INFO (2026-11-10)
- Firefox — security/manager/ssl/nsNSSComponent.cpp (2026-11-10)
- Firefox — modules/libpref/init/StaticPrefList.yaml (2026-11-10)
- Oracle — JDK 21 Providers Documentation: SunJSSE Cipher Suites (2026-11-10)
- Oracle — JDK 21 JSSE Reference Guide: jdk.tls.disabledAlgorithms (2026-11-10)
- Microsoft Learn — TLS Cipher Suites in Windows 11 (2026-11-10)
- Microsoft Learn — TLS Cipher Suites in Windows Server 2022 (2026-11-10)
- docs.rs — rustls 0.23.46 crypto::aws_lc_rs (default provider) (2026-11-10)
- RFC Editor — RFC index
- Nmap — ssl-enum-ciphers