# Stripe Connector for Amazon S3

Amazon S3 バケットから Stripe への継続的なファイルのインポートを自動化します。

このガイドでは、Amazon S3 から Stripe Data Management プラットフォームにファイルをインポートする方法を説明します。この手順を使用して、Stripe プロダクトを最新の状態に維持するためのデータインポートの自動化ジョブを設定します。

## 前提条件

導入を開始する前に、以下が揃っていることを確認してください。

1. 関連するファイルへのアクセス権を持つアクティブな AWS アカウントと S3 バケット。
2. Stripe ダッシュボードにアクセスするための管理者アカウント。

## AWS アカウントにログインする

設定プロセス中に、AWS マネジメントコンソールへのアクセス権が必要です。

1. [AWS マネジメントコンソール](https://console.aws.amazon.com/)にサインインします

## Amazon S3 でファイルを準備する

接続設定を検証するために、適切な形式のファイルを S3 バケットで使用します。設定プロセスでは利用可能なファイルが表示され、接続が設定されると最初の同期が実行されます。

1. [Amazon S3 コンソール](https://s3.console.aws.amazon.com/)にアクセスします。
2. ファイルが指定の S3 バケットに保存され、インポート設定に従って構成されていることを確認します。
   - 現在 S3 バケットがない場合は、[最初のバケットを作成するための AWS ガイドライン](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html)に従ってください。
   - 正常に取得するために、Stripe には次のファイル要件があります。
     - ファイル名が、[S3 オブジェクトの名前の規則](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html)に従っている必要があります。
     - 最大ファイルサイズは 1 GB です。
3. バケット名とリージョンは、今後のステップで必要になるため、覚えておいてください。
4. AWS コンソールは、以降のステップで IAM ロールを設定するために開いたままにしてください。

### サポートされているファイル形式

- CSV
- TSV
- JSON
- JSONLINE

追加の形式をリクエストするには、[Stripe サポートにお問い合わせ](https://support.stripe.com/)ください。

## Stripe Amazon S3 コネクターで、S3 バケットからファイルをインポートするように設定する

1. [Stripe Data Management Connector ダッシュボード](https://dashboard.stripe.com/data-management/connectors)にサインインします。
2. **+ コネクターを設定する**、**Amazon S3** の順にクリックします。
3. このコネクションに一意のコネクター名を指定します。データソース、ファイルのオブジェクト、接続先の製品に関する詳細を使用して、強固な一意の名前を作成することを検討してください。
4. Amazon コンソールで、[IAM コンソール](https://console.aws.amazon.com/iam/) に移動します。
5. Stripe Amazon S3 コネクター設定の次のステップでは、カスタム信頼ポリシーを使用して IAM ロールを作成するための詳細をご説明します。
   - コンソールのナビゲーションペインで、**ポリシー**、**ポリシーの作成**の順にクリックします。
   - 権限のポリシーを作成するには、**JSON** を選択し、示されているコードブロックをコピーして貼り付けて、既存のポリシーテキストを置き換えます。**ポリシーエディター**のコードブロックの Resource セクションにある `USER_TARGET_BUCKET` を目的のバケット名に置き換えます。**次へ**をクリックします。**ポリシーの詳細**でポリシー名を追加して (オプションでタグも指定可能)、**ポリシーの作成**をクリックします。
   - コンソールのナビゲーションペインに戻り、**ロール**、**ロールを作成**の順にクリックします。
   - **カスタム信頼ポリシー**ロールタイプを選択し、示されているコードブロックをコピーして貼り付けて、**次へ**をクリックします。
   - 権限のポリシーを選択するには、リストで新規作成した権限のポリシーを探します。チェックボックスにチェックマークを付け、ポリシーを選択し、スクロールダウンして**次へ**をクリックします。
   - ロール名を作成するには、示されているロール名をコピーして貼り付けて、**ロールを作成**をクリックします。
6. Stripe Amazon S3 コネクター設定の次のステップでは、Amazon S3 バケットと Stripe 間の接続を設定します。
   - AWS コンソールから、[AWS アカウント ID を検索して指定します](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-identifiers.html#FindAccountId)。
   - 記録したバケット名とリージョンを入力してください。
   - フォルダーを使用して Amazon S3 バケットのファイルを構成している場合は、上記バケット内のフォルダーを指定します。
     - 上記のバケット内のフォルダを指定した場合、Stripe はバケット全体ではなく、そのフォルダからのみデータを取得します。
7. 新しいコネクターが正しく設定されると、Stripe は過去 90 日間に変更された Amazon S3 バケットのすべてのデータを取得します。
   - Stripe は 5 分ごとにデータを取得します。
   - 継続的なインポートでは、最後の同期よりも後の LastModified 日付を持つオブジェクトのみがインポートされます。
8. セットアップウィザードの次のステップでは、接続された Amazon S3 バケットで利用可能なファイルをプレビューし、それらをデータテンプレートに関連付けることができます。
   - ファイルのプレビューでは、ご自身の認証情報によって、想定される Amazon S3 のバケットとフォルダーに Stripe が関連付けられていることを検証します。
   - データテンプレートは、この接続を初回および継続的なインポートで想定されるファイル形式に関連付けます。
9. **完了**をクリックして、アクティブなデータ接続を作成し、最初のデータインポートを開始します。

## Amazon S3 への接続を維持する

接続が確立されると、Stripe は 5 分ごとにデータを取得します。接続の状態を監視するには、以下の操作を実行できます:

- [Stripe Data Management Connector ダッシュボード](https://dashboard.stripe.com/data-management/connectors)にアクセスして、確立された接続のステータスと最後の同期の詳細を確認します。
- コネクタを選択すれば、1 つの接続を管理できます。
  - コネクター名やデータテンプレートを編集し、切断された接続を再度認証し、接続を削除できます。
- 自動ジョブを設定すれば、新しいファイルを定期的に S3 バケットに配信できます。
- オブジェクトの有効期限を適切に設定して、バケット内のファイル数を 50000 件未満に抑えてください。Amazon の List Object API では、LastModified によるオブジェクトのフィルタリングに対応していないため、Stripe はインポートのたびにバケット内のすべてのコンテンツを一覧表示する必要があります。
- 関連付けられた IAM ロールには、Stripe にインポートする予定のデータへのアクセスのみを許可してください。