Amazon Simple Storage Service
開発者ガイド (API バージョン 2006-03-01)

AWS CloudTrail を使用して Amazon S3 API 呼び出しのログを記録する

Amazon S3 は AWS CloudTrail と統合されています。このサービスは、ユーザーやロール、または Amazon S3 の AWS のサービスによって実行されたアクションを記録するサービスです。CloudTrail は、Amazon S3 コンソールからの呼び出しと Amazon S3 API へのコード呼び出しを含む、Amazon S3 の API コールのサブセットをイベントとしてキャプチャします。証跡を作成する場合は、Amazon S3 のイベントなど、Amazon S3 バケットへの CloudTrail イベントの継続的な配信を有効にすることができます。証跡を設定しない場合でも、CloudTrail コンソールの [Event history] で最新のイベントを表示できます。CloudTrail によって収集された情報を使用して、リクエストの作成元の IP アドレス、リクエストの実行者、リクエストの実行日時などの詳細を調べて、Amazon S3 に対してどのようなリクエストが行われたかを判断できます。

CloudTrail の詳細 (設定する方法や有効にする方法など) については、AWS CloudTrail User Guide を参照してください。

CloudTrail 内の Amazon S3 情報

CloudTrail は、アカウント作成時に AWS アカウントで有効になります。Amazon S3 でサポートされるイベントアクティビティが発生すると、そのアクティビティは CloudTrail イベントとして AWS のサービスの他のイベントとともに [Event history (イベント履歴)] に記録されます。最近のイベントは、AWS アカウントで表示、検索、ダウンロードできます。詳細については、CloudTrail イベント履歴でのイベントの表示」を参照してください。

Amazon S3 のイベントなど、AWS アカウントのイベントの継続的な記録については、証跡を作成します。証跡により、CloudTrail はログファイルを Amazon S3 バケットに配信できます。デフォルトでは、コンソールで証跡を作成するときに、証跡がすべてのリージョンに適用されます。証跡では、AWS パーティションのすべてのリージョンからのイベントがログに記録され、指定した Amazon S3 バケットにログファイルが配信されます。さらに、より詳細な分析と CloudTrail ログで収集されたデータに基づいた行動のためにその他の AWS サービスを設定できます。詳細については、以下のトピックを参照してください。

各イベントまたはログエントリには、リクエストの生成者に関する情報が含まれます。この ID 情報は以下のことを確認するのに役立ちます。

  • リクエストが、ルートと IAM ユーザー認証情報のどちらを使用して送信されたか.

  • リクエストが、ロールとフェデレーティッドユーザーのどちらの一時的なセキュリティ認証情報を使用して送信されたか.

  • リクエストが、別の AWS サービスによって送信されたかどうか.

詳細については、「CloudTrail userIdentity 要素」を参照してください。

ログファイルは無期限に保管できますが、ログファイルを自動的にアーカイブまたは削除するように Amazon S3 ライフサイクルルールを定義することもできます。 デフォルトでは Amazon S3 のサーバー側の暗号化 (SSE) を使用して、ログファイルが暗号化されます。

CloudTrail のログ記録で追跡される Amazon S3 バケットレベルのアクション

デフォルトでは、CloudTrail はバケットレベルのアクションをログに記録します。Amazon S3 レコードは、他の AWS のサービスレコードと一緒にログファイルに記録されます。CloudTrail は、期間とファイルサイズに基づいて、新しいファイルをいつ作成して書き込むかを決定します。

このセクションの表では、CloudTrail によるログ記録でサポートされている Amazon S3 バケットレベルのアクションをリストアップします。

CloudTrail のログ記録で追跡される Amazon S3 バケットレベルのアクション

REST API 名 CloudTrail ログで使用される API イベント名

DELETE Bucket

DeleteBucket

DELETE Bucket cors

DeleteBucketCors

DELETE Bucket encryption

DeleteBucketEncryption

DELETE Bucket lifecycle

DeleteBucketLifecycle

DELETE Bucket policy

DeleteBucketPolicy

DELETE Bucket replication

DeleteBucketReplication

DELETE Bucket tagging

DeleteBucketTagging

DELETE Bucket website

DeleteBucketWebsite

GET Bucket acl

GetBucketAcl

GET Bucket cors

GetBucketCors

GET Bucket encryption

GetBucketEncryption

GET Bucket lifecycle

GetBucketLifecycle

GET Bucket location

GetBucketLocation

GET Bucket logging

GetBucketLogging

GET Bucket notification

GetBucketNotification

GET Bucket policy

GetBucketPolicy

GET Bucket replication

GetBucketReplication

GET Bucket requestPayment

GetBucketRequestPay

GET Bucket tagging

GetBucketTagging

GET Bucket versioning

GetBucketVersioning

GET Bucket website

GetBucketWebsite

GET Service (すべてのバケットを表示します)

ListBuckets

PUT Bucket

CreateBucket

PUT Bucket acl

PutBucketAcl

PUT Bucket cors

PutBucketCors

PUT Bucket encryption

PutBucketEncryption

PUT Bucket lifecycle

PutBucketLifecycle

PUT Bucket logging

PutBucketLogging

PUT Bucket notification

PutBucketNotification

PUT Bucket policy

PutBucketPolicy

PUT Bucket replication

PutBucketReplication

PUT Bucket requestPayment

PutBucketRequestPay

PUT Bucket tagging

PutBucketTagging

PUT Bucket versioning

PutBucketVersioning

PUT Bucket website

PutBucketWebsite

これらの API オペレーションに加えて、OPTIONS オブジェクトのオブジェクトレベルのアクションを使用することもできます。このアクションは、バケットの CORS 設定を確認するため、CloudTrail ログ記録のバケットレベルアクションように扱われます。

CloudTrail のログ記録によって追跡される Amazon S3 オブジェクトレベルのアクション

オブジェクトレベルの Amazon S3 アクションの CloudTrail ログを取得することもできます。これを行うには、証跡の Amazon S3 オブジェクトを指定します。オブジェクトレベルのアクションがアカウントで発生すると、CloudTrail によって証跡の設定が評価されます。イベントが証跡で指定したオブジェクトに一致すると、そのイベントが記録されます。詳細については、「AWS CloudTrail データイベントで S3 バケットのオブジェクトレベルのログ記録を有効にする方法」(Amazon Simple Storage Service コンソールユーザーガイド) と「データイベント」(AWS CloudTrail User Guide) を参照してください。CloudTrail でログに記録できるオブジェクトレベルのアクションを、次の表に示します。

REST API 名 CloudTrail ログで使用される API イベント名

マルチパートアップロードの中止

AbortMultipartUpload

Complete Multipart Upload

CompleteMultipartUpload

DELETE Object

DeleteObject

GET Object

GetObject

GET Object ACL

GetObjectAcl

GET Object tagging

GetObjectTagging

GET Object torrent

GetObjectTorrent

HEAD Object

HeadObject

Initiate Multipart Upload

CreateMultipartUpload

パートのリスト

ListParts

POST Object

PostObject

POST Object restore

RestoreObject

PUT Object

PutObject

PUT Object acl

PutObjectAcl

PUT Object tagging

PutObjectTagging

PUT Object – Copy

CopyObject

SELECT Object Content

SelectObjectContent

Upload Part

UploadPart

Upload Part - Copy

UploadPartCopy

これらのオペレーションに加えて、次のバケットレベルのオペレーションを使用して、特定の条件下で CloudTrail ログをオブジェクトレベルの Amazon S3 アクションとして取得できます。

クロスアカウントのシナリオでのオブジェクトレベルのアクション

クロスアカウントのシナリオでオブジェクトレベルの API コールに関連する特殊なユースケースと CloudTrail ログが報告される方法を次に示します。CloudTrail は、常に依頼者 (API コールを行った人) にログを配信します。クロスアカウントアクセスを設定する際には、このセクションの例を検討します。

注記

例では、CloudTrail ログが適切に設定されていることを前提とします。

例 1: CloudTrail がバケット所有者にアクセスログを配信する

CloudTrail は、バケット所有者が同じオブジェクト API に対するアクセス許可を持つ場合にのみ、バケット所有者にアクセスログを配信します。次のクロスアカウントのシナリオを検討してください。

  • Account-A がバケットを所有しています。

  • Account-B (依頼者) が、そのバケット内のオブジェクトへのアクセスを試みます。

CloudTrail は、常にオブジェクトレベルの API アクセスログを依頼者に配信します。さらに、CloudTrail は、バケット所有者がそのオブジェクトに対する同じ API アクションのアクセス許可を持っている場合にのみ、そのバケット所有者に同じログを配信します。

注記

バケット所有者がオブジェクトの所有者でもある場合、そのバケット所有者はオブジェクトのアクセスログを取得します。そうでない場合、バケット所有者が同じオブジェクトアクセス API ログを取得するには、オブジェクト ACL を通じて同じオブジェクト API に対するアクセス許可を取得する必要があります。

例 2: CloudTrail は設定オブジェクト ACL で使用されている E メールアドレスを拡散しない

次のクロスアカウントのシナリオを検討してください。

  • Account-A がバケットを所有しています。

  • Account-B (依頼者) は、E メールアドレスを使用してオブジェクト ACL 権限を設定するリクエストを送信します。ACL の詳細については、「アクセスコントロールリスト (ACL) の概要」を参照してください。

リクエストは E メール情報とともにログを取得します。ただし、例 1 のようにバケット所有者がログの受信資格を持つ場合、バケット所有者はイベントを報告する CloudTrail ログを取得します。一方、バケット所有者は ACL 設定情報 (具体的には被付与者の E メールと権限) を取得しません。ログがバケット所有者に通知する情報は、Account-B によって行われた ACL API コールだけです。

Amazon S3 SOAP API コールでの CloudTrail 追跡

CloudTrail は Amazon S3 の SOAP API 呼び出しを追跡します。Amazon S3SOAP のサポートは HTTP 経由では廃止されましたが、HTTPS 経由では引き続き利用可能です。Amazon S3 の SOAP に対するサポートの詳細については、「付録 A: SOAP API の使用」を参照してください。

重要

新しい Amazon S3 機能は、SOAP ではサポートされません。REST API か AWS SDK を使用することをお勧めします。

CloudTrail のログ記録で追跡される Amazon S3 の SOAP アクション

SOAP API 名 CloudTrail ログで使用される API イベント名

ListAllMyBuckets

ListBuckets

CreateBucket

CreateBucket

DeleteBucket

DeleteBucket

GetBucketAccessControlPolicy

GetBucketAcl

SetBucketAccessControlPolicy

PutBucketAcl

GetBucketLoggingStatus

GetBucketLogging

SetBucketLoggingStatus

PutBucketLogging

Amazon S3 サーバーアクセスログおよび CloudWatch Logs で CloudTrail ログを使用する

AWS CloudTrail のログは Amazon S3 のサーバーアクセスログとともに使用できます。CloudTrail ログは Amazon S3 バケットレベルとオブジェクトレベルのオペレーションに対する詳細な API 追跡を提供します。一方、Amazon S3 のサーバーアクセスログでは Amazon S3 内のデータに対するオブジェクトレベルのオペレーションが可視化されます。サーバーアクセスログの詳細については、「Amazon S3 サーバーアクセスのログ記録」を参照してください。

また、CloudTrail ログは Amazon S3 の CloudWatch と一緒に使用することもできます。CloudTrail を CloudWatch ログと統合することで、指定した CloudWatch ロググループの CloudWatch ログストリームに CloudTrail がキャプチャした S3 バケットレベルの API アクティビティが配信されます。特定の API アクティビティをモニタリングする CloudWatch アラームを作成し、その API アクティビティが発生した時に電子メールの通知を受け取ることができます。特定の API アクティビティをモニタリングする CloudWatch アラームの詳細については、AWS CloudTrail User Guideを参照してください。CloudWatch で Amazon S3 を使用する方法については、「Amazon CloudWatch を使用したメトリクスのモニタリング」を参照してください。

例: Amazon S3 ログファイルのエントリ

証跡は、指定した Amazon S3 バケットにイベントをログファイルとして配信するように設定できます。CloudTrail ログファイルには、1 つ以上のログエントリが含まれます。イベントは任意の発生元からの 1 つのリクエストを表し、リクエストされたアクション、アクションの日時、リクエストのパラメータなどに関する情報が含まれます。CloudTrail ログファイルは、パブリック API 呼び出しの順序付けられたスタックトレースではないため、特定の順序では表示されません。

次の例は、DELETE Bucket policyPUT Bucket acl、および GET Bucket versioning アクションを示す CloudTrail ログエントリです。

{ "Records": [ { "eventVersion": "1.03", "userIdentity": { "type": "IAMUser", "principalId": "111122223333", "arn": "arn:aws:iam::111122223333:user/myUserName", "accountId": "111122223333", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "userName": "myUserName" }, "eventTime": "2015-08-26T20:46:31Z", "eventSource": "s3.amazonaws.com", "eventName": "DeleteBucketPolicy", "awsRegion": "us-west-2", "sourceIPAddress": "127.0.0.1", "userAgent": "[]", "requestParameters": { "bucketName": "myawsbucket" }, "responseElements": null, "requestID": "47B8E8D397DCE7A6", "eventID": "cdc4b7ed-e171-4cef-975a-ad829d4123e8", "eventType": "AwsApiCall", "recipientAccountId": "111122223333" }, { "eventVersion": "1.03", "userIdentity": { "type": "IAMUser", "principalId": "111122223333", "arn": "arn:aws:iam::111122223333:user/myUserName", "accountId": "111122223333", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "userName": "myUserName" }, "eventTime": "2015-08-26T20:46:31Z", "eventSource": "s3.amazonaws.com", "eventName": "PutBucketAcl", "awsRegion": "us-west-2", "sourceIPAddress": "", "userAgent": "[]", "requestParameters": { "bucketName": "", "AccessControlPolicy": { "AccessControlList": { "Grant": { "Grantee": { "xsi:type": "CanonicalUser", "xmlns:xsi": "http://www.w3.org/2001/XMLSchema-instance", "ID": "d25639fbe9c19cd30a4c0f43fbf00e2d3f96400a9aa8dabfbbebe1906Example" }, "Permission": "FULL_CONTROL" } }, "xmlns": "http://s3.amazonaws.com/doc/2006-03-01/", "Owner": { "ID": "d25639fbe9c19cd30a4c0f43fbf00e2d3f96400a9aa8dabfbbebe1906Example" } } }, "responseElements": null, "requestID": "BD8798EACDD16751", "eventID": "607b9532-1423-41c7-b048-ec2641693c47", "eventType": "AwsApiCall", "recipientAccountId": "111122223333" }, { "eventVersion": "1.03", "userIdentity": { "type": "IAMUser", "principalId": "111122223333", "arn": "arn:aws:iam::111122223333:user/myUserName", "accountId": "111122223333", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "userName": "myUserName" }, "eventTime": "2015-08-26T20:46:31Z", "eventSource": "s3.amazonaws.com", "eventName": "GetBucketVersioning", "awsRegion": "us-west-2", "sourceIPAddress": "", "userAgent": "[]", "requestParameters": { "bucketName": "myawsbucket" }, "responseElements": null, "requestID": "07D681279BD94AED", "eventID": "f2b287f3-0df1-4961-a2f4-c4bdfed47657", "eventType": "AwsApiCall", "recipientAccountId": "111122223333" } ] }