Apple 푸시 알림 인증서: Expo에서 .p8과 .p12 중 선택

Apple 푸시 인증서는 서버가 Apple의 알림 서비스인 APNs를 통해 내 앱에 알림을 보낼 수 있게 허가해 줘요. 형태는 두 가지예요. 1년 동안 유효하고 앱 하나에만 연결되는 .p12 인증서, 그리고 만료되지 않고 계정의 모든 앱에 쓸 수 있는 .p8 키예요. Expo를 쓴다면 인증서는 필요 없어요. 첫 빌드 때 EAS가 .p8 키 생성을 제안하고, Expo 푸시 서비스가 그 키를 대신 사용해요.

개발자 인증서와 provisioning profile 가이드에서는 푸시 키를 몇 줄로만 다뤘어요. 이 글에서는 끝까지 파고들어요. 두 형식 중 무엇을 고를지, sandbox와 production 환경, 갱신, 그리고 TestFlight에서 알림이 끊기는 문제까지요.

저는 Expo와 EAS로 앱을 출시해요. Solys와 TradaZen은 설정에 expo-notifications 플러그인을 선언하고 있어요. 이 플러그인이 앱이 알림을 받을 수 있도록 준비해 줘요.

Apple이 인증서나 키를 요구하는 이유

푸시 알림은 내 서버나 Expo 서버에서 출발해 APNs로 넘어가고, APNs가 iPhone에 전달해요. 그래서 APNs는 그 서버가 내 앱에 메시지를 보낼 권한이 있는지 확인해야 해요. Apple은 이를 증명하는 방법을 두 가지 제공해요.

• .p8 키를 사용하는 토큰 기반 연결. Apple에 따르면 더 빠르고, 여러 서버에서 쓸 수 있고, 키 하나로 팀의 모든 앱이나 일부 앱을 커버해요. 서버는 이 키로 토큰에 서명하는데, 적어도 한 시간마다 다시 만들어야 해요.
• .p12 파일을 사용하는 인증서 기반 연결. Apple 설명에 따르면 이 인증서는 앱 하나에만 연결되고 1년 동안 유효해요. 앱이 여러 개면 인증서도 여러 개예요.

Apple의 만료 안내 페이지에도 나와 있듯이, APNs 토큰 서명 키는 절대 만료되지 않아요.

.p8 / .p12 비교표

기준	.p8 키	.p12 인증서
유효 기간	만료 없음	1년
적용 범위	모든 앱	앱 하나
환경	생성 시 선택	Sandbox와 production
갱신	없음 (폐기 시 제외)	매년
다운로드	한 번만	Mac에서 내보내기
개수	환경당 2개	앱당 1개
Expo에서의 사용	EAS가 생성하고 관리	Expo 문서에 없음

세 가지를 짚고 갈게요. .p8 파일은 한 번만 다운로드할 수 있어요. Apple은 계정에 이 파일을 보관하지 않아요. 반면 .p12는 인증서를 만든 Mac의 키체인에서 내보내요. 그리고 환경당 키 2개 제한은 팀 키에 적용돼요. 특정 앱으로 제한된 키는 환경당 최대 200개까지 허용돼요.

Expo의 자격 증명 페이지는 푸시 키만 다루고, 계정당 최대 2개라고 설명해요. 환경이나 앱별 키는 구분하지 않아요. Expo 앱이라면 .p8 키가 정답이에요.

Sandbox와 production: 두 가지 환경

APNs에는 서버가 두 개 있어요. sandbox라고도 부르는 development, 그리고 production이에요. Apple은 앞쪽을 테스트용, 뒤쪽을 출시된 앱용으로 정해 두었어요. 앱은 aps-environment entitlement로 어느 쪽을 쓸지 알아요. Apple에 따르면 이 값은 서명 프로필을 따라가요. 개발 프로필이면 development, 배포 프로필과 TestFlight면 production이에요.

그래서 TestFlight 빌드는 App Store와 똑같이 production과 통신해요.

Expo 쪽에서는 두 가지를 알아 두세요. expo-notifications 문서에 따르면 프로젝트에는 entitlement가 항상 development로 작성되고, 릴리스 빌드의 아카이브에서 production으로 바뀌어요. 그리고 Expo 토큰은 생성될 때 앱의 환경에 연결되는데, 이 환경은 자동으로 감지돼요. 보낼 때 따로 고를 건 없어요.

키를 직접 만든다면 Apple이 환경과 범위(팀 전체 또는 특정 앱)를 물어봐요. 개발자 문서에는 이제 sandbox나 production으로 제한된 팀 키가 설명되어 있고, 예전처럼 어디서나 쓸 수 있는 키도 계속 허용돼요. 그런데 계정 도움말에는 여전히 키가 두 환경 모두에 쓰인다고 적혀 있어요. Apple 문서끼리 말이 달라요. 생성할 때 고른 환경을 기억해 두세요. sandbox 전용 키는 TestFlight에도 App Store에도 쓸 수 없어요.

Expo가 푸시 키를 관리하는 방식

2026년 7월 28일에 업데이트된 Expo 설정 가이드에 따르면, 첫 개발 빌드 때 푸시 알림 설정과 APNs 키 생성을 제안해요. 둘 다 yes라고 답하세요. EAS Build를 쓰지 않는다면 eas credentials를 실행하세요. 유료 Apple Developer 계정이 필요해요.

그다음은 이렇게 돼요.

• EAS가 키를 저장하고 앱에 연결해요. Expo에 따르면 키 하나를 원하는 만큼 많은 앱에 쓸 수 있고, 새 키를 업로드해도 사용자의 Expo Push 토큰은 바뀌지 않아요.
• 내 서버는 APNs를 호출하지 않아요. Expo 푸시 서비스로 보내면, 그쪽이 APNs로 전달해요. Expo는 전송 후 약 15분 뒤에 영수증(receipt)을 확인하라고 해요. 오류는 거기에 표시돼요.
• 플러그인이 entitlement를 추가해요. plugins에 expo-notifications를 선언하세요.

{
  "expo": {
    "plugins": ["expo-notifications"]
  }
}

함정이 두 가지 있어요. Expo FAQ는 SDK 53부터 Expo Go가 푸시 알림을 더 이상 지원하지 않는다고 하는데, expo-notifications 페이지는 Android만 해당한다고 해요. 어느 쪽이든 Expo는 개발 빌드를 권장하니, 개발 빌드로 테스트하세요. 그리고 eas credentials로 키를 삭제하면 Expo 서버에서만 지워지고 Apple 계정에서는 지워지지 않아요. 자리를 비우려면 Apple 포털에서 폐기하세요. 다른 비밀 정보와 마찬가지로 .p8 파일은 절대 저장소에 들어가면 안 돼요. Expo 앱의 API 키와 같은 규칙이에요.

갱신: 실제로 만료되는 것

.p8 키는 갱신할 게 없어요. 내가 폐기하지 않는 한 멈추지 않아요. 키가 유출됐다고 의심되면 Apple은 새 키를 만들고, 그 키로 전환한 다음에야 기존 키를 폐기하라고 권장해요. Expo에서 키를 교체하는 방법은 FAQ에 나와 있어요. eas credentials, iOS, 빌드 프로필을 차례로 선택한 뒤 푸시 키를 제거하고 새로 생성하면 돼요.

.p12 인증서는 매년 만료돼요. Apple은 만료 전에 갱신하고 키체인에서 날짜를 확인하라고 해요. 만료되거나 폐기되면 앱에 더 이상 알림을 보낼 수 없어요. Apple은 별도의 갱신 절차를 설명하지 않아요. 앱 식별자에서 새 인증서를 만들고, 만료 전에 서버에 설치한 다음, 기존 인증서를 제거하면 돼요. 가장 좋은 갱신 방법은 키로 넘어가는 거예요.

Intune이나 다른 기기 관리 도구로 iPhone을 관리하고 있나요? 그건 다른 인증서예요. 기기 관리용 푸시 인증서는 Apple Push Certificates Portal에서 만들고 매년 갱신해요. Apple은 사용한 Apple 계정을 기록해 두라고 권장해요. 갱신할 때 필요하거든요.

흔한 문제와 해결법

개발 환경에선 되는데 TestFlight에선 안 돼요

1. 잘못된 토큰으로 보내고 있어요. TestFlight 빌드는 production에 등록되고 새 토큰을 받아요. 개발 빌드에서 받은 토큰은 작동하지 않아요. 토큰이 환경과 맞지 않으면 Apple은 BadDeviceToken을 반환해요. TestFlight 앱 자체에서 토큰을 가져오세요.
2. production 앱에 푸시 자격 증명이 없어요. Expo FAQ에 나오는 진단이에요. expo.dev의 프로젝트 자격 증명 페이지나 eas credentials로 확인하세요.
3. 키가 sandbox로 제한되어 있어요. production에서 쓸 수 있는 키로 교체하세요.
4. iPhone이 토큰을 받지 못해요. Xcode 빌드 위에 TestFlight 빌드를 설치했다면 Expo는 기기를 재시작해 보라고 해요.

"No valid aps-environment entitlement string found"

Expo FAQ에 따르면 이 오류는 iOS 프로젝트에 푸시 키가 설정되어 있지 않다는 뜻이에요. 자격 증명 페이지를 확인한 뒤 다시 빌드하세요. 그러면 EAS가 키 생성을 제안해요. plugins에 expo-notifications가 들어 있는지도 확인하세요.

ITMS-90078: Missing Push Notification Entitlement

업로드 후에 Apple이 이 이메일을 보내요. 앱이 APNs에 등록하는 것처럼 보이는데 서명에 aps-environment entitlement가 없다는 내용이에요. SDK 51에 관한 Expo 안내에 설명이 있어요. 이 SDK부터는 expo-notifications가 설치된 경우에만 entitlement가 추가돼요. 이 경고는 Apple의 검사 두 가지에서 나와요. 첫째는 앱 식별자의 capability와 앱의 entitlement를 비교하는 검사예요. 둘째는 바이너리에서 알림 등록 메서드를 찾는 검사인데, Expo 코드는 모든 앱에 이 메서드를 포함하고 있어요.

이건 경고일 뿐 리젝이 아니에요, Expo도 그렇게 설명해요. 알림을 쓴다면 플러그인을 추가하고 다시 빌드하세요. EAS는 빌드할 때마다 앱 식별자의 capability를 동기화해요. 알림을 쓰지 않는다면 Apple 포털에서 식별자의 Push Notifications capability를 제거하세요. 경고가 계속 올 수도 있지만 아무 문제 없어요.

InvalidCredentials 또는 모든 앱이 한꺼번에 조용해짐

영수증에 InvalidCredentials가 있다면 푸시 자격 증명이 더 이상 유효하지 않다는 뜻이에요. 대개 키가 폐기됐기 때문이에요. 그 키를 쓰던 모든 앱이 동시에 알림을 못 보내요. Expo의 해결법은 eas credentials를 실행하고 새 키를 만드는 거예요. 영수증에 InvalidProviderToken이 나온다면 Expo는 푸시 키와 프로필을 다시 생성하면서 새로 빌드하라고 권장해요.

알림을 켜기 전에

출시 전에 iPhone에서 알림을 테스트하려면 TestFlight로 앱 테스트하기를 따라 하세요. 앱을 깨우는 무음 알림을 보낸다면 백그라운드 모드에 관한 가이드라인 2.5.4를 다시 읽어 보세요. Mac 없이 전체 과정을 진행하는 방법은 Mac 없이 iOS 앱 출시하기에, 출시 단계는 App Store에 앱 출시하기 페이지에 있어요.

첫 전송 전에 무료 진단을 받아 보세요. 프로젝트에서 무엇이 막히는지 알려 주고, 제 Apple 리젝 방지 체크리스트도 보내 드려요. 앱을 만들고, 구독을 연결하고, 출시하는 과정은 iOS & Android Kit가 제 앱의 Starter Code와 함께 4단계로 안내해요. 내 속도에 맞춰 진행하면 돼요.

자주 묻는 질문

Apple 푸시 인증서는 만료되나요?

.p12 인증서는 1년 후에 만료되고, 교체하지 않으면 알림이 멈춰요. .p8 키는 절대 만료되지 않아요. 내가 폐기할 때만 멈춰요. 이게 키를 선호하는 가장 큰 이유예요.

앱마다 푸시 인증서가 필요한가요?

.p12 인증서라면 그래요. 인증서 하나는 앱 하나에만 연결돼요. .p8 키는 계정의 모든 앱에 쓸 수 있어요. 그래서 Expo에서는 키 하나로 모든 앱을 커버할 수 있어요.

Apple 푸시 인증서는 어떻게 갱신하나요?

새 인증서 서명 요청으로 앱 식별자에서 새 인증서를 만들고, 서버에 설치한 다음, 기존 인증서를 제거하세요. 만료 전에 하세요. 가장 간단한 방법은 갱신이 필요 없는 .p8 키로 넘어가는 거예요.

.p8 파일을 잃어버렸어요. 어떻게 해야 하나요?

Apple은 한 번만 다운로드할 수 있게 해요. EAS가 키를 만들었다면 Expo가 보관하고 있으니 알림은 계속 작동해요. 그렇지 않다면 새 키를 만들어 eas credentials로 추가한 다음, Apple 포털에서 기존 키를 폐기하세요. 사용자의 Expo Push 토큰은 바뀌지 않아요.

푸시 키를 바꾼 뒤에 다시 빌드해야 하나요?

보통은 아니에요. 키는 설치된 앱이 아니라 알림을 보내는 서버에서 쓰이고, Expo는 새 키가 토큰을 바꾸지 않는다고 설명해요. 예외는 영수증에 InvalidProviderToken이 나올 때예요. 이 경우 Expo는 새 키와 새 프로필로 다시 빌드하라고 권장해요.