Files
skills/public/cryptography-sni-routing.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

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&#x27;t know which certificate to send!
With SNI (2003+):
Client → [TLS Handshake + hostname: &quot;example.com&quot;]
← [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: &quot;example.com&quot;</code></pre>
<p><strong>Viewing SNI with tcpdump</strong>:</p>
<pre><code class="lang-bash">sudo tcpdump -i any -A &#x27;tcp port 443&#x27; | grep -i &quot;server_name&quot;</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
&lt;VirtualHost *:443&gt;
ServerName example.com
ServerAlias www.example.com
SSLEngine on
SSLCertificateFile /etc/ssl/certs/example.com.crt
SSLCertificateKeyFile /etc/ssl/private/example.com.key
&lt;/VirtualHost&gt;
# Domain 2
&lt;VirtualHost *:443&gt;
ServerName api.example.com
SSLEngine on
SSLCertificateFile /etc/ssl/certs/api.example.com.crt
SSLCertificateKeyFile /etc/ssl/private/api.example.com.key
&lt;/VirtualHost&gt;
# 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 (
&quot;crypto/tls&quot;
&quot;fmt&quot;
&quot;net/http&quot;
)
func main() {
// Load certificates for different domains
cert1, _ := tls.LoadX509KeyPair(&quot;example.com.crt&quot;, &quot;example.com.key&quot;)
cert2, _ := tls.LoadX509KeyPair(&quot;api.example.com.crt&quot;, &quot;api.example.com.key&quot;)
tlsConfig := &amp;tls.Config{
Certificates: []tls.Certificate{cert1, cert2},
MinVersion: tls.VersionTLS12,
}
// Go automatically handles SNI with multiple certificates
server := &amp;http.Server{
Addr: &quot;:443&quot;,
TLSConfig: tlsConfig,
Handler: http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
fmt.Fprintf(w, &quot;Connected to: %s\n&quot;, r.Host)
}),
}
server.ListenAndServeTLS(&quot;&quot;, &quot;&quot;)
}</code></pre>
<p><strong>Custom SNI logic</strong>:</p>
<pre><code class="lang-go">tlsConfig := &amp;tls.Config{
GetCertificate: func(hello *tls.ClientHelloInfo) (*tls.Certificate, error) {
// Custom logic based on SNI
switch hello.ServerName {
case &quot;example.com&quot;, &quot;www.example.com&quot;:
return &amp;cert1, nil
case &quot;api.example.com&quot;:
return &amp;cert2, nil
default:
return &amp;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 = &#x27;example.com&#x27;
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&quot;SNI sent for: {hostname}&quot;)
print(f&quot;Certificate subject: {ssock.getpeercert()[&#x27;subject&#x27;]}&quot;)</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(&#x27;https://example.com&#x27;)</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 &quot;&quot;;
if ($host ~* &quot;^(.+)\.example\.com$&quot;) {
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 (
&quot;crypto/tls&quot;
&quot;database/sql&quot;
&quot;net/http&quot;
)
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(
&quot;SELECT cert, key FROM tenant_certs WHERE domain = ?&quot;,
hello.ServerName,
).Scan(&amp;certPEM, &amp;keyPEM)
if err != nil {
// Return default cert
return getDefaultCert()
}
cert, err := tls.X509KeyPair([]byte(certPEM), []byte(keyPEM))
return &amp;cert, err
}
func main() {
store := &amp;CertStore{db: initDB()}
tlsConfig := &amp;tls.Config{
GetCertificate: store.GetCertificate,
MinVersion: tls.VersionTLS12,
}
server := &amp;http.Server{
Addr: &quot;:443&quot;,
TLSConfig: tlsConfig,
Handler: myHandler(),
}
server.ListenAndServeTLS(&quot;&quot;, &quot;&quot;)
}</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 &quot;Mismatch Error&quot;;
}
}</code></pre>
<hr>
<h2>Troubleshooting</h2>
<h3>Issue 1: Certificate Mismatch</h3>
<p><strong>Symptom</strong>: Certificate doesn&#x27;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 &lt; 2.7.9
- Android &lt; 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 &quot;Testing SNI: $domain&quot;
openssl s_client -connect 192.168.1.1:443 -servername $domain 2&gt;/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>