Amazon Pinpoint의 작동 방식 IAM - Amazon Pinpoint
Amazon Pinpoint ID 기반 정책Amazon Pinpoint 리소스 기반 권한 정책Amazon Pinpoint 태그 기반 권한 부여Amazon Pinpoint IAM 역할

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

Amazon Pinpoint의 작동 방식 IAM

Amazon Pinpoint 를 사용하려면 AWS 계정의 사용자에게 분석 데이터를 보고, 프로젝트를 생성하고, 사용자 세그먼트를 정의하고, 캠페인을 배포하는 등의 권한이 필요합니다. 모바일 또는 웹 앱을 Amazon Pinpoint와 통합하는 경우 앱 사용자는 Amazon Pinpoint에 대한 액세스 권한도 가져야 합니다. 이러한 액세스 권한이 있어야 앱이 엔드포인트를 등록하고 Amazon Pinpoint에 사용 데이터를 보고할 수 있습니다. Amazon Pinpoint 기능에 대한 액세스 권한을 부여하려면 IAM 자격 증명 또는 Amazon Pinpoint 리소스에 대한 Amazon Pinpoint 작업을 허용하는 AWS Identity and Access Management (IAM) 정책을 생성합니다.

IAM 는 관리자가 AWS 리소스에 대한 액세스를 안전하게 제어하는 데 도움이 되는 서비스입니다. IAM 정책에는 특정 사용자 또는 특정 리소스에 대한 특정 작업을 허용하거나 거부하는 문이 포함됩니다. Amazon Pinpoint는 IAM 정책에서 Amazon Pinpoint 사용자 및 리소스에 대한 세분화된 권한을 지정하는 데 사용할 수 있는 일련의 작업을 제공합니다. 즉, 중요 데이터를 노출시키거나 리소스를 손상시킬 수 있는 과도하게 허용적인 정책을 생성하지 않고 Amazon Pinpoint에 대한 적정 수준의 액세스 권한을 부여할 수 있습니다. 예를 들어, Amazon Pinpoint 관리자에게는 제한 없는 액세스 권한을 부여하고 특정 프로젝트에만 액세스해야 하는 직원에게는 읽기 전용 액세스 권한만 부여할 수 있습니다.

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

Amazon Pinpoint ID 기반 정책

IAM 자격 증명 기반 정책을 사용하면 허용되거나 거부된 작업 및 리소스와 작업이 허용되거나 거부되는 조건을 지정할 수 있습니다. Amazon Pinpoint는 특정 작업, 리소스 및 조건 키를 지원합니다. JSON 정책에서 사용할 수 있는 모든 요소에 대해 알아보려면 IAM 사용 설명서의 IAM JSON 정책 요소 참조를 참조하세요.

작업

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

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

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

즉, 정책 작업은 사용자가 Amazon Pinpoint 콘솔에서 수행할 수 있는 작업을 제어합니다. 또한 AWS SDKs, AWS Command Line Interface (AWS CLI) 또는 Amazon Pinpoint를 APIs 직접 사용하여 사용자가 프로그래밍 방식으로 수행할 수 있는 작업도 제어합니다.

Amazon Pinpoint의 정책 작업은 다음 접두사를 사용합니다.

  • mobiletargeting - Amazon Pinpoint 의 기본API인 API Amazon Pinpoint 에서 파생된 작업의 경우.

  • sms-voice - Amazon Pinpoint SMS 및 음성에서 파생된 작업의 경우API, Amazon Pinpoint 에서 SMS 및 음성 채널을 사용하고 관리하기 위한 고급 옵션을 API 제공하는 추가 기능입니다.

예를 들어, Amazon Pinpoint 의 GetSegments 작업에 해당하는 작업인 프로젝트의 모든 세그먼트에 대한 정보를 볼 수 있는 권한을 부여하려면 mobiletargeting:GetSegments 해당 작업을 정책에 API포함합니다. 정책 문에는 Action 또는 NotAction 요소가 포함되어야 합니다. Amazon Pinpoint는 이를 활용하여 수행할 수 있는 태스크를 설명하는 고유한 작업 집합을 정의합니다.

단일 구문에서 여러 작업을 지정하려면 다음과 같이 쉼표로 구분합니다.

"Action": [
      "mobiletargeting:action1",
      "mobiletargeting:action2"

와일드카드(*)를 사용하여 여러 작업을 지정할 수도 있습니다. 예를 들어, Get라는 단어로 시작하는 모든 태스크를 지정하려면 다음 태스크를 포함합니다.

"Action": "mobiletargeting:Get*"

하지만 가장 좋은 방법은 최소 권한의 원칙을 따르는 정책을 만드는 것입니다. 즉, 특정 작업을 수행하는 데 필요한 권한만 포함하는 정책을 생성해야 합니다.

IAM 정책에서 사용할 수 있는 Amazon Pinpoint 작업 목록은 섹션을 참조하세요IAM 정책에 대한 Amazon Pinpoint 작업.

리소스

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

Resource JSON 정책 요소는 작업이 적용되는 객체를 지정합니다. 문장에는 Resource또는 NotResource요소가 반드시 추가되어야 합니다. 가장 좋은 방법은 Amazon 리소스 이름(ARN)을 사용하여 리소스를 지정하는 것입니다. 리소스 수준 권한이라고 하는 특정 리소스 유형을 지원하는 작업에 대해 이 태스크를 수행할 수 있습니다.

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

"Resource": "*"

예를 들어, mobiletargeting:GetSegments 작업은 특정 Amazon Pinpoint 프로젝트와 연결된 모든 세그먼트에 대한 정보를 검색합니다. 다음 형식ARN의 를 사용하여 프로젝트를 식별합니다.

arn:aws:mobiletargeting:${Region}:${Account}:apps/${projectId}

형식에 대한 자세한 내용은 의 Amazon 리소스 이름(ARNs)을 ARNs참조하세요AWS 일반 참조.

IAM 정책에서 다음 유형의 Amazon Pinpoint 리소스에 ARNs 대해 를 지정할 수 있습니다.

  • 캠페인

  • 여정

  • 메시지 템플릿(일부 컨텍스트에서는 템플릿 이라고 지칭)

  • 프로젝트(일부 컨텍스트에서는 앱 또는 애플리케이션 이라고 지칭)

  • 추천 모델(일부 컨텍스트에서는 추천이라고 함)

  • 세그먼트

예를 들어 프로젝트 ID가 인 프로젝트에 대한 정책 문을 생성하려면 다음 를 810c7aab86d42fb2b56c8c966example사용합니다ARN.

"Resource": "arn:aws:mobiletargeting:us-east-1:123456789012:apps/810c7aab86d42fb2b56c8c966example"

특정 계정에 속하는 모든 프로젝트를 지정하려면 와일드카드(*)를 사용합니다.

"Resource": "arn:aws:mobiletargeting:us-east-1:123456789012:apps/*"

리소스를 생성하기 위한 특정 작업과 같은 일부 Amazon Pinpoint 작업은 특정 리소스에서 수행할 수 없습니다. 이러한 경우 와일드카드(*)를 사용해야 합니다.

"Resource": "*"

IAM 정책에서 다음 유형의 Amazon Pinpoint SMS 및 Voice 리소스에 ARNs 대해 를 지정할 수도 있습니다.

  • 구성 세트

  • 옵트아웃 목록

  • 전화번호

  • 풀

  • 발신자 ID

예를 들어 전화번호 ID가 있는 전화번호에 대한 정책 문을 생성하려면 다음을 phone-12345678901234567890123456789012 사용합니다ARN.

"Resource": "arn:aws:sms-voice:us-east-1:123456789012:phone-number/phone-12345678901234567890123456789012"

특정 계정에 속하는 모든 전화번호를 지정하려면 전화번호 ID 대신 와일드카드(*)를 사용합니다.

"Resource": "arn:aws:sms-voice:us-east-1:123456789012:phone-number/*"

일부 Amazon Pinpoint SMS 및 Voice 작업은 지출 한도와 같은 계정 수준 설정을 관리하기 위한 리소스와 같은 특정 리소스에서는 수행되지 않습니다. 이러한 경우 와일드카드(*)를 사용해야 합니다.

"Resource": "*"

일부 Amazon Pinpoint API 작업에는 여러 리소스가 포함됩니다. 예를 들어 TagResource 작업을 통해 여러 프로젝트에 태그를 추가할 수 있습니다. 단일 문에서 여러 리소스를 지정하려면 쉼표ARNs로 를 구분합니다.

"Resource": [
      "resource1",
      "resource2"

Amazon Pinpoint 리소스 유형 및 해당 의 목록을 보려면 IAM 사용 설명서의 Amazon Pinpoint에서 정의한 리소스를 ARNs참조하세요. 각 리소스 유형의 로 지정할 수 있는 작업을 알아보려면 IAM 사용 설명서ARN의 Amazon Pinpoint에서 정의한 작업을 참조하세요.

조건 키

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

Condition 요소(또는 Condition 블록)를 사용하면 정책이 발효되는 조건을 지정할 수 있습니다. Condition 요소는 옵션입니다. 같거나 작음과 같은 조건 연산자를 사용하여 정책의 조건을 요청의 값과 일치시키는 조건식을 생성할 수 있습니다.

한 문에서 여러 Condition 요소를 지정하거나 단일 Condition 요소에서 여러 키를 지정하는 경우, AWS 는 논리적 AND 태스크를 사용하여 평가합니다. 단일 조건 키에 여러 값을 지정하는 경우 는 논리적 OR 작업을 사용하여 조건을 AWS 평가합니다. 명문의 권한을 부여하기 전에 모든 조건을 충족해야 합니다.

조건을 지정할 때 자리 표시자 변수를 사용할 수도 있습니다. 예를 들어 IAM 리소스에 사용자 IAM 이름으로 태그가 지정된 경우에만 사용자에게 리소스에 액세스할 수 있는 권한을 부여할 수 있습니다. 자세한 내용은 IAM 사용 설명서의 IAM 정책 요소: 변수 및 태그를 참조하세요.

AWS 는 전역 조건 키 및 서비스별 조건 키를 지원합니다. 모든 AWS 전역 조건 키를 보려면 IAM 사용 설명서의 AWS 전역 조건 컨텍스트 키를 참조하세요.

Amazon Pinpoint에서는 자체 조건 키 세트를 정의하고 일부 전역 조건 키도 지원합니다. 모든 AWS 전역 조건 키 목록을 보려면 IAM 사용 설명서의 AWS 전역 조건 컨텍스트 키를 참조하세요. Amazon Pinpoint 조건 키 목록을 보려면 IAM 사용 설명서의 Amazon Pinpoint용 조건 키를 참조하세요. 조건 키를 사용할 수 있는 작업 및 리소스를 알아보려면 IAM 사용 설명서의 Amazon Pinpoint에서 정의한 작업을 참조하세요.

예시

Amazon Pinpoint ID 기반 정책 예제를 보려면 Amazon Pinpoint ID 기반 정책 예제 섹션을 참조하세요.

Amazon Pinpoint 리소스 기반 권한 정책

리소스 기반 권한 정책은 지정된 보안 주체가 Amazon Pinpoint 리소스에서 수행할 수 있는 작업과 조건을 지정하는 JSON 정책 문서입니다. Amazon Pinpoint는 캠페인, 여정, 메시지 템플릿(템플릿), 추천 모델(추천), 프로젝트(앱), 세그먼트에 대한 리소스 기반 권한 정책을 지원합니다.

예시

Amazon Pinpoint 리소스 기반 정책의 예제를 보려면 Amazon Pinpoint ID 기반 정책 예제 섹션을 참조하세요.

Amazon Pinpoint 태그 기반 권한 부여

태그를 특정 유형의 Amazon Pinpoint 리소스와 연결하거나 요청의 태그를 Amazon Pinpoint에 전달할 수 있습니다. 태그에 근거하여 액세스를 제어하려면 aws:ResourceTag/${TagKey}, aws:RequestTag/${TagKey} 또는 aws:TagKeys 조건 키를 사용하여 정책의 조건 요소에 태그 정보를 제공합니다.

예제 IAM 정책을 포함하여 Amazon Pinpoint 리소스에 태그를 지정하는 방법에 대한 자세한 내용은 섹션을 참조하세요Amazon Pinpoint 리소스 태그 관리.

Amazon Pinpoint IAM 역할

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

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

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

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

서비스 연결 역할

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

Amazon Pinpoint는 서비스 연결 역할을 사용하지 않습니다.

서비스 역할

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

Amazon Pinpoint는 서비스 역할 사용을 지원합니다.