Stripe Connector for Amazon S3公開プレビュー
Amazon S3 バケットから Stripe への継続的なファイルのインポートを自動化します。
このガイドでは、Amazon S3 から Stripe Data Management プラットフォームにファイルをインポートする方法を説明します。この手順を使用して、Stripe プロダクトを最新の状態に維持するためのデータインポートの自動化ジョブを設定します。
前提条件
導入を開始する前に、以下が揃っていることを確認してください。
- 関連するファイルへのアクセス権を持つアクティブな AWS アカウントと S3 バケット。
- Stripe ダッシュボードにアクセスするための管理者アカウント。
AWS アカウントにログインする
設定プロセス中は、 AWS Access Console (AWS アクセスコンソール) にアクセスする必要があります。
- AWS マネジメントコンソールにサインインします
Amazon S3 でファイルを準備する
接続設定を検証するために、適切な形式のファイルを S3 バケットで使用します。設定プロセスでは利用可能なファイルが表示され、接続が設定されると最初の同期が実行されます。
- Amazon S3 コンソールにアクセスします。
- ファイルが指定の S3 バケットに保存され、インポート設定に従って構成されていることを確認します。
- 現在 S3 バケットがない場合は、最初のバケットを作成するための AWS ガイドラインに従ってください。
- 正常に取得するために、Stripe には次のファイル要件があります。
- ファイル名が、S3 オブジェクトの名前の規則に従っている必要があります。
- 最大ファイルサイズは 1 GB です。
- バケット名と地域は後続のステップで必要になるので、覚えておいてください。
- AWS コンソールは、以降のステップで IAM ロールを設定するために開いたままにしてください。
サポートされているファイル形式
- CSV
- TSV
- JSON
- JSONLINE
- その他の形式については、サポートにお問い合わせください
Stripe Amazon S3 コネクターで、S3 バケットからファイルをインポートするように設定する
- Stripe Data Management Connector ダッシュボードにサインインします。
- + コネクターを設定する、Amazon S3 の順にクリックします。
- このコネクションに一意のコネクター名を指定します。データソース、ファイルのオブジェクト、接続先の製品に関する詳細を使用して、強固な一意の名前を作成することを検討してください。
- Amazon コンソールで、IAM コンソールに移動します。
- Stripe Amazon S3 コネクター設定の次のステップでは、カスタム信頼ポリシーを使用して IAM ロールを作成するための詳細をご説明します。
- コンソールのナビゲーションペインで、ポリシー、ポリシーの作成の順にクリックします。
- 権限のポリシーを作成するには、JSON を選択し、示されているコードブロックをコピーして貼り付けて、既存のポリシーテキストを置き換えます。ポリシーエディターのコードブロックの Resource セクションにある
USER_
を目的のバケット名に置き換えます。次へをクリックします。ポリシーの詳細でポリシー名を追加して (オプションでタグも指定可能)、ポリシーの作成をクリックします。TARGET_ BUCKET - コンソールのナビゲーションペインに戻り、ロール、ロールを作成の順にクリックします。
- カスタム信頼ポリシーロールタイプを選択し、示されているコードブロックをコピーして貼り付けて、次へをクリックします。
- 権限のポリシーを選択するには、リストで新規作成した権限のポリシーを探します。チェックボックスにチェックマークを付け、ポリシーを選択し、スクロールダウンして次へをクリックします。
- ロール名を作成するには、示されているロール名をコピーして貼り付けて、ロールを作成をクリックします。
- Stripe Amazon S3 コネクター設定の次のステップでは、Amazon S3 バケットと Stripe 間の接続を設定します。
- AWS コンソールから、AWS アカウント ID を検索して指定します。
- ステップ 2.3 で AWS コンソールに保存したバケット名と地域を指定します。
- フォルダーを使用して Amazon S3 バケットのファイルを構成している場合は、上記バケット内のフォルダーを指定します。
- 上記バケット内のフォルダーを指定する場合、バケット全体ではなく、このフォルダーのデータのみが取得されます。
- 新しいコネクターが正しく設定されると、Stripe は過去 90 日間に変更された Amazon S3 バケットのすべてのデータを取得します。
- Stripe は 5 分ごとにデータを取得します。
- 継続的なインポートでは、最後の同期よりも後の LastModified 日付を持つオブジェクトのみがインポートされます。
- ステップ 4 では、接続された Amazon S3 バケットで利用できるファイルをプレビューし、それらをデータテンプレートに関連付けることができます。
- ファイルのプレビューでは、ご自身の認証情報によって、想定される Amazon S3 のバケットとフォルダーに Stripe が関連付けられていることを検証します。
- データテンプレートは、この接続を初回および継続的なインポートで想定されるファイル形式に関連付けます。
- 完了をクリックして、アクティブなデータ接続を作成し、最初のデータインポートを開始します。
Amazon S3 への接続を維持する
接続が確立されると、Stripe は 5 分ごとにデータを取得します。接続の健全性を監視するには、次の操作を実行できます。
- Stripe Data Management Connector ダッシュボードにアクセスして、確立された接続のステータスと最後の同期の詳細を確認します。
- コネクターをクリックして、単一の接続を管理します。
- コネクター名やデータテンプレートを編集し、切断された接続を再度認証し、接続を削除できます。
- 自動化ジョブを設定して、S3 バケットに新しいファイルを定期的に送信することをお勧めします。
- Amazon List Object API では LastModified によるオブジェクトの絞り込みを実行できません。このため、インポートごとにすべてのバケットコンテンツのリストを作成する必要があります。Stripe にインポートする予定のデータには、関連付けられた IAM ロールのみがアクセスできるようにしてください。バケット内のファイル数は 5 万件未満に制限することをお勧めします。そのためには、オブジェクトの有効期限もこれに応じて設定します。