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]>
488 lines
23 KiB
HTML
488 lines
23 KiB
HTML
<!doctype html>
|
|
<html lang="en"><head>
|
|
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<title>cryptography-ssl-legacy</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-ssl-legacy.md">
|
|
|
|
<link rel="icon" href="/favicon.svg">
|
|
<link rel="canonical" href="https://hanzoskills.com/cryptography-ssl-legacy">
|
|
</head>
|
|
<!-- Reading this with a machine? Every page here is also plain markdown.
|
|
This one: https://hanzoskills.com/cryptography-ssl-legacy.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-ssl-legacy</h1><p class="lede">Legacy SSL/TLS protocols (SSL 2.0/3.0, TLS 1.0/1.1), vulnerabilities, deprecation, and migration strategies</p><h1>Legacy SSL/TLS Protocols</h1>
|
|
<p><strong>Scope</strong>: SSL 2.0/3.0, TLS 1.0/1.1, vulnerabilities, migration to modern TLS <strong>Lines</strong>: ~310 <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>Understanding SSL/TLS history</li><li>Migrating from legacy protocols</li><li>Supporting legacy clients</li><li>Addressing security vulnerabilities</li><li>Meeting compliance requirements (PCI DSS, HIPAA)</li><li>Debugging compatibility issues</li><li>Planning protocol deprecation</li><li>Conducting security audits</li></ul>
|
|
<h2>Protocol Timeline</h2>
|
|
<pre><code>1995: SSL 2.0 (deprecated 2011)
|
|
1996: SSL 3.0 (deprecated 2015)
|
|
1999: TLS 1.0 (deprecated 2020)
|
|
2006: TLS 1.1 (deprecated 2020)
|
|
2008: TLS 1.2 (current, widely supported)
|
|
2018: TLS 1.3 (current, modern)</code></pre>
|
|
<hr>
|
|
<h2>SSL 2.0</h2>
|
|
<h3>Overview</h3>
|
|
<p><strong>Released</strong>: 1995 <strong>Deprecated</strong>: 2011 (RFC 6176) <strong>Status</strong>: MUST NOT be used</p>
|
|
<h3>Major Vulnerabilities</h3>
|
|
<pre><code>1. No protection for handshake
|
|
2. Weak MAC construction
|
|
3. Same key for encryption and MAC
|
|
4. Downgrade attacks possible
|
|
5. No certificate chain verification</code></pre>
|
|
<h3>Detection</h3>
|
|
<pre><code class="lang-bash"># Test if SSL 2.0 is enabled (should fail)
|
|
openssl s_client -connect example.com:443 -ssl2</code></pre>
|
|
<p><strong>Expected output</strong> (secure):</p>
|
|
<pre><code>error:1407F0E5:SSL routines:SSL2_WRITE:ssl handshake failure</code></pre>
|
|
<hr>
|
|
<h2>SSL 3.0</h2>
|
|
<h3>Overview</h3>
|
|
<p><strong>Released</strong>: 1996 <strong>Deprecated</strong>: 2015 (RFC 7568) <strong>Status</strong>: MUST NOT be used</p>
|
|
<h3>POODLE Attack</h3>
|
|
<p><strong>Vulnerability</strong>: Padding Oracle On Downgraded Legacy Encryption</p>
|
|
<p><strong>Impact</strong>: CBC mode ciphers can be exploited to decrypt data</p>
|
|
<p><strong>Exploit</strong>:</p>
|
|
<pre><code>1. Force downgrade to SSL 3.0
|
|
2. Use CBC cipher
|
|
3. Inject chosen plaintext
|
|
4. Decrypt 1 byte per 256 requests
|
|
5. Recover session cookies</code></pre>
|
|
<p><strong>Mitigation</strong>: Disable SSL 3.0 entirely</p>
|
|
<pre><code class="lang-nginx"># Nginx
|
|
ssl_protocols TLSv1.2 TLSv1.3;
|
|
|
|
# Apache
|
|
SSLProtocol -all +TLSv1.2 +TLSv1.3</code></pre>
|
|
<hr>
|
|
<h2>TLS 1.0</h2>
|
|
<h3>Overview</h3>
|
|
<p><strong>Released</strong>: 1999 (RFC 2246) <strong>Deprecated</strong>: 2020 <strong>Status</strong>: Should not be used</p>
|
|
<h3>Known Vulnerabilities</h3>
|
|
<p><strong>BEAST</strong> (2011):</p>
|
|
<ul><li>Browser Exploit Against SSL/TLS</li><li>CBC cipher vulnerability</li><li>Mitigated by using TLS 1.1+ or RC4</li></ul>
|
|
<p><strong>CRIME</strong> (2012):</p>
|
|
<ul><li>Compression Ratio Info-leak Made Easy</li><li>Exploits TLS compression</li><li>Mitigation: Disable compression</li></ul>
|
|
<p><strong>Example vulnerable configuration</strong>:</p>
|
|
<pre><code class="lang-nginx"># ❌ Bad: Includes TLS 1.0
|
|
ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
|
|
ssl_ciphers ALL:!aNULL:!eNULL;</code></pre>
|
|
<h3>Browser Support End Dates</h3>
|
|
<pre><code>Chrome: Disabled January 2020
|
|
Firefox: Disabled March 2020
|
|
Safari: Disabled March 2020
|
|
Edge: Disabled January 2020</code></pre>
|
|
<hr>
|
|
<h2>TLS 1.1</h2>
|
|
<h3>Overview</h3>
|
|
<p><strong>Released</strong>: 2006 (RFC 4346) <strong>Deprecated</strong>: 2020 <strong>Status</strong>: Should not be used</p>
|
|
<h3>Improvements over TLS 1.0</h3>
|
|
<pre><code>+ Explicit IV for CBC (BEAST mitigation)
|
|
+ Protection against CBC attacks
|
|
+ Better PRNG requirements</code></pre>
|
|
<h3>Why Still Deprecated?</h3>
|
|
<pre><code>- No modern cipher suites (no AEAD)
|
|
- No perfect forward secrecy requirement
|
|
- No modern features (SNI optional)
|
|
- Superseded by TLS 1.2/1.3</code></pre>
|
|
<hr>
|
|
<h2>Migration Strategies</h2>
|
|
<h3>Phase 1: Assessment</h3>
|
|
<p><strong>Identify current usage</strong>:</p>
|
|
<pre><code class="lang-bash"># Check server configuration
|
|
openssl s_client -connect example.com:443 -tls1
|
|
openssl s_client -connect example.com:443 -tls1_1
|
|
|
|
# Analyze logs for client versions
|
|
awk '{print $9}' access.log | sort | uniq -c</code></pre>
|
|
<p><strong>Python script to analyze TLS versions</strong>:</p>
|
|
<pre><code class="lang-python">import ssl
|
|
import socket
|
|
from collections import Counter
|
|
|
|
def check_tls_version(host, port=443):
|
|
versions = []
|
|
for version in [ssl.TLSVersion.TLSv1, ssl.TLSVersion.TLSv1_1,
|
|
ssl.TLSVersion.TLSv1_2, ssl.TLSVersion.TLSv1_3]:
|
|
try:
|
|
context = ssl.SSLContext(ssl.PROTOCOL_TLS_CLIENT)
|
|
context.minimum_version = version
|
|
context.maximum_version = version
|
|
with socket.create_connection((host, port)) as sock:
|
|
with context.wrap_socket(sock, server_hostname=host) as ssock:
|
|
versions.append(ssock.version())
|
|
except:
|
|
pass
|
|
return versions
|
|
|
|
# Check what server supports
|
|
supported = check_tls_version('example.com')
|
|
print(f"Supported versions: {supported}")</code></pre>
|
|
<h3>Phase 2: Communication</h3>
|
|
<p><strong>Announce deprecation timeline</strong>:</p>
|
|
<pre><code>T-180 days: Announce deprecation plan
|
|
T-90 days: Remind users, provide migration guide
|
|
T-30 days: Final warning
|
|
T-0: Disable legacy protocols
|
|
T+30 days: Monitor for issues</code></pre>
|
|
<p><strong>Migration notice template</strong>:</p>
|
|
<pre><code>Subject: Action Required: TLS 1.0/1.1 Deprecation
|
|
|
|
We are upgrading our security by disabling TLS 1.0 and 1.1 on [DATE].
|
|
|
|
Required Action:
|
|
- Update clients to support TLS 1.2 or 1.3
|
|
- Test your integration before [DATE]
|
|
|
|
How to Check:
|
|
$ openssl s_client -connect api.example.com:443 -tls1_2
|
|
|
|
Support: [email protected]</code></pre>
|
|
<h3>Phase 3: Gradual Rollout</h3>
|
|
<p><strong>Progressive enforcement</strong>:</p>
|
|
<pre><code class="lang-nginx"># Week 1-2: Log warnings
|
|
map $ssl_protocol $is_legacy {
|
|
"TLSv1" "1";
|
|
"TLSv1.1" "1";
|
|
default "0";
|
|
}
|
|
|
|
server {
|
|
if ($is_legacy = "1") {
|
|
add_header X-TLS-Deprecated "true" always;
|
|
}
|
|
}
|
|
|
|
# Week 3-4: Specific endpoints only
|
|
location /api/v2 {
|
|
if ($is_legacy = "1") {
|
|
return 426 "Upgrade Required: TLS 1.2+ needed";
|
|
}
|
|
}
|
|
|
|
# Week 5+: Full enforcement
|
|
ssl_protocols TLSv1.2 TLSv1.3;</code></pre>
|
|
<h3>Phase 4: Monitoring</h3>
|
|
<p><strong>Track migration progress</strong>:</p>
|
|
<pre><code class="lang-bash"># Count requests by TLS version
|
|
awk '{print $ssl_protocol}' access.log | sort | uniq -c
|
|
|
|
# Alert on legacy usage
|
|
if grep -q "TLSv1.0\|TLSv1.1" access.log; then
|
|
echo "ALERT: Legacy TLS detected"
|
|
fi</code></pre>
|
|
<hr>
|
|
<h2>Legacy Client Support</h2>
|
|
<h3>Compatibility Matrix</h3>
|
|
<p>| Client | TLS 1.2 | TLS 1.3 | |--------|---------|---------| | Chrome 30+ | ✅ | Chrome 70+ | | Firefox 27+ | ✅ | Firefox 63+ | | Safari 7+ | ✅ | Safari 12.1+ | | IE 11 | ✅ | ❌ | | Python 2.7.9+ | ✅ | Python 3.7+ | | Java 8+ | ✅ | Java 11+ | | .NET 4.5+ | ✅ | .NET Core 3.0+ |</p>
|
|
<h3>Handling Legacy Clients</h3>
|
|
<p><strong>Option 1: Separate endpoint</strong>:</p>
|
|
<pre><code class="lang-nginx"># Modern endpoint
|
|
server {
|
|
listen 443 ssl;
|
|
server_name api.example.com;
|
|
ssl_protocols TLSv1.2 TLSv1.3;
|
|
}
|
|
|
|
# Legacy endpoint (isolated)
|
|
server {
|
|
listen 8443 ssl;
|
|
server_name legacy.example.com;
|
|
ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
|
|
|
|
# Additional monitoring/restrictions
|
|
limit_req zone=legacy burst=5;
|
|
}</code></pre>
|
|
<p><strong>Option 2: User agent detection</strong>:</p>
|
|
<pre><code class="lang-nginx">map $http_user_agent $allow_legacy {
|
|
"~*MSIE [6-9]" "1";
|
|
"~*Windows NT 5" "1";
|
|
default "0";
|
|
}
|
|
|
|
server {
|
|
ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
|
|
|
|
if ($allow_legacy != "1") {
|
|
ssl_protocols TLSv1.2 TLSv1.3;
|
|
}
|
|
}</code></pre>
|
|
<hr>
|
|
<h2>Compliance Requirements</h2>
|
|
<h3>PCI DSS</h3>
|
|
<pre><code>Requirement 4.1 (as of June 2018):
|
|
- TLS 1.0 must be disabled
|
|
- TLS 1.1 can be used until June 2024
|
|
- TLS 1.2+ recommended</code></pre>
|
|
<h3>NIST Guidelines</h3>
|
|
<pre><code>NIST SP 800-52 Rev. 2:
|
|
- TLS 1.2 minimum
|
|
- TLS 1.3 recommended
|
|
- SSL 2.0/3.0, TLS 1.0/1.1 prohibited</code></pre>
|
|
<h3>HIPAA</h3>
|
|
<pre><code>Not specific about TLS version, but requires:
|
|
- Current security standards
|
|
- Protection against known vulnerabilities
|
|
→ Effectively requires TLS 1.2+</code></pre>
|
|
<hr>
|
|
<h2>Vulnerability Summary</h2>
|
|
<p>| Protocol | Critical Vulnerabilities | |----------|-------------------------| | SSL 2.0 | Multiple fundamental flaws | | SSL 3.0 | POODLE | | TLS 1.0 | BEAST, CRIME | | TLS 1.1 | No AEAD support | | TLS 1.2 | ROBOT (RSA only) | | TLS 1.3 | None known (as of 2025) |</p>
|
|
<hr>
|
|
<h2>Testing Legacy Protocol Support</h2>
|
|
<h3>Detect Enabled Protocols</h3>
|
|
<pre><code class="lang-bash">#!/bin/bash
|
|
HOST=$1
|
|
PORT=${2:-443}
|
|
|
|
for version in ssl2 ssl3 tls1 tls1_1 tls1_2 tls1_3; do
|
|
echo -n "Testing $version: "
|
|
if openssl s_client -connect $HOST:$PORT -$version </dev/null 2>/dev/null | grep -q "Protocol"; then
|
|
echo "✅ Enabled"
|
|
else
|
|
echo "❌ Disabled"
|
|
fi
|
|
done</code></pre>
|
|
<h3>Automated Scanning</h3>
|
|
<pre><code class="lang-bash"># Using testssl.sh
|
|
./testssl.sh --protocols example.com
|
|
|
|
# Using nmap
|
|
nmap --script ssl-enum-ciphers -p 443 example.com
|
|
|
|
# Using sslscan
|
|
sslscan example.com:443</code></pre>
|
|
<hr>
|
|
<h2>Best Practices</h2>
|
|
<h3>1. Minimum TLS Version</h3>
|
|
<pre><code class="lang-nginx"># ✅ Good: TLS 1.2 minimum
|
|
ssl_protocols TLSv1.2 TLSv1.3;
|
|
|
|
# ⚠️ Acceptable: TLS 1.2 only (legacy support)
|
|
ssl_protocols TLSv1.2;
|
|
|
|
# ❌ Bad: Legacy protocols enabled
|
|
ssl_protocols TLSv1 TLSv1.1 TLSv1.2;</code></pre>
|
|
<h3>2. Regular Audits</h3>
|
|
<pre><code class="lang-bash"># Monthly check for legacy protocol usage
|
|
0 0 1 * * /usr/local/bin/check-tls-versions.sh | mail -s "TLS Audit" [email protected]</code></pre>
|
|
<h3>3. Document Exceptions</h3>
|
|
<pre><code class="lang-yaml"># legacy-clients.yaml
|
|
allowed_legacy_clients:
|
|
- ip: 192.168.1.100
|
|
reason: "Legacy medical device - upgrade planned Q3 2025"
|
|
approved_by: "security-team"
|
|
expires: "2025-09-30"</code></pre>
|
|
<hr>
|
|
<h2>Related Skills</h2>
|
|
<ul><li><code>cryptography-tls-configuration</code> - Modern TLS setup</li><li><code>cryptography-crypto-best-practices</code> - Security practices</li><li><code>protocols-protocol-debugging</code> - TLS troubleshooting</li><li><code>security-vulnerability-assessment</code> - Security auditing</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-ssl-legacy.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
|
|
</footer>
|
|
</div></body></html> |