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]>
594 lines
24 KiB
HTML
594 lines
24 KiB
HTML
<!doctype html>
|
|
<html lang="en"><head>
|
|
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<title>cryptography-sni-routing</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-sni-routing.md">
|
|
|
|
<link rel="icon" href="/favicon.svg">
|
|
<link rel="canonical" href="https://hanzoskills.com/cryptography-sni-routing">
|
|
</head>
|
|
<!-- Reading this with a machine? Every page here is also plain markdown.
|
|
This one: https://hanzoskills.com/cryptography-sni-routing.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-sni-routing</h1><p class="lede">Server Name Indication (SNI) for multi-domain TLS hosting, routing, and configuration patterns</p><h1>SNI (Server Name Indication)</h1>
|
|
<p><strong>Scope</strong>: SNI protocol extension, multi-domain TLS hosting, routing, security implications <strong>Lines</strong>: ~290 <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>Hosting multiple HTTPS domains on one IP</li><li>Configuring reverse proxies with TLS</li><li>Implementing TLS-based routing</li><li>Troubleshooting certificate mismatch errors</li><li>Setting up multi-tenant systems</li><li>Working with load balancers</li><li>Debugging old client compatibility</li><li>Implementing TLS termination</li></ul>
|
|
<h2>Core Concepts</h2>
|
|
<h3>What is SNI?</h3>
|
|
<p><strong>Problem SNI Solves</strong>:</p>
|
|
<pre><code>Before SNI (circa 2003):
|
|
Client → [TLS Handshake]
|
|
← [Certificate for ???]
|
|
Problem: Server doesn't know which certificate to send!
|
|
|
|
With SNI (2003+):
|
|
Client → [TLS Handshake + hostname: "example.com"]
|
|
← [Certificate for example.com]
|
|
Solution: Server sends correct certificate</code></pre>
|
|
<p><strong>How SNI Works</strong>:</p>
|
|
<pre><code>1. Client initiates TLS handshake
|
|
2. Client includes hostname in ClientHello (SNI extension)
|
|
3. Server selects appropriate certificate based on SNI
|
|
4. Server continues handshake with correct certificate
|
|
5. Encrypted connection established</code></pre>
|
|
<h3>SNI in ClientHello</h3>
|
|
<p><strong>TLS Handshake with SNI</strong>:</p>
|
|
<pre><code>ClientHello
|
|
├─ Version: TLS 1.2
|
|
├─ Random: [32 bytes]
|
|
├─ Cipher Suites: [...]
|
|
└─ Extensions:
|
|
└─ server_name (SNI):
|
|
├─ name_type: host_name (0)
|
|
└─ host_name: "example.com"</code></pre>
|
|
<p><strong>Viewing SNI with tcpdump</strong>:</p>
|
|
<pre><code class="lang-bash">sudo tcpdump -i any -A 'tcp port 443' | grep -i "server_name"</code></pre>
|
|
<hr>
|
|
<h2>Server Configuration</h2>
|
|
<h3>Nginx</h3>
|
|
<p><strong>Multi-domain setup</strong>:</p>
|
|
<pre><code class="lang-nginx"># Domain 1
|
|
server {
|
|
listen 443 ssl;
|
|
server_name example.com www.example.com;
|
|
|
|
ssl_certificate /etc/ssl/certs/example.com.crt;
|
|
ssl_certificate_key /etc/ssl/private/example.com.key;
|
|
|
|
location / {
|
|
proxy_pass http://backend1;
|
|
}
|
|
}
|
|
|
|
# Domain 2
|
|
server {
|
|
listen 443 ssl;
|
|
server_name api.example.com;
|
|
|
|
ssl_certificate /etc/ssl/certs/api.example.com.crt;
|
|
ssl_certificate_key /etc/ssl/private/api.example.com.key;
|
|
|
|
location / {
|
|
proxy_pass http://backend2;
|
|
}
|
|
}
|
|
|
|
# Domain 3
|
|
server {
|
|
listen 443 ssl;
|
|
server_name another-domain.com;
|
|
|
|
ssl_certificate /etc/ssl/certs/another-domain.com.crt;
|
|
ssl_certificate_key /etc/ssl/private/another-domain.com.key;
|
|
|
|
location / {
|
|
proxy_pass http://backend3;
|
|
}
|
|
}</code></pre>
|
|
<p><strong>SNI-based routing</strong>:</p>
|
|
<pre><code class="lang-nginx"># Route based on SNI to different backends
|
|
map $ssl_server_name $backend {
|
|
example.com backend1:8080;
|
|
api.example.com backend2:8080;
|
|
admin.example.com backend3:8080;
|
|
default backend1:8080;
|
|
}
|
|
|
|
server {
|
|
listen 443 ssl;
|
|
server_name _;
|
|
|
|
ssl_certificate /etc/ssl/certs/default.crt;
|
|
ssl_certificate_key /etc/ssl/private/default.key;
|
|
|
|
location / {
|
|
proxy_pass http://$backend;
|
|
proxy_set_header Host $ssl_server_name;
|
|
}
|
|
}</code></pre>
|
|
<h3>Apache</h3>
|
|
<p><strong>Multi-domain setup</strong>:</p>
|
|
<pre><code class="lang-apache"># Domain 1
|
|
<VirtualHost *:443>
|
|
ServerName example.com
|
|
ServerAlias www.example.com
|
|
|
|
SSLEngine on
|
|
SSLCertificateFile /etc/ssl/certs/example.com.crt
|
|
SSLCertificateKeyFile /etc/ssl/private/example.com.key
|
|
</VirtualHost>
|
|
|
|
# Domain 2
|
|
<VirtualHost *:443>
|
|
ServerName api.example.com
|
|
|
|
SSLEngine on
|
|
SSLCertificateFile /etc/ssl/certs/api.example.com.crt
|
|
SSLCertificateKeyFile /etc/ssl/private/api.example.com.key
|
|
</VirtualHost>
|
|
|
|
# Enable SNI
|
|
SSLStrictSNIVHostCheck on</code></pre>
|
|
<h3>Go HTTP Server</h3>
|
|
<p><strong>Multi-domain TLS</strong>:</p>
|
|
<pre><code class="lang-go">package main
|
|
|
|
import (
|
|
"crypto/tls"
|
|
"fmt"
|
|
"net/http"
|
|
)
|
|
|
|
func main() {
|
|
// Load certificates for different domains
|
|
cert1, _ := tls.LoadX509KeyPair("example.com.crt", "example.com.key")
|
|
cert2, _ := tls.LoadX509KeyPair("api.example.com.crt", "api.example.com.key")
|
|
|
|
tlsConfig := &tls.Config{
|
|
Certificates: []tls.Certificate{cert1, cert2},
|
|
MinVersion: tls.VersionTLS12,
|
|
}
|
|
|
|
// Go automatically handles SNI with multiple certificates
|
|
server := &http.Server{
|
|
Addr: ":443",
|
|
TLSConfig: tlsConfig,
|
|
Handler: http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
|
|
fmt.Fprintf(w, "Connected to: %s\n", r.Host)
|
|
}),
|
|
}
|
|
|
|
server.ListenAndServeTLS("", "")
|
|
}</code></pre>
|
|
<p><strong>Custom SNI logic</strong>:</p>
|
|
<pre><code class="lang-go">tlsConfig := &tls.Config{
|
|
GetCertificate: func(hello *tls.ClientHelloInfo) (*tls.Certificate, error) {
|
|
// Custom logic based on SNI
|
|
switch hello.ServerName {
|
|
case "example.com", "www.example.com":
|
|
return &cert1, nil
|
|
case "api.example.com":
|
|
return &cert2, nil
|
|
default:
|
|
return &defaultCert, nil
|
|
}
|
|
},
|
|
}</code></pre>
|
|
<hr>
|
|
<h2>Client Configuration</h2>
|
|
<h3>Python</h3>
|
|
<p><strong>Set SNI explicitly</strong>:</p>
|
|
<pre><code class="lang-python">import ssl
|
|
import socket
|
|
|
|
hostname = 'example.com'
|
|
context = ssl.create_default_context()
|
|
|
|
with socket.create_connection((hostname, 443)) as sock:
|
|
# SNI automatically set from server_hostname parameter
|
|
with context.wrap_socket(sock, server_hostname=hostname) as ssock:
|
|
print(f"SNI sent for: {hostname}")
|
|
print(f"Certificate subject: {ssock.getpeercert()['subject']}")</code></pre>
|
|
<p><strong>Requests library</strong> (SNI automatic):</p>
|
|
<pre><code class="lang-python">import requests
|
|
|
|
# SNI automatically extracted from URL
|
|
response = requests.get('https://example.com')</code></pre>
|
|
<h3>cURL</h3>
|
|
<pre><code class="lang-bash"># SNI automatically sent
|
|
curl https://example.com
|
|
|
|
# Test different SNI vs Host header
|
|
curl --resolve example.com:443:192.168.1.1 https://example.com
|
|
|
|
# Test SNI with different hostname
|
|
curl --connect-to example.com:443:api.example.com:443 https://example.com</code></pre>
|
|
<hr>
|
|
<h2>Patterns</h2>
|
|
<h3>Pattern 1: Wildcard Certificates with SNI</h3>
|
|
<p><strong>Setup</strong>:</p>
|
|
<pre><code class="lang-nginx">server {
|
|
listen 443 ssl;
|
|
server_name *.example.com;
|
|
|
|
# Single wildcard cert for all subdomains
|
|
ssl_certificate /etc/ssl/certs/wildcard.example.com.crt;
|
|
ssl_certificate_key /etc/ssl/private/wildcard.example.com.key;
|
|
|
|
# Route based on subdomain
|
|
location / {
|
|
set $subdomain "";
|
|
if ($host ~* "^(.+)\.example\.com$") {
|
|
set $subdomain $1;
|
|
}
|
|
|
|
proxy_pass http://$subdomain-backend:8080;
|
|
}
|
|
}</code></pre>
|
|
<h3>Pattern 2: Multi-Tenant Systems</h3>
|
|
<p><strong>Tenant-specific certificates</strong>:</p>
|
|
<pre><code class="lang-go">package main
|
|
|
|
import (
|
|
"crypto/tls"
|
|
"database/sql"
|
|
"net/http"
|
|
)
|
|
|
|
type CertStore struct {
|
|
db *sql.DB
|
|
}
|
|
|
|
func (cs *CertStore) GetCertificate(hello *tls.ClientHelloInfo) (*tls.Certificate, error) {
|
|
// Fetch tenant cert from database based on SNI
|
|
var certPEM, keyPEM string
|
|
err := cs.db.QueryRow(
|
|
"SELECT cert, key FROM tenant_certs WHERE domain = ?",
|
|
hello.ServerName,
|
|
).Scan(&certPEM, &keyPEM)
|
|
|
|
if err != nil {
|
|
// Return default cert
|
|
return getDefaultCert()
|
|
}
|
|
|
|
cert, err := tls.X509KeyPair([]byte(certPEM), []byte(keyPEM))
|
|
return &cert, err
|
|
}
|
|
|
|
func main() {
|
|
store := &CertStore{db: initDB()}
|
|
|
|
tlsConfig := &tls.Config{
|
|
GetCertificate: store.GetCertificate,
|
|
MinVersion: tls.VersionTLS12,
|
|
}
|
|
|
|
server := &http.Server{
|
|
Addr: ":443",
|
|
TLSConfig: tlsConfig,
|
|
Handler: myHandler(),
|
|
}
|
|
|
|
server.ListenAndServeTLS("", "")
|
|
}</code></pre>
|
|
<h3>Pattern 3: Default Certificate Fallback</h3>
|
|
<pre><code class="lang-nginx"># Catch-all for invalid SNI
|
|
server {
|
|
listen 443 ssl default_server;
|
|
server_name _;
|
|
|
|
ssl_certificate /etc/ssl/certs/default.crt;
|
|
ssl_certificate_key /etc/ssl/private/default.key;
|
|
|
|
return 404;
|
|
}
|
|
|
|
# Specific domains
|
|
server {
|
|
listen 443 ssl;
|
|
server_name example.com;
|
|
|
|
ssl_certificate /etc/ssl/certs/example.com.crt;
|
|
ssl_certificate_key /etc/ssl/private/example.com.key;
|
|
|
|
# ... normal config
|
|
}</code></pre>
|
|
<hr>
|
|
<h2>Security Considerations</h2>
|
|
<h3>SNI Leaks Hostname</h3>
|
|
<p><strong>Problem</strong>: SNI is sent in plaintext during handshake</p>
|
|
<pre><code>Eavesdropper can see:
|
|
✓ Destination hostname (from SNI)
|
|
✓ Client IP
|
|
✓ Connection timing
|
|
✗ Actual data (encrypted)</code></pre>
|
|
<p><strong>Solution</strong>: Encrypted Client Hello (ECH) / ESNI</p>
|
|
<pre><code class="lang-nginx"># Enable ECH (nginx 1.25+)
|
|
ssl_ech on;
|
|
ssl_ech_key /etc/ssl/ech-key.pem;</code></pre>
|
|
<h3>SNI Spoofing</h3>
|
|
<p><strong>Attack</strong>: Client sends wrong SNI to bypass routing</p>
|
|
<p><strong>Mitigation</strong>:</p>
|
|
<pre><code class="lang-nginx"># Verify SNI matches Host header
|
|
server {
|
|
if ($ssl_server_name != $host) {
|
|
return 421 "Mismatch Error";
|
|
}
|
|
}</code></pre>
|
|
<hr>
|
|
<h2>Troubleshooting</h2>
|
|
<h3>Issue 1: Certificate Mismatch</h3>
|
|
<p><strong>Symptom</strong>: Certificate doesn't match hostname</p>
|
|
<p><strong>Check SNI sent</strong>:</p>
|
|
<pre><code class="lang-bash">openssl s_client -connect example.com:443 -servername example.com -tlsextdebug</code></pre>
|
|
<p><strong>Common causes</strong>:</p>
|
|
<ul><li>Client not sending SNI (very old clients)</li><li>SNI mismatch with Host header</li><li>Server not configured for SNI</li></ul>
|
|
<h3>Issue 2: Old Clients Without SNI</h3>
|
|
<p><strong>Affected clients</strong>:</p>
|
|
<pre><code>- IE 6 on Windows XP
|
|
- Java 6
|
|
- Python < 2.7.9
|
|
- Android < 2.3</code></pre>
|
|
<p><strong>Workaround</strong>: Dedicated IP per domain</p>
|
|
<pre><code class="lang-nginx"># Different IPs for each domain
|
|
server {
|
|
listen 192.168.1.10:443 ssl;
|
|
server_name example.com;
|
|
ssl_certificate /etc/ssl/certs/example.com.crt;
|
|
}
|
|
|
|
server {
|
|
listen 192.168.1.11:443 ssl;
|
|
server_name api.example.com;
|
|
ssl_certificate /etc/ssl/certs/api.example.com.crt;
|
|
}</code></pre>
|
|
<h3>Issue 3: Load Balancer SNI</h3>
|
|
<p><strong>Problem</strong>: Load balancer needs to route based on SNI</p>
|
|
<p><strong>Solution</strong> (HAProxy):</p>
|
|
<pre><code class="lang-haproxy">frontend https_front
|
|
bind *:443
|
|
mode tcp
|
|
tcp-request inspect-delay 5s
|
|
tcp-request content accept if { req_ssl_hello_type 1 }
|
|
|
|
use_backend example_com if { req_ssl_sni -i example.com }
|
|
use_backend api_example_com if { req_ssl_sni -i api.example.com }
|
|
default_backend default_backend
|
|
|
|
backend example_com
|
|
mode tcp
|
|
server server1 192.168.1.10:443
|
|
|
|
backend api_example_com
|
|
mode tcp
|
|
server server2 192.168.1.11:443</code></pre>
|
|
<hr>
|
|
<h2>Testing SNI</h2>
|
|
<h3>Check SNI Support</h3>
|
|
<pre><code class="lang-bash"># Test with specific SNI
|
|
openssl s_client -connect 192.168.1.1:443 -servername example.com
|
|
|
|
# Test without SNI (should get default cert)
|
|
openssl s_client -connect 192.168.1.1:443 -noservername
|
|
|
|
# Test different SNI values
|
|
for domain in example.com api.example.com unknown.com; do
|
|
echo "Testing SNI: $domain"
|
|
openssl s_client -connect 192.168.1.1:443 -servername $domain 2>/dev/null | \
|
|
openssl x509 -noout -subject
|
|
done</code></pre>
|
|
<hr>
|
|
<h2>Related Skills</h2>
|
|
<ul><li><code>cryptography-pki-fundamentals</code> - Certificate basics</li><li><code>cryptography-tls-configuration</code> - TLS setup</li><li><code>networking-load-balancing</code> - Load balancer configuration</li><li><code>proxies-reverse-proxy</code> - Reverse proxy patterns</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-sni-routing.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
|
|
</footer>
|
|
</div></body></html> |