> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/datasets/ja/toappurdo/adding-data/datasource-credentials/aws-s3.md).

# AWS S3 認証情報

Roboflow に AWS S3 バケットをミラーリングさせたい場合は、このページを使用してください。 [データソース](/datasets/ja/toappurdo/adding-data/datasources.md).

{% hint style="warning" %}
AWS S3 では、継続的な同期、繰り返しのインポート、またはメタデータのサイドカーサポートが必要な場合は、データソースとバケットミラーリングを使用してください。そのユースケース向けに、署名付き URL やローカルダウンロードのワークフローを構築しないでください。
{% endhint %}

## 認証情報の種類を選択

Roboflow は、S3 データソース向けに 3 種類の AWS アクセスパターンをサポートしています： [IAM 認証情報](#use-iam-access-keys), [ロールの引き受け](#use-assume-role)、および [バケットポリシーによるアクセス](#use-a-bucket-policy-grant).

1. [**IAM 認証情報**](#use-iam-access-keys)：最も簡単なセットアップ方法
2. [**ロールの引き受け**](#use-assume-role)：ほとんどのチームに推奨
3. [**バケットポリシーによるアクセス**](#use-a-bucket-policy-grant)：チームがバケットで直接アクセスを許可したい場合に使用

長期間有効な AWS シークレットを回避できるため、ロールの引き受けが最も安全なデフォルトです。

### セキュリティガイドライン

認証情報を作成する前に：

1. Roboflow 専用のロールまたは IAM ID を使用してください。
2. AWS アカウントのルートユーザーは使用しないでください。
3. 可能な限り、特定のバケットにアクセス範囲を限定してください。
4. 推奨： [ロールの引き受け](/datasets/ja/toappurdo/adding-data/datasource-policy-examples.md#assume-role-trust-policy) 長期間有効なアクセスキーよりも。
5. 認証情報は Roboflow Workspace にのみ保存してください [認証情報](https://app.roboflow.com/settings/thirdpartykeys) またはご自身のシークレットマネージャーに保存してください。
6. アクセスキーを使用する場合はローテーションし、未使用のキーは削除してください。

### ロールの引き受けを使用

**Amazon 推奨**。長期間有効なアクセスキーは不要です。代わりに、Roboflow がバケットを読み取るために引き受ける IAM ロールを AWS アカウントで作成します。

1. 以下を開きます： [IAM ロールコンソール](https://console.aws.amazon.com/iam/home#/roles).
2. AWS アカウントで新しいロールを作成します。
3. Roboflow で次を開きます： [認証情報](https://app.roboflow.com/settings/thirdpartykeys)、次にクリック： [認証情報を追加](https://app.roboflow.com/settings/thirdpartykeys#create)、そして「AWS Assume Role」認証情報タイプを選択します。
4. 認証情報を作成モーダルに表示されている Roboflow AWS プリンシパル ARN と外部 ID をコピーします。
5. 以下の信頼ポリシーを追加します： [データソースポリシーの例](/datasets/ja/toappurdo/adding-data/datasource-policy-examples.md#assume-role-trust-policy) をロールに追加し、プレースホルダーをモーダルの値に置き換えます。
6. 以下のバケットスコープの読み取りポリシーをアタッチします： [データソースポリシーの例](/datasets/ja/toappurdo/adding-data/datasource-policy-examples.md#custom-iam-policy)、または同等の最小権限ポリシー。
7. ロール ARN をコピーします。
8. ロール ARN を Roboflow の認証情報フォームに貼り付け、認証情報を保存します。

外部 ID はワークスペースと認証情報タイプに紐付けられているため、モーダルを再度開いても同じ値が表示されます。

### IAM アクセスキーを使用

これは最も簡単なセットアップ方法ですが、Amazon は推奨していません。

1. 以下を開きます： [IAM ユーザーコンソール](https://console.aws.amazon.com/iam/home#/users).
2. Roboflow 専用の IAM ユーザーを作成します。
3. AWS 管理ポリシーをアタッチします `AmazonS3ReadOnlyAccess`、または推奨として、以下のバケットスコープポリシーを使用します： [データソースポリシーの例](/datasets/ja/toappurdo/adding-data/datasource-policy-examples.md#custom-iam-policy).
4. 現在の AWS コンソールの手順で、そのユーザー用のアクセスキーを作成します。
5. アクセスキー ID とシークレットアクセスキーを安全な場所に保存します。
6. Roboflow で次を開きます： [認証情報](https://app.roboflow.com/settings/thirdpartykeys)、次にクリック： [認証情報を追加](https://app.roboflow.com/settings/thirdpartykeys#create)、そして「AWS IAM」認証情報タイプを選択します。
7. アクセスキーとシークレットキーを入力し、認証情報を保存します。

`AmazonS3ReadOnlyAccess` は、アカウント内のすべてのバケットへの読み取りアクセスを許可します。最小権限アクセスが必要な場合は、以下のカスタムバケットスコープポリシーを使用してください： [データソースポリシーの例](/datasets/ja/toappurdo/adding-data/datasource-policy-examples.md#custom-iam-policy).

### バケットポリシーによる許可を使用

**Enterprise のお客様のみ**。IAM 認証情報は不要です。代わりに、Roboflow の AWS ロールに直接読み取りアクセスを許可するバケットポリシーを追加します。

1. Roboflow 担当者から Roboflow AWS ロール ARN を取得します。
2. AWS で対象の S3 バケットポリシーを開きます。
3. 以下の例をマージします： [データソースポリシーの例](/datasets/ja/toappurdo/adding-data/datasource-policy-examples.md#bucket-policy).
4. ポリシーがバケットに必要な最小限の読み取りアクセスのみを許可していることを確認します。
5. ワークスペースのフローで必要な場合は、Roboflow で対応する認証情報を作成します。

正しいロール ARN については Roboflow 担当者にお問い合わせください。既存のバケットポリシーがある場合は、そのポリシーに例をマージしてください。

## Roboflow で認証情報を作成

AWS 側のアクセスを作成した後：

1. 次へ移動： [認証情報](https://app.roboflow.com/settings/thirdpartykeys#create) ワークスペース設定内。
2. クリック： [認証情報を追加](https://app.roboflow.com/settings/thirdpartykeys#create).
3. AWS S3 データソースの認証情報タイプを選択します。
4. 選択した方法に応じて、ロール ARN またはアクセスキーの詳細を入力します。
5. 認証情報を保存します。
6. 以下を作成する際に、その認証情報を選択します： [データソース](https://app.roboflow.com/settings/datasources#create).

## 次のステップ

認証情報を保存したら、以下に進みます： [データソース](/datasets/ja/toappurdo/adding-data/datasources.md) バケットミラーリングを設定するために。