[iOS] 앱 이전으로 인한 FCM 장애 및 APNs 키 갱신

유니페스 개발팀에 합류 후 새로운 기능을 추가한 다음 빌드의 배포를 목전에 두고 있었다.
여러가지를 점검해보고 있던 차, 서버에서 FCM을 통한 iOS앱에게로의 푸쉬 알림이 실패한다는 이슈가 보고됐다.
현재는 해결했으나, 재발 방지와 앱 이전 후 FCM iOS 푸쉬 알림 장애를 겪는 개발자들에게 공유하는 차원에서
원인, 분석, 해결까지의 기록을 남겨보고자 한다.

0. APNs와 FCM의 개념 및 역할

APNs는 Apple에서 제공하는 푸쉬 알림 전송 서버로, 푸쉬알림을 애플 APNs서버에 요청, 대상 디바이스에게 푸쉬알림을 전송한다.
사실상 Push notification capability를 등록하여 APNs를 사용하지 않으면 Apple 플랫폼 단말에게 푸쉬 알림을 보낼 수 없다.
FCM(Firebase Cloud Messaging)은 구글에서 제공하는 푸쉬 알림 서비스이다.
iOS뿐 아니라 iOS나 웹 등 여러 플랫폼에 같은 API로 푸쉬 알림을 보낼 수 있으며, 앱 서버가 직접 APNs랑 통신하지 않아도 된다.

FCM은 내부적으로 Apple플랫폼 단말에게 APNs를 통해 알림을 전달한다.
따라서 앱 서버는 FCM API로 플랫폼에 구애받지 않고 알림을 보낼 수 있게 되고, iOS로의 실제 알림 전달은 APNs가 해주는 구조이다.
덕분에 개발자는 플랫폼별 세부 처리 없이도 푸쉬 알림을 보낼 수 있지만, APNs 관련 설정 변동 등에 대한 작업을 신경써주어야 한다.

1. 이슈 발생: Firebase Cloud Messaging를 사용한 iOS 푸쉬 알림 장애

새 빌드의 앱을 배포하기 전 푸쉬 알림 점검을 위해 서버측에 푸쉬 알림을 요청했다. 환경은 다음과 같다.

• 앱스토어를 통해 설치한 현행 배포 빌드의 앱
• 앱은 Firebase의 SDK를 내장, 재시작시 매번 AppDelegate내에서 APNs토큰을 FCM에 등록
• FCM을 사용해 푸쉬 알림을 보내는 서버

서버는 특정 대기열에 나의 DeviceID를 등록하고, 단일대상으로 직접 푸쉬 알림을 보내는 플로우를 수행했다.
그러나 푸쉬알림이 나에게 도달하지 않았고, 수차례 반복했음에도 도달하지 않는것을 확인했다.
또한 서버측에도 푸쉬알림 실패 메세지를 반환받고 있다는 보고로 푸쉬알림 장애가 발생했다는 사실을 확인했다.

2. 이슈 재현: 푸쉬 알림 플로우를 수동으로 실행하여 장애 확인

장애가 발생한 푸쉬 알림 플로우는 다음과 같다.

앱에서 특정 대기열에 대기 등록 (디바이스ID를 서버 내 임의의 대기열에 등록)
-> 운영자 웹에서 대기열 내의 유저를 선택 (서버가 FCM API로 푸쉬 전송 요청)
-> 선택된 유저 디바이스ID로 FCM이 APNs에게 푸쉬 전송 요청 (FCM이 APNs에게 푸쉬 전송 요청)
-> 앱이 푸쉬 알림 수신 (APNs가 앱에게 푸쉬 알림 전송 및 앱이 수신)

상기 플로우를 직접 수행했고, iOS플랫폼 외의 단말(안드로이드)는 알림을 정상적으로 수신하고 있음을 확인했다.
따라서 iOS플랫폼에 한해 Push Notification 전송이 실패하고 있음을 알 수 있었다. 

푸쉬알림 전송실패 얼럿

3. 이슈 분석: Push Notification Console로 푸쉬 알림 장애 지점 분석

푸쉬 알림 요청은 다음을 경유한다.

• 서버
• FCM
• APNs

앱의 API호출을 서버에서는 정상적으로 받고 있으므로, FCM, APNs 둘 중 하나 혹은 전부가 문제라고 판단했다.
따라서 어느 지점에서 장애가 발생하는지 알기 APNs 콘솔로 앱에 직접 푸쉬를 진행했고, 환경은 아래와 같다.

• TestFlight의 배포 프로비저닝으로 서명한 릴리즈 빌드 앱
• Push notification capability 및 유효성을 확인한 APNs 증명서, 프로파일, 개인 키

앱스토어 배포 브랜치로 git checkout한 후
단말의 토큰을 출력하도록 간단히 수정한 뒤에 Push Notification Console에서 Production 환경에서 직접 푸쉬 알람을 보냈다.

Push Notification Console로 푸쉬알림 직접 전송

앱 푸쉬알림 정상 수신을 확인했고, 증명서등에 문제가 없으며, 따라서 FCM쪽으로 장애 발생 범위를 좁힐 수 있었다.
이에 FCM이 어떻게 푸쉬 알림을 보내는 지 조사, 또한 최근에 앱을 이전받았음을 고려해 다음과 같은 가설을 세웠다.

앱 이전에 의해 앱의 APNs관련 인증키(개인키), 키ID, 팀ID가 자동으로 변경됐다.
따라서 FCM에 등록된 기존의 리소스가 더이상 유효하지 않아 APNs이 FCM의 요청을 거부하고 있으며
이에 Push Notification이 iOS 플랫폼에 한해 실패하고 있다.

4. 이슈 해결: Firebase Cloud Messaging의 APNs 키 갱신 및 푸쉬 알림 정상 동작 확인

FCM에 새로 등록해야 할 리소스를 내가 갖고 있었으며, 이때는 오후 11시쯤의 늦은 시간이었다.
따라서 Firebase의 관리권한을 부여받은 뒤 직접 Cloud Messaging의 설정값을 점검했다.
앱 이전 전의 정보가 설정돼 있음을 확인했고, 관련 리소스를 모두 업데이트 했다.

Firebase의 프로젝트 설정 내 Cloud Messaging - Apple 앱 구성 섹션

이후 장애가 발생한 푸쉬 알림 플로우를 다시 점검, 정상적으로 송신했음을 확인했다.

이슈 해결!

앱 이전 이후 푸쉬 알림에 장애를 겪는 서비스의 개발자들에게 도움이 됐으면 하는 바람과 함께 포스팅을 줄인다.

---

https://vandijk.tistory.com/4

FCM, APNS 연동 방법

https://zeddios.tistory.com/1399

Push Notification Console 써보기