microCMSでやってみた！AI活用からユースケースまで大募集 by microCMS Advent Calendar 2025

microCMSのWebhookカスタム通知からAWS API Gatewayを叩く

Last updated at 2025-12-08Posted at 2025-11-13

microCMSのWebhookにおける、カスタム通知を試してみます。
Webhookを使った以下の記事

では、microCMSのChatwork用の標準Webhookを使ってみたのですが、今度はカスタム通知を試してみます。

参考情報

解説サイト

(ステップ1) microCMS側の準備

分かりやすくするために、なるべく単純なものを準備します。スキームはタイトルと本文だけとします。

API名とエンドポイント

APIスキーマ

(ステップ2) AWS側

自分で作った記事

を参考にして、AWS API GatewayにAPIを用意します。
ポイントは、microCMSから送られる署名を利用して、本当にmicroCMSからの呼び出しかどうかをチェックするところです。microCMSのドキュメント

の「Signatureの検証」に説明がありますので、これをpythonに書き換えた形です。

AWS Lambda

関数を以下の設定で作成します。

コードは

import os
import hmac
import hashlib
import json
import urllib.parse
import base64

def _get_header(event, name: str):
    headers = event.get("headers") or {}
    lname = name.lower()
    for k, v in headers.items():
        if k.lower() == lname:
            return v
    return None

def _response(status: int, body: str):
    return {
        "statusCode": status,
        "headers": {"Content-Type": "application/json"},
        "body": json.dumps(body),
    }

def lambda_handler(event, context):
    secret = os.environ.get("MICROCMS_WEBHOOK_SECRET")
    print('secret=', secret)
    if not secret:
        return _response(500, "Server misconfigured: missing secret")

    # イベントとコンテキストの内容を出力
    print( "event:" , event )
    print( "context:", context )

    # QueryString をパースする
    body = event.get('body')
    param = urllib.parse.parse_qs(body)

    # microCMSから送られる署名
    signature = _get_header(event, "x-microcms-signature")
    print('signature=', signature)

    body = event.get("body") or ""
    if event.get("isBase64Encoded"):
        try:
            body_bytes = base64.b64decode(body)
        except Exception:
            return _response(400, "Invalid base64 body")
    else:
        # UTF-8でbytes 化
        body_bytes = body.encode("utf-8")

    # HMAC-SHA256
    expected_signature = hmac.new(
        key=secret.encode("utf-8"),
        msg=body_bytes,
        digestmod=hashlib.sha256,
    ).hexdigest()
    print('expected_signature=', expected_signature)

    # 比較
    if not hmac.compare_digest(signature, expected_signature):
        print("Invalid signature")
        # abort(401, "Invalid signature")

    # 検証成功
    print("Valid signature ✅")
    return _response(200, "OK")