디바이스 토큰 또는 등록 ID 추가

앱과 모바일 디바이스를 Apple 푸시 알림 서비스(APN) 및 Firebase Cloud Messaging(FCM)과 같은 알림 서비스에 처음 등록할 때 디바이스 토큰 또는 등록 ID가 알림 서비스에서 반환됩니다. 디바이스 토큰 또는 등록 ID를 Amazon SNS에 추가하면 이 디바이스 토큰 또는 등록 ID는 PlatformApplicationArn API에서 앱과 디바이스에 대한 엔드포인트를 만드는 데 사용됩니다. Amazon SNS에서 엔드포인트를 만들면 EndpointArn이 반환됩니다. EndpointArn은 Amazon SNS가 어떤 앱과 모바일 디바이스에 알림 메시지를 전송할지를 아는 방법입니다.

다음 방법을 사용하여 디바이스 토큰과 등록 ID를 Amazon SNS에 추가할 수 있습니다.

• AWS Management Console을 사용하여 단일 토큰을 AWS에 수동으로 추가

• CreatePlatformEndpoint API를 사용하여 여러 토큰을 업로드

• 향후 앱을 설치할 디바이스에서 토큰을 등록

디바이스 토큰 또는 등록 ID를 수동으로 추가하려면

1. Amazon SNS 콘솔에 로그인합니다.

2. 탐색 창에서 모바일을 선택한 다음 푸시 알림을 선택합니다.

3. 플랫폼 애플리케이션 섹션에서 애플리케이션을 선택한 다음 편집을 선택합니다. 플랫폼 애플리케이션을 생성하지 않은 경우 지금 생성합니다. 작업 방법에 대한 지침은 플랫폼 애플리케이션 생성을(를) 참조하세요.

4. 엔드포인트 추가를 선택합니다.

5. [Endpoint Token] 상자에서 알림 서비스에 따라 토큰 ID 또는 등록 ID를 입력합니다. 예를 들어, ADM 및 FCM의 경우 등록 ID를 입력합니다.

6. (선택 사항) 사용자 데이터 상자에 엔드포인트와 연결할 임의의 정보를 입력합니다. Amazon SNS는 이 데이터를 사용하지 않습니다. 데이터는 UTF-8 형식이어야 하며 2KB 미만이어야 합니다.

7. 마지막으로 Add Endpoints(엔드포인트 추가)를 선택합니다.

   이제 엔드포인트가 만들어졌으므로 모바일 디바이스에 메시지를 직접 전송하거나 주제를 구독하는 모바일 디바이스에 메시지를 전송할 수 있습니다.

CreatePlatformEndpoint API를 사용하여 여러 토큰을 업로드하려면

다음 단계에서는 AWS에서 제공하는 샘플 Java 앱(bulkupload 패키지)을 사용하여 여러 토큰(디바이스 토큰 또는 등록 ID)을 Amazon SNS에 업로드하는 방법을 보여 줍니다. 이 샘플 앱을 사용하여 기존 토큰 업로드를 시작할 수 있습니다.

참고

다음 단계에서는 Eclipse Java IDE를 사용합니다. 이 단계는 AWS SDK for Java를 설치했고 AWS 계정에 대한 AWS 보안 자격 증명을 가지고 있다고 전제합니다. 자세한 내용은 AWS SDK for Java 섹션을 참조하세요. 자격 증명에 대한 자세한 정보는 AWS 일반 참조의 보안 자격 증명을 가져오려면 어떻게 해야 합니까?를 참조하세요.

1. snsmobilepush.zip 파일을 다운로드하여 압축을 풉니다.

2. Eclipse에서 새 Java 프로젝트를 생성합니다.

3. SNSSamples 폴더를 새로 만든 Java 프로젝트의 최상위 디렉터리로 가져옵니다. Eclipse에서 Java 프로젝트 이름을 마우스 오른쪽 버튼으로 선택한 후 가져오기를 선택하고 일반을 확장한 후 파일 시스템, 다음을 차례로 선택한 다음 SNSSamples 폴더로 이동하여 확인, 마침을 차례로 선택합니다.

4. OpenCSV 라이브러리의 사본을 다운로드하여 bulkupload 패키지의 빌드 경로에 추가합니다.

5. bulkupload 패키지에 있는 BulkUpload.properties 파일을 엽니다.

6. 다음을 BulkUpload.properties로 추가하십시오:

   • 엔드포인트를 추가하려는 ApplicationArn.

   • 토큰이 포함된 CSV 파일 위치의 절대 경로.

   • Amazon SNS에서 올바르게 구문 분석한 토큰과 실패한 토큰을 기록하기 위해 작성할 CSV 파일의 이름(예: goodTokens.csv 및 badTokens.csv).

   • (선택 사항) 토큰이 포함된 CSV 파일에서 구분 기호와 따옴표를 지정할 문자.

   • (선택 사항) 엔드포인트를 동시에 만들기 위해 사용할 스레드 수. 기본 값은 1 스레드입니다.

   완성된 BulkUpload.properties는 다음과 같습니다.

   applicationarn:arn:aws:sns:us-west-2:111122223333:app/FCM/fcmpushapp
   csvfilename:C:\\mytokendirectory\\mytokens.csv
   goodfilename:C:\\mylogfiles\\goodtokens.csv
   badfilename:C:\\mylogfiles\\badtokens.csv
   delimiterchar:' 
   quotechar:"
   numofthreads:5

7. BatchCreatePlatformEndpointSample.java 애플리케이션을 실행하여 토큰을 Amazon SNS에 업로드합니다.

   이 예에서 엔드포인트를 만들기 위해 Amazon SNS에 성공적으로 업로드된 토큰은 goodTokens.csv에 로그되고, 잘못된 형식의 토큰은 badTokens.csv에 로그됩니다. 또한 Eclipse 콘솔에 기록된 STD OUT 로그에는 다음과 같은 내용이 포함됩니다.

   <1>[SUCCESS] The endpoint was created with Arn arn:aws:sns:us-west-2:111122223333:app/FCM/fcmpushapp/165j2214-051z-3176-b586-138o3d420071
   <2>[ERROR: MALFORMED CSV FILE] Null token found in /mytokendirectory/mytokens.csv            

향후 앱을 설치할 디바이스에서 토큰을 등록하려면

다음 두 가지 옵션 중 하나를 사용할 수 있습니다.

• Amazon Cognito 서비스 사용: 모바일 앱에서 Amazon SNS 플랫폼 애플리케이션과 관련된 엔드포인트를 만들려면 자격 증명이 필요합니다. 일정 기간 이후 만료되는 임시 자격 증명을 사용하는 것이 좋습니다. 대부분의 시나리오에서 Amazon Cognito를 사용하여 임시 보안 자격 증명을 만들 것을 권장합니다. 자세한 정보는 Amazon Cognito 개발자 안내서를 참조하세요. 앱이 Amazon SNS에 등록될 때 알림을 수신하려는 경우 새 엔드포인트 ARN을 제공하는 Amazon SNS 이벤트를 수신하도록 등록할 수 있습니다. ListEndpointByPlatformApplication API를 사용하여 Amazon SNS에 등록된 전체 엔드포인트 목록을 얻을 수도 있습니다.

• 프록시 서버 사용: 모바일 앱이 각 설치에서 호출하고 등록하기 위한 애플리케이션 인프라가 이미 설정된 경우 이 설정을 계속 사용할 수 있습니다. 서버는 프록시로 작용하여 저장하려는 모든 사용자 데이터와 함께 디바이스 토큰을 Amazon SNS 모바일 푸시 알림에 전달합니다. 이렇게 하기 위해 프록시 서버를 AWS 자격 증명을 사용하여 Amazon SNS에 연결하고 CreatePlatformEndpoint API 호출을 사용하여 토큰 정보를 업로드합니다. 새로 만든 엔드포인트 ARN(Amazon 리소스 이름)이 반환되고, 서버는 Amazon SNS에 대한 후속 게시 호출을 위해 이 정보를 저장할 수 있습니다.