App Store Connect(Apple)

Classic/VPC 환경에서 이용 가능합니다.

애플 아이디 로그인 기능을 사용하기 위한 콘솔 사용 가이드 입니다.
게임팟 연동 이외 콘솔 사용법에 대해서는 App Store Connect 페이지를 통해 정보를 확인해 주시기 바랍니다.

Apple sign-in

Apple Developer 프로그램에 가입되어 있어야 하며, Apple의 웹 로그인 기능을 구현하는 방법은 몇 가지 주요 단계를 포함합니다.

Apple의 'Sign in with Apple' 기능을 사용하면 사용자들이 Apple ID를 사용하여 웹사이트나 애플리케이션에 로그인할 수 있습니다. 이를 위해선 Apple Developer 계정이 필요하고, 몇 가지 설정과 코드 구현이 필요합니다.

콘솔 설정 전 체크 사항

1. 계약, 세금 및 금융 거래 > 계약 항목에서 ‘유료’ 계약이 활성화 상태인지 확인합니다.
   

2. 계약, 세금 및 금융 거래 > 금융거래 항목에 거래 가능한 은행 계좌가 등록되어 있어야 합니다.

3. 앱 선택 > 앱 내 구입 > 인앱 상품 목록 맨 오른쪽에 ‘제출 준비 완료’ 라고 표시되어 있는지 확인합니다.

Apple ID 로그인 설정

1. Client ID 설정하기

1. Apple developer console > Certificates, Identifiers & Profiles > Identifiers 에서 적용하려는 앱의 IDENTIFIER 선택합니다.

• 만들어놓은 APP ID가 없으실경우
  
  
  1-1. Apple developer console > Certificates, Identifiers & Profiles > Identifiers + 선택 
  

1-2. Register a New Identifier > App IDs 를 선택하세요.

1-3. Register an App ID의 Platform, Description(게임 Title), Bundle ID(Explicit)를 입력 후 Continue를 눌러주세요

2. Capabilities 탭의 Sign In with Apple 체크 > 오른쪽에 Edit 버튼을 클릭합니다.
   

3. Enable as a primary App ID 선택 후, 저장합니다.

2. Service ID / Callback URL 설정하기

1. Apple developer console > Certificates, Identifiers & Profiles > Identifiers에서 +버튼 클릭하여 Services ID 체크 후 Continue 버튼을 클릭합니다.
   

2. Description / Identifiers 입력 후 Continue 버튼 클릭 > Register 버튼 클릭하여 생성 완료합니다.

• Description : 앱 타이틀 기재
• Identifiers : 애플로그인에 이용되는 거기때문에 Identifier는 구분하기 쉽도록 Bundle ID 기준으로 작성하시면 좋습니다. {예 :Bundle ID.webauth}
  

3. 생성된 Services ID 선택 > Sign In with Apple 항목의 Configure 버튼을 클릭합니다.

4. Primary App ID 항목에 사용할 앱을 선택하고, Website URLs 항목 옆의 +버튼을 클릭합니다.

5. Register Website URLs 항목에 게임팟 API 도메인과 Return URL 를 입력합니다.
예시) Return URL 이 [https://gpapps.gamepot.ntruss.com/v1/auth/apple/callback/{projectid}] 일 경우
API 도메인은 [gpapps.gamepot.ntruss.com] 이 됩니다.

6. 생성된 Services ID의 IDENTIFIER를 게임팟 대시보드 > 프로젝트 설정 > 일반 > Apple ID Login > Clien ID 항목에 추가합니다.
   

3. Team ID 확인하기

• Apple developer console > account > 하단의 멤버십 세부사항에서 확인할 수 있습니다.
  

• 혹은 Certificates, Identifiers & Profiles 페이지의 우측 상단에서도 TeamId를 확인하실 수 있습니다.
  

4. Key 설정하기

1. Apple developer console > Certificates, Identifiers & Profiles > Keys 에서 '+' 버튼을 클립합니다.
   

2. Key Name 입력 > Sign in with Apple 체크 후 Configure 버튼을 클릭합니다.
   

3. Primary App ID 항목에 사용할 앱을 선택하고, Save 버튼을 클릭합니다.
   

4. Register 버튼 클릭 > Download 버튼을 클릭하여 .p8 파일을 다운로드 합니다.
   

5. 다운로드 한 .p8 파일을 오픈하여 전체 내용을 복사하여 게임팟 대시보드 > 프로젝트 설정 > 일반 > Apple ID Login > Private Key 항목에 입력합니다.
   • 파일은 xcode 또는 메모장 등을 통해 오픈할 수 있습니다.

{height="" width="50%"}'

6. 생성된 Key의 ‘Key ID’ 항목을 Apple ID Login > Key ID 항목에 입력합니다.
   

5. 애플 영수증 검증 강화

게임팟 대시보드 > 프로젝트 설정 > 일반 > 애플스토어 결제 영수증 검증

• 허용 번들 ID : 영수증 검증시 애플 영수증의 번들 ID ( XX.XX.XX ) 를 비교 하여 틀린 경우 불법 결제로 판단하고 결제 실패 처리합니다.
  => 필수 사항은 아니지만, 해외에서 불법 결제 사례가 많으므로 설정하시길 권장합니다.
• 앱 공유 암호 : 해당 정보를 추가로 있으면 추가 페이크 결제 검증을 진행 후 맞지 않은 경우 결제 실패 처리 진행을 합니다.

앱 공유 암호(Apple Password) 확인 방법

1. 앱스토어 - 프로젝트 선택 - 앱 정보 - 앱 공유 암호 - 관리 글씨 클릭
   

2. 사용자 및 액세스 - 공유 암호

6. App Store 서버 알림

해당 부분은 결제 취소 정보를 가져올때 사용되는 용도로 게임팟 에서는 V1 알림 타입만 지원을 합니다.
알림 주소는 > 게임팟 대시보드 > 결제 > 결제 취소 > AppStore > 주소 복사 버튼 클릭 하면 관련 정보를 확보 가능합니다. ( 대시보드 리전에 따라 관련 주소가 달라집니다. )

7. 인앱 결제 StoreKit 설정

1. SyncedProducts.storekit 이런 파일 만들어서 싱크합니다.
   

2. Product -> Scheme -> Edit Scheme -> Run 에 StoreKit Configuration 에 연결되어 있는지 확인합니다.
   

• Root folder 에서 New File 한 후에 StoreKit 선택해서 만들면 됩니다.