Base64とは?暗号ではない理由と、使う場面・使ってはいけない場面
この記事の要点
- Base64 は、バイナリデータを、64種類の文字だけで書き表すための変換です。メールや JSON のように、文字しか扱えない場所で、ファイルなどを運ぶために使います。
- Base64 は暗号ではありません。決まった規則の置き換えで、誰でも元に戻せます。パスワードの保護には、使えません。
- 変換すると、データの大きさは約4/3倍(約33%増)になります。
- よくある失敗は、URL用の形(- と _)、先頭の data:…;base64,、日本語の文字コードの3つです。
1. Base64 の仕組み
コンピューターのデータは、バイト(0〜255の数)の並びです。画像や PDF のようなバイナリデータには、メールのシステムや、JSON の文字列の中に、そのまま入れられない値が含まれています。そこで、3バイト(24ビット)を、6ビットずつ4つに分け、それぞれを64種類の文字のどれかで表す、という変換を行います。
使う文字は、A〜Z(26)、a〜z(26)、0〜9(10)、+、/ の、合計64種類です。データの長さが3の倍数でないときは、末尾に =(パディング)を付けて、4文字の区切りに合わせます。
Base64変換ツールと、Node.js で、短い文字列を変換した結果です。
| 元のデータ | バイト数 | Base64 | 文字数 |
|---|---|---|---|
a | 1 | YQ== | 4 |
ab | 2 | YWI= | 4 |
abc | 3 | YWJj | 4 |
abcd | 4 | YWJjZA== | 8 |
Hello, World! | 13 | SGVsbG8sIFdvcmxkIQ== | 20 |
猫の手道具箱 | 18 | 54yr44Gu5omL6YGT5YW3566x | 24 |
1バイトなら ==、2バイトなら = が付き、3バイトちょうどなら付きません。日本語は、UTF-8 で1文字が3バイトなので、「猫の手道具箱」の6文字は18バイトになり、24文字の Base64 になります。
2. 暗号ではないことを、確かめる
Base64 の文字列は、ぱっと見では、意味の分からない文字の並びです。そのため、「暗号化されている」と誤解されることがあります。実際には、誰でも、元に戻せます。
例1: Basic 認証の値
HTTP の Basic 認証では、「ユーザー名:パスワード」を Base64 にして、Authorization: Basic … というヘッダーに入れます。次の値を、Base64変換ツールのデコードに貼り付けました(架空の値です)。
dXNlcjpwYXNzMTIzNA==
→ user:pass1234
ユーザー名もパスワードも、そのまま読めます。Basic 認証が、HTTPS を前提にしているのは、このためです。通信が暗号化されていないと、途中で、誰でも読めてしまいます。
例2: JWT の中身
ログインで使われる JWT(JSON Web Token)は、「ヘッダー.ペイロード.署名」の3つを、ピリオドでつないだ文字列です。ヘッダーとペイロードは、Base64(URL用の形)になっているだけです。次は、架空のペイロードを、ツールでデコードした結果です。
eyJzdWIiOiIxMDAxIiwibmFtZSI6IuWxseeUsCDlpKrpg44iLCJyb2xlIjoiYWRtaW4iLCJleHAiOjE4OTM0NTYwMDB9
→ {"sub":"1001","name":"山田 太郎","role":"admin","exp":1893456000}
JWT の署名は、「内容が書き換えられていないこと」を確かめるためのもので、中身を隠すものではありません。ペイロードに、パスワードや、他人に見られたくない情報を入れてはいけません。
JWT の中身を確認するときは、真ん中のペイロードの部分だけを、デコードします。トークンの全体を貼り付けると、ピリオドがあるため、エラーになります。
3. 使われる場面
| 場面 | 使われかた |
|---|---|
| メールの添付ファイル | メールは、もともと文字だけを運ぶ仕組みです。添付ファイルは、Base64 に変換して本文に入れます。メールのソースを開くと、長い Base64 の文字列が見えます。 |
| HTML・CSS への画像の埋め込み | data:image/png;base64,… の形で、画像を、ファイルを別に用意せずに埋め込めます(データ URI)。 |
| JSON の API でのファイルの受け渡し | JSON はバイナリを直接入れられないため、画像や PDF を、Base64 の文字列にして、項目に入れます。 |
| HTTP の Basic 認証 | 「ユーザー名:パスワード」を Base64 にして送ります。 |
| JWT | ヘッダーとペイロードを、URL 用の Base64 で表します。 |
共通するのは、「文字しか通らない場所」を、バイナリが通れるようにする、という目的です。データを守るためではなく、運ぶための変換です。
4. データの大きさ
3バイトが4文字になるため、Base64 にすると、データの大きさは、約4/3倍(約33%増)になります。1MB の画像は、約1.33MB の文字列になります。
- HTML や CSS に、大きな画像を、データ URI で埋め込むと、ページのデータが重くなります。また、画像のキャッシュも、効きにくくなります。小さなアイコン程度にとどめます。
- API でファイルを受け渡すときは、通信量が約33%増えます。大きなファイルは、別の方法(ファイルのアップロード専用の仕組み)を検討します。
- Base64変換ツールは、ブラウザのメモリの中で処理します。数十MBを超えるファイルは、端末によっては失敗することがあります。
5. つまずきやすい点
URL 用の Base64(- と _)
通常の Base64 には、+ と / が含まれます。これらは、URL の中では特別な意味を持つため、URL や JWT では、+ を -、/ を _ に置き換えた「URL 用の形」(Base64url)を使います。末尾の = も、省くことがあります。
たとえば、3バイト(FB FF FE)は、通常の形では +//+、URL 用の形では -__- になります。Base64変換ツールのデコードは、URL 用の形を、そのままでは読めません。-__- を貼り付けると、デコードエラーになります。- を + に、_ を / に置き換えてから貼り付けてください。末尾の = は、無くても、このツールでは読めます。
エラーのときの注意: このツールは、エラーが出ても、前回のデコード結果が、結果の欄に残ります。エラーが出たときは、結果の欄の内容を使わないでください。
先頭の data:…;base64,
データ URI の形(data:image/png;base64,iVBORw0KGgo…)は、Base64 の本体の前に、種類を示す部分が付いています。この部分は、Base64 ではないため、デコードする前に取り除きます。逆に、エンコードの結果を、HTML の img タグの src に使うときは、data:image/png;base64, を、自分で前に付けます。画像の種類に合わせて、png の部分を変えてください。
日本語の文字コード
Base64 は、バイトの並びの変換です。日本語の文字列を変換するときは、先に、どの文字コードでバイトにするかが決まります。Base64変換ツールは、UTF-8 で変換します。
ブラウザの JavaScript の btoa() は、日本語を直接渡すと、InvalidCharacterError になります(Node.js で確かめました)。日本語を扱うときは、UTF-8 のバイトにしてから、変換します。Python では、base64.b64encode('猫の手'.encode()) で、54yr44Gu5omL になりました。
デコードした結果が、UTF-8 のテキストでないとき(Shift_JIS のテキストや、バイナリ)は、このツールは「[バイナリデータ] ○ バイト」と表示します。その場合は、「ファイルとしてダウンロード」で保存してください。
途中の改行
メールのソースにある Base64 は、76文字ごとに改行が入っています。Base64変換ツールのデコードは、途中の空白や改行があっても読めます。一方、エンコードの結果は、1行につながった形で出力します。76文字ごとの折り返しは入りません。
6. 使ってはいけない場面
- パスワードや個人情報の「保護」。Base64 にしても、誰でも読めます。設定ファイルや、ログ、コードに、Base64 にしたパスワードを書いても、守ったことにはなりません。ソースコードのリポジトリに、Base64 の認証情報が入っていれば、漏えいと同じです。
- ログの「マスク」。ログに出すトークンを、Base64 にしても、隠したことにはなりません。
- パスワードの保存。パスワードをデータベースに保存するときは、Base64 ではなく、bcrypt や Argon2 のような、パスワード用のハッシュを使います。なお、ハッシュ生成ツールは、パスワードの保存用のハッシュ(bcrypt、Argon2、salt 付き)には、対応していません。
内容を守りたいときは、暗号化(AES など)を使います。Base64 は、暗号化したあとのバイナリを、文字として運ぶために、その後ろで使うものです。
本物の認証情報を、貼り付けるときの注意: Base64変換ツールは、入力した内容を、サーバーに送りません。それでも、本番のパスワードや、有効なトークンは、画面共有や、ブラウザの履歴・拡張機能に残る可能性があります。確認が済んだら、そのトークンは、無効にするか、変更することをおすすめします。
7. よくある質問
- 末尾の
=は、必要ですか? - Base64変換ツールのデコードでは、無くても読めます(
SGVsbG8はHelloになります)。ただし、読み込む側のプログラムによっては、=が必要です。ツールのエンコードの結果には、必要な=が付きます。 - デコードが「エラー」になります。
- 多くの場合は、次のどれかです。
-と_を使った URL 用の形になっている。先頭にdata:…;base64,が付いている。途中に、Base64 で使わない文字が入っている。文字列が、途中で切れている。JWT の全体(ピリオドを含む)を貼り付けている。 - 画像を Base64 にして、HTML に埋め込めますか?
- ファイルを選んでエンコードし、結果の前に
data:image/png;base64,を付けると、imgタグのsrcに使えます。大きな画像は、HTML が重くなるので、向きません。 - Base64 にしたデータは、サーバーに送られますか?
- 送られません。変換は、ブラウザの中だけで行います。