JWT 密钥生成器

在浏览器本地免费生成密码学安全的随机 HMAC 密钥,支持 HS256、HS384 和 HS512。

生成 JWT 密钥

算法
输出编码

切换编码会保留原始字节。

进阶生成

结果在当前浏览器内生成。点击复制会将结果写入剪贴板。

使用密钥

将 JWT_SECRET_B64URL 配置行保存到示例代码同目录的 .env 文件。该值始终采用无填充的 Base64URL,示例解码后再用于 HMAC。

JWT_SECRET_B64URL=<your-base64url-secret>

密钥配置帮助

请勿将密钥提交到版本库。

怎样生成 JWT 密钥?

打开页面就会自动生成一把密钥,选好算法后直接复制即可。在「算法」中选择 HS256、HS384 或 HS512,「密钥长度(字节)」保持最小值,或最多调到 256,改动任一项都会生成新密钥。在「输出编码」中选择 Hex、Base64 或 Base64URL,切换编码不会改变密钥字节。最后点击「复制密钥」;如果要写入 .env,可在「使用密钥」里点击「复制 .env 行」,得到现成的 JWT_SECRET_B64URL 配置行。需要新密钥时点击「重新生成」。

HMAC 密钥长度
最小密钥长度与编码后的字符数
算法bitBHexBase64Base64URL
HS25625632644443
HS38438448966464
HS512512641288886

HS256 至少需要 32 字节,HS384 至少 48 字节,HS512 至少 64 字节,因为 RFC 7518 §3.2 要求 HMAC 密钥不小于哈希输出的长度。切换编码不会改变原始字节:32 字节的密钥显示为 64 个 Hex 字符、44 个带填充的 Base64 字符,或 43 个无填充的 Base64URL 字符。

常见问题

访问令牌和刷新令牌要用不同的密钥吗?

为刷新令牌单独配一把密钥是常见的最佳实践,但 JWT 和 OAuth 规范并没有强制要求。两把密钥互不影响:一把泄露或轮换,另一把不受牵连,签给一种用途的令牌也不能冒充另一种。可以在本页再生成一把,用单独的变量保存,例如 JWT_REFRESH_SECRET。OWASP 的 JWT 备忘单只在不会出现令牌类型混淆时才认可共用一把密钥,所以还应校验令牌类型或 audience 声明。如果刷新令牌是存在服务端的不透明随机字符串,而不是签名的 JWT,就完全不需要签名密钥。

怎样用命令行(cmd)生成 JWT 密钥?

用 OpenSSL、Node.js、Python 或 PowerShell 都行,下面每条命令都会用密码学安全的随机源输出 32 个随机字节,正好是 HS256 的最小长度。普通 cmd.exe 没有内置的安全随机数生成命令,请改用 PowerShell,或者在 cmd 里通过 powershell -Command 调用。单行的 PowerShell 示例需要 PowerShell 7.2 及以上;Windows PowerShell 5.1 请用第二条。Node.js 的 base64url 输出需要 Node.js 14.18 及以上。OpenSSL 输出的是带 +、/ 和 = 的标准 Base64,需要 Base64URL 时,再用 tr '+/' '-_' 和 tr -d '=' 处理一下。

OpenSSL,Base64(44 个字符)
openssl rand -base64 32
OpenSSL,Hex(64 个字符)
openssl rand -hex 32
Node.js,Base64URL(43 个字符)
node -e "console.log(require('crypto').randomBytes(32).toString('base64url'))"
Python,Base64URL(43 个字符)
python3 -c "import secrets; print(secrets.token_urlsafe(32))"
PowerShell 7.2+,Base64(44 个字符)
[Convert]::ToBase64String([System.Security.Cryptography.RandomNumberGenerator]::GetBytes(32))
Windows PowerShell 5.1,Base64(44 个字符)
$b = New-Object byte[] 32; [System.Security.Cryptography.RandomNumberGenerator]::Create().GetBytes($b); [Convert]::ToBase64String($b)

这个生成器用 Base64 编码吗?

默认以无填充的 Base64URL 显示密钥,也可以随时切换为 Hex 或标准 Base64,底层的随机字节不变。32 字节的密钥是 43 个 Base64URL 字符、44 个 Base64 字符或 64 个 Hex 字符。「复制 .env 行」始终输出无填充 Base64URL 格式的 JWT_SECRET_B64URL,页面里的示例代码会先解码再签名。请确认你用的库怎样读取字符串密钥:jsonwebtoken、PyJWT 和 Hasura 会原样使用这个字符串,也就是编码后的文本本身成了密钥;jose 需要你自己构造字节;jjwt 则要你自己选择解码器。两种做法都可行,前提是签发方和验证方对这个字符串的理解一致。

JWT_SECRET_KEY 应该填什么?

填一段足够长的随机字符串:在本页生成密钥,粘贴 Hex 或 Base64URL 的值,可以避开标准 Base64 里的 +、/ 和 =。Flask-JWT-Extended 读取 JWT_SECRET_KEY,没设置时回退到 Flask 的 SECRET_KEY。django-graphql-jwt 也有 JWT_SECRET_KEY 设置,默认值是 Django 的 SECRET_KEY,GraphQL JWT 用它来签发令牌。Hasura 把密钥放在 HASURA_GRAPHQL_JWT_SECRET 这段 JSON 里,与算法类型并列,HS256 的密钥至少要有 32 个字符。请把密钥放进环境变量或密钥管理服务,不要提交到版本库,并让所有需要验证令牌的服务使用同一个值。本页的 .env 行特意命名为 JWT_SECRET_B64URL,请按你的框架改成对应的变量名。如果某个服务先把它解码成字节再使用,所有验证令牌的服务都要用同样的方式解码。

JWT 密钥要多长?32 个字符够吗?

HS256 至少用 32 个随机字节,HS384 用 48 个,HS512 用 64 个。RFC 7518 §3.2 要求 HMAC 密钥不小于哈希输出的长度,这是长度要求,而不是熵的要求。32 个字符的文本是 32 字节,满足 HS256 的长度,但 32 个随机字母和数字只有约 190 位熵,低于 32 个随机字节的 256 位。这仍然远超暴力破解的能力,不过文本要用 43 个字母和数字才能达到完整的 HS256 强度。在「进阶生成」里选「JWT 随机文本」,HS256 会从 62 字符集生成 43 个字符,从含符号的字符集生成 40 个。字节模式下密钥最长可到 256 字节。不要把自己记得住的口令当作密钥。

这个 JWT 密钥生成器的随机性够安全吗?

够安全:密钥来自 crypto.getRandomValues,也就是浏览器 Web Crypto 提供的随机数生成器,不是 Math.random,随机字节在你的设备上生成。文本模式使用拒绝采样:丢弃会造成偏差的随机字节,让字符集中每个字符出现的概率相同。这符合 OWASP 的建议:JWT 密钥应由本地的、密码学安全的生成器产生。

能离线使用吗?需要浏览器扩展吗?

页面加载完成后,生成密钥不需要网络,密钥也不会离开你的浏览器。本站没有浏览器扩展,也不需要扩展,把页面加入书签即可快速打开。如果开启了使用统计,只会记录选择了哪种算法这类信息,不会包含密钥或你输入的任何内容;开启 Do Not Track 或 Global Privacy Control 时不会统计,详见页面底部的「使用统计」。