JWT トークン
JSON Web Token (JWT) は、当事者間で情報を JSON オブジェクトとして安全に送信するための手段です。
JWT の構造
JWT はドットで区切られた 3 つの部分で構成されます。
header.payload.signatureヘッダー
{ "alg": "HS256", "typ": "JWT"}ペイロード
{ "sub": "1234567890", "iat": 1516239022, "exp": 1516242622}署名
署名は次のように生成します。
HMACSHA256( base64UrlEncode(header) + "." + base64UrlEncode(payload), secret)JWT トークンの生成
Node.js の例
const jwt = require('jsonwebtoken');
const payload = { userId: '12345', scope: ['email', 'contacts']};
const token = jwt.sign(payload, process.env.JWT_SECRET, { expiresIn: '1h', issuer: 'your-app', audience: 'brevo-api'});Python の例
import jwtimport datetime
payload = { 'user_id': '12345', 'exp': datetime.datetime.utcnow() + datetime.timedelta(hours=1), 'iat': datetime.datetime.utcnow()}
token = jwt.encode(payload, 'your-secret-key', algorithm='HS256')Brevo API での JWT の利用
curl -X GET "https://api.brevo.com/v3/account" \ -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \ -H "Accept: application/json"トークンの検証
const validateToken = (token) => { try { const decoded = jwt.verify(token, process.env.JWT_SECRET); return { valid: true, payload: decoded }; } catch (error) { return { valid: false, error: error.message }; }};ベストプラクティス
- 強度の高いランダムなシークレットを使用します
- 適切な有効期限を設定します
- リクエストごとにトークンを検証します
- HTTPS のみを使用します
- シークレットを安全に保管します
- トークンの更新処理を実装します