기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon Rekognition에서 IAM을 사용하는 방법
IAM을 사용하여 Amazon Rekognition에 대한 액세스를 관리하기 전에 Amazon Rekognition에서 사용할 수 있는 IAM 기능을 이해해야 합니다. Amazon Rekognition 및 기타 AWS 서비스에서 IAM을 사용하는 방법을 전체적으로 알아보려면 *IAM 사용 설명서*의 [AWS IAM으로 작업하는 서비스를](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) 참조하세요.
**Topics**
+ [Amazon Rekognition 자격 증명 기반 정책](#security_iam_service-with-iam-id-based-policies)
+ [Amazon Rekognition 리소스 기반 정책](#security_iam_service-with-iam-resource-based-policies)
+ [Amazon Rekognition IAM 역할](#security_iam_service-with-iam-roles)
## Amazon Rekognition 자격 증명 기반 정책
IAM ID 기반 정책을 사용하면 허용되거나 거부되는 작업과 리소스뿐 아니라 작업이 허용되거나 거부되는 조건을 지정할 수 있습니다. Amazon Rekognition은 특정 작업, 리소스 및 조건 키를 지원합니다. JSON 정책에서 사용하는 모든 요소에 대해 알고 싶다면 *IAM 사용 설명서*의 [IAM JSON 정책 요소 참조](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html)를 참조하세요.
### 작업
관리자는 AWS JSON 정책을 사용하여 누가 무엇에 액세스할 수 있는지 지정할 수 있습니다. 즉, 어떤 **보안 주체**가 어떤 **리소스**와 어떤 **조건**에서 **작업**을 수행할 수 있는지를 지정할 수 있습니다.
JSON 정책의 `Action`요소는 정책에서 액세스를 허용하거나 거부하는 데 사용할 수 있는 작업을 설명합니다. 연결된 작업을 수행할 수 있는 권한을 부여하기 위한 정책에 작업을 포함하세요.
Amazon Rekognition의 정책 작업은 작업 앞에 `rekognition:` 접두사를 사용합니다. 예를 들어 Amazon Rekognition `DetectLabels` API 작업을 사용하여 이미지의 객체, 장면 또는 개념을 감지할 수 있는 권한을 다른 사람에게 부여하려면 `rekognition:DetectLabels` 작업을 정책에 포함시킵니다. 정책 문에는 `Action` 또는 `NotAction` 요소가 포함되어야 합니다. Amazon Rekognition은 이 서비스로 수행할 수 있는 태스크를 설명하는 고유한 작업 세트를 정의합니다.
명령문 하나에 여러 태스크를 지정하려면 다음과 같이 쉼표로 구분합니다.
```
"Action": [
"rekognition:action1",
"rekognition:action2"
```
와일드카드(\*)를 사용하여 여러 작업을 지정할 수 있습니다. 예를 들어, `Describe`라는 단어로 시작하는 모든 작업을 지정하려면 다음 작업을 포함합니다.
```
"Action": "rekognition:Describe*"
```
Amazon Rekognition 작업의 목록을 보려면 *IAM 사용 설명서*의 [Amazon Rekognition에서 정의한 작업](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonrekognition.html#amazonrekognition-actions-as-permissions)을 참조하세요.
### 리소스
관리자는 AWS JSON 정책을 사용하여 누가 무엇에 액세스할 수 있는지 지정할 수 있습니다. 즉, 어떤 **보안 주체**가 어떤 **리소스**와 어떤 **조건**에서 **작업**을 수행할 수 있는지를 지정할 수 있습니다.
`Resource` JSON 정책 요소는 작업이 적용되는 하나 이상의 객체를 지정합니다. 모범 사례에 따라 [Amazon 리소스 이름(ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html)을 사용하여 리소스를 지정합니다. 리소스 수준 권한을 지원하지 않는 작업의 경우, 와일드카드(\*)를 사용하여 해당 문이 모든 리소스에 적용됨을 나타냅니다.
```
"Resource": "*"
```
ARN 형식에 대한 자세한 내용은 [Amazon 리소스 이름(ARNs) 및 AWS 서비스 네임스페이스를 참조하세요](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html).
예를 들어 설명문에서 `MyCollection` 컬렉션을 지정하려면 다음 ARN을 사용합니다.
```
"Resource": "arn:aws:rekognition:us-east-1:123456789012:collection/MyCollection"
```
특정 계정에 속하는 모든 인스턴스를 지정하려면 와일드카드(\*)를 사용합니다.
```
"Resource": "arn:aws:rekognition:us-east-1:123456789012:collection/*"
```
리소스 생성과 같은 일부 Amazon Rekognition 작업은 특정 리소스에서 수행할 수 없습니다. 이러한 경우, 와일드카드(\*)를 사용해야 합니다.
```
"Resource": "*"
```
Amazon Rekognition 리소스 유형 및 해당 ARN의 목록을 보려면 *IAM 사용 설명서*의 [Amazon Rekognition에서 정의한 리소스](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonrekognition.html#amazonrekognition-resources-for-iam-policies)를 참조하세요. 각 리소스의 ARN을 지정할 수 있는 작업을 알아보려면 [Amazon Rekognition에서 정의한 작업](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonrekognition.html#amazonrekognition-actions-as-permissions)을 참조하세요.
### 조건 키
Amazon Rekognition은 서비스별 조건 키를 제공하지 않지만, 일부 전역 조건 키 사용을 지원합니다. 모든 AWS 전역 조건 키를 보려면 *IAM 사용 설명서*의 [AWS 전역 조건 컨텍스트 키를 참조하세요](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html).
## Amazon Rekognition 리소스 기반 정책
Amazon Rekognition은 Custom Labels 모델을 복사하는 작업에 대해 리소스 기반 정책을 지원합니다. 자세한 내용은 [Amazon Rekognition 리소스 기반 정책 예제](https://docs.aws.amazon.com/rekognition/latest/dg/security_iam_resource-based-policy-examples.html)를 참조하세요.
Amazon S3과 같은 다른 서비스도 리소스 기반 권한 정책을 지원합니다. 예를 들어, 정책을 S3 버킷에 연결하여 해당 버킷에 대한 액세스 권한을 관리할 수 있습니다.
Amazon S3 버킷에 저장된 이미지에 액세스하려면 S3 버킷에 있는 객체에 대한 액세스 권한이 있어야 합니다. 이 권한이 있으면 Amazon Rekognition이 S3 버킷에서 이미지를 다운로드할 수 있습니다. 다음 정책 예제에서 사용자는 amzn-s3-demo-bucket3라는 S3 버킷에서 `s3:GetObject` 작업을 수행할 수 있습니다.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "s3:GetObject",
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket3/*"
]
}
]
}
```
------
버전 관리를 활성화한 상태로 S3 버킷을 사용하려면 다음 예제와 같이 `s3:GetObjectVersion` 작업을 추가합니다.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:GetObject",
"s3:GetObjectVersion"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket3/*"
]
}
]
}
```
------
## Amazon Rekognition IAM 역할
[IAM 역할은](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) 특정 권한이 있는 AWS 계정 내 엔터티입니다.
### Amazon Rekognition에서 임시 보안 인증 사용
임시 보안 인증을 사용하여 페더레이션을 통해 로그인하거나, IAM 역할을 맡거나, 교차 계정 역할을 맡을 수 있습니다. [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) 또는 [GetFederationToken](https://docs.aws.amazon.com/STS/latest/APIReference/API_GetFederationToken.html)과 같은 AWS STS API 작업을 호출하여 임시 보안 자격 증명을 얻습니다.
Amazon Rekognition은 임시 보안 인증 사용을 지원합니다.
### 서비스 연결 역할
[서비스 연결 역할을](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role) 사용하면 AWS 서비스가 다른 서비스의 리소스에 액세스하여 사용자를 대신하여 작업을 완료할 수 있습니다. 서비스 연결 역할은 IAM 계정에 나타나고 서비스가 소유합니다. IAM 관리자는 서비스 연결 역할의 권한을 볼 수 있지만 편집할 수 없습니다.
Amazon Rekognition은 서비스 연결 역할을 지원하지 않습니다.
### 서비스 역할
이 기능을 사용하면 서비스가 사용자를 대신하여 [서비스 역할](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-role)을 수임할 수 있습니다. 이 역할을 사용하면 서비스가 다른 서비스의 리소스에 액세스해 사용자를 대신해 작업을 완료할 수 있습니다. 서비스 역할은 IAM 계정에 나타나고, 해당 계정이 소유합니다. 즉, IAM 관리자가 이 역할에 대한 권한을 변경할 수 있습니다. 그러나 권한을 변경하면 서비스의 기능이 손상될 수 있습니다.
Amazon Rekognition은 서비스 역할을 지원합니다.
서비스 역할을 사용하면 Amazon Rekognition을 사용하여 다른 서비스를 직접 호출하고 액세스할 수 없는 리소스를 조작하는 보안 문제가 발생할 수 있습니다. 계정 보안을 유지하려면 Amazon Rekognition의 액세스 범위를 사용 중인 리소스로만 제한합니다. 이는 IAM 서비스 역할에 신뢰 정책을 추가하는 것으로 수행할 수 있습니다. 이렇게 하는 방법에 대한 정보는 [교차 서비스 혼동된 대리인 방지](cross-service-confused-deputy-prevention.md) 단원을 참조하십시오.
### Amazon Rekognition에서 IAM 역할 선택
Amazon Rekognition을 구성하여 저장된 비디오를 분석할 때 Amazon Rekognition에서 사용자를 대신하여 Amazon SNS 에 액세스할 수 있도록 역할을 선택해야 합니다. 이전에 서비스 역할 또는 서비스 연결 역할을 생성한 경우 Amazon Rekognition은 선택할 수 있는 역할 목록을 제공합니다. 자세한 내용은 [Amazon Rekognition Video 구성](api-video-roles.md) 단원을 참조하십시오.
### 예: Amazon S3 버킷의 이미지에 액세스하도록 Amazon Rekognition 구성
다음은 Amazon S3 버킷의 이미지를 분석하기 위해 Amazon Rekognition을 구성하는 방법의 예입니다. Amazon Rekognition을 사용하여 Amazon S3 버킷의 이미지를 분석하려면 다음을 수행해야 합니다.
1. IAM 사용자/역할(클라이언트)에 관련 Amazon Rekognition API 작업(예: DetectLabels, DetectFaces 등)을 직접 호출할 수 있는 권한이 있는지 확인합니다.
원하는 API 작업을 간접 호출할 수 있는 적절한 권한을 부여하는 ID 기반 정책을 연결합니다. 예를 들어 역할에 `DetectLabels` 및 `DetectFaces`를 직접 호출할 수 있는 권한을 부여하려면 역할에 다음과 같은 정책을 연결합니다.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"rekognition:DetectLabels",
"rekognition:DetectFaces"
],
"Resource": "*"
}
]
}
```
------
1. Amazon Rekognition 서비스는 Amazon S3 버킷에 액세스할 수 있는 권한이 필요합니다. API 직접 호출 시 Amazon Rekognition에 전달해야 하는 IAM 서비스 역할을 생성합니다. 서비스 역할: Amazon Rekognition 서비스 위탁자를 신뢰하고 버킷에 대한 `s3:GetObject` 권한이 있는지 확인합니다.
신뢰 정책은 다음과 같을 수 있습니다.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "rekognition.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
------
서비스 역할에 연결된 ID 기반 정책은 다음과 같을 수 있습니다.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "s3:GetObject",
"Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*"
}
]
}
```
------