메인 콘텐츠로 건너뛰기
iOS 앱에 푸시 알림을 보내려면 Apple Push Notification Services(APNs)에 대한 인증된 연결이 필요합니다. 토큰 기반(.p8 키) 또는 인증서 기반(.p12 파일) 방법을 사용하여 인증할 수 있지만 하나만 필요합니다. 이 가이드는 권장되는 접근 방식인 토큰 기반 .p8 키 설정을 안내합니다.

​
요구 사항

시작하기 전에 다음 사항이 있는지 확인하세요:

​
단계

​
Apple Developer 계정에서 .p8 키 생성

  1. Apple Developer 계정에 로그인하세요.
  2. **Certificates, Identifiers & Profiles > Keys**로 이동하세요.
  3. 파란색 플러스(+) 아이콘을 클릭하세요.
    • 표시되지 않으면 액세스 권한을 위해 관리자에게 문의하세요.
  1. **Apple Push Notifications service (APNs)**를 선택하세요.
  2. 키를 구성할 때 Sandbox & Production이 선택되었는지 확인하세요:
  1. 키 이름을 입력하고 Continue를 클릭한 다음 Register를 클릭하세요.
  1. .p8 키를 다운로드하고 안전하게 보관하세요. 다시 다운로드할 수 없습니다.
새 .p8를 생성해야 하는데 이미 두 개가 있는 경우 기존 키 중 하나를 먼저 취소해야 하며 더 이상 사용할 수 없습니다.

​
OneSignal에 .p8 키 업로드

  1. OneSignal 대시보드에서 Settings > Push & In-App > Apple iOS (APNs) Settings로 이동하세요.

OneSignal 대시보드 푸시 구성 페이지.

  1. 인증 방법으로 **.p8 Auth Key (Recommended)**를 선택하세요.

p12 또는 다른 p8에서 업데이트하는 경우 '인증 업데이트' 옵션이 제공됩니다

다음을 제공하세요:
  • .p8 File – Apple Developer 계정에서 다운로드한 개인 키 파일.
  • Key ID – Apple Developer 계정의 Keys 섹션에 있습니다. 다운로드한 .p8 파일과 일치하는지 확인하세요.
  • Team ID – Apple Developer 계정의 오른쪽 상단에 있습니다.
  • App Bundle ID – 다음에서 찾을 수 있습니다:

.p8 키 세부 정보 찾기

Xcode에서 Bundle ID 찾기

완료되면 Save & Continue를 클릭하세요.
OneSignal에서 .p8 키를 사용한 APNs 인증 설정을 성공적으로 완료했습니다.이제 iOS 앱이 푸시 알림을 보내고 받을 준비가 되었습니다! 🎉

​
.p8 문제 해결

단계별 체크리스트:
1

.p8 파일 형식 확인

  • 텍스트 편집기에서 .p8 파일을 여세요.
  • 다음과 같이 표시되어야 합니다: 
    -----BEGIN PRIVATE KEY-----
64 character line
64 character line
64 character line
8 character line
-----END PRIVATE KEY-----
2

실수로 .p12를 업로드하지 않았는지 확인

  • .p8 키는 Apple Developer 계정의 Keys 섹션에서 가져옵니다.
  • .p12 인증서는 Certificates 섹션에서 가져옵니다. 이들은 .p8 인증과 호환되지 않습니다.
3

올바른 키 ID가 있는지 확인

  • Apple Developer > Keys 섹션으로 이동하세요.
  • OneSignal에 입력한 Key ID와 다운로드한 .p8 키에 대해 나열된 Key ID가 일치하는지 확인하세요.
4

팀 ID 확인

  • Team ID는 Apple Developer 계정의 오른쪽 상단에 나타납니다.
  • 정확히 복사되었는지 그리고 키가 생성된 계정과 일치하는지 확인하세요.
5

키에 APNs 기능이 있는지 확인

  • Apple Developer에서 키를 볼 때 Apple Push Notifications service (APNs) 기능이 나열되어야 합니다.
  • 그렇지 않으면 키를 취소하고 새 키를 생성하세요.
6

몇 분 기다리기

  • 새로 생성된 키는 Apple이 외부 인증을 허용하기 전에 전파되는 데 10-15분이 걸릴 수 있습니다.
  • 생성 직후 유효성 검사 오류가 발생하면 기다렸다가 다시 시도하세요.

​
다른 모든 방법이 실패할 경우

  • 현재 .p8 키를 취소하고 처음부터 새로 만드세요.
  • 키가 생성된 동일한 계정의 유효한 Bundle ID를 사용하고 있는지 다시 확인하세요.
  • Key ID, Team ID, Bundle ID 및 Apple Developer Key 구성의 편집된 스크린샷과 함께 support@onesignal.com에 문의하세요.

​
FAQ

​
프로비저닝 프로파일이 필요한가요? 어떻게 만드나요?

네, Apple은 개발, 테스트(Ad Hoc) 및 App Store 배포를 위해 다양한 유형의 프로파일을 요구합니다. Xcode에서 Automatically manage signing을 선택하여 자동으로 생성할 수 있어야 합니다.
그렇지 않으면 자세한 내용은 Apple의 프로비저닝 프로파일 문서를 참조하세요.