Base64 鍵ジェネレーター

鍵の生成方法

1. 設定しようとしているものに合うプリセットをクリックします。ページを開いた時点では 32 バイト が選ばれています。
2. ランダム値 から値をコピーします。Laravel や Auth.js のように設定行があるプリセットでは、すぐ貼り付けられる形式 にもその行が表示されます。
3. 別の鍵が必要なら 再生成 を押します。個数 を増やせば、環境ごとに 1 つずつなど、複数の鍵をまとめて作れます。

プリセットはバイト数と形式を自動で設定します。どちらかの項目を変更すると、値はそのままで カスタム に切り替わります。

プリセットと各鍵の使い道

CSP nonce プリセットは用途が異なるため、専用ページの CSP nonce ジェネレーター があります。

サイズは各アルゴリズムに合わせています。AES の鍵はちょうど 16、24、32 バイトのいずれかで、それ以外は受け付けられません。RFC 7518 では HS256 のシークレットに 256 ビット以上を求めているため、JWT プリセットは 32 バイトです。ハッシュの出力より短い HMAC 鍵は HMAC を弱めるので、HMAC-SHA256 には 32 バイト、HMAC-SHA512 には 64 バイトのプリセットが適しています。Django プリセットは棄却サンプリングで 50 文字を選ぶため、アルファベットのどの文字も同じ確率で出現します。Django 自身の get_random_secret_key() と同じ挙動です。

Base64 の鍵はテキスト、鍵の実体はバイト列

コピーした値は、ランダムなバイト列を Base64 で表したものです。使う側のコードでは先にデコードする必要があります。

import base64, os

key = base64.b64decode(os.environ["AES_KEY"])
assert len(key) == 32

Node.js では Buffer.from(process.env.AES_KEY, "base64") で同じことができます。44 文字の文字列をそのまま AES ライブラリに渡すと、拒否される（Python なら AESGCM key must be 128, 192, or 256 bits、Node.js なら Invalid key length）か、緩いライブラリでは何も警告せずに間違ったバイト列を使ってしまいます。Laravel の base64: 接頭辞のように、フレームワークが自分の鍵を読む場合は、このデコードを自動で行います。

Base64URL と標準の Base64 はデコードすれば同じバイト列になりますが、パーサーはどちらを受け付けるかに厳しいことがよくあります。受け取る側がもう一方に対応していると分かっている場合を除き、プリセットが出力した形式のまま使ってください。

Fernet の鍵とその他の形式

Python の cryptography パッケージは、Fernet の鍵として 32 バイトをパディング付きの URLセーフ Base64 にした 44 文字を想定しています。JWT や API トークンのプリセットは = なしの URLセーフ形式を出力するので、末尾に 1 つ足すか、Python で生成してください。

from cryptography.fernet import Fernet

print(Fernet.generate_key().decode())

それ以外の形式は、バイト数から考えます。カスタム を選び、ライブラリのドキュメントにあるバイト数を入力して、Base64、Base64URL、16進数のいずれかを選んでください。出力の長さについては ランダム Base64 ジェネレーター で解説しています。HMAC を Base64 で や AES 暗号化 を使えば、生成した鍵をすぐに試せます。

生成後の鍵の扱い

ここで生成した鍵は、コピーするまでこのタブの中にしか存在しません。コピーした後の安全性は、貼り付けた先次第です。本番用の鍵はプラットフォームのシークレットストアやシークレットマネージャーに保管し、環境ごとに別の鍵を使い、決してコミットしないでください。Git リポジトリに入ってしまった鍵は公開されたものとみなして交換すべきです。暗号鍵をローテーションするには、古いデータを再暗号化するか、復号用に古い鍵を残しておく必要があります。稼働中のシステムで APP_KEY を差し替える前に、その計画を立てておきましょう。

よくある質問