AWS EmulatorでS3の署名付きURLを作り、curlで使う方法

​​AWS Emulator​Amazon S3,AWS CLI,curl,Python

S3 の署名付き URL(presigned URL)は、AWS の認証情報を持たない相手でも、決まったオブジェクトを決まった時間だけダウンロードやアップロードできるようにする URL です。ファイルの共有リンクや、ブラウザやアプリから S3 へ直接アップロードさせる仕組みに使われます。ここでは、手元で動かした AWS Emulator を相手に、ダウンロード用(GET)とアップロード用(PUT)の URL を作り、curl で使います。期限切れや、別のメソッドで使ったときに何が返るかも、検証環境で実行したコマンドと出力のまま載せます。

補足

検証環境は Ubuntu 24.04(x86_64)、AWS Emulator 1.0.385(2026年11月14日リリース)、AWS CLI 2.40.3、Python 3.11 と boto3 1.44.3、curl 8.5.0 です。AWS のアカウントと認証情報は使っていません。本物の S3 での動き(料金、バケット名がホスト名に入る形の URL、一時的な認証情報で作った URL の期限、期限の途中で始まったダウンロードの扱い、URL を作った人の権限やバケットポリシーによる制限など)は確かめていません。本物の S3 について書いているところは、公式ドキュメントを出どころにしています。

エミュレーターを起動して、S3 にファイルを置く

AWS Emulator の入れ方は別の記事「AWS EmulatorをUbuntuに入れて使い始める方法」で、バケットやファイルの基本的な扱いは「AWS EmulatorでS3にファイルを置いて取り出す方法」で扱っています。ここでは、Linux 向けの手順にある Debian パッケージを gpg で署名を確かめてから入れ、aws-emulator -t off で起動しました。-t off は利用状況のデータ(テレメトリー)を AWS に送らない指定です。

別の端末で、公式ドキュメントにある環境変数を設定します。AWS CLI も、あとで使う Python の boto3 も、この環境変数を読んでエミュレーターにつなぎます。証明書の ca.pem は、curl にも渡すので AWS_CA_BUNDLE に入れておきます。

bash
export AWS_ENDPOINT_URL=https://127.0.0.1:9297
export AWS_SHARED_CREDENTIALS_FILE=~/.aws/emulator/9297/emulator_credentials
export AWS_CONFIG_FILE=~/.aws/emulator/9297/config
export AWS_CA_BUNDLE=~/.aws/emulator/9297/ca.pem
export AWS_EC2_METADATA_DISABLED=true
export AWS_DISABLE_HOST_PREFIX_INJECTION=true
export AWS_REGION=us-east-1
export AWS_DEFAULT_REGION=us-east-1
unset AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY AWS_SESSION_TOKEN AWS_PROFILE
注意

公式ドキュメントによると、AWS_ENDPOINT_URL が設定されていないシェルでは、見つかった認証情報で本物の AWS にリクエストが送られます。本物の認証情報があるマシンでは、上の環境変数がすべて設定されたシェルで実行してください。

バケットを作り、試しに使うファイルを1つ置きます。

text
$ aws s3 mb s3://example-bucket
make_bucket: example-bucket
$ printf "にゃー\n" > hello.txt && aws s3 cp --no-progress hello.txt s3://example-bucket/
upload: ./hello.txt to s3://example-bucket/hello.txt

ダウンロード用の URL を aws s3 presign で作る

ダウンロード用の URL は、AWS CLI の aws s3 presign で作れます。--expires-in は有効な秒数で、リファレンスによると既定は 3600秒、最大は 604800秒(7日)です。

エミュレーターでは、URL の向き先が https://127.0.0.1:9297/バケット名/キー になりました。下の出力では、アクセスキーを含む X-Amz-Credential と、署名の X-Amz-Signature の値を <省略> に置き換えています。

text
$ URL=$(aws s3 presign s3://example-bucket/hello.txt --expires-in 300)
$ echo "$URL"
https://127.0.0.1:9297/example-bucket/hello.txt?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=<省略>&X-Amz-Date=20261115T020150Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=<省略>

クエリの中に、URL を作った日時(X-Amz-Date)、有効な秒数(X-Amz-Expires)、署名に含めたヘッダー(X-Amz-SignedHeaders)が入っています。この URL を受け取った側は、AWS の認証情報を持っていなくても、URL だけでオブジェクトを取り出せます。

curl でダウンロードする

curl には、エミュレーターの証明書を --cacert で渡します。URL には & が入るので、必ず " で囲みます。-i を付けると、応答のヘッダーも表示されます(x-amz-request-id と x-amz-id-2 の行は除いて載せています)。

text
$ curl -sS -i --cacert "$AWS_CA_BUNDLE" "$URL"
HTTP/1.1 200 OK
content-type: text/plain
accept-ranges: bytes
last-modified: Sun, 15 Nov 2026 02:01:49 GMT
content-length: 10
etag: "62dedf873d7afac717e8b0ef7c7b4db8"
x-amz-server-side-encryption: AES256
date: Sun, 15 Nov 2026 02:01:50 GMT

にゃー

ファイルに保存するときは -o を付けます。有効期限のうちは、同じ URL を何度使っても取り出せました。S3 のユーザーガイドの署名付き URL の説明にも、有効期限までは何度でも使えると書かれています。

text
$ curl -sS --cacert "$AWS_CA_BUNDLE" -o saved.txt "$URL" && cat saved.txt
にゃー
$ for i in 1 2 3; do curl -sS -o /dev/null -w "%{http_code}\n" --cacert "$AWS_CA_BUNDLE" "$URL"; done
200
200
200

ユーザーガイドでは、署名付き URL を、持っている人なら誰でも使える鍵のようなもの(bearer token)として扱い、適切に守るよう勧めています。URL をログやチャットに貼るときは、受け取った人が誰でも使える点に気をつけます。

また、本物の S3 では、URL でできることは、URL を作った人の権限の範囲に限られます。エミュレーターが IAM のポリシーを AWS どおりに判定しない点は、別の記事「AWS EmulatorでIAMの権限がAWSどおりに判定されない例」で扱っています。

403 が返るのはどんなときか

同じ URL でも、作ったときと違う使い方をすると、エミュレーターは HTTP の 403 を返しました。エラーの本文は XML なので、下の出力では、本文から Code と Message の部分だけを取り出し、ステータスコードと並べて載せています。

aws s3 presign の URL は GET 用です。curl -I(HEAD)で確かめようとすると 403 になりました。-T でファイルを送る(PUT)と SignatureDoesNotMatch の 403 になり、置いてあった hello.txt は元の中身のままでした。

text
$ curl -sS -I --cacert "$AWS_CA_BUNDLE" "$URL" | head -1
HTTP/1.1 403 Forbidden
$ printf "ねこ\n" > cat.txt
$ curl -sS -w "\n%{http_code}\n" --cacert "$AWS_CA_BUNDLE" -T cat.txt "$URL"
<Code>SignatureDoesNotMatch</Code><Message>The request signature we calculated does not match the signature you provided. Check your key and signing method.</Message>
403
$ aws s3 cp s3://example-bucket/hello.txt -
にゃー

URL の中のキーを hello.txt から other.txt に書き換えても、同じ SignatureDoesNotMatch でした。エミュレーターのエラーの本文には、エミュレーターが署名を計算したときの元の文字列(CanonicalRequest)も入っていました。下は、その部分をエラーの本文から取り出し、XML の &amp; を & に戻したものです。1行目がメソッド、2行目がパスで、ここが URL を作ったときと違うと、署名が合いません。

text
GET
/example-bucket/other.txt
X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=<省略>&X-Amz-Date=20261115T020150Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host
host:127.0.0.1:9297

host
UNSIGNED-PAYLOAD

署名のクエリを付けずに、同じキーへアクセスしたときは AccessDenied でした。

text
$ curl -sS -w "\n%{http_code}\n" --cacert "$AWS_CA_BUNDLE" https://127.0.0.1:9297/example-bucket/hello.txt
<Code>AccessDenied</Code><Message>Access Denied</Message>
403

S3 のユーザーガイドにある、署名付き URL でアップロードする方法の説明では、本物の S3 で SignatureDoesNotMatch が出たときに確かめることとして、システムの時刻が合っているか、URL を作ったままの形で使っているか、Content-Type が URL を作ったときと同じか、などを挙げています。

有効期限が切れたときと、7日を超える指定

--expires-in 3 で作った URL は、すぐに使うと 200 でした。5秒待ってから使うと、Request has expired の 403 になりました。

text
$ URL=$(aws s3 presign s3://example-bucket/hello.txt --expires-in 3)
$ curl -sS -o /dev/null -w "%{http_code}\n" --cacert "$AWS_CA_BUNDLE" "$URL"
200
$ sleep 5
$ curl -sS -w "\n%{http_code}\n" --cacert "$AWS_CA_BUNDLE" "$URL"
<Code>AccessDenied</Code><Message>Request has expired</Message>
403

上限の 604800秒ちょうどで作った URL は使えました。1秒多い 604801秒を指定すると、AWS CLI はエラーを出さずに URL を作りました(終了コードは 0)。その URL を使うと、エミュレーターが 400 の AuthorizationQueryParametersError で断りました。エミュレーターでは、上限を超えた指定は、URL を作るときではなく使うときに分かりました。

text
$ URL=$(aws s3 presign s3://example-bucket/hello.txt --expires-in 604800)
$ curl -sS -o /dev/null -w "%{http_code}\n" --cacert "$AWS_CA_BUNDLE" "$URL"
200
$ URL=$(aws s3 presign s3://example-bucket/hello.txt --expires-in 604801); echo "aws s3 presign の終了コード: $?"
aws s3 presign の終了コード: 0
$ curl -sS -w "\n%{http_code}\n" --cacert "$AWS_CA_BUNDLE" "$URL"
<Code>AuthorizationQueryParametersError</Code><Message>X-Amz-Expires must be less than a week (in seconds); that is, the given X-Amz-Expires must be less than 604800 seconds</Message>
400

エラーのメッセージには「604800秒より短く」とありますが、ちょうど 604800秒の URL は 200 でした。

本物の S3 では、期限は --expires-in だけで決まりません。ユーザーガイドによると、IAM ロールや AWS STS の一時的な認証情報で作った URL は、指定した期限より前でも、認証情報の期限が切れた時点で使えなくなります。また、期限は HTTP のリクエストを受けた時点で確かめるので、期限の直前に始めたダウンロードは、途中で期限を過ぎても続くと書かれています。

アップロード用の URL を boto3 で作り、curl で PUT する

aws s3 presign のリファレンスには、作った URL は HTTP の GET でオブジェクトを取り出すためのものと書かれています。アップロード用(PUT)の URL は、AWS SDK で作ります。ここでは、ユーザーガイドの例と同じく、Python の boto3 の generate_presigned_url を使いました。boto3 は、python3 -m venv で作った環境に pip install boto3 で入れています。

boto3 のリファレンスには、以前の動作との互換性を保つため、リージョンによっては署名付き URL が既定で古い署名の方式(Signature Version 2)になるという注意があります。そのため、Config(signature_version="s3v4") を付けて、AWS CLI と同じ Signature Version 4 で作るようにしています。

python
import sys
import boto3
from botocore.config import Config

# 使い方: python presign_put.py バケット キー 有効秒数 [Content-Type]
bucket, key, expires = sys.argv[1], sys.argv[2], int(sys.argv[3])
params = {"Bucket": bucket, "Key": key}
if len(sys.argv) > 4:
    params["ContentType"] = sys.argv[4]

s3 = boto3.client("s3", config=Config(signature_version="s3v4"))
print(s3.generate_presigned_url("put_object", Params=params, ExpiresIn=expires))

コードの中にエンドポイントや認証情報は書いていません。boto3 が、先ほど設定した環境変数を読みます。uploads/cat.txt に置くための URL を作り、curl -X PUT -T ファイル で送ると、200 が返りました。

text
$ PUT_URL=$(python presign_put.py example-bucket uploads/cat.txt 300)
$ echo "$PUT_URL"
https://127.0.0.1:9297/example-bucket/uploads/cat.txt?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=<省略>&X-Amz-Date=20261115T020158Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=<省略>
$ curl -sS -i --cacert "$AWS_CA_BUNDLE" -X PUT -T cat.txt "$PUT_URL"
HTTP/1.1 200 OK
content-type: application/xml
etag: "4fdc41ef3b2307beceb9992a4c8a57ba"
x-amz-checksum-crc64nvme: j9y+hf4ZOtU=
x-amz-checksum-type: FULL_OBJECT
x-amz-server-side-encryption: AES256
content-length: 0
date: Sun, 15 Nov 2026 02:01:59 GMT

置かれたかどうかを AWS CLI で確かめます。ETag は手元のファイルの MD5 と同じ値でした。-H で Content-Type を指定せずに送ったところ、オブジェクトの Content-Type は binary/octet-stream になっていました。

text
$ aws s3api head-object --bucket example-bucket --key uploads/cat.txt
{
    "AcceptRanges": "bytes",
    "LastModified": "2026-11-15T02:01:59+00:00",
    "ContentLength": 7,
    "ETag": "\"4fdc41ef3b2307beceb9992a4c8a57ba\"",
    "ContentType": "binary/octet-stream",
    "ServerSideEncryption": "AES256",
    "Metadata": {}
}
$ md5sum cat.txt
4fdc41ef3b2307beceb9992a4c8a57ba  cat.txt
$ aws s3 cp s3://example-bucket/uploads/cat.txt -
ねこ

アップロード用の URL も、有効期限のうちは何度でも使えます。 同じ URL で別の中身を送ると、200 が返り、オブジェクトは新しい中身で上書きされました。ユーザーガイドにも、同じキーのオブジェクトがあれば置き換えると書かれています。反対に、この PUT 用の URL で GET すると、SignatureDoesNotMatch の 403 でした。

text
$ printf "みゃー\n" > cat2.txt
$ curl -sS -o /dev/null -w "%{http_code}\n" --cacert "$AWS_CA_BUNDLE" -T cat2.txt "$PUT_URL"
200
$ aws s3 cp s3://example-bucket/uploads/cat.txt -
みゃー
$ curl -sS -w "\n%{http_code}\n" --cacert "$AWS_CA_BUNDLE" "$PUT_URL"
<Code>SignatureDoesNotMatch</Code><Message>The request signature we calculated does not match the signature you provided. Check your key and signing method.</Message>
403

Content-Type を決めた URL では、同じヘッダーを付けて送る

URL を作るときに ContentType を渡すと、X-Amz-SignedHeaders が host から content-type;host(URL の中では content-type%3Bhost)に変わりました。Content-Type のヘッダーも署名に含まれるということです。

text
$ printf "{\"name\": \"tama\"}\n" > cat.json
$ JSON_URL=$(python presign_put.py example-bucket uploads/cat.json 300 application/json)
$ echo "$JSON_URL"
https://127.0.0.1:9297/example-bucket/uploads/cat.json?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=<省略>&X-Amz-Date=20261115T020201Z&X-Amz-Expires=300&X-Amz-SignedHeaders=content-type%3Bhost&X-Amz-Signature=<省略>

この URL に、Content-Type を付けずに送ると、SignatureDoesNotMatch の 403 でした。text/plain を付けても 403 で、どちらのときもオブジェクトは作られていませんでした。URL を作ったときと同じ application/json を付けると 200 になり、オブジェクトの Content-Type も application/json になりました。

text
$ curl -sS -w "\n%{http_code}\n" --cacert "$AWS_CA_BUNDLE" -T cat.json "$JSON_URL"
<Code>SignatureDoesNotMatch</Code><Message>The request signature we calculated does not match the signature you provided. Check your key and signing method.</Message>
403
$ curl -sS -o /dev/null -w "%{http_code}\n" --cacert "$AWS_CA_BUNDLE" -T cat.json -H "Content-Type: text/plain" "$JSON_URL"
403
$ aws s3 ls s3://example-bucket/uploads/
2026-11-15 02:02:00         10 cat.txt
$ curl -sS -o /dev/null -w "%{http_code}\n" --cacert "$AWS_CA_BUNDLE" -T cat.json -H "Content-Type: application/json" "$JSON_URL"
200
$ aws s3api head-object --bucket example-bucket --key uploads/cat.json --query "{ContentType: ContentType, ContentLength: ContentLength}"
{
    "ContentType": "application/json",
    "ContentLength": 17
}

ブラウザからアップロードさせる仕組みでは、URL を作るサーバー側で決めた Content-Type と、ブラウザが送る Content-Type をそろえる必要があります。ユーザーガイドの curl の例でも、URL を作ったときと同じ Content-Type を -H で付けるよう書かれています。

保存するときのファイル名を URL に入れる

GetObject の API リファレンスによると、response-content-disposition などのクエリで、応答の Content-Disposition や Content-Type などのヘッダーを、そのリクエストだけ変えられます。このクエリは、署名したリクエストか署名付き URL でしか使えません。

boto3 では、get_object の Params に ResponseContentDisposition を入れます。

python
import sys
import boto3
from botocore.config import Config

# 使い方: python presign_get.py バケット キー 有効秒数 保存するときのファイル名
bucket, key, expires, filename = sys.argv[1], sys.argv[2], int(sys.argv[3]), sys.argv[4]

s3 = boto3.client("s3", config=Config(signature_version="s3v4"))
print(s3.generate_presigned_url(
    "get_object",
    Params={
        "Bucket": bucket,
        "Key": key,
        "ResponseContentDisposition": f'attachment; filename="{filename}"',
    },
    ExpiresIn=expires,
))

キーは hello.txt のまま、保存するときの名前を neko.txt にした URL を作りました。応答に content-disposition: attachment; filename="neko.txt" が付き、-OJ を付けた curl は、応答の content-disposition にある neko.txt という名前でファイルを保存しました。

text
$ DL_URL=$(python presign_get.py example-bucket hello.txt 300 neko.txt)
$ echo "$DL_URL"
https://127.0.0.1:9297/example-bucket/hello.txt?response-content-disposition=attachment%3B%20filename%3D%22neko.txt%22&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=<省略>&X-Amz-Date=20261115T020203Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=<省略>
$ curl -sS -I --cacert "$AWS_CA_BUNDLE" -X GET "$DL_URL" | grep -iE "^(HTTP|content-disposition)"
HTTP/1.1 200 OK
content-disposition: attachment; filename="neko.txt"
$ mkdir dl && cd dl && curl -sS -OJ --cacert "$AWS_CA_BUNDLE" "$DL_URL" && ls && cat neko.txt
neko.txt
にゃー

上の curl -I には -X GET を付けています。-I だけでは HEAD で送られ、前の節のとおり GET 用の URL では 403 になるためです。-X GET を付けて GET で送ると、200 が返りました。

ポイント

署名付き URL は、作ったときのメソッド、キー、署名に含めたヘッダーのとおりに使う必要があります。エミュレーターでは、どれかが違うと SignatureDoesNotMatch、期限を過ぎると Request has expired の 403 が返りました。

検証ではコマンドを1つのスクリプトにまとめ、URL をファイルに保存してから使いました。この記事では読みやすいように、URL をシェルの変数に入れる形で載せています。本物の S3 では、URL の向き先は https://バケット名.s3.リージョン.amazonaws.com/キー のような形になり、aws s3 presign のリファレンスにもその形の例が載っています。エミュレーターは IP アドレスで待ち受けるため、AWS Emulator に SDK を向ける方法の説明にあるとおり、バケット名はホスト名ではなくパスに入ります。

​Posted by 86