◀ 4.

AWS SignatureDoesNotMatch エラーの対処

▶

このページの元XMLは旧Amazon PA-APIのエラーです。対象APIと署名版を確認してから診断し、廃止済み連携と稼働中AWSサービスの署名問題を分けてください。

対象APIと署名版、署名対象、実際の送信内容を順に比較する診断図

2026年10月確認: PA-API 5.0も移行が必要

PA-API 5.0を現在の新規導入先として勧める説明は更新が必要です。 Amazon公式はPA-API 5の廃止と後継Creators APIへの移行を案内し、旧PA-API 5への要求に403 AccessDeniedExceptionが返る例を示しています。これは署名を調整すれば利用を再開できる、という案内ではありません。

公式の廃止案内と移行ガイドを先に確認してください。Creators APIはOAuth 2.0を使い、旧PA-APIのAWS Access Key / Secret Keyはそのまま利用できません。Credential ID / Credential Secretと対象の資格情報Versionを取得し、APIの送信先・ヘッダー・項目名も変更します。秘密情報をこのページや問い合わせへ貼り付けないでください。

この記事の要点
  • AWS の SignatureDoesNotMatch エラー
  • 原因: リクエストの署名が AWS 側で再計算した署名と一致しない
  • 秘密鍵だけに原因を限定せず、対象API・署名方式・署名対象と送信内容の一致を確認
  • 最初に廃止済みPA-APIの呼出しか、現在利用するAWSサービスのSigV4かを区別

 

エラー内容

下の元XMLは旧PA-APIのItemSearchErrorResponseです。一般的なAWS SigV4の診断と、旧PA-APIの復旧手順を同一視しないでください。XMLの名前空間だけから、実際に使ったライブラリや署名版まで断定することもできません。

<ItemSearchErrorResponse xmlns="http://ecs.amazonaws.com/doc/2005-10-05/">
    <Error>
        <Code>SignatureDoesNotMatch</Code>
        <Message>
            The request signature we calculated does not match the signature you provided. Check your AWS Secret Access Key and signing method. Consult the service documentation for details.
        </Message>
    </Error>
    <RequestID> ... </RequestID>
</ItemSearchErrorResponse>

 

発生条件/原因

署名対象の要求と、サービスが再計算した要求が一致しない場合に起こります。シークレットキーの不備は一候補であって、エラー文言だけで秘密鍵が誤っているとは断定できません。

パラメータの正規化・並べ替えは、使用する署名版の規則に従います。旧ItemSearchのクエリ署名と、SigV4のCanonical Requestを混同しないでください。JSON本文を一般的な意味でソートすればすべて直る、という話ではありません。

 

対処法

1.旧PA-APIの調査では、当時のAccess KeyとSecret Keyの組、AssociateTag、対象エンドポイントを区別します。Creators APIへの移行では別の認証情報が必要です。タグの問題と署名不一致も同じエラーと決めつけません。

2.署名対象のHTTPメソッド・パス・クエリ・ヘッダー・本文と実際の送信内容を照合します。秘密鍵そのものをハッシュ表示して公開したり、エラー解析のためにログへ書いたりしないでください。

3.署名版の仕様に従って正規化・エンコード・並べ替えを確認します。署名後のURL再エンコード、JSONの再生成、HTTPクライアントやプロキシによるヘッダー変更も切り分けます。

署名認証の方法はこちらを参照。

 

利用中のAWSサービスでSigV4を調べる場合

PA-APIとは別に、稼働中のAWSサービスで同じSignatureDoesNotMatchが出ることがあります。そのサービスのSDK/CLIと署名仕様を使って、以下を順に確認します。廃止済みPA-APIへAWS CLIを向ければ復旧する、という意味ではありません。

確認対象比較する内容
送信先とスコープ対象ホスト、日付、Region、serviceが実際の要求先と一致するか
Canonical Requestメソッド、URI、クエリ、署名対象ヘッダー、SignedHeaders、payload hash
実際の本文署名したバイト列をそのまま送ったか。JSONの空白・改行や文字エスケープも影響する
日時実際のUTC時刻、x-amz-date、スコープ日付が整合するか。許容時間やエラー名を全サービス共通の固定値としない
途中の変更リダイレクト、プロキシ、HTTPクライアントが要求を変更していないか

読み取り専用で呼べる安全な操作を選び、正規SDK/CLIの結果と比較します。権限不足・トークン期限・廃止APIの403は、すべてが署名不一致ではありません。診断にはHTTP状態、エラーコード、Request ID、時刻、サービス名を使い、Authorization全体・秘密鍵・セッショントークンを公開しません。

公式資料

2026年10月確認: AWS SigV4の診断。この記事は公式仕様の照合であり、実キー通信・廃止済みItemSearchの成功再現ではありません。

子ページ

子ページはありません

同階層のページ
  1. Error 400 : Bad Request Parameter Operation is missing
  2. MissingParameter. The request must contain the parameter Signature.
  3. RequestThrottled. AWS Access Key ID: ... . You are submitting requests too quickly
  4. SignatureDoesNotMatch. The request signature we calculated does not match the signature you provided. Check your AWS Secret Access Key and signing method. Consult the service documentation for details.
  5. failed to open stream: HTTP request failed! HTTP/1.1 503 Service Unavailable

最近更新/作成されたページ