푸시 알림은 어떻게 작동할까: APNs와 FCM 설명

푸시 알림은 밖에서 보면 단순합니다. 서버에서 무언가 일어나면 1초 뒤 휴대폰 화면이 켜집니다. 그 사이에는 Apple과 Google이 운영하는 두 개의 전송 네트워크가 있고, 푸시는 반드시 둘 중 하나를 거쳐 휴대폰에 도착합니다.
- APNs(Apple Push Notification service)는 아이폰, 아이패드, 맥, Apple Watch로 가는 모든 푸시를 전달합니다.
- FCM(Firebase Cloud Messaging)은 Google Play 서비스가 설치된 안드로이드 기기로 푸시를 전달하며, APNs에 메시지를 넘겨 iOS로 보낼 수도 있습니다.
이 가이드는 알림 하나가 서버에서 두 플랫폼의 잠금 화면까지 가는 과정을 따라가며, 실제 운영 환경에서 실행해 보기 전에는 드러나지 않는 세부 사항도 함께 다룹니다. 저희는 Pocket Alert 뒤에서 두 파이프라인을 모두 운영하고 있으므로, 여기 나오는 예시는 실제로 배포하는 코드에서 가져왔습니다.
네 주체
- 사용자의 서버입니다. Apple은 이를 제공자(provider)라고 부릅니다. 무언가를 보내야 한다고 판단합니다.
- 푸시 서비스, 즉 APNs 또는 FCM입니다. 요청을 받아 경로를 정합니다.
- 기기입니다. 운영체제는 Apple 또는 Google과 하나의 장기 암호화 연결을 유지하고, 모든 앱의 푸시를 이 연결을 통해 받습니다.
- 앱입니다. 알림을 등록했고, 푸시가 향하는 토큰을 소유합니다.
세 번째 주체 덕분에 푸시는 배터리를 적게 씁니다. 휴대폰은 서버에 주기적으로 물어보지 않습니다. 모든 앱이 공유하는 연결 하나가 계속 열려 있고, 전달할 내용이 생기면 푸시 서비스가 그 연결로 보냅니다.
1단계: 기기가 토큰을 받습니다
앱이 원격 알림을 등록하면 운영체제는 토큰을 건넵니다. 토큰은 "이 기기의 이 앱"을 가리키는 불투명한 주소입니다. 앱은 이 토큰을 서버로 보내고, 서버는 이를 저장합니다.
- APNs 기기 토큰은 앱과 기기의 조합마다 고유합니다. Apple은 앱에 토큰을 캐시하지 말라고 권장합니다. 사용자가 백업에서 복원하거나, 새 기기로 옮기거나, 운영체제를 재설치하면 토큰이 바뀌기 때문입니다.
- FCM 등록 토큰은 안드로이드에서 같은 역할을 하며, FCM은 자체 일정에 따라 이를 새로 고칩니다.
토큰은 수시로 오래된 상태가 됩니다. 저장된 토큰을 최신으로 유지하는 것이 푸시 운영에서 가장 큰 부분 중 하나입니다.
2단계: 서버가 자신을 증명합니다
APNs
APNs는 TLS 1.2 이상 위에서 HTTP/2를 사용합니다. 운영 환경은 api.push.apple.com, 개발 빌드는 api.sandbox.push.apple.com이며, 포트는 443 또는 2197입니다. 인증 방식은 두 가지입니다.
- 토큰 기반. Apple 개발자 계정에서
.p8서명 키를 만든 뒤, ES256으로 짧은 JWT에 서명합니다. 이 JWT에는 Team ID와 키 ID가 들어갑니다. Apple은 JWT를 20분에 한 번보다 자주 갱신하지 말고, 60분에 한 번보다 드물게 갱신하지 말라고 요구합니다. 오래된 JWT를 보내면403 ExpiredProviderToken이 돌아오고, 너무 자주 갱신하면429 TooManyProviderTokenUpdates가 돌아옵니다. - 인증서 기반. 앱마다 TLS 클라이언트 인증서를 하나씩 쓰며, 유효 기간은 1년이고 이후에는 갱신해야 합니다.
토큰 인증을 사용하세요. 키 하나로 모든 앱을 처리할 수 있고, 매년 만료되지도 않습니다.
FCM
FCM의 HTTP v1 API는 Google 서비스 계정에서 발급받은 단기 OAuth 2.0 액세스 토큰을 요구하며, firebase.messaging 범위를 사용합니다. 정적 서버 키를 쓰던 이전 "레거시" API는 2023년에 지원 중단이 발표되었고 2024년 7월부터 종료되었습니다. 그래서 여전히 Authorization: key=...로 보내는 코드는 더 이상 동작하지 않습니다.
3단계: 요청
APNs로 보내기
각 푸시는 /3/device/<device token> 경로로 가는 HTTP/2 POST 요청입니다. 처리 방식을 바꾸는 몇 가지 헤더가 함께 붙습니다.
curl --http2 \
-H "authorization: bearer $APNS_JWT" \
-H "apns-topic: com.example.alerts" \
-H "apns-push-type: alert" \
-H "apns-priority: 10" \
-d '{"aps": {"alert": {"title": "Backup failed", "body": "db-01: pg_dump exited with code 1"}, "sound": "default", "interruption-level": "time-sensitive"}}' \
"https://api.push.apple.com/3/device/$DEVICE_TOKEN"
apns-topic은 앱의 번들 ID입니다.apns-push-type은 푸시의 종류를 지정합니다. 화면에 보이는 알림은alert, 소리 없는 데이터 푸시는background이며, 그 밖에도 몇 가지 값이 있습니다.apns-priority는 지금 바로 전달하려면10, 기기의 전원 상태에 맡기려면5, 전력을 아끼고 기기를 깨우지 않으려면1입니다.apns-expiration은 APNs가 재시도를 얼마나 계속할지 정합니다.0이면 한 번만 시도하고 저장하지 않습니다.apns-collapse-id는 같은 id를 가진 새 알림이 이전 알림을 대체하게 합니다.
페이로드는 aps 사전을 담은 JSON이며, 크기 상한은 4KB(VoIP는 5KB)입니다.
FCM으로 보내기
FCM은 요청 하나에 JSON 메시지 하나를 받습니다.
curl -X POST "https://fcm.googleapis.com/v1/projects/$PROJECT_ID/messages:send" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
-d '{
"message": {
"token": "DEVICE_REGISTRATION_TOKEN",
"notification": { "title": "Backup failed", "body": "db-01: pg_dump exited with code 1" },
"android": { "priority": "high", "notification": { "channel_id": "alerts_high" } }
}
}'
notification 메시지는 앱이 백그라운드에 있을 때 시스템이 직접 표시합니다. data 메시지는 앱에 전달되어 앱이 처리합니다. 어느 쪽이든 페이로드 제한은 4,096바이트입니다.
4단계: 전달, 또는 전달을 기다리는 시간
휴대폰이 온라인이면 푸시는 열린 연결을 타고 곧바로 도착합니다. 오프라인이라면 다음과 같습니다.
- APNs는
apns-expiration에 따라 최대 30일까지 알림을 보관하지만, 앱당 기기당 알림 하나만 보관합니다. 휴대폰이 비행기 모드일 때 다섯 개를 보내면 보통 마지막 것 하나만 받게 됩니다. Apple은 그것이 가장 최신 알림이라는 것조차 보장하지 않습니다. - FCM은 메시지를 유효 기간(TTL)만큼 보관합니다. 기본값은 4주이며 최대 28일입니다. 병합 가능한 메시지는 서로를 대체하며, 기기당 최대 4개의 병합 키를 쓸 수 있습니다.
우선순위는 전달 시점에도 영향을 줍니다. iOS에서는 우선순위 5와 1 푸시가 묶이거나, 속도가 제한되거나, 버려질 수 있습니다. 안드로이드에서는 normal 우선순위 메시지가 기기가 Doze 상태를 벗어날 때까지 기다릴 수 있고, high 우선순위 메시지는 즉시 전달됩니다. FCM은 이 특권을 어떻게 쓰는지도 지켜봅니다. 화면에 아무 알림도 표시하지 않는 높은 우선순위 메시지는 시간이 지나면서 조용히 일반 우선순위로 낮춰질 수 있습니다.
알림이 얼마나 크게 울리는지: 중요도 수준과 채널
전달은 한 가지 문제이고, 휴대폰에서 소리가 나는지는 또 다른 문제입니다. 두 플랫폼은 이를 다르게 처리합니다.
iOS(15 이상)는 알림마다 중요도 수준(interruption level)을 지정합니다.
passive는 화면을 켜거나 소리를 내지 않고 목록에만 추가합니다.active가 기본값입니다.time-sensitive는 집중 모드와 알림 요약을 뚫고 나올 수 있습니다. 사용자는 앱별로 이 기능을 끌 수 있습니다.critical은 방해 금지 모드와 무음 스위치가 켜져 있어도 항상 재생됩니다. 이를 쓰려면 Apple이 심사 후 요청에 따라 승인하는 권한(entitlement)이 필요합니다.
안드로이드(8 이상)는 모든 알림을 채널에 넣고, 채널이 중요도를 결정합니다. 소리, 진동, 헤즈업 표시, 방해 금지 모드에서의 동작이 모두 채널 설정입니다. 앱이 채널을 만들지만, 채널이 한 번 생기면 그 동작은 사용자의 몫이 됩니다. 앱은 나중에 이를 바꿀 수 없습니다.
이 마지막 규칙은 실제로 영향을 줍니다. Pocket Alert의 치명적 경고를 무음 모드에서도 울리게 만들었을 때, 기존 critical 채널은 사후에 알람 오디오로 바꿀 수 없었습니다. 해결책은 새 id를 가진 두 번째 채널을 만드는 것이었습니다. 서버는 이 채널을 만든 앱 빌드에만 이를 선택합니다. 앱이 만든 적 없는 채널로 보내면 알림이 아예 표시되지 않기 때문입니다.
Android 13 이상에서는 관문이 하나 더 있습니다. 앱에 POST_NOTIFICATIONS 런타임 권한이 필요하며, 새로 설치한 경우 사용자가 허용하기 전까지 알림은 꺼져 있습니다.
운영 환경에서 생기는 문제들
- 오래된 토큰. APNs는 더 이상 유효하지 않은 토큰에
410 Unregistered를 응답합니다. 그 토큰으로 보내는 것을 멈추고 삭제하세요. - 잘못된 환경. 개발 빌드의 토큰을 운영 호스트로 보내면
400 BadDeviceToken으로 실패합니다. - 지나치게 큰 페이로드. 4KB를 넘으면
413 PayloadTooLarge가 돌아옵니다. 알림 본문에 긴 로그 줄을 넣는 것이 흔한 원인입니다. - 낮춰진 우선순위. 아무것도 표시하지 못한 높은 우선순위 안드로이드 메시지는 우선순위를 잃습니다.
- 알림 꺼짐. 푸시는 전달되었지만 사용자는 보지 못합니다. 권한을 거부했거나 채널을 음소거했기 때문입니다.
지름길
이 모든 것을 직접 구축할 가치가 있는 경우는 앱이 여러분의 제품이고 그 사용자에게 보내야 할 때입니다. 자신이나 팀에게 보내는 경고라면 이는 지나치게 큰 인프라입니다. 플랫폼마다 개발자 계정이 필요하고, 서명 키, 토큰 저장소, 두 가지 요청 형식, 두 가지 우선순위 모델을 관리해야 합니다.
푸시 알림 서비스는 두 파이프라인을 대신 운영해 줍니다. Pocket Alert를 쓰면 자신의 토큰이나 인증서 없이 요청 하나만 보내면 됩니다.
curl -X POST https://api.pocketalert.app/v1/messages \
-H "Token: $PA_KEY" \
-H 'Content-Type: application/json' \
-d '{"title": "Backup failed", "message": "db-01: pg_dump exited with code 1", "level": "high"}'
level 필드는 플랫폼마다 다음과 같이 변환됩니다.
silent는 아이폰에서 소리 없는 passive 알림이며, 안드로이드에서는 무음 채널로 갑니다.low는 아이폰에서 passive이고, 안드로이드에서는 낮은 중요도입니다.default는 두 플랫폼 모두에서 일반 알림입니다.high는 아이폰에서 time-sensitive이고, 안드로이드에서는 높은 우선순위입니다.critical은 안드로이드에서 방해 금지 모드를 무시합니다. 아이폰에서는 time-sensitive로 도착하며, Apple이 권한을 승인함에 따라 전체 치명적 경고 소리를 순차적으로 도입하고 있습니다.
이에 대해서는 치명적 경고에서 더 자세히 다루고, API 자체는 푸시 알림 API란 무엇인가에서 확인할 수 있습니다.
FAQ
APNs는 전달을 보장하나요?
아니요. APNs와 FCM은 모두 최선 노력(best-effort) 방식입니다. APNs는 오프라인 기기에 대해 가장 최신 알림 하나만 저장하며, 두 서비스 모두 메시지가 언제 도착할지 보장하지 않습니다. Google 문서는 한 걸음 더 나아가 FCM을 생명에 관련된 긴급 경고에 쓰면 안 된다고 명시합니다. 온콜 호출에서는 푸시를 가장 빠른 채널로 보되, 유일한 채널로 여기지 마세요.
APNs와 FCM을 둘 다 써야 하나요?
아이폰은 APNs를 통해서만 푸시를 받습니다. Google Play 서비스가 있는 안드로이드 기기는 FCM으로 받습니다. 사용자가 두 플랫폼을 모두 쓴다면 서버는 두 곳과 모두 통신해야 합니다. 직접 보내거나, FCM을 거쳐 APNs로 전달되도록 할 수 있습니다.
FCM으로 아이폰에 알림을 보낼 수 있나요?
네. APNs 인증 키를 Firebase에 업로드하면 FCM이 메시지를 APNs에 넘겨 iOS로 전달합니다. Apple 기기로 보내는 데이터 메시지는 일반 우선순위로 보내야 합니다.
푸시 알림은 얼마나 클 수 있나요?
APNs 페이로드는 4KB(VoIP 푸시는 5KB), FCM 메시지는 4,096바이트입니다. 긴 텍스트는 푸시가 아니라 앱이나 링크에 담으세요.
기기 토큰이란 무엇인가요?
Apple 또는 Google이 발급하는, 기기 한 대의 앱 하나를 가리키는 주소입니다. 서버는 이 주소로 푸시를 보냅니다. 토큰은 언제든 바뀔 수 있으므로, 서버는 갱신된 토큰을 받아들이고 APNs나 FCM이 무효하다고 알려온 토큰은 버려야 합니다.
무료 Pocket Alert 계정을 만들고 키와 토큰 관리를 건너뛰거나, 대안에서 다른 서비스와 비교해 보세요.