[FCM] iOS에서 Firebase 푸시알림 구현하기

모바일 앱 사용자 경험을 향상시키는 핵심 요소 중 하나는 적절한 시점에 전달되는 푸시알림입니다.
iOS 플랫폼에서 Firebase Cloud Messaging(FCM)을 활용하면 비교적 쉽게 푸시알림 기능을 구축할 수 있지만, 플랫폼 특성상 몇 가지 중요한 환경설정을 반드시 선행해야 합니다. 
이 글에서는 iOS 앱에 Firebase 푸시알림 기능을 구현하기 위해 필요한 초기 환경설정을 단계별로 정리해보았습니다.

 

0. 앱 & 앱 식별자 추가하기

가장 먼저 Apple Developer 플랫폼에서 푸시알림을 연결하고자 하는 앱을 추가해줘야 합니다. 이미 앱이 추가되어있는 상황이면 해당 절차를 무시하셔도 됩니다.

여기서 법인 개발자의 경우 SKU 필드가 추가로 생성되는데, 이는 Apple 내부적으로 사용되지 않고, 앱 개발사(법인)에서 자체적으로 관리용으로 사용하는 식별 코드입니다. 때문에 {회사명}_yyyy_mm과 같이 앱 자체 식별이 가능한 문자열로 설정해두면 좋습니다.

 

여기서 다른 필드와 달리 번들 ID는 다른 창에서 따로 추가가 필요한 값입니다. 이는 Apple 내부적으로 관리하기 위해 사용하는 식별 코드이기 때문이죠. 때문에, 번들 ID 드롭다운 창 내부 +버튼 클릭을 통해 번들 ID 추가 창으로 이동하여 아래와 같이 식별자값을 추가합니다.

1. Firebase 인증을 위한 APNs 키 생성

iOS 플랫폼의 경우, Firebase에서는 Apple Developer 플랫폼에서 발급할 수 있는 인증서 파일(p8)을 통해 앱 개발자 인증을 수행합니다. 해당 키는 본래 APN(Apple Push Notification) 기능을 위한 키인데요. 애플 서버에서 푸시알림 요청이 악성 해커가 아닌 해당 앱개발자가 보낸 것인지 확인하기 위해 사용되는 인증수단입니다. 

 

좌측 메뉴의 Keys 탭을 선택할 경우, 키에 대한 생성을 할 수 있는데요. 위와 같이 Key name을 임의로 설정한 후(저는 "{앱이름} APN"으로 설정하였습니다. 하단에 키가 보유하게될 권한 선택지들 중, Apple Push Notifications service 항목을 체크합니다. 이때 키 관련 설정이 선행된다고 경고 메세지가 표시되는데요. 

위와 같이 키가 효력을 같는 범위에 대한 설정을 마치고 Save를 누르면 설정과정이 완료되며, 아래와 같이 키 등록 버튼이 활성화됩니다.

활성화된 버튼 선택을 통해 키 생성을 마무리해줍니다.

 

사실 이와 유사한 역할을 하는 또다른 인증수단이 있는데요. 이는 인증서(.cer)입니다. 기존에는 .cer 방식을 주로 사용해왔지만, 2023년부터 Firebase에서는 p8을 사용하는 것을 권장하고 있습니다.
APNs 키(.p8) : 서버용으로 한 번 발급하면 유지 가능 (최대 2개까지 생성 가능)
인증서(.cer) : 앱별로 유효 기간 존재, 갱신 필요

 

2. Firebase 프로젝트 등록

이후, Firebase 콘솔을 접속하여 로그인을 진행합니다.

https://console.firebase.google.com

로그인 - Google 계정

이후, 아래 프로젝트 시작하기 버튼을 클릭합니다.

1. 프로젝트 이름 설정

해당 프로젝트 이름은 firebase 플랫폼에서 앱을 식별하기 위해 사용되는 값이기에, 고유한 값을 입력해야합니다. 또한, 한번 설정한 이름은 설정에 사용했던 프로젝트가 삭제되더라도 더이상 사용이 불가하니, 주의에 주의를 가합시다...!

여기서 Google Analytics를 희망하시는 분은 사용 설정을 진행하여줍니다.

 

2. 프로젝트에 iOS 앱 추가

프로젝트 설정 완료 이후에는, iOS 앱을 추가합니다.

iOS 앱 추가 자체에 대한 과정은 Google Firebase 자체 공식문서가 굉장히 설명이 잘 되어있기에 해당 링크로 대체합니다.

https://firebase.google.com/docs/ios/setup?hl=ko

Apple 프로젝트에 Firebase 추가  |  Firebase for Apple platforms

2. iOS 앱에 발급받은 인증키 파일(p8) 업로드

iOS 앱 추가가 완료된 이후에는 아래와 같은 프로젝트 설정 창에서 p8 파일 업로드를 통해 앱구성 과정을 마칠 수 있습니다.

 

감사합니다.