猫の手道具箱ロゴ

猫の手道具箱

このサイトは社内情シスやPGに役立ちそうなツールを公開しています。

English

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文字数
a1YQ==4
ab2YWI=4
abc3YWJj4
abcd4YWJjZA==8
Hello, World!13SGVsbG8sIFdvcmxkIQ==20
猫の手道具箱1854yr44Gu5omL6YGT5YW3566x24

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 にしたデータは、サーバーに送られますか?
送られません。変換は、ブラウザの中だけで行います。

Base64変換ツールを開く

この記事で使ったツール

特記のないツールは、入力した内容をブラウザの中だけで処理し、サーバーへ送りません。詳しくはプライバシーポリシーをご覧ください。

ほかのガイド

ガイドの一覧を見る

記事の内容に誤りや古い点があれば、お問い合わせからお知らせください。 ツールの動作の確認方法や運営方針は、運営者情報にまとめています。