The request must contain the parameter Signatureは、署名項目の不足を示す旧要求の診断資料です。署名が存在して値が合わない場合とは別です。下のXMLだけで、すべてのAWS SigV4要求のAuthorization不足と同じエラーだとは断定しません。
対象APIと提供状況を先に確認
2026年10月確認。PA-API 5も公式の廃止案内の対象です。旧キーの変更や再試行だけで利用を再開する案内ではありません。現在の連携はCreators APIの移行ガイドを確認し、専用資格情報とOAuth、要求/応答の変更を照合します。一般AWSサービスの署名/SDKと混用しないでください。
親のエラー一覧から他の個別症状を選択できます。以下の旧サンプルを現行APIの完成実装や実通信済みの例とは扱いません。
不足と不一致を分けて調べる
| 観測 | 確認すること |
|---|---|
| 旧Signature項目がない | 対象APIの世代、送信前のQuery生成、空値/名前違い。実キーや署名値を公開しない |
| 署名項目はあるが不一致 | 実際の送信要求と署名対象の一致を確認。秘密鍵だけに原因を限定しない |
| サービス提供終了/403 | 署名の再生成や無限再送で解決しない。公式の提供状況を確認 |
一般AWSの診断はSigV4公式トラブルシュート、関連症状は署名不一致へ進んでください。SDKの版・要求方式・安全に伏せたRequest ID等を記録し、鍵や生のdebugを共有しないでください。
| この記事の要点 |
|
このエラーが出る状況
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種類だけ、という意味ではありません。次の観点を分けて確認します:
- SigV2: クエリ文字列に
Signature=...パラメータが付いていない - 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-sdkuse 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正規化・重複クエリ・一時資格情報のトークン等も網羅しません。対象サービスで必要なヘッダー/署名規則は公式仕様と照合してください。処理の概略は:
- CanonicalRequest を作る
- StringToSign を作る
- SigningKey を派生
- HMAC-SHA256 で署名
- 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 エンコードが不正確 | SignatureDoesNotMatch | RFC3986 エンコード(+ ではなく %20) |
| システム時計がずれている | RequestTimeTooSkewed | 時刻同期と対象サービスの有効期限を確認。一律5分としない |
| 古い API 版を叩いている | MissingParameter Signature | サービス提供状況・現在の認証方式を確認。旧PA-API5を移行先としない |
| Content-Type と payload hash の不一致 | SignatureDoesNotMatch | payload を生のまま 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日と判断しません。
子ページはありません
- Error 400 : Bad Request Parameter Operation is missing
- MissingParameter. The request must contain the parameter Signature.
- RequestThrottled. AWS Access Key ID: ... . You are submitting requests too quickly
- 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.
- failed to open stream: HTTP request failed! HTTP/1.1 503 Service Unavailable
人気ページ
- 1 Eclipseで「サーバーに追加または除去できるリソースがありません。」の原因と対処法
- 2 tomcat の起動 / 停止ログと catalina.log・catalina.out の違い
- 3 JavaScript で base URL を取得する方法|window.location.origin
- 4 YouTube Data API v3 エラー一覧|403・400・404 の原因と対処
- 5 Laravel エラー一覧|500/Blade/DB 接続/ルーティングの代表エラー
- 6 3Dグラフィックスのソフト一覧|Blender・Metasequoiaと用途別の選び方
- 7 Spring Frameworkのアノテーション一覧
- 8 【Spring】@Valueアノテーションとは
- 9 CATALINA_HOME の確認方法 (Linux / Mac)
- 10 【Spring】@Autowiredアノテーションとは
最近更新/作成されたページ
- Visual Studio「デザイナーを表示できません」エラーの原因と対処 2026-10-28 12:06:00
- SSH 認証に失敗しました。再試行してください の対処 2026-10-28 12:06:00
- SSH2 秘密鍵の読み込みに失敗しました の原因と対処 2026-10-28 12:06:00
- TeraTerm のよくあるエラーと対処法完全ガイド — Connection refused / 2026-10-28 12:06:00
- Visual Studio エラー一覧|コンパイルエラー・警告の確認方法と対処 2026-10-28 11:39:57
- Whitelabel Error Page の原因と消し方|Spring Boot のエラーページ 2026-10-28 11:39:57
- Eclipseで「サーバーに追加または除去できるリソースがありません。」の原因と対処法 2026-10-28 11:39:57
- SQL WHERE 句完全ガイド 2026-10-28 11:39:57
- SQL JOIN 完全ガイド (INNER/LEFT/RIGHT/FULL OUTER) 2026-10-28 11:39:57
- tomcat の起動 / 停止ログと catalina.log・catalina.out の違い 2026-10-28 10:24:23
- Tomcat の起動確認方法 5 つ|localhost:8080・ポート・プロセス・ログ 2026-10-28 10:24:23
- Oracle 19c COMMITの使い方: 暗黙コミット・自動確定・応答不明時の確認 2026-10-28 09:59:09
- Oracle 19c DELETE文|削除対象の確認・COMMIT前の判断・ROLLBACKの条件 2026-10-28 09:59:09
- Oracle 19c INSERT文|INSERT ALL・SELECT・RETURNINGとMERGEの使い分け 2026-10-28 09:59:09
- Oracle 19cのトランザクション制御|COMMIT・ROLLBACK・分離レベルと接続設定 2026-10-28 09:59:09