콘텐츠로 이동

Apple App Store 콘솔 설정

개요

App Store로 앱을 출시하려면 App Store Connect와 Apple Developer에서 여러 값을 확인해 Hive 콘솔에 등록해야 합니다. 이 문서는 각 값을 확인하는 위치와 방법, 확인한 값을 등록할 Hive 콘솔 화면을 안내합니다. 콘솔 화면에서 값을 입력하고 저장하는 방법은 관련 콘솔 가이드에서 설명합니다.

스토어 App ID 등록

Bundle ID는 App Store가 앱을 식별하는 값입니다. Hive Axyl은 이 값을 기준으로 App Store와 연동해 로그인, 결제 등을 처리하므로, 로그인 연동과 결제 연동을 설정하기 전에 먼저 등록하세요.

App Store Connect에 접속해 대상 앱의 Bundle ID를 확인하세요.

확인한 Bundle ID는 Hive 콘솔 프로젝트 설정 > App ID에서 App Store 스토어로 만든 App ID의 Store App ID에 등록합니다. 등록 방법은 Store App ID 등록을 참조하세요.

로그인 연동

Apple 로그인은 Apple이 발급한 인증 결과를 Hive Axyl 서버가 검증한 뒤에 완료됩니다. 검증과 인가 코드 교환에 사용하는 Service ID, Team ID, Key ID, Private Key 네 가지 값을 Apple Developer에서 확인해 Hive 콘솔에 등록해야 앱에서 Apple 로그인이 동작합니다.

네 가지 값은 모두 Apple Developer의 Account에서 준비합니다. App Store Connect에서는 확인하지 않습니다.

1. Apple Developer에 Service ID 등록

Service ID는 Apple이 로그인 요청을 보낸 앱을 식별할 때 사용하는 값입니다. Apple Developer에 Services IDs 유형의 식별자를 등록하면, 등록할 때 입력한 식별자 값이 그대로 Service ID가 됩니다.

  1. Apple Developer에 접속한 후 Account > 인증서, ID 및 프로파일 > 식별자로 이동하세요.
  2. 새 식별자를 등록하는 화면에서 Services IDs를 선택하세요.
  3. Description에 앱을 구분할 이름을 입력하고, Identifier에 식별자 값을 입력한 후 등록을 마치세요. Identifier에는 Bundle ID를 기준으로 만든 {Bundle ID}.siwa 형식처럼 구분하기 쉬운 값을 입력하세요.
  4. 등록한 식별자를 선택해 Sign in with Apple을 활성화하세요.

  5. Identifier에 입력한 값을 복사하세요. 이 값이 Service ID입니다.

2. iOS와 macOS용 App ID와 프로비저닝 프로파일 준비

iOS나 macOS에서 Apple 로그인 Add-on을 사용하려면 Apple Developer의 앱 App ID에서 Sign in with Apple 기능을 활성화하세요. 기능을 활성화한 App ID에 맞춰 프로비저닝 프로파일을 새로 발급하거나 갱신한 뒤, 앱 빌드에 사용하세요.

Apple 로그인 Add-on은 Xcode 프로젝트에 필요한 entitlement를 빌드 시점에 자동으로 추가합니다. 하지만 App ID 기능 활성화와 프로비저닝 프로파일 발급은 Apple Developer에서 직접 마쳐야 합니다.

3. Service ID의 Return URL 등록

iOS와 macOS 외의 OS에서 Apple 로그인을 제공하려면 Hive Axyl 중계 주소를 Service ID의 Return URL로 등록하세요. Apple은 로그인 결과를 등록된 HTTPS 주소로만 보내므로, Android와 Windows의 Apple 로그인에서는 Hive Axyl이 운영하는 중계 주소가 결과를 받아 앱으로 전달합니다. 앱에서 중계 주소를 사용하는 방법은 Apple 로그인 연동 환경 구성을 참조하세요.

Apple Developer에 Service ID 등록에서 Service ID에 활성화한 Sign in with Apple의 설정에 아래 값을 등록하세요.

  • Primary App ID: Apple 로그인을 사용할 Apple App ID 식별자
  • Return URL: https://core-api.hiveaxyl.com/auth/v1/provider/callback. Apple 인가 URL의 redirect_uri에도 같은 값을 사용
  • 도메인: core-api.hiveaxyl.com

4. Team ID 확인

Team ID는 Apple Developer 팀을 구분하는 식별자입니다. 새로 만들지 않고 확인만 하면 됩니다.

  1. Apple Developer에 접속한 후 Account > 멤버십 세부 사항으로 이동하세요.
  2. Team ID에 표시된 값을 복사하세요.

5. Apple 로그인용 키 발급

Hive Axyl 인증 서버는 Apple 로그인용 키로 서명한 값을 Apple에 보내 Apple 인가 코드를 교환합니다. 키를 발급하면 Key ID와 Private Key 파일을 한 화면에서 함께 확인합니다.

  1. Apple Developer에 접속한 후 Account > 인증서, ID 및 프로파일 > Keys로 이동하세요.
  2. 새 키를 등록하는 화면에서 Key Name을 입력하고 Sign in with Apple을 선택하세요.
  3. Configure Key 화면의 Primary App ID에서 Apple 로그인을 사용할 Apple App ID 식별자를 선택한 후 저장하세요.
  4. 등록을 마치면 표시되는 Key ID 값을 복사하세요.
  5. 다운로드를 선택해 .p8 형식의 키 파일을 내려받으세요.

키 파일은 Hive 콘솔에 Private Key로 등록하며, 앱이나 앱 서버에는 두지 않습니다. 이 파일은 발급 시점에 한 번만 내려받을 수 있습니다. 파일을 잃어버리면 키를 새로 발급받아 Hive 콘솔에 Key ID와 Private Key를 다시 등록해야 합니다.

<!-- 이미지 추가: Apple Developer Keys 화면의 Key ID 확인과 다운로드 영역 -->

6. Hive 콘솔 설정으로 이동

확인한 인증 정보를 등록하고 Apple 로그인을 활성화하는 방법은 Apple 로그인 인증 정보를 참조하세요.

결제 연동

App Store 결제는 사용자가 결제를 마친 뒤 Hive Axyl 서버가 App Store Connect API로 영수증을 검증하는 방식으로 동작합니다. 검증에 사용할 인증 정보와 판매할 상품 정보를 App Store Connect에서 확인해 Hive 콘솔에 등록해야 App Store 결제가 동작합니다. 구독 상품을 판매하지 않으면 2단계와 4단계는 건너뛰세요.

1. App Store Connect API 키 발급

Hive 콘솔에 등록할 Issuer ID, Private Key ID, Private Key는 App Store Connect API 키 화면에서 모두 확인합니다.

  1. App Store Connect에 접속한 후 사용자 및 액세스 > 통합 > App Store Connect API로 이동하세요.
  2. 활성화된 키 목록이 없으면 액세스 요청을 선택해 API 액세스 요청을 완료하세요.
  3. 활성화된 키 목록 오른쪽의 + 버튼을 선택하세요.
  4. 이름을 입력하고 액세스 항목에서 관리자를 선택한 후 생성을 선택하세요.
  5. Issuer ID에 표시된 값을 복사하세요.
  6. 생성한 키의 Key ID 값을 복사하세요. 이 값이 Hive 콘솔에 등록할 Private Key ID입니다.
  7. 다운로드를 선택해 .p8 형식의 키 파일을 내려받으세요. 이 파일이 Hive 콘솔에 등록할 Private Key입니다.

키 파일은 이 화면에서 한 번만 내려받으며 다시 내려받지 못합니다. 파일을 잃어버리면 키를 새로 발급받아 Hive 콘솔에 Private Key ID와 Private Key를 다시 등록해야 합니다.

<!-- 이미지 추가: App Store Connect의 App Store Connect API 화면에서 Issuer ID와 키 확인 영역 -->

2. 구독 상품용 공유 암호 확인

구독 상품을 판매하면 Hive Axyl 서버가 구독 영수증을 검증할 때 공유 암호를 사용합니다. 공유 암호는 App Store Connect에서 발급하는 32자리 16진수 문자열입니다. 공유 암호를 새로 생성하면 같은 조직에 속한 모든 앱의 자동 갱신 구독을 확인할 때 새 값을 사용해야 하므로, 이미 사용 중인 공유 암호가 있으면 새로 생성하지 마세요.

  1. App Store Connect에 접속한 후 사용자 및 액세스 > 통합 > 공유 암호로 이동하세요.
  2. 이미 생성한 공유 암호가 있으면 표시된 값을 복사하세요. 없으면 공유 암호를 생성한 후 표시된 값을 복사하세요.

앱마다 다른 공유 암호를 사용하는 경우에는 기본 공유 암호 대신 앱 공유 암호를 사용합니다. 앱 공유 암호는 App Store Connect에서 대상 앱을 선택한 후 일반 정보 > 앱 정보 > 앱 공유 암호에서 생성하세요. 앱이 앱 공유 암호를 사용하기 시작하면 그 앱에는 기본 공유 암호를 더 이상 사용하지 못하므로, Hive 콘솔에는 그 앱이 실제로 사용하는 공유 암호를 입력하세요.

<!-- 이미지 추가: App Store Connect의 공유 암호 생성 화면 -->

3. 판매할 상품 등록과 상품 ID 확인

Hive Axyl은 Hive 콘솔에 등록한 상품 ID로 App Store에 등록된 상품 정보를 조회합니다. 따라서 App Store Connect에 등록한 상품 ID와 Hive 콘솔에 등록할 상품 ID가 같아야 합니다.

App Store Connect에서 판매할 인앱 구입 상품 또는 구독 상품을 등록하고 상품 ID를 확인하세요.

4. App Store Connect에 Hive Axyl 서버 URL 입력

구독 상품을 판매하면 App Store가 구독 상태 변경 알림을 Hive Axyl 서버로 보내도록 App Store Connect에 Hive Axyl 서버 URL을 입력합니다.

  1. App Store Connect에 접속한 후 대상 앱을 선택하세요.
  2. 일반 정보 > 앱 정보 > App Store 서버 알림으로 이동하세요.
  3. 프로덕션 서버 URL에 https://api.hiveaxyl.com/payment/v1/webhook/subscription/apple을 입력하세요.

  4. 변경 내용을 저장하세요.

5. Hive 콘솔에 등록

App Store Connect에서 확인한 값은 아래 위치에 등록합니다. Hive Axyl 서버는 스토어 설정에 등록한 인증 정보로 영수증을 검증하고, 상품 등록에 등록한 상품 ID로 App Store의 상품 정보를 조회합니다.

App Store Connect에서 확인한 값 Hive 콘솔 등록 위치 등록 방법
Issuer ID, Private Key ID, Private Key, Subscription Shared Secret Key 결제 > 스토어 설정의 App Store 카드 App Store 인증 정보
상품 ID 결제 > 상품 등록 상품 등록

상품을 등록할 때 결제 플랫폼은 App Store를 선택하세요. App Store 상품의 실제 결제 가격은 App Store Connect에서 관리하므로, Hive 콘솔에 입력한 가격은 결제 금액에 영향을 주지 않습니다.

App ID마다 다른 인증 정보를 사용한다면 App ID별 인증 정보 설정에서 개별로 등록하세요.

구독 상품을 판매하면 구독 상태 변경 알림을 전달받을 앱 서버 URL도 결제 > 구독 서버 알림 URL에 등록합니다. 등록 방법은 구독 서버 알림 URL을 참조하세요. 알림을 받을 앱 서버가 아직 없으면 앱 서버에서 서버를 먼저 등록하세요.

푸시 알림 연동

App Store 푸시 알림은 Apple Push Notification service(APNs)를 사용해 발송합니다. iOS 앱에서 푸시 알림을 사용하려면 Apple Developer에서 APNs 인증 정보를 준비해야 합니다.

아래의 순서와 같이 APNs를 활성화하고 개인 키를 준비합니다.

1. APNs 인증서 파일과 Key ID 준비

Apple Developer에서 APNs 발송에 사용할 키를 등록하세요. 키 발급 방법은 Apple 공식 가이드를 참조하세요.

  1. Apple Developer에 접속한 후 Account > 인증서, ID 및 프로파일 > Keys로 이동하세요.
  2. APNs 발송에 사용할 키를 등록하세요.
  3. 등록한 키의 Key ID 값을 복사하세요. Key ID 확인 방법은 Apple 공식 가이드를 참조하세요.
  4. 다운로드를 선택하세요.
  5. .p8 형식의 파일을 내려받으세요.
  6. 내려받은 파일을 Hive 콘솔에 등록할 APNs 인증서 파일로 사용하세요.

새 키의 Key ID를 확인하세요. 새 키 파일을 APNs 인증서 파일로 사용하세요.

2. Team ID 확인

Team ID는 Apple Developer 팀을 구분하는 식별자입니다. Team ID 확인 방법은 Apple 공식 가이드를 참조하세요.

  1. Apple Developer에 접속한 후 Account > 멤버십 세부 사항으로 이동하세요.
  2. Team ID에 표시된 값을 복사하세요.

3. Hive 콘솔에 등록

APNs 푸시 알림 수단을 설정하려면 푸시 > 푸시 설정으로 이동하세요. 확인한 값을 Hive 콘솔에 등록합니다.

Apple Developer에서 준비한 값 Hive 콘솔 등록 위치
APNs 인증서 파일 푸시 > 푸시 설정의 APNs 설정
Key ID 푸시 > 푸시 설정의 APNs 설정
Team ID 푸시 > 푸시 설정의 APNs 설정

APNs 인증서 파일을 업로드하세요.

Key ID와 Team ID를 입력하고 저장을 선택하세요.