📘 公式リファレンス🔧 リファレンス/フィルター中級

hmac_sha1 フィルター（HMAC-SHA1ハッシュ生成）

文字列を秘密鍵を使って HMAC-SHA1 ハッシュに変換するフィルター。メッセージ認証コードとして機能し、API 連携時の署名検証やセキュアなトークン生成に用いる。

用途

Webhook 検証時に Shopify からの X-Shopify-Hmac-SHA256 ヘッダーと比較する署名チェック、または外部 API との通信でメッセージの完全性を検証したいとき。

設置場所

Liquid テンプレート内で `{{ 'メッセージ文字列' | hmac_sha1: '秘密鍵' }}` の形で使用する。通常は product / order など Liquid オブジェクトの値を渡す。

注意点

秘密鍵は文字列リテラルではなく環境変数やメタフィールドから取得し、テンプレート内にハードコードしない。生成されるハッシュは 40 文字の 16 進数文字列となる。Shopify の Webhook 検証には hmac_sha1 ではなく hmac_sha256 を使用するため、API 仕様書で要求されるハッシュアルゴリズムを確認してから適用する。

タグ:hmacsha1hashsignaturesecurity

仕様

30 行 / json

{
  "category": "string",
  "deprecated": false,
  "deprecation_reason": "",
  "description": "The secret key for the message is supplied as a parameter to the filter.",
  "parameters": [],
  "return_type": [
    {
      "type": "string",
      "name": "",
      "description": "",
      "array_value": ""
    }
  ],
  "examples": [
    {
      "name": "",
      "description": "",
      "syntax": "",
      "path": "/",
      "raw_liquid": "{%- assign secret_potion = 'Polyjuice' | hmac_sha1: 'Polina' -%}\n\nMy secret potion: {{ secret_potion }}",
      "parameter": false,
      "display_type": "text",
      "show_data_tab": true
    }
  ],
  "summary": "Converts a string into an SHA-1 hash using a hash message authentication code (HMAC).",
  "syntax": "string | hmac_sha1: string",
  "name": "hmac_sha1"
}

出典・ライセンス

Source:: Shopify/theme-liquid-docs/data/filters.json
Repository:: https://github.com/Shopify/theme-liquid-docs
License:: MIT

このコードは Shopify 著作の MIT ライセンスソースです。原本の著作権は Shopify が保有します。日本語訳は ALSEL によるものです。

hmac_sha1 フィルター（HMAC-SHA1ハッシュ生成）

仕様

出典・ライセンス

関連項目

avatar フィルター（顧客アバター画像HTML生成）

default_errors フィルター（フォーム送信エラーを日本語化）

date フィルター（日付を指定形式でフォーマット）

payment_terms フィルター（Shop Pay分割払いバナーを生成）

abs フィルター（数値の絶対値を取得）

append フィルター（文字列の末尾に追加）