◀ 2.

Signature不足エラーの確認|旧PA-APIとAWS署名方式の違い

▶

The request must contain the parameter Signatureは、署名項目の不足を示す旧要求の診断資料です。署名が存在して値が合わない場合とは別です。下のXMLだけで、すべてのAWS SigV4要求のAuthorization不足と同じエラーだとは断定しません。

旧PA-APIと後継Creators APIの世代と認証の違い

対象APIと提供状況を先に確認

2026年10月確認。PA-API 5も公式の廃止案内の対象です。旧キーの変更や再試行だけで利用を再開する案内ではありません。現在の連携はCreators APIの移行ガイドを確認し、専用資格情報とOAuth、要求/応答の変更を照合します。一般AWSサービスの署名/SDKと混用しないでください。

親のエラー一覧から他の個別症状を選択できます。以下の旧サンプルを現行APIの完成実装や実通信済みの例とは扱いません。

不足と不一致を分けて調べる

観測確認すること
旧Signature項目がない対象APIの世代、送信前のQuery生成、空値/名前違い。実キーや署名値を公開しない
署名項目はあるが不一致実際の送信要求と署名対象の一致を確認。秘密鍵だけに原因を限定しない
サービス提供終了/403署名の再生成や無限再送で解決しない。公式の提供状況を確認

一般AWSの診断はSigV4公式トラブルシュート、関連症状は署名不一致へ進んでください。SDKの版・要求方式・安全に伏せたRequest ID等を記録し、鍵や生のdebugを共有しないでください。

この記事の要点
  • 典型ケース: AWS PA-API (Product Advertising API) や旧 SigV2 API でリクエストに Signature パラメータが付いていない
  • 原因: 自前で URL クエリ署名する実装が壊れている / 古い API バージョンを叩いている / SDK が古い
  • PA-API 5も旧API。下のSigV4例と、現在のCreators APIのOAuth方式を分ける
  • 対処: 対象サービス/署名方式/SDKを確認。AWS SDKと商品API用SDK、旧キーと現行資格情報を混用しない
  • SigV4 のフロー: CanonicalRequest → StringToSign → HMAC-SHA256(SigningKey) → Authorization ヘッダ

このエラーが出る状況

AWS の API 呼び出しで以下のレスポンスが返ってくるケース:

<ErrorResponse>
  <Error>
    <Code>MissingParameter</Code>
    <Message>The request must contain the parameter Signature.</Message>
  </Error>
</ErrorResponse>

代表的なシチュエーション:

  • Amazon Product Advertising API (PA-API) を自前 URL 署名で叩いている
  • 古い AWS SigV2 (Query String 認証) API を叩いている
  • SDK ではなく file_get_contents や curl で手書きしている
  • 古いライブラリ(PA-API 4.0 系)を使っている

原因の本質

AWS は API リクエストが正しい呼び出し元から来たことを署名 (Signature) で検証します。ここでは旧Query署名とSigV4の一般的な要件を比較します。すべてのAWS認証がこの2種類だけ、という意味ではありません。次の観点を分けて確認します:

  1. SigV2: クエリ文字列に Signature=... パラメータが付いていない
  2. SigV4は別途確認: ヘッダー署名と署名付きURLで必要項目が異なる。この旧メッセージをすべての欠落条件の共通エラーとしない

という観点を分けます。旧XML要求が明示するSignature不足と、SigV4の一般的な署名要件は同一の診断根拠ではありません。

対処1: 公式 SDK を使う

利用中サービスの公式SDK・認証方式を先に確認します。一般AWSサービスのSDKを入れれば旧PA-APIが復活する、という対処ではありません。下の旧SDK・汎用AWS例は比較用です。

PA-API 5.0 (Amazon アソシエイト)

次のComposerコマンドと旧SDK例は実行を勧めない原資料です。 配布名・名前空間・動作成功を検証していません。現在のCreators APIは別の資格情報とOAuth方式を確認してください。

composer require amzn/paapi5-php-sdk
use Amazon\ProductAdvertisingAPI\v1\com\amazon\paapi5\v1\api\DefaultApi;
use Amazon\ProductAdvertisingAPI\v1\com\amazon\paapi5\v1\SearchItemsRequest;
use Amazon\ProductAdvertisingAPI\v1\com\amazon\paapi5\v1\PartnerType;
use Amazon\ProductAdvertisingAPI\v1\Configuration;

$config = new Configuration();
$config->setAccessKey(getenv('PAAPI_ACCESS_KEY'));
$config->setSecretKey(getenv('PAAPI_SECRET_KEY'));
$config->setHost('webservices.amazon.co.jp');
$config->setRegion('us-west-2');

$api = new DefaultApi(new GuzzleHttp\Client(), $config);

$req = new SearchItemsRequest();
$req->setPartnerTag(getenv('PAAPI_PARTNER_TAG'));
$req->setPartnerType(PartnerType::ASSOCIATES);
$req->setKeywords('プログラミング');
$req->setSearchIndex('Books');

$res = $api->searchItems($req);

一般 AWS API (S3 / DynamoDB 等)

次はS3への書込みを含む別サービスの断片です。PA-APIのテストではなく、実行すると対象バケットに変更が発生します。実資格情報を入れて診断用に実行しないでください。一時資格情報のトークンや権限、対象リソース等も別途必要です。

$s3 = new Aws\S3\S3Client([
    'version' => 'latest',
    'region'  => 'ap-northeast-1',
    'credentials' => [
        'key'    => getenv('AWS_ACCESS_KEY_ID'),
        'secret' => getenv('AWS_SECRET_ACCESS_KEY'),
    ],
]);
$s3->putObject([
    'Bucket' => 'my-bucket',
    'Key'    => 'hello.txt',
    'Body'   => 'Hello world',
]);

SigV4 署名の仕組み(自前で計算する場合)

次のSigV4関数は保守比較用の未実行断片です。汎用の完成署名器ではありません。日時を同一時点から取得せず、URI正規化・重複クエリ・一時資格情報のトークン等も網羅しません。対象サービスで必要なヘッダー/署名規則は公式仕様と照合してください。処理の概略は:

  1. CanonicalRequest を作る
  2. StringToSign を作る
  3. SigningKey を派生
  4. HMAC-SHA256 で署名
  5. Authorization ヘッダを組み立て
function sigv4(
    string $method, string $host, string $path, array $query,
    string $payload, string $region, string $service,
    string $accessKey, string $secretKey
): array {
    $amzDate   = gmdate('Ymd\THis\Z');
    $dateStamp = gmdate('Ymd');

    // 1. CanonicalRequest
    ksort($query);
    $canonicalQuery = http_build_query($query, '', '&', PHP_QUERY_RFC3986);
    $payloadHash    = hash('sha256', $payload);
    $headers = [
        'host'         => $host,
        'x-amz-date'   => $amzDate,
        'x-amz-content-sha256' => $payloadHash,
    ];
    ksort($headers);
    $canonicalHeaders = '';
    $signedHeaders    = '';
    foreach ($headers as $k => $v) {
        $canonicalHeaders .= "$k:$v\n";
        $signedHeaders    .= ($signedHeaders ? ';' : '') . $k;
    }
    $canonicalRequest =
        "$method\n$path\n$canonicalQuery\n$canonicalHeaders\n$signedHeaders\n$payloadHash";

    // 2. StringToSign
    $credentialScope = "$dateStamp/$region/$service/aws4_request";
    $stringToSign    = "AWS4-HMAC-SHA256\n$amzDate\n$credentialScope\n" .
                       hash('sha256', $canonicalRequest);

    // 3. SigningKey
    $kDate    = hash_hmac('sha256', $dateStamp,  'AWS4' . $secretKey, true);
    $kRegion  = hash_hmac('sha256', $region,     $kDate,   true);
    $kService = hash_hmac('sha256', $service,    $kRegion, true);
    $kSigning = hash_hmac('sha256', 'aws4_request', $kService, true);

    // 4. Signature
    $signature = hash_hmac('sha256', $stringToSign, $kSigning);

    // 5. Authorization ヘッダ
    $authHeader =
        "AWS4-HMAC-SHA256 Credential=$accessKey/$credentialScope, " .
        "SignedHeaders=$signedHeaders, Signature=$signature";

    return array_merge($headers, ['Authorization' => $authHeader]);
}

よくあるミス

ミス症状対処
クエリパラメータの URL エンコードが不正確SignatureDoesNotMatchRFC3986 エンコード(+ ではなく %20)
システム時計がずれているRequestTimeTooSkewed時刻同期と対象サービスの有効期限を確認。一律5分としない
古い API 版を叩いているMissingParameter Signatureサービス提供状況・現在の認証方式を確認。旧PA-API5を移行先としない
Content-Type と payload hash の不一致SignatureDoesNotMatchpayload を生のまま hash
パーソナルタグ未設定 (PA-API)InvalidPartnerTagアソシエイトコンソールでタグ取得

デバッグ手順

次のdebug出力は、そのまま公開・共有しないでください。 認証ヘッダー/トークン/署名付きURL等を含み得ます。S3のls成功はPA-APIの資格や署名の成功証明ではありません。末尾のPHP断片がbash枠に混在する旧資料で、ブロック全体を実行する例ではありません。

# 1. AWS CLI で同じリクエストを実行して成功するか確認
aws s3 ls --debug

# --debug 出力に「CanonicalRequest」「StringToSign」が出るので
# 自前実装と比較する

# 2. 時刻ずれを確認
date -u
# サーバー時刻と 5 分以上ずれていないか

# 3. SDK ロギング有効化(PHP)
$client = new Aws\S3\S3Client([
    ...,
    'debug' => true,
]);

FAQ

Q: PA-API 4.0 のコードがある
A: 現在は5.0も廃止案内対象です。旧署名だけを書き換えるのではなく、Creators APIの送信先・資格情報・OAuth・項目の変更を確認します。

Q: SigV2 で良いケースは?
A: 過去に対応したサービス名を挙げて現在の利用可否を推測しません。対象サービスの現行認証資料を確認します。Creators APIのOAuthと、一般AWS APIの署名要件は別です。

Q: Signature の有効期限
A: 有効期限は対象サービス・署名方式・資格情報の期限等で異なります。通常要求と署名付きURLを区別し、一律15分や7日と判断しません。

子ページ

子ページはありません

同階層のページ
  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

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