Kinesis にイベントをストリーミングするための IAM ロール

Amazon Pinpoint は、アプリの使用状況データまたはイベントデータを、アプリからアカウントの Amazon Kinesis データストリームまたは Amazon Kinesis Data Firehose デリバリーストリームに自動的に送信できます。 AWS Amazon Pinpoint でイベントデータのストリーミングを開始するには、事前に Amazon Pinpoint に必要なアクセス権限を割り当てなければなりません。

コンソールを使用してイベントストリーミングをセットアップする場合、Amazon Pinpoint は自動的に必要なアクセス権限を持つ AWS Identity and Access Management (IAM) ロールを作成します。詳細については、『Amazon Pinpoint ユーザーガイド』の「Amazon Pinpoint イベントを Amazon Kinesis へストリーミングする」を参照してください。

手動でロールを作成する場合は、次のポリシーをロールにアタッチします。

• イベントデータをストリームに送信することを Amazon Pinpoint に許可するアクセス許可ポリシー。

• Amazon Pinpoint がロールを引き受けるのを許可する信頼ポリシー。

ロールの作成が完了したら、Amazon Pinpoint を設定して自動的にストリームにイベントを送信できます。詳細については、このガイドの「Amazon Pinpoint のイベントを Kinesis にストリーミングする」を参照してください。

IAM ロールの作成 (AWS CLI)

AWS Command Line Interface (AWS CLI) を使って IAM ロールを手動で作成するには、次の手順を実行します。Amazon Pinpoint コンソールを使用してロールを作成する方法については、『Amazon Pinpoint ユーザーガイド』の「Amazon Pinpoint のイベントを Kinesis にストリーミングする」を参照してください。

をインストールしていない場合は AWS CLI、ユーザーガイドの「AWS CLIのインストール」を参照してください。AWS Command Line Interface

を使用して IAM ロールを作成するには AWS CLI

1. 新しいファイルを作成します。ドキュメントに次のポリシーを貼り付けます。

   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Effect": "Allow",
               "Principal": {
                   "Service": "pinpoint.amazonaws.com"
               },
               "Action": "sts:AssumeRole",
               "Condition": {
                   "StringEquals": {
                       "aws:SourceAccount": "accountId"
                   },
                   "ArnLike": {
                       "aws:SourceArn": "arn:aws:mobiletargeting:region:accountId:apps/applicationId"
                   }
               }
           }
       ]
   }

   終了したら、PinpointEventStreamTrustPolicy.json としてファイルを保存します。

2. create-role コマンドを使用して、ロールを作成し、信頼ポリシーをアタッチします。

   aws iam create-role --role-name PinpointEventStreamRole --assume-role-policy-document file://PinpointEventStreamTrustPolicy.json

3. ロールのアクセス許可ポリシーを含む新しいファイルを作成します。

   Kinesis ストリームにデータを送信するように Amazon Pinpoint を設定する場合は、次のポリシーをファイルに貼り付けます。

   {
       "Version": "2012-10-17",
       "Statement": {
           "Action": [
               "kinesis:PutRecords",
               "kinesis:DescribeStream"
           ],
           "Effect": "Allow",
           "Resource": [
               "arn:aws:kinesis:region:accountId:stream/streamName"
           ]
       }
   }

   また、Kinesis Data Firehose ストリームにデータを送信するように Amazon Pinpoint を設定する場合は、次のポリシーをファイルに貼り付けます。

   {
       "Version": "2012-10-17",
       "Statement": {
           "Effect": "Allow",
           "Action": [
           	"firehose:PutRecordBatch",
           	"firehose:DescribeDeliveryStream"
           ],
           "Resource": [
           	"arn:aws:firehose:region:accountId:deliverystream/delivery-stream-name"
       	]
       }
   }

   終了したら、PinpointEventStreamPermissionsPolicy.json としてファイルを保存します。

4. put-role-policy コマンドを使用して、ロールにアクセス権限ポリシーをアタッチします。

   aws iam put-role-policy --role-name PinpointEventStreamRole --policy-name PinpointEventStreamPermissionsPolicy --policy-document file://PinpointEventStreamPermissionsPolicy.json