2026.08.08

【Python版】JWTのパースでbase64デコードできるようにパディングする

saratogax

記事内に商品プロモーションを含む場合があります

Python で JWT の文字列を base64 デコードしようとして、パディングのエラーになっていませんか？

本記事では、JWT からペイロード部分を抜き出し、正しくデコードできるようにパディングする方法を紹介します。

jwt のパッケージを使う手もありますが、ここではシンプルにベタ実装します。

同じ処理を Java と TypeScript で書いた記事もあります。

必要なパッケージのインポート

今回は base64 と json を扱うので、以下の 2 つのライブラリを使用します。

import base64
import json

JWT文字列のパース

JWT の文字列はドットで区切られているので、まずはここを分解。

jwtstr='aaa.bbb.ccc'

jwtstrs=jwtstr.split('.')
payload=jwtstrs[1]

これでペイロード部分が抜き出せますが、文字列によってはそのまま base64 デコードはできない状態に。

そこで、足りない部分をイコール(ゲタ文字)でパディングしてあげましょう。

まずは payload の文字数を 4 で割って余りを取得。

4 からその余りを引いて、足りない文字数(0から3)を補ってあげます。

payload += '=' * (4 - (len(payload) % 4))

base64デコード

payload が抜き出せて、パディングもできたら、あとは　base64 でデコードしてあげましょう。

decodePayload=base64.urlsafe_b64decode(payload)

結果を確認して、さらに JSON への変換を行えばバッチリですね。

print(decodePayload)

jsonPayload=json.loads(decodePayload)
print(jsonPayload)

まとめ

最後に参考ソースを貼っておきます。

バリデーションなど、細かな処理は省略しています。

import base64
import json

jwtstr='aaa.bbb.ccc'

jwtstrs=jwtstr.split('.')
payload=jwtstrs[1]

payload += '=' * (4 - (len(payload) % 4))
decodePayload=base64.urlsafe_b64decode(payload)

print(decodePayload)

jsonPayload=json.loads(decodePayload)

print(jsonPayload)