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

# Amazon Chime SDK ID 네임스페이스로 마이그레이션
<a name="identity-namespace-migration"></a>

[Amazon Chime SDK Identity](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Identity.html) 네임스페이스는 AppInstances, AppInstanceUsers 등의 Amazon Chime SDK 자격 증명 리소스를 생성하고 관리하는 데 사용되는 API를 위한 전용 공간입니다. 네임스페이스를 사용하여 사용 가능한 모든 AWS 리전에서 Amazon Chime SDK 자격 증명 API 엔드포인트를 처리합니다. Amazon Chime SDK를 막 사용하기 시작한 경우 이 네임스페이스를 사용하세요. 리전에 대한 자세한 내용은 이 설명서의 [Amazon Chime SDK에 사용 가능한 AWS 리전](sdk-available-regions.md) 섹션을 참조하세요.

[Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 네임스페이스를 사용하는 기존 애플리케이션은 전용 네임스페이스로의 마이그레이션을 계획해야 합니다.

**Topics**
+ [마이그레이션하는 이유](#identity-migration-reasons)
+ [마이그레이션하기 전](#id-before-migrating)
+ [네임스페이스 간 차이점](#id-namespace-differences)

## 마이그레이션하는 이유
<a name="identity-migration-reasons"></a>

다음과 같은 이유로 [Amazon Chime SDK Identity](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Identity.html) 네임스페이스로 마이그레이션하는 것이 좋습니다.

**API 엔드포인트 선택**  
Amazon Chime SDK Identity 네임스페이스는 API 엔드포인트를 [사용할 수 있는 모든 리전](https://docs.aws.amazon.com/chime-sdk/latest/dg/sdk-available-regions.html)에서 API 엔드포인트를 사용할 수 있는 유일한 API 네임스페이스입니다. `us-east-1` 이외의 API 엔드포인트를 사용하려면 Amazon Chime SDK Identity 네임스페이스를 사용해야 합니다. 현재 엔드포인트에 대한 자세한 내용은 이 설명서의 [API 매핑](migrate-from-chm-namespace.md#name-end-map) 섹션을 참조하세요.

**업데이트되고 새로운 메시징 API**  
Amazon Chime SDK Identity 네임스페이스에서만 자격 증명 API를 추가하거나 업데이트합니다.

## 마이그레이션하기 전
<a name="id-before-migrating"></a>

마이그레이션하기 전에 네임스페이스 간 차이점에 유의해야 합니다. 다음 표에는 차이점과 그에 대한 설명이 나와 있습니다.


|  | Amazon Chime SDK Identity 네임스페이스 | Amazon Chime 네임스페이스 | 
| --- | --- | --- | 
| AWS SDK 네임스페이스 | ChimeSDKIdentity | Chime | 
| 리전 | 다양함 | us-east-1 전용 | 
| 서비스 보안 주체 | https://identity.chime.amazonaws.com | https://chime.amazonaws.com | 
| API | 자격 증명용 API만 | 자격 증명 및 Amazon Chime의 기타 부분을 위한 API | 
| 사용자 만료 | Available | 사용할 수 없음 | 
| 봇 | Available | 사용할 수 없음 | 

## 네임스페이스 간 차이점
<a name="id-namespace-differences"></a>

다음 섹션에서는 `Chime` 네임스페이스와 `ChimeSDKIdentity` 네임스페이스의 차이점을 설명합니다.

**AWS SDK 네임스페이스**  
Amazon Chime SDK 네임스페이스는 `Chime` 공식 이름을 사용합니다. Amazon Chime SDK Identity 네임스페이스는 `ChimeSDKIdentity` 공식 이름을 사용합니다. 이름의 정확한 형식은 플랫폼마다 다릅니다.

예를 들어 Node.js의 AWS SDK를 사용하여 자격 증명을 생성하는 경우 코드 줄을 사용하여 네임스페이스를 처리합니다.

```
const chimeIdentity = AWS.Chime();
```

`ChimeSDKIdentity` 네임스페이스로 마이그레이션하려면 이 코드 줄을 새 네임스페이스와 엔드포인트 리전으로 업데이트하세요.

```
const chimeIdentity = AWS.ChimeSDKIdentity({ region: "{{eu-central-1}}" });
```

**리전**  
[Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 네임스페이스는 `us-east-1` 리전의 API 엔드포인트만 다룹니다. [Amazon Chime SDK Identity](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Identity.html) 네임스페이스는 사용 가능한 모든 리전의 Amazon Chime SDK Identity API 엔드포인트를 처리할 수 있습니다. 엔드포인트 리전의 현재 목록은 이 안내서의 [Amazon Chime SDK에 사용 가능한 AWS 리전](sdk-available-regions.md) 섹션을 참조하세요.

**엔드포인트**  
[Amazon Chime SDK Identity](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Identity.html) 네임스페이스는 [Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 네임스페이스와는 다른 API 엔드포인트를 사용합니다.

ID 리소스를 생성하는 데 사용된 엔드포인트만 자격 증명 리소스를 업데이트하는 데 사용할 수 있습니다. 즉, `eu-central-1`의 엔드포인트를 통해 생성된 AppInstance는 `eu-central-1`을 통해서만 수정할 수 있습니다. 또한 Chime 네임스페이스를 통해 생성된 AppInstance를 `us-east-1`의 ChimeSDKIdentity 네임스페이스로 주소 지정하거나 AppInstance 및 AppInstanceUser 멤버가 생성된 리전이 아닌 다른 리전에서 채널을 생성할 수 없음을 의미합니다. 현재 엔드포인트에 대한 자세한 내용은 이 설명서의 [API 매핑](migrate-from-chm-namespace.md#name-end-map) 섹션을 참조하세요.

**서비스 보안 주체**  
[Amazon Chime SDK Identity](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) 네임스페이스는 새로운 서비스 주체인 `Identity.chime.amazonaws.com`을 사용합니다. 서비스에 대한 액세스 권한을 부여하는 SQS, SNS 또는 기타 IAM 액세스 정책이 있는 경우 새 서비스 보안 주체에 대한 액세스 권한을 부여하도록 해당 정책을 업데이트해야 합니다.

**API**  
[Amazon Chime SDK Identity](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Identity.html) 네임스페이스에는 메시징 리소스를 생성 및 관리하고 메시지를 전송 및 수신하기 위한 API만 포함되어 있습니다. [Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 네임스페이스에는 Amazon Chime 서비스의 다른 부분과 메시징을 위한 API가 포함되어 있습니다.

**사용자 만료**  
AppInstanceUsers 생성 시 만료 설정을 통해 임시 사용자를 생성할 수 있습니다. 예를 들어 대규모 브로드캐스트 기간 동안만 존재하는 채팅 사용자를 생성할 수 있습니다. Identity 네임스페이스만 AppInstanceUsers에 대한 만료 설정을 지원합니다.

**봇**  
[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_identity-chime_AppInstanceBot.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_identity-chime_AppInstanceBot.html) API를 사용하여 Amazon Lex V2에서 제공하는 채팅 봇을 애플리케이션에 추가할 수 있습니다. Identity 네임스페이스에서는 AppInstanceBots 봇만 사용할 수 있습니다. 봇에 대한 자세한 내용은 이 설명서의 [Amazon Chime SDK 메시징을 위한 지능형 채널 에이전트로 AppInstanceBots 사용](appinstance-bots.md) 섹션을 참조하세요.

**추가 API**  
Identity 네임스페이스에는 Chime 네임스페이스에는 없는 추가 API 목록이 점점 늘어나고 있습니다. Amazon Chime SDK로 시작하는 경우 ID 네임스페이스를 사용하여 모든 최신 기능에 액세스할 수 있습니다. 현재 API에 대한 자세한 내용은 Amazon Chime SDK API 참조**의 [Amazon Chime SDK Identity](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Identity.html)를 참조하세요.