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

# Amazon Kendra에서 IAM을 사용하는 방법
<a name="security_iam_service-with-iam"></a>

IAM을 사용하여 Amazon Kendra에 대한 액세스를 관리하기 전에 Amazon Kendra에서 사용할 수 있는 IAM 기능을 이해해야 합니다. Amazon Kendra 및 기타 AWS 서비스에서 IAM을 사용하는 방법을 전체적으로 알아보려면 *IAM 사용 설명서*의 [AWS IAM으로 작업하는 서비스를](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) 참조하세요.

**Topics**
+ [Amazon Kendra 자격 증명 기반 정책](#security_iam_service-with-iam-id-based-policies)
+ [Amazon Kendra 리소스 기반 정책](#security_iam_service-with-iam-resource-based-policies)
+ [액세스 제어 목록(ACL)](#security_iam_service-with-iam-acls)
+ [Amazon Kendra 태그 기반 권한 부여](#security_iam_service-with-iam-tags)
+ [Amazon Kendra IAM 역할](#security_iam_service-with-iam-roles)

## Amazon Kendra 자격 증명 기반 정책
<a name="security_iam_service-with-iam-id-based-policies"></a>

IAM ID 기반 정책을 사용하면 허용되거나 거부되는 작업과 리소스뿐 아니라 작업이 허용되거나 거부되는 조건을 지정할 수 있습니다. Amazon Kendra는 특정 작업, 리소스, 조건 키를 지원합니다. JSON 정책에서 사용하는 모든 요소에 대해 알고 싶다면 *IAM 사용 설명서*의 [IAM JSON 정책 요소 참조](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html)를 참조하세요.

### 작업
<a name="security_iam_service-with-iam-id-based-policies-actions"></a>

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

JSON 정책의 `Action`요소는 정책에서 액세스를 허용하거나 거부하는 데 사용할 수 있는 작업을 설명합니다. 연결된 작업을 수행할 수 있는 권한을 부여하기 위한 정책에 작업을 포함하세요.

Amazon Kendra의 정책 작업은 작업 앞에 `kendra:` 접두사를 사용합니다. 예를 들어 누군가에게 [ListIndices](https://docs.aws.amazon.com/kendra/latest/dg/API_ListIndices.html) API 작업을 통해 Amazon Kendra 인덱스를 나열할 수 있는 권한을 부여하려면 해당 정책에 `kendra:ListIndices` 작업을 포함시킵니다. 정책 문에는 `Action` 또는 `NotAction` 요소가 포함되어야 합니다. Amazon Kendra는 이 서비스로 수행할 수 있는 태스크를 설명하는 고유한 작업 세트를 정의합니다.

명령문 하나에 여러 태스크를 지정하려면 다음과 같이 쉼표로 구분합니다.

```
"Action": [
      "kendra:action1",
      "kendra:action2"
```

와일드카드(\$1)를 사용하여 여러 작업을 지정할 수 있습니다. 예를 들어, `Describe`라는 단어로 시작하는 모든 작업을 지정하려면 다음 작업을 포함합니다.

```
"Action": "kendra:Describe*"
```

Amazon Kendra 작업의 목록을 보려면 *IAM 사용 설명서*의 [Amazon Kendra에서 정의한 작업](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_kendra.html#kendra-actions-as-permissions)을 참조하세요.

### 리소스
<a name="security_iam_service-with-iam-id-based-policies-resources"></a>

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

`Resource` JSON 정책 요소는 작업이 적용되는 하나 이상의 객체를 지정합니다. 모범 사례에 따라 [Amazon 리소스 이름(ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html)을 사용하여 리소스를 지정합니다. 리소스 수준 권한을 지원하지 않는 작업의 경우, 와일드카드(\$1)를 사용하여 해당 문이 모든 리소스에 적용됨을 나타냅니다.

```
"Resource": "*"
```





Amazon Kendra 인덱스 리소스의 ARN은 다음과 같습니다.

```
arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}
```

ARN 형식에 대한 자세한 내용은 [Amazon 리소스 이름(ARNs) 및 AWS 서비스 네임스페이스를 참조하세요](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html).

예를 들어 문에 인덱스를 지정하려면 다음 ARN에서 인덱스의 GUID를 사용합니다.

```
"Resource": "arn:aws:kendra:${Region}:${Account}:index/${GUID}"
```

특정 계정에 속하는 모든 인덱스를 지정하려면 와일드카드(\$1)를 사용합니다.

```
"Resource": "arn:aws:${Region}:${Account}:index/*"
```

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

```
"Resource": "*"
```

Amazon Kendra 리소스 유형 및 해당 ARN의 목록을 보려면 *IAM 사용 설명서*의 [Amazon Kendra에서 정의한 리소스](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_kendra.html#kendra-resources-for-iam-policies)를 참조하세요. 각 리소스의 ARN을 지정할 수 있는 작업을 알아보려면 [Amazon Kendra에서 정의한 작업](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_kendra.html#kendra-actions-as-permissions)을 참조하세요.

### 조건 키
<a name="security_iam_service-with-iam-id-based-policies-conditionkeys"></a>

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

`Condition` 요소는 정의된 기준에 따라 문이 실행되는 시기를 지정합니다. 같음(equals) 또는 미만(less than)과 같은 [조건 연산자](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html)를 사용하여 정책의 조건을 요청의 값과 일치시키는 조건식을 생성할 수 있습니다. 모든 AWS 전역 조건 키를 보려면 *IAM 사용 설명서*의 [AWS 전역 조건 컨텍스트 키를](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) 참조하세요.

Amazon Kendra는 서비스별 조건 키를 제공하지 않지만, 일부 전역 조건 키 사용을 지원합니다. 모든 AWS 전역 조건 키를 보려면 *IAM 사용 설명서*의 [AWS 전역 조건 컨텍스트 키를 참조하세요](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html).

### 예제
<a name="security_iam_service-with-iam-id-based-policies-examples"></a>



Amazon Kendra 자격 증명 기반 정책 예제를 보려면 [Amazon Kendra 자격 증명 기반 정책 예제](security_iam_id-based-policy-examples.md) 단원을 참조하세요.

## Amazon Kendra 리소스 기반 정책
<a name="security_iam_service-with-iam-resource-based-policies"></a>

Amazon Kendra는 리소스 기반 정책을 지원하지 않습니다.

## 액세스 제어 목록(ACL)
<a name="security_iam_service-with-iam-acls"></a>

Amazon Kendra는 AWS 서비스 및 리소스에 대한 액세스를 위한 액세스 제어 목록(ACL)을 지원하지 않습니다.

## Amazon Kendra 태그 기반 권한 부여
<a name="security_iam_service-with-iam-tags"></a>

태그를 특정 유형의 Amazon Kendra 리소스와 연결하여 해당 리소스에 대한 액세스를 승인할 수 있습니다. 태그를 기반으로 액세스를 제어하려면 `aws:RequestTag/key-name` 또는 `aws:TagKeys` 조건 키를 사용하여 정책의 조건 요소에 태그 정보를 제공합니다.

다음 표에는 태그 기반 액세스 제어에 필요한 작업, 해당 리소스 유형과 조건 키가 나열되어 있습니다. 각 작업은 해당 리소스 유형과 연결된 태그를 기반으로 권한이 부여됩니다.


| 작업 | 리소스 유형 | 조건 키 | 
| --- | --- | --- | 
|  [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)  |   | aws:RequestTag, aws:TagKeys | 
| [CreateFaq](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateFaq.html) |   | aws:RequestTag, aws:TagKeys | 
|  [CreateIndex](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateIndex.html)  |   | aws:RequestTag, aws:TagKeys | 
|  [API\$1ListTagsForResource](https://docs.aws.amazon.com/kendra/latest/dg/API_ListTagsForResource.html)  | 데이터 소스, FAQ, 인덱스 |   | 
| [TagResource](https://docs.aws.amazon.com/kendra/latest/dg/API_TagResource.html)  | 데이터 소스, FAQ, 인덱스 | aws:RequestTag, aws:TagKeys | 
| [UntagResource](https://docs.aws.amazon.com/kendra/latest/dg/API_UntagResource.html)  | 데이터 소스, FAQ, 인덱스 | aws:TagKeys | 

Amazon Kendra 리소스 태그 지정에 대한 자세한 내용은 [Tags](tagging.md) 섹션을 참조하세요. 리소스 태그를 기반으로 리소스에 대한 액세스를 제한하는 자격 증명 기반 정책의 예는 [태그 기반 정책 예제](security_iam_id-based-policy-examples.md#examples-tagging) 단원을 참조하세요. 태그를 사용하여 리소스에 대한 액세스를 제한하는 방법에 대한 자세한 내용은 *IAM 사용 설명서*의 [태그를 사용한 액세스 제어](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html)를 참조하세요.

## Amazon Kendra IAM 역할
<a name="security_iam_service-with-iam-roles"></a>

[IAM 역할은](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) 특정 권한이 있는 AWS 계정 내 엔터티입니다.

### Amazon Kendra에서 임시 자격 증명 사용
<a name="security_iam_service-with-iam-roles-tempcreds"></a>

임시 보안 인증을 사용하여 페더레이션을 통해 로그인하거나, 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 Kendra는 임시 자격 증명 사용을 지원합니다.

### 서비스 역할
<a name="security_iam_service-with-iam-roles-service"></a>

이 기능을 사용하면 서비스가 사용자를 대신하여 [서비스 역할](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-role)을 수임할 수 있습니다. 이 역할을 사용하면 서비스가 다른 서비스의 리소스에 액세스해 사용자를 대신해 작업을 완료할 수 있습니다. 서비스 역할은 IAM 계정에 나타나고, 해당 계정이 소유합니다. 즉, IAM 관리자가 이 역할에 대한 권한을 변경할 수 있습니다. 그러나 권한을 변경하면 서비스의 기능이 손상될 수 있습니다.

Amazon Kendra는 서비스 역할을 지원합니다.

### Amazon Kendra에서 IAM 역할 선택
<a name="security_iam_service-with-iam-roles-choose"></a>

인덱스를 생성하거나, `BatchPutDocument` 작업을 호출하거나, 데이터 소스나 FAQ를 생성할 때는 Amazon Kendra가 사용자 대신 필요한 리소스에 액세스하는 데 사용하는 Amazon 리소스 이름(ARN) 액세스 역할을 제공해야 합니다. 이전에 역할을 생성한 경우 Amazon Kendra 콘솔이 선택할 수 있는 역할 목록을 제공합니다. 필요한 리소스에 대한 액세스를 허용하는 역할을 선택하는 것이 중요합니다. 자세한 내용은 [IAM 에 대한 Amazon Kendra액세스 역할](iam-roles.md) 단원을 참조하십시오.