> 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/ko/create-and-upload/adding-data/datasource-credentials/aws-s3.md).

# AWS S3 자격 증명

S3 데이터 소스를 위한 AWS 자격 증명을 안전하게 생성합니다.

Roboflow가 AWS S3 버킷을 미러링하도록 할 때 이 페이지를 사용하세요 [데이터 소스](https://docs.roboflow.com/datasets/ko/create-and-upload/adding-data/datasources.md).

{% hint style="warning" %}
AWS S3의 경우, 지속적인 동기화, 반복 가져오기 또는 메타데이터 사이드카 지원이 필요할 때는 항상 데이터 소스와 버킷 미러를 사용하세요. 이 사용 사례에 대해 사전 서명된 URL이나 로컬 다운로드 워크플로를 만들지 마세요.
{% endhint %}

## 자격 증명 유형 선택

Roboflow는 S3 데이터 소스를 위해 세 가지 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. 를 선호하세요 [역할 위임](https://docs.roboflow.com/datasets/ko/create-and-upload/adding-data/datasource-policy-examples.md#assume-role-trust-policy) 장기 액세스 키보다
5. 자격 증명은 Roboflow Workspace [자격 증명](https://app.roboflow.com/settings/thirdpartykeys) 또는 자체 비밀 관리자에만 저장하세요.
6. 액세스 키를 사용하는 경우 정기적으로 교체하고, 사용하지 않는 키는 삭제하세요.

### 역할 위임 사용

**Amazon 권장**. 장기 액세스 키는 필요하지 않습니다. 대신, Roboflow가 버킷을 읽을 수 있도록 AWS 계정에 IAM 역할을 생성하세요.

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 역할 위임" 자격 증명 유형을 선택하세요.
4. Create Credential 모달에 표시된 Roboflow AWS 주체 ARN과 External ID를 복사하세요.
5. 다음의 신뢰 정책을 추가하세요 [데이터 소스 정책 예시](https://docs.roboflow.com/datasets/ko/create-and-upload/adding-data/datasource-policy-examples.md#assume-role-trust-policy) 의 자리표시자를 모달의 값으로 바꿔 역할에 추가하세요.
6. 다음의 버킷 범위 읽기 정책을 연결하세요 [데이터 소스 정책 예시](https://docs.roboflow.com/datasets/ko/create-and-upload/adding-data/datasource-policy-examples.md#custom-iam-policy), 또는 이에 상응하는 최소 권한 정책을 사용하세요.
7. 역할 ARN을 복사하세요.
8. 역할 ARN을 Roboflow 자격 증명 양식에 붙여넣고 자격 증명을 저장하세요.

External ID는 워크스페이스와 자격 증명 유형에 연결되어 있으므로, 모달을 다시 열어도 동일한 값이 표시됩니다. 이 값을 신뢰 정책과 자격 증명 양식에 사용하세요. Roboflow는 Roboflow가 발급하지 않은 External ID는 거부합니다.

### IAM 액세스 키 사용

이것은 가장 간단한 설정 경로이지만 Amazon은 권장하지 않습니다.

1. 여세요 [IAM 사용자 콘솔](https://console.aws.amazon.com/iam/home#/users).
2. Roboflow 전용 IAM 사용자를 만드세요.
3. AWS 관리형 정책을 연결하세요 `AmazonS3ReadOnlyAccess`, 또는 가능하면 [데이터 소스 정책 예시](https://docs.roboflow.com/datasets/ko/create-and-upload/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` 계정의 모든 버킷에 대한 읽기 액세스를 부여합니다. 최소 권한 액세스가 필요하면 [데이터 소스 정책 예시](https://docs.roboflow.com/datasets/ko/create-and-upload/adding-data/datasource-policy-examples.md#custom-iam-policy).

### 버킷 정책 부여 사용

**엔터프라이즈 고객 전용**. IAM 자격 증명은 필요하지 않습니다. 대신 Roboflow의 AWS 역할에 직접 읽기 액세스를 부여하는 버킷 정책을 추가하세요.

1. Roboflow 담당자로부터 Roboflow AWS 역할 ARN을 받으세요.
2. AWS에서 대상 S3 버킷 정책을 여세요.
3. 다음 예시를 병합하세요 [데이터 소스 정책 예시](https://docs.roboflow.com/datasets/ko/create-and-upload/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).

## 다음 단계

자격 증명이 저장되면 다음으로 진행하세요 [데이터 소스](https://docs.roboflow.com/datasets/ko/create-and-upload/adding-data/datasources.md) 버킷 미러링을 구성하려면
