# AI成果物の署名付きURLに失効境界を設ける

> AIエージェントの成果物をS3署名付きURLで渡す際の期限管理は、s3:signatureAgeで上限を決め、一時資格情報の寿命と合わせて設計する。

- Canonical: https://kuucorp.com/blog/agent-artifact-s3-presigned-url-expiry-controls/
- Date: 2026-11-17
- Last modified: 2026-11-17
- Publisher: Kuu株式会社 (https://kuucorp.com)

---
AIエージェントがレポートや画像、CSVを生成し、S3に置いて署名付きURLで利用者に渡す構成は手軽です。ところがURLを一度発行すると、有効期限内は誰が開いても同じ成果物が取得できます。チャットログやチケットに貼られたURLが、想定より長く生き続ける事故が起こります。

この記事では、成果物リンクの失効を「URLの期限」「資格情報の寿命」「バケット側の上限」の3層で設計する方法を整理します。Files APIのfile_id所有権やワークスペース分離は[別記事](/blog/claude-files-api-workspace-scoped-security-design/)で扱っているため、ここではS3側の失効制御に絞ります。

## 署名付きURLはなぜ漏れると危険なのか

> 署名付きURLは、持っている人なら誰でも使える bearer token です。AWSの公式ドキュメントでも、期限内なら複数回使えると明記されています。

AWSのドキュメントは、署名付きURLを「保持者にアクセスを与える bearer token」と位置づけ、適切に保護するよう求めています。一回限りのアクセスではありません。期限内であれば同じURLを何度でも使えます。

URLの権限は、発行したIAMプリンシパルの権限が上限です。エージェントの実行ロールが広い読み取り権限を持つと、そのロールで署名したURLも広い範囲に届きます。発行用ロールは成果物用プレフィックスの `s3:GetObject` だけに絞ります。

## 有効期限は何で決まるのか

> 有効期限は、URL自体の期限と署名した資格情報の寿命の短い方で決まります。AssumeRoleのセッションは既定で1時間です。

URLに `X-Amz-Expires` で長い期限を指定しても、一時資格情報で署名した場合は資格情報の失効とともにURLも失効します。公式ドキュメントの整理は次のとおりです。

- IAMユーザー: SigV4で最大7日
- IAMロール資格情報: ロールセッションの終了まで
- EC2のインスタンスプロファイル: 資格情報の期間（通常約6時間）
- コンソールで発行する場合: 1分〜12時間、CLIとSDKは最大7日

エージェント基盤では長期のアクセスキーを使わず、ロールの一時資格情報で署名します。これだけで7日間生き続けるURLは作れなくなります。また、S3は期限をHTTPリクエスト時点で判定します。ダウンロード開始後に期限が過ぎても継続しますが、再開時には失敗します。

## s3:signatureAgeでバケット側に上限を置くには

> s3:signatureAge は署名からの経過時間をミリ秒で制限します。900000なら15分で、期限を延ばすことはできません。

発行側のコードが期限を長く指定しても、バケットポリシーで上限を強制できます。AWSのガイダンスでは、署名から15分を超えた署名付きリクエストを拒否する例が示されています。

```json
{
  "Sid": "DenyPresignedOver15Minutes",
  "Effect": "Deny",
  "Principal": "*",
  "Action": "s3:*",
  "Resource": "arn:aws:s3:::{bucket-name}/artifacts/*",
  "Condition": {
    "NumericGreaterThan": { "s3:signatureAge": "900000" },
    "StringNotEquals": { "aws:PrincipalTag/long-presigned-allowed": "true" }
  }
}
```

運用上の注意は3点です。

1. このキーは期限を短縮するだけで、延長はできません。
2. 60秒未満の設定は、時計のずれや遅延で正当なリクエストまで拒否する可能性があるため実用的ではありません。
3. 署名時刻を未来にした署名は想定外の長さになり得ます。資格情報の有効性が最終的な防波堤になるため、一時資格情報の最大セッション時間も短く保ちます。

長い期限が必要な業務は、`long-presigned-allowed` のようなタグで例外を承認制にします。タグを付与できる権限は別途統制します。

## URLを残さない実装にするには

> URL全体がログやプロンプトに残ると、期限内は第三者に使われます。保存するのは object key だけにします。

期限を短くしても、期限内に漏れたURLは使えます。次の実装で露出を減らします。

- DBやログには object key を保存し、URLは閲覧のたびに再発行する
- アプリケーションログとトレースでクエリ文字列をマスクする
- 署名付きURLをモデルの入力やツール結果にそのまま渡さない（再発行用の識別子を渡す）
- `aws:SourceIp` や `aws:SourceVpce` で、アクセス元ネットワークを制限できる場合は併用する

`s3:authType` で `REST-QUERY-STRING` を一括拒否する方法もありますが、AWSは、S3コンソールからのアップロードやダウンロードも止まると注意しています。成果物バケットだけに適用し、例外を設けるのが現実的です。

## 参考

- [Download and upload objects with presigned URLs（Amazon S3 User Guide）](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-presigned-url.html)
- [Additional guardrails（AWS Prescriptive Guidance）](https://docs.aws.amazon.com/prescriptive-guidance/latest/presigned-url-best-practices/additional-guardrails.html)
- [AWS Signature Version 4 Authentication 固有のポリシーキー（Amazon S3 API Reference）](https://docs.aws.amazon.com/AmazonS3/latest/API/bucket-policy-s3-sigv4-conditions.html)

## まとめ

署名付きURLは bearer token です。期限は、URLの指定、一時資格情報の寿命、`s3:signatureAge` の3層で決まります。発行はロールの一時資格情報に限り、バケット側で上限を強制し、URLそのものはログにもモデル入力にも残さない構成にします。

自社のAI基盤でどこまで絞るべきか迷う場合は、[Kuuの導入〜定着の伴走支援](https://kuucorp.com/services/ai-ops/)にご相談ください。
