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

# Amazon SNS를 Firebase Cloud Messaging 인증 설정과 통합
<a name="sns-fcm-authentication-methods"></a>

이 주제에서는 API AWS AWS CLI 및와 함께 사용하는 데 필요한 FCM API(HTTP v1) 자격 증명을 Google에서 가져오는 방법을 설명합니다 AWS Management Console.

**중요**  
2024년 3월 26일 - Amazon SNS는 Apple 디바이스 및 웹푸시 대상에 대한 FCM HTTP v1 API를 지원합니다. 애플리케이션 중단을 방지하려면 2024년 6월 1일 또는 그 이전까지 기존 모바일 푸시 애플리케이션을 최신 FCM HTTP v1 API로 마이그레이션하는 것을 권장합니다.  
2024년 1월 18일 - Amazon SNS는 Android 디바이스로 모바일 푸시 알림을 전송하는 FCM HTTP v1 API에 대한 지원을 도입했습니다.  
2023년 6월 20일 - Google은 자체 Firebase Cloud Messaging(FCM) 레거시 HTTP API 지원을 중단했습니다. 이제 Amazon SNS는 FCM HTTP v1 API를 사용하여 모든 디바이스 유형에 전송 기능을 지원합니다. 중단을 방지하려면 2024년 6월 1일 또는 그 이전까지 기존 모바일 푸시 애플리케이션을 최신 FCM HTTP v1 API로 마이그레이션하는 것을 권장합니다.

앱 개발자임을 식별하는 정보를 제공하여 Amazon SNS가 애플리케이션에 푸시 알림을 보낼 수 있는 권한을 부여할 수 있습니다. 인증하려면 [플랫폼 애플리케이션을 만들 때](https://docs.aws.amazon.com/sns/latest/api/API_SetPlatformApplicationAttributes.html) **API 키** 또는 **토큰**을 제공하세요. [Firebase 애플리케이션 콘솔](https://firebase.google.com/?gad=1&gclid=CjwKCAiA0syqBhBxEiwAeNx9N27M7zxHjlS74_gp4mAS4QTMQH5J35sTO29od-yauuq259zzX_I2DRoCrbsQAvD_BwE&gclsrc=aw.ds)에서 다음 정보를 가져올 수 있습니다.

**API 키**  
API 키는 Firebase의 레거시 API를 직접 호출할 때 사용되는 보안 인증 정보입니다. Google은 2024년 6월 20일에 FCM 레거시 API를 삭제할 예정입니다. 현재 API 키를 플랫폼 보안 인증 정보로 사용하고 있다면 **토큰**을 옵션으로 선택하고 Firebase 애플리케이션용 관련 JSON 파일을 업로드하여 플랫폼 보안 인증 정보를 업데이트할 수 있습니다.

**토큰**  
HTTP v1 API를 직접 호출할 경우 수명이 짧은 액세스 토큰이 사용됩니다. 이것은 푸시 알림 전송을 위한 Firebase의 추천 API입니다. 액세스 토큰을 생성하기 위해 Firebase는 개발자에게 프라이빗 키 파일(service.json 파일이라고도 함) 형태의 보안 인증 정보 세트를 제공합니다.

## 사전 조건
<a name="sns-fcm-authentication-prerequisite"></a>

Amazon SNS에서 FCM 설정을 관리하기 시작하려면 먼저 FCM service.json 보안 인증 정보를 받아야 합니다. service.json 보안 인증 정보를 얻으려면 Google Firebase 설명서에서 [레거시 FCM API에서 HTTP v1으로 마이그레이션](https://firebase.google.com/docs/cloud-messaging/migrate-v1) 섹션을 참조하세요.

## CLI를 사용한 FCM 설정 관리
<a name="sns-fcm-authentication-api"></a>

 AWS API를 사용하여 FCM 푸시 알림을 생성할 수 있습니다. AWS 계정의 Amazon SNS 리소스 수와 크기는 제한됩니다. 자세한 내용은 *AWS 일반 참조 가이드*의 [Amazon Simple Notification Service endpoints and quotas](https://docs.aws.amazon.com/general/latest/gr/sns.html)를 참조하세요.

**Amazon SNS 주제와 함께 FCM 푸시 알림을 생성하려면(AWS API)**  
**키** 보안 인증을 사용하는 경우, `PlatformCredential`은 `API key`입니다. **토큰** 보안 인증을 사용하는 경우, `PlatformCredential`은 JSON 형식의 프라이빗 키 파일입니다.
+ [https://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformApplication.html](https://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformApplication.html)

**기존 Amazon SNS 주제에 대한 FCM 자격 증명 유형을 검색하려면(AWS API)**  
다음 보안 인증 유형 `"AuthenticationMethod": "Token"` 또는 ` "AuthenticationMethod": "Key"`를 검색합니다.
+ [GetPlatformApplicationAttributes](https://docs.aws.amazon.com/sns/latest/api/API_GetPlatformApplicationAttributes.html)

**기존 Amazon SNS 주제에 대한 FCM 속성을 설정하려면(AWS API)**  
FCM 속성을 설정합니다.
+ [SetPlatformApplicationAttributes](https://docs.aws.amazon.com/sns/latest/api/API_SetPlatformApplicationAttributes.html)

## 콘솔을 사용한 FCM 설정 관리
<a name="sns-fcm-authentication-cli"></a>

 AWS Command Line Interface (CLI)를 사용하여 FCM 푸시 알림을 생성할 수 있습니다. AWS 계정의 Amazon SNS 리소스 수와 크기는 제한됩니다. 자세한 내용은 [Amazon Simple Notification Service 엔드포인트 및 할당량](https://docs.aws.amazon.com/general/latest/gr/sns.html)을 참조하세요.

**Amazon SNS 주제와 함께 FCM 푸시 알림 생성(AWS CLI)**  
**키** 보안 인증을 사용하는 경우, `PlatformCredential`은 `API key`입니다. **토큰** 보안 인증을 사용하는 경우, `PlatformCredential`은 JSON 형식의 프라이빗 키 파일입니다. AWS CLI를 사용하는 경우 파일은 문자열 형식이어야 하며 특수 문자는 무시해야 합니다. Amazon SNS는 파일 형식을 올바르게 지정하기 위해 다음 명령을 사용할 것을 권장합니다: `SERVICE_JSON=`jq @json <<< cat service.json``:
+ [create-platform-application](https://docs.aws.amazon.com/cli/latest/reference/sns/create-platform-application.html)

**기존 Amazon SNS 주제에 대한 FCM 보안 인증 유형 검색(AWS CLI)**  
다음 보안 인증 유형 `"AuthenticationMethod": "Token"` 또는 ` "AuthenticationMethod": "Key"`를 검색합니다.
+ [get-platform-application-attributes](https://docs.aws.amazon.com/cli/latest/reference/sns/get-platform-application-attributes.html)

**기존 Amazon SNS 주제에 대한 FCM 속성 설정(AWS CLI)**  
FCM 속성을 설정합니다.
+ [set-platform-application-attributes](https://docs.aws.amazon.com/cli/latest/reference/sns/set-platform-application-attributes.html)

## FCM 설정 관리(콘솔)
<a name="sns-fcm-authentication-console"></a>

다음 단계에 따라 Amazon SNS에서 Firebase Cloud Messaging(FCM) 자격 증명을 입력하고 관리합니다.

1. [Amazon SNS 콘솔](https://console.aws.amazon.com/sns/home)에 로그인합니다.

1. 탐색 창에서 **푸시 알림**을 선택합니다.

1. **플랫폼 애플리케이션** 섹션에서 자격 증명을 편집하려는 **FCM 플랫폼 애플리케이션**을 선택한 다음 **편집**을 선택합니다.

1. **Firebase Cloud Messaging 자격 증명** 섹션에서 다음 옵션 중 하나를 선택합니다.
   + **토큰 기반 인증**(권장 방법) - Firebase 콘솔에서 다운로드한 **프라이빗 키 파일**(JSON)을 업로드합니다. 이 파일에는 FCM 알림을 위한 수명이 짧은 액세스 토큰을 생성하는 데 필요한 자격 증명이 포함되어 있습니다. 이 파일을 가져오는 방법:

     1. [Firebase 애플리케이션 콘솔](https://firebase.google.com/?gad=1&gclid=CjwKCAiA0syqBhBxEiwAeNx9N27M7zxHjlS74_gp4mAS4QTMQH5J35sTO29od-yauuq259zzX_I2DRoCrbsQAvD_BwE&gclsrc=aw.ds)로 이동합니다.

     1. **프로젝트 설정**에서 **클라우드 메시징**을 선택합니다.

     1. **프라이빗 키** JSON 파일(토큰 기반 인증 방법에 사용)을 다운로드합니다.
   + **API 키 인증** - 이전 API 키 인증 방법을 사용하려면 제공된 필드에 **Google API 키를** 입력합니다. 이 파일을 가져오는 방법:

     1. [Firebase 애플리케이션 콘솔](https://firebase.google.com/?gad=1&gclid=CjwKCAiA0syqBhBxEiwAeNx9N27M7zxHjlS74_gp4mAS4QTMQH5J35sTO29od-yauuq259zzX_I2DRoCrbsQAvD_BwE&gclsrc=aw.ds)로 이동합니다.

     1. **프로젝트 설정**에서 **클라우드 메시징**을 선택합니다.

     1. 알림 전송에 사용할 **서버 키**(API 키)를 복사합니다.

1. 변경 작업을 마치면 **변경 사항 저장**을 선택합니다.

**관련 주제**
+ [Amazon SNS에서 Google Firebase Cloud Messaging v1 페이로드 사용](sns-fcm-v1-payloads.md)