Skip to content

Commit 235b21c

Browse files
authored
Add TLS networking requirements for Chainguard Containers (#2442)
Recently we had many support cases and requests around TLS connectivity, as to what is supported what is required and how to test and debug such connectivity. Document the lowest common denominator of TLS connectivity as supported by: - NIST FIPS - CA/Browser Forum - Let's Encrypt - Fulcio - All Chainguard FIPS and non-FIPS containers It really boils down to a single hash, two signature algorithms, and two pairs of TLS versions with a matching ciphersuite string/group/curve. Preview: - https://deploy-preview-2442--ornate-narwhal-088216.netlify.app/chainguard/chainguard-images/network-requirements/#minimum-tls-requirements
1 parent 6f5e22f commit 235b21c

1 file changed

Lines changed: 21 additions & 0 deletions

File tree

content/chainguard/chainguard-images/network-requirements.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -64,3 +64,24 @@ You will need egress rules that allow new traffic to the hosts listed here. You
6464
Many of the hosts listed on this page use multiple DNS A records or CNAME aliases. Additionally, many A records have a short time to live of 60 seconds, and the majority are less than an hour (3600s).
6565

6666
If your network filters traffic based on IP addresses, ensure that any firewalls update their rules at an appropriate interval to match the TTL for each DNS record.
67+
68+
## Minimum TLS requirements
69+
70+
For guaranteed connectivity, the following TLS requirements must be at
71+
minimum supported by clients and servers communicating with Chainguard
72+
Containers and endpoints:
73+
74+
- TLSv1.3 with the TLS_AES_256_GCM_SHA384 cipher suite
75+
- TLSv1.2 with
76+
- ECDHE-ECDSA-AES256-GCM-SHA384 cipher string
77+
- [RFC 7627](https://datatracker.ietf.org/doc/html/rfc7627) Extended Master Secret Extenstion support
78+
- Signatures using P-256 with SHA-256
79+
- Signatures using RSA-PSS with 2048 bits and SHA-256
80+
81+
The requirements can be approximately tested with the following OpenSSL client command:
82+
83+
```
84+
openssl s_client -cipher @SECLEVEL=2:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384 -ciphersuites TLS_AES_256_GCM_SHA384 -groups P-256 -connect HOST:PORT
85+
```
86+
87+
> Note that in the case of TLSv1.2 connectivity you must check the output for `Extended master secret: yes`.

0 commit comments

Comments
 (0)