Amazon S3 バケットを設定するには?
- 選択した AWS リージョンで S3 バケットを作成してください。パブリックアクセスのブロックを有効のままにし、非公開バケットではオブジェクト所有者の設定に「バケット所有者の強制」を使用してください。バケット名とリージョンを記録してください。
- 出力先のバケットとプレフィックスに権限を制限した、Transloadit 専用の AWS アイデンティティを設定してください。タグ、リージョンの検出、暗号化に関する追加の権限も含め、/s3/store の権限ポリシーに従ってください。ルートアクセスキーは使用しないでください。
- アクセスキー ID(
key)、シークレットアクセスキー(secret)、bucket、bucket_regionを指定して、Amazon S3 の Template 認証情報を保存してください。AWS の秘密情報は信頼できるバックエンドに保持してください。有効期間の短い AWS 認証情報を使用する場合は、Robot の一時認証情報に関するガイダンスに従ってください。 - Template で認証情報の名前を参照し、
acl: "bucket-default"を明示的に設定してください。aclを省略すると、Robot のデフォルト値であるpublic-readが使用されます。privateを指定した場合も ACL が送信されます。次の例では ACL ヘッダーを省略し、ポリシーのuploads/プレフィックス配下に書き込みます。
{
"steps": {
":original": {
"robot": "/upload/handle"
},
"exported": {
"robot": "/s3/store",
"use": ":original",
"credentials": "YOUR_S3_CREDENTIALS",
"acl": "bucket-default",
"path": "uploads/${unique_prefix}/${file.url_name}"
}
}
}
YOUR_S3_CREDENTIALSを保存した認証情報の名前に置き換えてください。認証情報を保存しても、アップロードが認可されるわけではありません。バックエンドでユーザーを認証し、アップロードを認可してください。また、署名付きのブラウザフローでは Signature Authentication を必須にしてください。アップロードフローを公開する前に、認証情報と Instructions の保護に関するガイダンスに従ってください。- 機密性のないファイルで Template をテストし、完了後の Assembly Status を確認して、バケット内のオブジェクトを検証してください。返された結果 URL によって、パブリック読み取りアクセスが付与されるわけではありません。書き込み権限があると既存のキーを上書きできます。一意のパスを選び、復旧のために S3 のバージョニングを検討してください。
関連情報
- Template とセキュリティの詳細は、Template のドキュメントをご覧ください。
- ファイル名のカスタマイズ方法など、S3 への保存について詳しくは、🤖/s3/store のドキュメントをご覧ください。
- ご自身の Node.js アプリケーションからファイルをアップロードするには、Amazon S3 アップロードチュートリアルに沿って進めてください。ファイルストレージのチュートリアル (English)では、curl と rclone を使ったワークフローも紹介しています。