Amazon Chime SDK ID 네임스페이스로 마이그레이션 - Amazon Chime SDK

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

Amazon Chime SDK ID 네임스페이스로 마이그레이션

Amazon Chime SDK Identity 네임스페이스는 AppInstances, AppInstanceUsers 등의 Amazon Chime SDK 자격 증명 리소스를 생성하고 관리하는 데 사용되는 API를 위한 전용 공간입니다. 네임스페이스를 사용하여 사용 가능한 모든 AWS 리전에서 Amazon Chime SDK 자격 증명 API 엔드포인트를 처리합니다. Amazon Chime SDK를 막 사용하기 시작한 경우 이 네임스페이스를 사용하세요. 리전에 대한 자세한 내용은 이 설명서의 Amazon Chime SDK에 사용 가능한 AWS 리전 섹션을 참조하세요.

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
사용자 만료 Available 사용할 수 없음
Available 사용할 수 없음

네임스페이스 간 차이점

다음 섹션에서는 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 네임스페이스는 us-east-1 리전의 API 엔드포인트만 다룹니다. Amazon Chime SDK Identity 네임스페이스는 사용 가능한 모든 리전의 Amazon Chime SDK Identity API 엔드포인트를 처리할 수 있습니다. 엔드포인트 리전의 현재 목록은 이 안내서의 Amazon Chime SDK에 사용 가능한 AWS 리전 섹션을 참조하세요.

엔드포인트

Amazon Chime SDK Identity 네임스페이스는 Amazon Chime 네임스페이스와는 다른 API 엔드포인트를 사용합니다.

ID 리소스를 생성하는 데 사용된 엔드포인트만 자격 증명 리소스를 업데이트하는 데 사용할 수 있습니다. 즉, eu-central-1의 엔드포인트를 통해 생성된 AppInstance는 eu-central-1을 통해서만 수정할 수 있습니다. 또한 Chime 네임스페이스를 통해 생성된 AppInstance를 us-east-1의 ChimeSDKIdentity 네임스페이스로 주소 지정하거나 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 생성 시 만료 설정을 통해 임시 사용자를 생성할 수 있습니다. 예를 들어 대규모 브로드캐스트 기간 동안만 존재하는 채팅 사용자를 생성할 수 있습니다. Identity 네임스페이스만 AppInstanceUsers에 대한 만료 설정을 지원합니다.

AppInstanceBot API를 사용하여 Amazon Lex V2에서 제공하는 채팅 봇을 애플리케이션에 추가할 수 있습니다. Identity 네임스페이스에서는 AppInstanceBots 봇만 사용할 수 있습니다. 봇에 대한 자세한 내용은 이 설명서의 Amazon Chime SDK 메시징을 위한 지능형 채널 에이전트로 AppInstanceBots 사용 섹션을 참조하세요.

추가 API

Identity 네임스페이스에는 Chime 네임스페이스에는 없는 추가 API 목록이 점점 늘어나고 있습니다. Amazon Chime SDK로 시작하는 경우 ID 네임스페이스를 사용하여 모든 최신 기능에 액세스할 수 있습니다. 현재 API에 대한 자세한 내용은 Amazon Chime SDK API 참조Amazon Chime SDK Identity를 참조하세요.