Files
skills/public/cryptography-tls-configuration.html
zeekayandHanzo Dev 9e10c1c10e Each llms index points at the other two
hanzoskills.com/llms.txt now opens with the install line, the API
reference index and the company index, so an agent that lands on any
one of the three can find the rest.

robots.txt claimed 537 documents while llms.txt counts 920. The number
is gone from robots.txt; llms.txt derives it.

public/ is regenerated from scripts/site.py, which it had fallen
behind: the copy-prompt menu and agent bar were in the generator and
not in the committed pages. tests/site.mjs passes against the result.

Co-authored-by: Hanzo Dev <[email protected]>
2026-09-11 00:27:59 -07:00

667 lines
29 KiB
HTML

<!doctype html>
<html lang="en"><head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>cryptography-tls-configuration</title>
<meta name="color-scheme" content="dark">
<style>
/* Committed to one visual world: a dark instrument panel. No light variant —
the dot field and the hairline rules only read on black, and a naive
inversion would wash both out. Every colour is painted explicitly so the page
never borrows a host background. */
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
:root{
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
--font-zen-pixel-square:'Zen Pixel Square',monospace;
--mono:var(--font-zen-mono);
--sans:var(--font-zen-sans);
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
--r:999px; --r-soft:14px;
}
*{box-sizing:border-box}
html{-webkit-text-size-adjust:100%}
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
/* The dot field. A halftone made of one repeating radial-gradient, faded out
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
/* No overflow clip here: the dot field is inset to the box already, and a clip
would cut off the copy-prompt menu. */
.hero{position:relative;border-bottom:1px solid var(--line)}
.hero::before{content:"";position:absolute;inset:0;
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
background-size:7px 7px;
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
pointer-events:none}
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
nav{border-bottom:1px solid var(--line)}
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
justify-content:space-between;align-items:center;gap:1rem}
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--ink);text-decoration:none;
display:inline-flex;align-items:center;gap:.6rem}
.brand i{font-style:normal;color:var(--faint)}
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--soft);text-decoration:none}
nav a.up:hover{color:var(--ink)}
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
h1 em{font-style:normal;color:var(--faint)}
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
line-height:1.2;font-weight:400}
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
.btn.solid:hover{background:#d8d8d4}
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
/* Copy-prompt selector. Each row copies the prompt for its own target. */
.copy{position:relative;display:inline-flex}
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
padding:.4rem;display:flex;flex-direction:column;
box-shadow:0 12px 32px rgba(0,0,0,.75)}
.menu[hidden]{display:none}
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
white-space:nowrap}
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
.mi:hover .mark{color:var(--ink)}
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
letter-spacing:.1em;text-transform:uppercase}
/* Works-with bar: one scrolling row, name and mark per agent. */
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
display:flex;align-items:center}
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
-webkit-overflow-scrolling:touch;
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
.bar::-webkit-scrollbar{display:none}
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
text-decoration:none;background:var(--ground)}
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
.agent .mark{width:.95rem;height:.95rem}
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
p{margin:0 0 1rem;max-width:70ch}
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
li{margin:.22rem 0}
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
text-decoration-color:var(--line-hi)}
a:hover{text-decoration-color:var(--ink)}
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
display:block;overflow-x:auto}
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
.curl{display:block;background:var(--panel);border:1px solid var(--line);
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
white-space:pre;line-height:1.9}
.curl b{color:var(--ink);font-weight:400}
.curl i{font-style:normal;color:var(--faint)}
/* index */
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
#q:focus{outline:none;border-color:var(--soft)}
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
text-transform:uppercase;margin:0 0 2rem}
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
padding-bottom:.45rem}
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
border-radius:var(--r-soft);text-decoration:none}
.row:hover{background:#0a0a0a}
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
color:var(--faint);font-size:.85rem}
footer a{color:var(--soft)}
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
margin:0 0 2rem;font-size:.85rem}
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
border-bottom:1px solid var(--line);padding-bottom:.4rem}
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
.fmap a:hover{text-decoration:underline}
.fmap div{color:var(--faint);line-height:1.5}
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
@media (max-width:640px){
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
.btns{gap:.5rem}
.btn{padding:.75rem 1.15rem;font-size:.68rem}
.copy,.copy .btn{width:100%;justify-content:center}
.menu{left:0;right:0;min-width:0}
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
.strip b{border-right:0;padding-right:0}
.bar{width:100%}
}
</style>
<link rel="alternate" type="text/markdown" href="/cryptography-tls-configuration.md">
<link rel="icon" href="/favicon.svg">
<link rel="canonical" href="https://hanzoskills.com/cryptography-tls-configuration">
</head>
<!-- Reading this with a machine? Every page here is also plain markdown.
This one: https://hanzoskills.com/cryptography-tls-configuration.md
Index: https://hanzoskills.com/llms.txt
Corpus: https://hanzoskills.com/all.md
Append .md to any path for the markdown twin. -->
<body>
<nav><div class="in">
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
<a class="up" href="/">All skills</a>
</div></nav>
<div class="wrap">
<h1>cryptography-tls-configuration</h1><p class="lede">TLS/SSL configuration including TLS 1.2/1.3 setup, cipher suites, security best practices, and server configuration</p><h1>TLS Configuration</h1>
<p><strong>Scope</strong>: TLS 1.2/1.3 setup, cipher suites, security configuration, server/client setup <strong>Lines</strong>: ~380 <strong>Last Updated</strong>: 2025-10-27 <strong>Format Version</strong>: 1.0 (Atomic)</p>
<hr>
<h2>When to Use This Skill</h2>
<p>Activate this skill when:</p>
<ul><li>Configuring HTTPS servers</li><li>Setting up TLS for APIs</li><li>Implementing secure client connections</li><li>Troubleshooting TLS handshake issues</li><li>Upgrading from TLS 1.2 to TLS 1.3</li><li>Selecting cipher suites</li><li>Configuring mutual TLS (mTLS)</li><li>Meeting security compliance requirements</li></ul>
<h2>Core Concepts</h2>
<h3>TLS 1.2 vs TLS 1.3</h3>
<p><strong>Key Differences</strong>:</p>
<pre><code>TLS 1.2:
├─ 2-RTT handshake (longer)
├─ Many cipher suites (some weak)
├─ RSA key exchange option
└─ Renegotiation support
TLS 1.3:
├─ 1-RTT handshake (faster)
├─ 0-RTT option (even faster, but replay risk)
├─ Only modern ciphers (AES-GCM, ChaCha20-Poly1305)
├─ Perfect forward secrecy mandatory
└─ No renegotiation</code></pre>
<p><strong>Handshake Comparison</strong>:</p>
<pre><code>TLS 1.2 (2-RTT):
Client → ClientHello
← ServerHello, Certificate, ServerKeyExchange, ServerHelloDone
Client → ClientKeyExchange, ChangeCipherSpec, Finished
← ChangeCipherSpec, Finished
[Application Data]
TLS 1.3 (1-RTT):
Client → ClientHello (with key share)
← ServerHello, Certificate, Finished
Client → Finished
[Application Data]</code></pre>
<h3>Cipher Suites</h3>
<p><strong>TLS 1.3 Cipher Suites</strong> (simplified):</p>
<pre><code>TLS_AES_128_GCM_SHA256
TLS_AES_256_GCM_SHA384
TLS_CHACHA20_POLY1305_SHA256</code></pre>
<p><strong>TLS 1.2 Recommended Cipher Suites</strong>:</p>
<pre><code>TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256</code></pre>
<p><strong>Cipher Suite Components</strong>:</p>
<pre><code>TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
│ │ │ │ └─ Hash: SHA256
│ │ │ └─ Mode: GCM (AEAD)
│ │ └─ Cipher: AES 128-bit
│ └─ Authentication: RSA
└─ Key Exchange: ECDHE (Elliptic Curve Diffie-Hellman Ephemeral)</code></pre>
<hr>
<h2>Server Configuration</h2>
<h3>Nginx</h3>
<p><strong>Modern Configuration</strong>:</p>
<pre><code class="lang-nginx">server {
listen 443 ssl http2;
server_name example.com;
# Certificates
ssl_certificate /etc/ssl/certs/example.com.crt;
ssl_certificate_key /etc/ssl/private/example.com.key;
# TLS versions
ssl_protocols TLSv1.2 TLSv1.3;
# Cipher suites (TLS 1.2)
ssl_ciphers &#x27;ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-CHACHA20-POLY1305&#x27;;
ssl_prefer_server_ciphers on;
# TLS 1.3 ciphers (explicit, though defaults are good)
ssl_conf_command Ciphersuites TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256;
# OCSP stapling
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/ssl/certs/ca-chain.crt;
# Session cache
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 10m;
ssl_session_tickets off;
# HSTS
add_header Strict-Transport-Security &quot;max-age=31536000; includeSubDomains&quot; always;
location / {
proxy_pass http://backend;
}
}</code></pre>
<h3>Apache</h3>
<p><strong>Modern Configuration</strong>:</p>
<pre><code class="lang-apache">&lt;VirtualHost *:443&gt;
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/ssl/certs/example.com.crt
SSLCertificateKeyFile /etc/ssl/private/example.com.key
SSLCertificateChainFile /etc/ssl/certs/ca-chain.crt
# TLS versions
SSLProtocol -all +TLSv1.2 +TLSv1.3
# Cipher suites
SSLCipherSuite ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384
SSLHonorCipherOrder on
# OCSP stapling
SSLUseStapling on
SSLStaplingCache &quot;shmcb:logs/ssl_stapling(32768)&quot;
# HSTS
Header always set Strict-Transport-Security &quot;max-age=31536000; includeSubDomains&quot;
&lt;/VirtualHost&gt;</code></pre>
<h3>Node.js</h3>
<p><strong>HTTPS Server</strong>:</p>
<pre><code class="lang-javascript">const https = require(&#x27;https&#x27;);
const fs = require(&#x27;fs&#x27;);
const options = {
key: fs.readFileSync(&#x27;/etc/ssl/private/example.com.key&#x27;),
cert: fs.readFileSync(&#x27;/etc/ssl/certs/example.com.crt&#x27;),
ca: fs.readFileSync(&#x27;/etc/ssl/certs/ca-chain.crt&#x27;),
// TLS version
minVersion: &#x27;TLSv1.2&#x27;,
maxVersion: &#x27;TLSv1.3&#x27;,
// Cipher suites (TLS 1.2)
ciphers: [
&#x27;ECDHE-RSA-AES128-GCM-SHA256&#x27;,
&#x27;ECDHE-RSA-AES256-GCM-SHA384&#x27;,
&#x27;ECDHE-RSA-CHACHA20-POLY1305&#x27;
].join(&#x27;:&#x27;),
// Prefer server cipher order
honorCipherOrder: true,
// Session resumption
sessionTimeout: 300
};
const server = https.createServer(options, (req, res) =&gt; {
res.writeHead(200);
res.end(&#x27;Secure connection\n&#x27;);
});
server.listen(443, () =&gt; {
console.log(&#x27;HTTPS server running on port 443&#x27;);
});</code></pre>
<hr>
<h2>Client Configuration</h2>
<h3>Python Requests</h3>
<p><strong>Secure Client</strong>:</p>
<pre><code class="lang-python">import requests
from requests.adapters import HTTPAdapter
from urllib3.util.ssl_ import create_urllib3_context
class TLSAdapter(HTTPAdapter):
def init_poolmanager(self, *args, **kwargs):
ctx = create_urllib3_context()
ctx.minimum_version = ssl.TLSVersion.TLSv1_2
ctx.maximum_version = ssl.TLSVersion.TLSv1_3
ctx.set_ciphers(&#x27;ECDHE+AESGCM:ECDHE+CHACHA20&#x27;)
kwargs[&#x27;ssl_context&#x27;] = ctx
return super().init_poolmanager(*args, **kwargs)
session = requests.Session()
session.mount(&#x27;https://&#x27;, TLSAdapter())
# Make request
response = session.get(&#x27;https://api.example.com&#x27;)
print(f&quot;TLS version: {response.raw.version}&quot;) # 771 = TLS 1.2, 772 = TLS 1.3</code></pre>
<h3>Go</h3>
<p><strong>Secure Client</strong>:</p>
<pre><code class="lang-go">package main
import (
&quot;crypto/tls&quot;
&quot;fmt&quot;
&quot;net/http&quot;
)
func main() {
tlsConfig := &amp;tls.Config{
MinVersion: tls.VersionTLS12,
MaxVersion: tls.VersionTLS13,
CipherSuites: []uint16{
tls.TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256,
tls.TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,
tls.TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305,
},
PreferServerCipherSuites: false,
}
client := &amp;http.Client{
Transport: &amp;http.Transport{
TLSClientConfig: tlsConfig,
},
}
resp, err := client.Get(&quot;https://api.example.com&quot;)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Printf(&quot;TLS version: %d\n&quot;, resp.TLS.Version)
fmt.Printf(&quot;Cipher suite: %x\n&quot;, resp.TLS.CipherSuite)
}</code></pre>
<h3>Rust</h3>
<p><strong>Secure Client</strong>:</p>
<pre><code class="lang-rust">use reqwest::ClientBuilder;
use std::time::Duration;
#[tokio::main]
async fn main() -&gt; Result&lt;(), Box&lt;dyn std::error::Error&gt;&gt; {
let client = ClientBuilder::new()
.min_tls_version(reqwest::tls::Version::TLS_1_2)
.max_tls_version(reqwest::tls::Version::TLS_1_3)
.timeout(Duration::from_secs(10))
.build()?;
let response = client
.get(&quot;https://api.example.com&quot;)
.send()
.await?;
println!(&quot;Status: {}&quot;, response.status());
Ok(())
}</code></pre>
<hr>
<h2>Patterns</h2>
<h3>Pattern 1: Mutual TLS (mTLS)</h3>
<p><strong>Server Configuration</strong> (Nginx):</p>
<pre><code class="lang-nginx">server {
listen 443 ssl;
ssl_certificate /etc/ssl/certs/server.crt;
ssl_certificate_key /etc/ssl/private/server.key;
# Client certificate verification
ssl_client_certificate /etc/ssl/certs/ca.crt;
ssl_verify_client on;
ssl_verify_depth 2;
location / {
# Client cert subject available
proxy_set_header X-Client-Cert-DN $ssl_client_s_dn;
proxy_pass http://backend;
}
}</code></pre>
<p><strong>Go Client with mTLS</strong>:</p>
<pre><code class="lang-go">package main
import (
&quot;crypto/tls&quot;
&quot;crypto/x509&quot;
&quot;io/ioutil&quot;
&quot;net/http&quot;
)
func main() {
// Load client cert
cert, err := tls.LoadX509KeyPair(&quot;client.crt&quot;, &quot;client.key&quot;)
if err != nil {
panic(err)
}
// Load CA cert
caCert, err := ioutil.ReadFile(&quot;ca.crt&quot;)
if err != nil {
panic(err)
}
caCertPool := x509.NewCertPool()
caCertPool.AppendCertsFromPEM(caCert)
tlsConfig := &amp;tls.Config{
Certificates: []tls.Certificate{cert},
RootCAs: caCertPool,
MinVersion: tls.VersionTLS12,
}
client := &amp;http.Client{
Transport: &amp;http.Transport{
TLSClientConfig: tlsConfig,
},
}
resp, err := client.Get(&quot;https://api.example.com&quot;)
if err != nil {
panic(err)
}
defer resp.Body.Close()
}</code></pre>
<h3>Pattern 2: TLS Session Resumption</h3>
<p><strong>Session Tickets</strong> (Nginx):</p>
<pre><code class="lang-nginx"># Disable session tickets (privacy)
ssl_session_tickets off;
# Or enable with rotation
ssl_session_tickets on;
ssl_session_ticket_key /etc/ssl/ticket_key1.key;
ssl_session_ticket_key /etc/ssl/ticket_key2.key;</code></pre>
<p><strong>Session Cache</strong> (better option):</p>
<pre><code class="lang-nginx">ssl_session_cache shared:SSL:10m;
ssl_session_timeout 10m;</code></pre>
<hr>
<h2>Best Practices</h2>
<h3>1. Protocol Selection</h3>
<pre><code class="lang-bash"># ✅ Good: TLS 1.2 and 1.3 only
ssl_protocols TLSv1.2 TLSv1.3;
# ❌ Bad: Old protocols
ssl_protocols SSLv3 TLSv1 TLSv1.1 TLSv1.2;</code></pre>
<h3>2. Cipher Suite Selection</h3>
<pre><code class="lang-bash"># ✅ Good: Modern ciphers only
ssl_ciphers &#x27;ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-CHACHA20-POLY1305&#x27;;
# ❌ Bad: Weak ciphers included
ssl_ciphers &#x27;ALL:!aNULL:!eNULL&#x27;;</code></pre>
<h3>3. Perfect Forward Secrecy</h3>
<pre><code class="lang-nginx"># ✅ Good: ECDHE for forward secrecy
ssl_ciphers &#x27;ECDHE-RSA-...&#x27;;
ssl_prefer_server_ciphers on;
# ❌ Bad: Static RSA key exchange
ssl_ciphers &#x27;RSA-AES128-SHA&#x27;;</code></pre>
<h3>4. Certificate Chain</h3>
<pre><code class="lang-python"># ✅ Good: Include full chain
with open(&#x27;fullchain.pem&#x27;) as f: # cert + intermediate
cert = f.read()
# ❌ Bad: Only leaf certificate
with open(&#x27;cert.pem&#x27;) as f: # missing intermediate
cert = f.read()</code></pre>
<h3>5. OCSP Stapling</h3>
<pre><code class="lang-nginx"># ✅ Good: Enable OCSP stapling
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/ssl/certs/ca-chain.crt;
# ❌ Bad: No OCSP stapling (client must check)</code></pre>
<hr>
<h2>Security Headers</h2>
<h3>HTTP Strict Transport Security (HSTS)</h3>
<pre><code class="lang-nginx"># Force HTTPS for 1 year, including subdomains
add_header Strict-Transport-Security &quot;max-age=31536000; includeSubDomains; preload&quot; always;</code></pre>
<h3>Additional Security Headers</h3>
<pre><code class="lang-nginx"># Prevent MIME sniffing
add_header X-Content-Type-Options &quot;nosniff&quot; always;
# XSS protection
add_header X-Frame-Options &quot;SAMEORIGIN&quot; always;
add_header X-XSS-Protection &quot;1; mode=block&quot; always;
# CSP
add_header Content-Security-Policy &quot;default-src &#x27;self&#x27;&quot; always;</code></pre>
<hr>
<h2>Troubleshooting</h2>
<h3>Issue 1: Handshake Failure</h3>
<p><strong>Check with OpenSSL</strong>:</p>
<pre><code class="lang-bash">openssl s_client -connect example.com:443 -tls1_2
openssl s_client -connect example.com:443 -tls1_3</code></pre>
<p><strong>Common causes</strong>:</p>
<ul><li>Mismatched TLS versions</li><li>No common cipher suites</li><li>Invalid certificate chain</li><li>SNI not sent (old clients)</li></ul>
<h3>Issue 2: Performance Issues</h3>
<p><strong>Symptoms</strong>: Slow HTTPS connections</p>
<p><strong>Check</strong>:</p>
<pre><code class="lang-bash"># Measure handshake time
curl -w &quot;time_appconnect: %{time_appconnect}s\n&quot; -o /dev/null -s https://example.com
# Should be &lt; 200ms for TLS 1.3, &lt; 400ms for TLS 1.2</code></pre>
<p><strong>Solutions</strong>:</p>
<ul><li>Enable session resumption</li><li>Use TLS 1.3 (1-RTT)</li><li>Enable OCSP stapling</li><li>Use HTTP/2</li></ul>
<h3>Issue 3: Certificate Chain Issues</h3>
<p><strong>Check chain</strong>:</p>
<pre><code class="lang-bash">openssl s_client -connect example.com:443 -showcerts</code></pre>
<p><strong>Fix</strong>: Ensure full chain in certificate file</p>
<pre><code class="lang-bash">cat cert.pem intermediate.pem &gt; fullchain.pem</code></pre>
<hr>
<h2>Testing TLS Configuration</h2>
<h3>Online Tools</h3>
<pre><code class="lang-bash"># SSL Labs
https://www.ssllabs.com/ssltest/analyze.html?d=example.com
# Mozilla Observatory
https://observatory.mozilla.org/analyze/example.com</code></pre>
<h3>Local Testing</h3>
<pre><code class="lang-bash"># Test specific TLS version
openssl s_client -connect example.com:443 -tls1_2
openssl s_client -connect example.com:443 -tls1_3
# Test cipher suite
openssl s_client -connect example.com:443 -cipher &#x27;ECDHE-RSA-AES128-GCM-SHA256&#x27;
# Test with curl
curl -v --tlsv1.2 --tls-max 1.2 https://example.com
curl -v --tlsv1.3 --tls-max 1.3 https://example.com</code></pre>
<hr>
<h2>TLS 1.3 Migration</h2>
<h3>Gradual Rollout</h3>
<pre><code class="lang-nginx"># Phase 1: Enable TLS 1.3 alongside 1.2
ssl_protocols TLSv1.2 TLSv1.3;
# Phase 2: Monitor adoption (check logs)
# Phase 3: Eventually deprecate TLS 1.2 (if possible)</code></pre>
<h3>Compatibility Considerations</h3>
<pre><code>TLS 1.3 Support (as of 2025):
✅ All modern browsers
✅ Modern programming language libraries
⚠️ Some legacy enterprise systems
❌ Very old clients (pre-2018)</code></pre>
<hr>
<hr>
<h2>Level 3 Resources</h2>
<p>This skill includes comprehensive resources for advanced TLS configuration, testing, and validation.</p>
<h3>Structure</h3>
<pre><code>resources/
├── REFERENCE.md # Detailed TLS specifications, RFCs, cipher suites
├── scripts/ # Executable validation and testing scripts
│ ├── README.md
│ ├── validate_tls_config.sh # Validate nginx/apache TLS configs
│ ├── check_cipher_suites.py # List and verify cipher suites
│ └── test_tls_connection.py # Test TLS connectivity and timing
└── examples/ # Real-world configuration examples
├── nginx/
│ ├── modern-tls-config.conf
│ └── mtls-config.conf
└── python/
├── tls_server.py
└── tls_client.py</code></pre>
<h3>Quick Start</h3>
<p><strong>Validate TLS configuration</strong>:</p>
<pre><code class="lang-bash">cd resources/scripts
./validate_tls_config.sh --file /etc/nginx/nginx.conf --verbose</code></pre>
<p><strong>Check cipher suites on remote host</strong>:</p>
<pre><code class="lang-bash">python check_cipher_suites.py --host example.com --json</code></pre>
<p><strong>Test TLS connection with timing</strong>:</p>
<pre><code class="lang-bash">python test_tls_connection.py example.com --test-all-versions</code></pre>
<p><strong>Reference material</strong>:</p>
<pre><code class="lang-bash">cat resources/REFERENCE.md # TLS 1.2 vs 1.3, cipher suites, RFCs, OCSP</code></pre>
<h3>Use Cases</h3>
<ul><li><strong>Configuration validation</strong>: Validate nginx/apache TLS settings against best practices</li><li><strong>Cipher suite analysis</strong>: Identify weak ciphers and security issues</li><li><strong>Connection testing</strong>: Test TLS handshake, measure timing, verify certificates</li><li><strong>Learning</strong>: Comprehensive reference for TLS protocols and RFCs</li><li><strong>CI/CD integration</strong>: JSON output for automated security testing</li></ul>
<p>See <code>resources/scripts/README.md</code> for detailed usage examples and CI/CD integration patterns.</p>
<hr>
<h2>Related Skills</h2>
<ul><li><code>cryptography-pki-fundamentals</code> - Certificate basics</li><li><code>cryptography-certificate-management</code> - Certificate lifecycle</li><li><code>networking-mtls-implementation</code> - Mutual TLS patterns</li><li><code>protocols-http2-multiplexing</code> - HTTP/2 over TLS</li><li><code>protocols-http3-quic</code> - QUIC with built-in TLS 1.3</li></ul>
<hr>
<p><strong>Last Updated</strong>: 2025-10-27</p>
<footer>
<div class="fmap">
<div><b>Build</b>
<a href="https://hanzo.app">hanzo.app</a> app builder
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
<div><b>Run</b>
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
<div><b>Account</b>
<a href="https://hanzo.id">hanzo.id</a> sign in
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
<div><b>Company</b>
<a href="https://hanzo.ai">hanzo.ai</a> canonical
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
</div>
<div class="fend"><a href="/cryptography-tls-configuration.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
</footer>
</div></body></html>