기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Amazon Chime SDK Identity 네임스페이스로 마이그레이션하기
Amazon Chime SDK ID 네임스페이스는 및 를 비롯한 Amazon Chime SDK 자격 증명 리소스를 생성하고 관리하는 데 사용되는 API를 위한 전용 공간입니다. AppInstances AppInstanceUsers 네임스페이스를 사용하면 사용 가능한 AWS 모든 지역의 Amazon Chime SDK ID API 엔드포인트에 주소를 지정할 수 있습니다. Amazon Chime SDK를 막 사용하기 시작한 경우 이 네임스페이스를 사용하세요. 리전에 대한 자세한 내용은 이 설명서의 사용 가능한 리전 섹션을 참조하세요.
Amazon Chime 네임스페이스를 사용하는 기존 애플리케이션은 전용 네임스페이스로의 마이그레이션을 계획해야 합니다.
마이그레이션하는 이유
다음과 같은 이유로 Amazon Chime SDK Identity 네임스페이스로 마이그레이션하는 것이 좋습니다.
- API 엔드포인트 선택
Amazon Chime SDK Identity 네임스페이스는 API 엔드포인트를 사용할 수 있는 모든 리전에서 API 엔드포인트를 사용할 수 있는 유일한 API 네임스페이스입니다.
us-east-1이외의 API 엔드포인트를 사용하려면 Amazon Chime SDK Identity 네임스페이스를 사용해야 합니다. 현재 엔드포인트에 대한 자세한 내용은 이 설명서의 API 매핑 섹션을 참조하세요.- 업데이트되고 새로운 메시징 API
Amazon Chime SDK Identity 네임스페이스에서만 자격 증명 API를 추가하거나 업데이트합니다.
마이그레이션하기 전
마이그레이션하기 전에 네임스페이스 간 차이점에 유의해야 합니다. 다음 표에는 차이점과 그에 대한 설명이 나와 있습니다.
| 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 |
| 사용자 만료 | 사용 가능 | 사용할 수 없음 |
| 봇 | 사용 가능 | 사용할 수 없음 |
네임스페이스 간 차이점
다음 섹션에서는 Chime 네임스페이스와 ChimeSDKIdentity 네임스페이스의 차이점을 설명합니다.
AWS SDK 네임스페이스
Amazon Chime SDK 네임스페이스는 Chime 공식 이름을 사용합니다. Amazon Chime SDK Identity 네임스페이스는 ChimeSDKIdentity 공식 이름을 사용합니다. 이름의 정확한 형식은 플랫폼마다 다릅니다.
예를 들어 Node.js AWS SDK를 사용하여 ID를 생성하는 경우 한 줄의 코드를 사용하여 네임스페이스의 주소를 지정합니다.
const chimeIdentity = AWS.Chime();
ChimeSDKIdentity 네임스페이스로 마이그레이션하려면 이 코드 줄을 새 네임스페이스와 엔드포인트 리전으로 업데이트하세요.
const chimeIdentity = AWS.ChimeSDKIdentity({ region: "eu-central-1" });
리전
Amazon Chime 네임스페이스는 us-east-1 리전의 API 엔드포인트만 다룹니다. Amazon Chime SDK Identity 네임스페이스는 사용 가능한 모든 리전의 Amazon Chime SDK Identity API 엔드포인트를 처리할 수 있습니다. 엔드포인트 리전의 현재 목록은 이 안내서의 사용 가능한 리전 섹션을 참조하세요.
엔드포인트
Amazon Chime SDK Identity 네임스페이스는 Amazon Chime 네임스페이스와는 다른 API 엔드포인트를 사용합니다.
ID 리소스를 생성하는 데 사용된 엔드포인트만 자격 증명 리소스를 업데이트하는 데 사용할 수 있습니다. 즉, 에서 엔드포인트를 통해 AppInstance 생성한 항목은 를 통해서만 수정할 eu-central-1 수 있습니다. eu-central-1 즉us-east-1, ChimesdIdentity 네임스페이스가 들어 있는 Chime 네임스페이스를 통해 AppInstance 생성된 주소를 지정하거나 및 멤버가 생성된 지역 이외의 지역에 채널을 생성할 수 없습니다. AppInstance AppInstanceUser 현재 엔드포인트에 대한 자세한 내용은 이 설명서의 API 매핑 섹션을 참조하세요.
서비스 보안 주체
Amazon Chime SDK Identity 네임스페이스는 새로운 서비스 주체인 Identity.chime.amazonaws.com을 사용합니다. 서비스에 대한 액세스 권한을 부여하는 SQS, SNS 또는 기타 IAM 액세스 정책이 있는 경우 새 서비스 보안 주체에 대한 액세스 권한을 부여하도록 해당 정책을 업데이트해야 합니다.
API
Amazon Chime SDK Identity 네임스페이스에는 메시징 리소스를 생성 및 관리하고 메시지를 전송 및 수신하기 위한 API만 포함되어 있습니다. Amazon Chime 네임스페이스에는 Amazon Chime 서비스의 다른 부분과 메시징을 위한 API가 포함되어 있습니다.
사용자 만료
생성 시 만료 설정을 통해 임시 사용자를 만들 수 있습니다. AppInstanceUsers 예를 들어 대규모 브로드캐스트 기간 동안만 존재하는 채팅 사용자를 생성할 수 있습니다. ID 네임스페이스만 에 대한 만료 설정을 지원합니다. AppInstanceUsers
봇
AppInstanceBotAPI를 사용하여 Amazon Lex V2에서 제공하는 채팅 봇을 애플리케이션에 추가할 수 있습니다. ID AppInstanceBots 네임스페이스에서만 사용할 수 있습니다. 봇에 대한 자세한 내용은 이 설명서의 지능형 채널 AppInstanceBots 에이전트로 사용 섹션을 참조하세요.
추가 API
Identity 네임스페이스에는 Chime 네임스페이스에는 없는 추가 API 목록이 점점 늘어나고 있습니다. Amazon Chime SDK로 시작하는 경우 ID 네임스페이스를 사용하여 모든 최신 기능에 액세스할 수 있습니다. 현재 API에 대한 자세한 내용은 Amazon Chime SDK API 참조의 Amazon Chime SDK Identity를 참조하세요.
