Amazon S3 コネクタ構成ガイド
この記事では、Amazon S3 コネクタの構成方法について説明します。
バッチ制限
このコネクタは、ベンダーへの大量データ転送をサポートするために、リクエストをバッチ処理します。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかのしきい値に達するか、プロファイルがパブリッシュされるまでキューに入れられます。
- リクエストの最大数:100,000
- 最も古いリクエストからの最大経過時間:10 分
- リクエストの最大サイズ:100 MB
構成
コネクタマーケットプレイスに移動し、新しいコネクタを追加します。詳細については、コネクタについてを参照してください。
コネクタを追加した後、次の構成を構成します。
- 認証タイプ
- 認証タイプを選択します。使用可能なオプションは、STS と アクセスキーです。
- STS:ロールの引き受け:ARN フィールドと ロールの引き受け:セッション名フィールドが必要です。
- アクセスキー:AWS アクセスキーフィールドと AWS シークレットアクセスキーフィールドが必要です。
- 認証タイプを選択します。使用可能なオプションは、STS と アクセスキーです。
- リージョン
- (必須)リージョンを選択します。
- STS - ロールの引き受け:ARN
- STS 認証では必須です。引き受けるロールの Amazon リソースネーム(ARN)を指定します。
- 例:
arn:aws:iam:222222222222:role/myrole - 詳細については、AWS Identity and Access Management:IAM ロールへの切り替え(AWS API)を参照してください。
- STS - ロールの引き受け:セッション名
- 引き受けるロールのセッション名です。
- 2~64 文字で指定する必要があります。
- STS - ロールの引き受け:外部 ID
- サードパーティの外部識別子を指定します。
- 詳細については、AWS Identity and Access Management:サードパーティが所有する AWS アカウントへのアクセスを参照してください。
- アクセスキー - AWS アクセスキー
- アクセスキー認証では必須です。AWS アクセスキーを指定します。
- アクセスキー - AWS シークレットアクセスキー
- アクセスキー認証では必須です。AWS シークレットアクセスキーを指定します。
AWS S3 への接続を作成する
Tealium がバケットの一覧を表示し、イベントおよびオーディエンスデータを S3 オブジェクトにアップロードするには、AWS S3 インスタンスへの接続が必要です。認証には次の 2 つのオプションがあります。
- アクセスキーとアクセスシークレットを指定します。
- STS(Security Token Service)認証情報を指定します。
コネクタを構成した後、完了をクリックします。
S3 オブジェクトが暗号化されている場合は、IAM ユーザーと KMS キーポリシーに復号権限を追加する必要があります。
アクセスキーとシークレット認証情報
AWS アクセスキーとシークレットを確認するには、次の手順を実行します。
- AWS Management Console にログインし、IAM(Identity and Access Management)サービスに移動します。
- ユーザーをクリックし、ユーザーを追加をクリックします。
- ユーザー名を入力します。例:
TealiumS3User - 作成したユーザーにポリシーをアタッチします。
- アクセス許可タブで、既存のポリシーを直接アタッチをクリックします。
- フルアクセスを許可するには、
AmazonS3FullAccessポリシーを検索してアタッチします。特定のバケットへのアクセスを制限するには、次の例のようなポリシーを作成します。この例では、YOUR_BUCKET_NAMEは、Tealium がイベントおよびオーディエンスデータを S3 オブジェクトにアップロードする際に使用するバケットです。
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:ListBucket", "s3:PutObject", "s3:GetObject", "s3:ListBucketMultipartUploads", "s3:ListMultipartUploadParts" ], "Resource": [ "arn:aws:s3:::YOUR_BUCKET_NAME", "arn:aws:s3:::YOUR_BUCKET_NAME/*" ] }, // Add the following section if you are running on a private cloud // and require decryption { "Effect": "Allow", "Action": [ "kms:Decrypt", "kms:GenerateDataKey" ], "Resource": "arn:aws:kms:YOUR_REGION:111879511226:key/YOUR_KEY_ID" } ] } - キーを作成します。
- セキュリティ認証情報タブに移動し、アクセスキーを作成をクリックします。
- アクセスキー ID と シークレットアクセスキーをコピーし、安全に保存します。
- プライベートクラウド環境を使用している場合は、次のようなステートメントをキーポリシーに追加します。
{ "Sid": "AllowDecryptFromIAMUser", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::<<account-id>>:user/<<user-name>>" }, "Action": [ "kms:Decrypt", "kms:GenerateDataKey" ], "Resource": "*" }
STS 認証情報
STS 認証情報を確認するには、次の手順を実行します。
- AWS Management Console にログインし、IAM(Identity and Access Management)サービスに移動します。
- Roles をクリックし、Create role をクリックします。
- Trusted entity のタイプとして、AWS アカウントを選択します。
- Another AWS account を選択し、Tealium のアカウント ID を入力します。
- プライベートクラウドのお客様の場合、ID は
111879511226です。 - その他すべてのお客様の場合、ID は
757913464184です。
- プライベートクラウドのお客様の場合、ID は
- (任意)Require external ID チェックボックスを選択し、使用する外部 ID を指定します。外部 ID は最大 256 文字で、英数字(
A-Z、a-z、0-9)およびハイフン(-)、アンダースコア(_)、ピリオド(.)などの記号を使用できます。 - ロールの名前を入力します。ロール名は TealiumS3 で始まる必要があります。例:
TealiumS3-test. - ロールにポリシーをアタッチします。
- Permissions タブで、Attach existing policies directly をクリックします。
- フルアクセスを許可するには、
AmazonS3FullAccessポリシーを検索してアタッチします。アクセスを特定のバケットに制限するには、次の例のようなポリシーを作成します。この例で、YOUR_BUCKET_NAMEは、Tealium がイベントおよびオーディエンスデータを S3 オブジェクトにアップロードするために使用するバケットです。
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:ListBucket", "s3:PutObject", "s3:GetObject", "s3:ListBucketMultipartUploads", "s3:ListMultipartUploadParts" ], "Resource": [ "arn:aws:s3:::YOUR_BUCKET_NAME", "arn:aws:s3:::YOUR_BUCKET_NAME/*" ] }, // Add the following section if you are running on a private cloud // and require decryption { "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111879511226:user/YOUR_USER_NAME" }, "Action": "s3:GetObject", "Resource": "arn:aws:s3:::YOUR_BUCKET_NAME/*" } ] } - 信頼ポリシーを作成します。
- Trust relationships タブに移動し、Edit trust relationship をクリックします。
- 信頼ポリシーで、指定した外部 ID に作成したロールの使用が許可されていることを確認します。また、プライベートクラウドのお客様の場合は ID が
111879511226、その他すべてのお客様の場合は ID が757913464184であることを確認します。 - Tealium への接続用に
EXTERNAL_IDの値を構成します。ID は最大 256 文字で、英数字(A-Z、a-z、0-9)およびハイフン(-)、アンダースコア(_)、ピリオド(.)などの記号を使用できます。
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::757913464184:root" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "sts:ExternalId": "EXTERNAL_ID" } } } ] }
バケットの作成
S3 バケットは、データの保存と整理に使用される AWS S3 内の保存コンテナです。コネクタ構成ウィンドウでは、構成手順で Create Bucket をクリックして新しいバケットを作成できます。
- コネクタ構成画面で、Create Bucket をクリックします。
- バケット名を入力します。
- Create をクリックします。
アクション
| アクション名 | 訪問プロファイル | イベントデータ |
|---|---|---|
| イベントデータ全体を送信 | ✗ | ✓ |
| カスタムイベントデータを送信 | ✗ | ✓ |
| 訪問データ全体を送信 | ✓ | ✗ |
| カスタム訪問データを送信 | ✓ | ✗ |
| ログイベントを送信 | ✗ | ✓ |
| ログイベント全体を送信 | ✗ | ✓ |
アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。
以下のセクションでは、各アクションのパラメータとオプションを構成する方法について説明します。
イベントデータ全体を送信
パラメータ
| パラメータ | 説明 |
|---|---|
| バケット | Amazon S3 バケットを選択するか、カスタム値を指定します。 |
| ファイルパス | データを追加する S3 オブジェクトへのパスを指定します。 |
| ファイルパスのサフィックス | 現在のタイムスタンプを持つ属性など、ファイルパスにサフィックスを動的に追加する場合は、ここで選択します。これにより、イベントごとに一意のファイルが作成され、既存のファイルが上書きされるのを防止できます。区切り文字は、ファイルパスとサフィックスの間、および複数のサフィックス値の間に配置されます。区切り文字は、ファイルパスの区切り文字で構成します。 |
| ファイルパスの区切り文字 | ファイルパスとファイルパスのサフィックスの間、および複数のサフィックス値の間に配置される文字です。オプションは、アンダースコア(デフォルト)、ハイフン、ピリオド、スラッシュ、またはなしです。既存の構成では、アンダースコアの動作が維持されます。 |
| レコードのサフィックス |
|
| 属性名を出力 | デフォルトでは、属性キーが使用されます。代わりに属性名をキーとして使用する場合は、このチェックボックスを有効にします。属性名が更新されると、ペイロードの名前にも更新が反映される点に注意してください。 |
| バッチの有効期間 | バッチアクションを送信する頻度を指定するため、有効期間(TTL)を構成します。1~60 分の値を入力します。デフォルト値は 10 分です。 |
カスタムイベントデータを送信
パラメータ
| パラメータ | 説明 |
|---|---|
| バケット | Amazon S3 バケットを選択するか、カスタム値を指定します。 |
| ファイルパス | データを追加する S3 オブジェクトへのパスを指定します。 |
メッセージデータ
| パラメータ | 説明 |
|---|---|
| イベント属性 | イベント属性とベンダーパラメータ間のカスタムマッピングを定義します。 |
| ファイルパスのサフィックス | 現在のタイムスタンプを持つ属性など、ファイルパスにサフィックスを動的に追加する場合は、ここで選択します。これにより、イベントごとに一意のファイルが作成され、既存のファイルが上書きされるのを防止できます。区切り文字は、ファイルパスとサフィックスの間、および複数のサフィックス値の間に配置されます。区切り文字は、ファイルパスの区切り文字で構成します。 |
| ファイルパスの区切り文字 | ファイルパスとファイルパスのサフィックスの間、および複数のサフィックス値の間に配置される文字です。オプションは、アンダースコア(デフォルト)、ハイフン、ピリオド、スラッシュ、またはなしです。既存の構成では、アンダースコアの動作が維持されます。 |
| レコードのサフィックス |
|
| バッチの有効期間 | バッチアクションを送信する頻度を指定するため、有効期間(TTL)を構成します。1~60 分の値を入力します。デフォルト値は 10 分です。 |
| テンプレート変数 |
|
| テンプレート |
|
訪問データ全体を送信
パラメータ
| パラメータ | 説明 |
|---|---|
| バケット | Amazon S3 バケットを選択するか、カスタム値を指定します。 |
| ファイルパス | データを追記する S3 オブジェクトのパスを指定します。 |
| ファイルパスのサフィックス | 現在のタイムスタンプを含む属性など、ファイルパスにサフィックスを動的に追加する場合は、ここで選択します。これにより、イベントごとに一意のファイルが作成され、既存ファイルの上書きを防止できます。区切り文字は、ファイルパスとサフィックスの間、および複数のサフィックス値の間に挿入されます。区切り文字は、ファイルパスの区切り文字で構成します。 |
| ファイルパスの区切り文字 | ファイルパスとファイルパスのサフィックスの間、および複数のサフィックス値の間に挿入する文字です。オプションは、アンダースコア(デフォルト)、ハイフン、ピリオド、スラッシュ、またはなしです。既存の構成では、アンダースコアの動作が維持されます。 |
| レコードのサフィックス |
|
| 属性名を出力 | デフォルトでは、属性キーが使用されます。代わりに属性名をキーとして使用する場合は、このチェックボックスを有効にします。属性名が更新されると、ペイロードの名前にもその更新が反映されることに注意してください。 |
| バッチの有効期間 | バッチアクションを送信する頻度を指定するため、有効期間(TTL)を構成します。1~60 分の値を入力します。デフォルト値は 10 分です。 |
| すべての訪問イベントを含める | 現在の訪問データを訪問データに含める場合に選択します。 |
カスタム訪問データを送信
パラメータ
| パラメータ | 説明 |
|---|---|
| バケット | Amazon S3 バケットを選択するか、カスタム値を指定します。 |
| ファイルパス | データを追記する S3 オブジェクトのパスを指定します。 |
メッセージデータ
| パラメータ | 説明 |
|---|---|
| ファイルパスのサフィックス | 現在のタイムスタンプを含む属性など、ファイルパスにサフィックスを動的に追加する場合は、ここで選択します。これにより、イベントごとに一意のファイルが作成され、既存ファイルの上書きを防止できます。区切り文字は、ファイルパスとサフィックスの間、および複数のサフィックス値の間に挿入されます。区切り文字は、ファイルパスの区切り文字で構成します。 |
| ファイルパスの区切り文字 | ファイルパスとファイルパスのサフィックスの間、および複数のサフィックス値の間に挿入する文字です。オプションは、アンダースコア(デフォルト)、ハイフン、ピリオド、スラッシュ、またはなしです。既存の構成では、アンダースコアの動作が維持されます。 |
| レコードのサフィックス |
|
| バッチの有効期間 | バッチアクションを送信する頻度を指定するため、有効期間(TTL)を構成します。1~60 分の値を入力します。デフォルト値は 10 分です。 |
| テンプレート変数 |
|
| テンプレート |
|
ログイベントを送信
パラメータ
| パラメータ | 説明 |
|---|---|
| バケット | Amazon S3 バケットを選択するか、カスタム値を指定します。 |
| ファイルパス | データを追記する S3 オブジェクトのパスを指定します。 |
メッセージデータ
| パラメータ | 説明 |
|---|---|
| イベント属性 | イベント属性とベンダーパラメータ間のカスタムマッピングを定義します。 |
| ファイルパスのサフィックス | 現在のタイムスタンプを含む属性など、ファイルパスにサフィックスを動的に追加する場合は、ここで選択します。これにより、イベントごとに一意のファイルが作成され、既存ファイルの上書きを防止できます。複数のサフィックス値を入力した場合は、アンダースコアで区切られます。 |
| レコードのサフィックス |
|
| バッチの有効期間 | バッチアクションを送信する頻度を指定するため、有効期間(TTL)を構成します。1~60 分の値を入力します。デフォルト値は 10 分です。 |
| テンプレート変数 |
|
| テンプレート |
|
ログイベント全体を送信
パラメータ
| パラメータ | 説明 |
|---|---|
| バケット | Amazon S3 バケットを選択するか、カスタム値を指定します。 |
| ファイルパス | データを追記する S3 オブジェクトのパスを指定します。 |
| ファイルパスのサフィックス | 現在のタイムスタンプを含む属性など、ファイルパスにサフィックスを動的に追加する場合は、ここで選択します。これにより、イベントごとに一意のファイルが作成され、既存ファイルの上書きを防止できます。複数のサフィックス値を入力した場合は、アンダースコアで区切られます。 |
| レコードのサフィックス |
|
最終更新日 :: 2026年November月10日