Amazon Rekognition에서 IAM을 사용하는 방법 - Amazon Rekognition
Amazon Rekognition 자격 증명 기반 정책Amazon Rekognition 리소스 기반 정책Amazon Rekognition IAM 역할

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Amazon Rekognition에서 IAM을 사용하는 방법

IAM을 사용하여 Amazon Rekognition에 대한 액세스를 관리하기 전에 Amazon Rekognition에서 사용할 수 있는 IAM 기능을 이해해야 합니다. Amazon Rekognition 및 기타 AWS 서비스가 IAM에서 작동하는 방식을 전체적으로 알아보려면 IAM 사용 설명서의 AWS IAM으로 작업하는 서비스를 참조하세요.

Amazon Rekognition 자격 증명 기반 정책

IAM ID 기반 정책을 사용하면 허용되거나 거부되는 작업과 리소스뿐 아니라 작업이 허용되거나 거부되는 조건을 지정할 수 있습니다. Amazon Rekognition은 특정 작업, 리소스 및 조건 키를 지원합니다. JSON 정책에서 사용하는 모든 요소에 대해 알고 싶다면 IAM 사용 설명서의 IAM JSON 정책 요소 참조를 참조하세요.

작업

관리자는 AWS JSON 정책을 사용하여 대상에 액세스할 수 있는 사용자를 지정할 수 있습니다. 즉, 어떤 위탁자가 어떤 리소스와 어떤 조건에서 작업을 수행할 수 있는지를 지정할 수 있습니다.

JSON 정책의 Action 요소는 정책에서 액세스를 허용하거나 거부하는 데 사용할 수 있는 작업을 설명합니다. 정책 작업은 일반적으로 연결된 AWS API 작업과 이름이 동일합니다. 일치하는 API 작업이 없는 권한 전용 작업 같은 몇 가지 예외도 있습니다. 정책에서 여러 작업이 필요한 몇 가지 작업도 있습니다. 이러한 추가 작업을 일컬어 종속 작업이라고 합니다.

연결된 작업을 수행할 수 있는 권한을 부여하기 위한 정책에 작업을 포함하세요.

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에서 정의한 작업을 참조하세요.

리소스

관리자는 AWS JSON 정책을 사용하여 대상에 액세스할 수 있는 사용자를 지정할 수 있습니다. 즉, 어떤 보안 주체가 어떤 리소스와 어떤 조건에서 작업을 수행할 수 있는지를 지정할 수 있습니다.

Resource JSON 정책 요소는 작업이 적용되는 하나 이상의 객체를 지정합니다. 문에는 Resource또는 NotResource요소가 반드시 추가되어야 합니다. 모범 사례에 따라 Amazon 리소스 이름(ARN)을 사용하여 리소스를 지정합니다. 리소스 수준 권한이라고 하는 특정 리소스 유형을 지원하는 작업에 대해 이를 수행할 수 있습니다.

작업 나열과 같이 리소스 수준 권한을 지원하지 않는 작업의 경우, 와일드카드(*)를 사용하여 해당 문이 모든 리소스에 적용됨을 나타냅니다.

"Resource": "*"

ARN 형식에 대한 자세한 내용은 Amazon 리소스 이름(ARNs) 및 AWS 서비스 네임스페이스를 참조하세요.

예를 들어 설명문에서 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에서 정의한 리소스를 참조하세요. 각 리소스의 ARN을 지정할 수 있는 작업을 알아보려면 Amazon Rekognition에서 정의한 작업을 참조하세요.

조건 키

Amazon Rekognition은 서비스별 조건 키를 제공하지 않지만, 일부 전역 조건 키 사용을 지원합니다. 모든 AWS 전역 조건 키를 보려면 IAM 사용 설명서의 AWS 전역 조건 컨텍스트 키를 참조하세요.

Amazon Rekognition 리소스 기반 정책

Amazon Rekognition은 Custom Labels 모델을 복사하는 작업에 대해 리소스 기반 정책을 지원합니다. 자세한 내용은 Amazon Rekognition 리소스 기반 정책 예제를 참조하세요.

Amazon S3과 같은 다른 서비스도 리소스 기반 권한 정책을 지원합니다. 예를 들어, 정책을 S3 버킷에 연결하여 해당 버킷에 대한 액세스 권한을 관리할 수 있습니다.

Amazon S3 버킷에 저장된 이미지에 액세스하려면 S3 버킷에 있는 객체에 대한 액세스 권한이 있어야 합니다. 이 권한이 있으면 Amazon Rekognition이 S3 버킷에서 이미지를 다운로드할 수 있습니다. 다음 예제 정책은 사용자가 amzn-s3-demo-bucket3이라는 S3 버킷에서 s3:GetObject 작업을 수행하도록 허용합니다.


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "s3:GetObject",
            "Resource": [
                "arn:aws:s3:::amzn-s3-demo-bucket3/*"
            ]
        }
    ]
}

버전 관리를 활성화한 상태로 S3 버킷을 사용하려면 다음 예제와 같이 s3:GetObjectVersion 작업을 추가합니다.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetObject",
                "s3:GetObjectVersion"
            ],
            "Resource": [
                "arn:aws:s3:::amzn-s3-demo-bucket3/*"
            ]
        }
    ]

Amazon Rekognition IAM 역할

IAM 역할은 AWS 계정 내에서 특정 권한이 있는 엔터티입니다.

Amazon Rekognition에서 임시 보안 인증 사용

임시 보안 인증을 사용하여 페더레이션을 통해 로그인하거나, IAM 역할을 맡거나, 교차 계정 역할을 맡을 수 있습니다. AssumeRole 또는 GetFederationToken과 같은 AWS STS API 작업을 호출하여 임시 보안 자격 증명을 얻습니다.

Amazon Rekognition은 임시 보안 인증 사용을 지원합니다.

서비스 연결 역할

서비스 연결 역할을 사용하면 AWS 서비스가 다른 서비스의 리소스에 액세스하여 사용자를 대신하여 작업을 완료할 수 있습니다. 서비스 연결 역할은 IAM 계정에 나타나고 서비스가 소유합니다. IAM 관리자는 서비스 연결 역할의 권한을 볼 수 있지만 편집할 수 없습니다.

Amazon Rekognition은 서비스 연결 역할을 지원하지 않습니다.

서비스 역할

이 기능을 사용하면 서비스가 사용자를 대신하여 서비스 역할을 수임할 수 있습니다. 이 역할을 사용하면 서비스가 다른 서비스의 리소스에 액세스해 사용자를 대신해 작업을 완료할 수 있습니다. 서비스 역할은 IAM 계정에 나타나고, 해당 계정이 소유합니다. 즉, IAM 관리자가 이 역할에 대한 권한을 변경할 수 있습니다. 그러나 권한을 변경하면 서비스의 기능이 손상될 수 있습니다.

Amazon Rekognition은 서비스 역할을 지원합니다.

서비스 역할을 사용하면 Amazon Rekognition을 사용하여 다른 서비스를 직접 호출하고 액세스할 수 없는 리소스를 조작하는 보안 문제가 발생할 수 있습니다. 계정 보안을 유지하려면 Amazon Rekognition의 액세스 범위를 사용 중인 리소스로만 제한합니다. 이는 IAM 서비스 역할에 신뢰 정책을 추가하는 것으로 수행할 수 있습니다. 이렇게 하는 방법에 대한 정보는 교차 서비스 혼동된 대리인 방지 단원을 참조하십시오.

Amazon Rekognition에서 IAM 역할 선택

Amazon Rekognition을 구성하여 저장된 비디오를 분석할 때 Amazon Rekognition에서 사용자를 대신하여 Amazon SNS 에 액세스할 수 있도록 역할을 선택해야 합니다. 이전에 서비스 역할 또는 서비스 연결 역할을 생성한 경우 Amazon Rekognition은 선택할 수 있는 역할 목록을 제공합니다. 자세한 내용은 Amazon Rekognition Video 구성 단원을 참조하십시오.

예: Amazon S3 버킷의 이미지에 액세스하도록 Amazon Rekognition 구성 Amazon S3

다음은 Amazon S3 버킷의 이미지를 분석하도록 Amazon Rekognition을 구성하는 방법의 예입니다. Amazon S3 Amazon Rekognition을 사용하여 Amazon S3 버킷의 이미지를 분석하려면 다음을 수행해야 합니다.

  1. IAM 사용자/역할(클라이언트)에 관련 Amazon Rekognition API 작업(예: DetectLabels, DetectFaces 등)을 호출할 수 있는 권한이 있는지 확인합니다.

    원하는 API 작업을 호출할 수 있는 적절한 권한을 부여하는 자격 증명 기반 정책을 연결합니다. 예를 들어 역할에 DetectLabels 및를 호출할 수 있는 권한을 부여하려면 다음과 같은 정책을 역할에 DetectFaces연결합니다.

    {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "rekognition:DetectLabels",
                "rekognition:DetectFaces"
                // other Rekognition permissions as needed
            ],
            "Resource": "*"
        }
    ]
}

  2. Amazon Rekognition 서비스는 Amazon S3 버킷에 액세스할 수 있는 권한이 필요합니다. API 호출 시 Amazon Rekognition에 전달해야 하는 IAM 서비스 역할을 생성합니다. 서비스 역할: Amazon Rekognition 서비스 보안 주체를 신뢰하고 버킷에 대한 s3:GetObject 권한이 있는지 확인합니다.

    신뢰 정책은 다음과 같을 수 있습니다.

    
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "rekognition.amazonaws.com"
            },
            "Action": "sts:AssumeRole"
        }
    ]
}

    서비스 역할에 연결된 자격 증명 기반 정책은 다음과 같을 수 있습니다.

    {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "s3:GetObject",
            "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*"
        }
    ]
}