mirror of
https://github.com/hanzoai/skills.git
synced 2026-11-19 00:47:36 +00:00
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]>
667 lines
29 KiB
HTML
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 'ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-CHACHA20-POLY1305';
|
|
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 "max-age=31536000; includeSubDomains" always;
|
|
|
|
location / {
|
|
proxy_pass http://backend;
|
|
}
|
|
}</code></pre>
|
|
<h3>Apache</h3>
|
|
<p><strong>Modern Configuration</strong>:</p>
|
|
<pre><code class="lang-apache"><VirtualHost *:443>
|
|
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 "shmcb:logs/ssl_stapling(32768)"
|
|
|
|
# HSTS
|
|
Header always set Strict-Transport-Security "max-age=31536000; includeSubDomains"
|
|
</VirtualHost></code></pre>
|
|
<h3>Node.js</h3>
|
|
<p><strong>HTTPS Server</strong>:</p>
|
|
<pre><code class="lang-javascript">const https = require('https');
|
|
const fs = require('fs');
|
|
|
|
const options = {
|
|
key: fs.readFileSync('/etc/ssl/private/example.com.key'),
|
|
cert: fs.readFileSync('/etc/ssl/certs/example.com.crt'),
|
|
ca: fs.readFileSync('/etc/ssl/certs/ca-chain.crt'),
|
|
|
|
// TLS version
|
|
minVersion: 'TLSv1.2',
|
|
maxVersion: 'TLSv1.3',
|
|
|
|
// Cipher suites (TLS 1.2)
|
|
ciphers: [
|
|
'ECDHE-RSA-AES128-GCM-SHA256',
|
|
'ECDHE-RSA-AES256-GCM-SHA384',
|
|
'ECDHE-RSA-CHACHA20-POLY1305'
|
|
].join(':'),
|
|
|
|
// Prefer server cipher order
|
|
honorCipherOrder: true,
|
|
|
|
// Session resumption
|
|
sessionTimeout: 300
|
|
};
|
|
|
|
const server = https.createServer(options, (req, res) => {
|
|
res.writeHead(200);
|
|
res.end('Secure connection\n');
|
|
});
|
|
|
|
server.listen(443, () => {
|
|
console.log('HTTPS server running on port 443');
|
|
});</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('ECDHE+AESGCM:ECDHE+CHACHA20')
|
|
kwargs['ssl_context'] = ctx
|
|
return super().init_poolmanager(*args, **kwargs)
|
|
|
|
session = requests.Session()
|
|
session.mount('https://', TLSAdapter())
|
|
|
|
# Make request
|
|
response = session.get('https://api.example.com')
|
|
print(f"TLS version: {response.raw.version}") # 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 (
|
|
"crypto/tls"
|
|
"fmt"
|
|
"net/http"
|
|
)
|
|
|
|
func main() {
|
|
tlsConfig := &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 := &http.Client{
|
|
Transport: &http.Transport{
|
|
TLSClientConfig: tlsConfig,
|
|
},
|
|
}
|
|
|
|
resp, err := client.Get("https://api.example.com")
|
|
if err != nil {
|
|
panic(err)
|
|
}
|
|
defer resp.Body.Close()
|
|
|
|
fmt.Printf("TLS version: %d\n", resp.TLS.Version)
|
|
fmt.Printf("Cipher suite: %x\n", 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() -> Result<(), Box<dyn std::error::Error>> {
|
|
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("https://api.example.com")
|
|
.send()
|
|
.await?;
|
|
|
|
println!("Status: {}", 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 (
|
|
"crypto/tls"
|
|
"crypto/x509"
|
|
"io/ioutil"
|
|
"net/http"
|
|
)
|
|
|
|
func main() {
|
|
// Load client cert
|
|
cert, err := tls.LoadX509KeyPair("client.crt", "client.key")
|
|
if err != nil {
|
|
panic(err)
|
|
}
|
|
|
|
// Load CA cert
|
|
caCert, err := ioutil.ReadFile("ca.crt")
|
|
if err != nil {
|
|
panic(err)
|
|
}
|
|
caCertPool := x509.NewCertPool()
|
|
caCertPool.AppendCertsFromPEM(caCert)
|
|
|
|
tlsConfig := &tls.Config{
|
|
Certificates: []tls.Certificate{cert},
|
|
RootCAs: caCertPool,
|
|
MinVersion: tls.VersionTLS12,
|
|
}
|
|
|
|
client := &http.Client{
|
|
Transport: &http.Transport{
|
|
TLSClientConfig: tlsConfig,
|
|
},
|
|
}
|
|
|
|
resp, err := client.Get("https://api.example.com")
|
|
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 'ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-CHACHA20-POLY1305';
|
|
|
|
# ❌ Bad: Weak ciphers included
|
|
ssl_ciphers 'ALL:!aNULL:!eNULL';</code></pre>
|
|
<h3>3. Perfect Forward Secrecy</h3>
|
|
<pre><code class="lang-nginx"># ✅ Good: ECDHE for forward secrecy
|
|
ssl_ciphers 'ECDHE-RSA-...';
|
|
ssl_prefer_server_ciphers on;
|
|
|
|
# ❌ Bad: Static RSA key exchange
|
|
ssl_ciphers 'RSA-AES128-SHA';</code></pre>
|
|
<h3>4. Certificate Chain</h3>
|
|
<pre><code class="lang-python"># ✅ Good: Include full chain
|
|
with open('fullchain.pem') as f: # cert + intermediate
|
|
cert = f.read()
|
|
|
|
# ❌ Bad: Only leaf certificate
|
|
with open('cert.pem') 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 "max-age=31536000; includeSubDomains; preload" always;</code></pre>
|
|
<h3>Additional Security Headers</h3>
|
|
<pre><code class="lang-nginx"># Prevent MIME sniffing
|
|
add_header X-Content-Type-Options "nosniff" always;
|
|
|
|
# XSS protection
|
|
add_header X-Frame-Options "SAMEORIGIN" always;
|
|
add_header X-XSS-Protection "1; mode=block" always;
|
|
|
|
# CSP
|
|
add_header Content-Security-Policy "default-src 'self'" 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 "time_appconnect: %{time_appconnect}s\n" -o /dev/null -s https://example.com
|
|
|
|
# Should be < 200ms for TLS 1.3, < 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 > 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 'ECDHE-RSA-AES128-GCM-SHA256'
|
|
|
|
# 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> |