--- title: "App Store Connect(Apple)" slug: "game-gamepot-storeguide-appstore" tags: ["GAMEPOT 2.0"] updated: 2026-09-17T09:07:47Z published: 2026-09-17T09:07:47Z canonical: "guide.ncloud-docs.com/game-gamepot-storeguide-appstore" stale: true --- > ## Documentation Index > Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # App Store Connect(Apple) Classic/VPC 환경에서 이용 가능합니다. 애플 아이디 로그인 기능을 사용하기 위한 콘솔 사용 가이드 입니다. 게임팟 연동 이외 콘솔 사용법에 대해서는 [App Store Connect](https://appstoreconnect.apple.com/login) 페이지를 통해 정보를 확인해 주시기 바랍니다. 참고 App Store Platform: [https://appstoreconnect.apple.com/](https://appstoreconnect.apple.com/login/) ### Apple sign-in [Apple Developer](https://developer.apple.com/programs/) 프로그램에 가입되어 있어야 하며, Apple의 웹 로그인 기능을 구현하는 방법은 몇 가지 주요 단계를 포함합니다. Apple의 'Sign in with Apple' 기능을 사용하면 사용자들이 Apple ID를 사용하여 웹사이트나 애플리케이션에 로그인할 수 있습니다. 이를 위해선 Apple Developer 계정이 필요하고, 몇 가지 설정과 코드 구현이 필요합니다. ### 콘솔 설정 전 체크 사항 1. 계약, 세금 및 금융 거래 > 계약 항목에서 ‘유료’ 계약이 활성화 상태인지 확인합니다. ![gamepot-appleLogin01.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-appleLogin01.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A35Z&se=2026-11-14T07%3A18%3A35Z&sr=c&sp=r&sig=GfsxhTdobYj4IH8ff5F75DrmoJy3N3YG3dFkaTHwS04%3D) 2. 계약, 세금 및 금융 거래 > 금융거래 항목에 거래 가능한 은행 계좌가 등록되어 있어야 합니다. ![gamepot-appleLogin02.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-appleLogin02.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A35Z&se=2026-11-14T07%3A18%3A35Z&sr=c&sp=r&sig=GfsxhTdobYj4IH8ff5F75DrmoJy3N3YG3dFkaTHwS04%3D) 3. 앱 선택 > 앱 내 구입 > 인앱 상품 목록 맨 오른쪽에 ‘제출 준비 완료’ 라고 표시되어 있는지 확인합니다. ![gamepot-appleLogin03.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-appleLogin03.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A35Z&se=2026-11-14T07%3A18%3A35Z&sr=c&sp=r&sig=GfsxhTdobYj4IH8ff5F75DrmoJy3N3YG3dFkaTHwS04%3D) ## Apple ID 로그인 설정 ![console_apple06.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/console_apple06(1).png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A35Z&se=2026-11-14T07%3A18%3A35Z&sr=c&sp=r&sig=GfsxhTdobYj4IH8ff5F75DrmoJy3N3YG3dFkaTHwS04%3D) ### 1. Client ID 설정하기 1. [Apple developer console](https://developer.apple.com/account/resources/identifiers/list) > Certificates, Identifiers & Profiles > Identifiers 에서 적용하려는 앱의 IDENTIFIER 선택합니다. ![gamepot-appleLogin06.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-appleLogin06.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A35Z&se=2026-11-14T07%3A18%3A35Z&sr=c&sp=r&sig=GfsxhTdobYj4IH8ff5F75DrmoJy3N3YG3dFkaTHwS04%3D) - **만들어놓은 APP ID가 없으실경우** 1-1. [Apple developer console](https://developer.apple.com/account/resources/identifiers/list) > Certificates, Identifiers & Profiles > Identifiers + 선택  ![gamepot-apple-Login02.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-apple-Login02.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A35Z&se=2026-11-14T07%3A18%3A35Z&sr=c&sp=r&sig=GfsxhTdobYj4IH8ff5F75DrmoJy3N3YG3dFkaTHwS04%3D) 1-2. Register a New Identifier > App IDs 를 선택하세요. ![gamepot-apple-Login03.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-apple-Login03.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A35Z&se=2026-11-14T07%3A18%3A35Z&sr=c&sp=r&sig=GfsxhTdobYj4IH8ff5F75DrmoJy3N3YG3dFkaTHwS04%3D) 1-3. Register an App ID의 Platform, Description(게임 Title), Bundle ID(Explicit)를 입력 후 Continue를 눌러주세요 ![gamepot-apple-Login05.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-apple-Login05.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A35Z&se=2026-11-14T07%3A18%3A35Z&sr=c&sp=r&sig=GfsxhTdobYj4IH8ff5F75DrmoJy3N3YG3dFkaTHwS04%3D) 1. Capabilities 탭의 **Sign In with Apple** 체크 > 오른쪽에 Edit 버튼을 클릭합니다. ![gamepot-appleLogin07.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-appleLogin07.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A35Z&se=2026-11-14T07%3A18%3A35Z&sr=c&sp=r&sig=GfsxhTdobYj4IH8ff5F75DrmoJy3N3YG3dFkaTHwS04%3D) 3. **Enable as a primary App ID** 선택 후, 저장합니다. ![gamepot-appleLogin04.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-appleLogin04.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A35Z&se=2026-11-14T07%3A18%3A35Z&sr=c&sp=r&sig=GfsxhTdobYj4IH8ff5F75DrmoJy3N3YG3dFkaTHwS04%3D) ### 2. Service ID / Callback URL 설정하기 1. [Apple developer console](https://developer.apple.com/account/resources/identifiers/list) > Certificates, Identifiers & Profiles > Identifiers에서 +버튼 클릭하여 **Services ID** 체크 후 Continue 버튼을 클릭합니다. ![gamepot-appleLogin09.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-appleLogin09.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A35Z&se=2026-11-14T07%3A18%3A35Z&sr=c&sp=r&sig=GfsxhTdobYj4IH8ff5F75DrmoJy3N3YG3dFkaTHwS04%3D) ![gamepot-appleLogin10.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-appleLogin10.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A35Z&se=2026-11-14T07%3A18%3A35Z&sr=c&sp=r&sig=GfsxhTdobYj4IH8ff5F75DrmoJy3N3YG3dFkaTHwS04%3D) 2. Description / Identifiers 입력 후 Continue 버튼 클릭 > Register 버튼 클릭하여 생성 완료합니다. - **Description** : 앱 타이틀 기재 - **Identifiers** : 애플로그인에 이용되는 거기때문에 Identifier는 구분하기 쉽도록 Bundle ID 기준으로 작성하시면 좋습니다. {예 :Bundle ID.webauth} ![gamepot-apple-Login09.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-apple-Login09.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A35Z&se=2026-11-14T07%3A18%3A35Z&sr=c&sp=r&sig=GfsxhTdobYj4IH8ff5F75DrmoJy3N3YG3dFkaTHwS04%3D) 3. 생성된 Services ID 선택 > **Sign In with Apple** 항목의 Configure 버튼을 클릭합니다. ![gamepot-apple-Login10.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-apple-Login10.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A35Z&se=2026-11-14T07%3A18%3A35Z&sr=c&sp=r&sig=GfsxhTdobYj4IH8ff5F75DrmoJy3N3YG3dFkaTHwS04%3D) 4. **Primary App ID** 항목에 사용할 앱을 선택하고, Website URLs 항목 옆의 +버튼을 클릭합니다. ![gamepot-appleLogin13.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-appleLogin13.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A35Z&se=2026-11-14T07%3A18%3A35Z&sr=c&sp=r&sig=GfsxhTdobYj4IH8ff5F75DrmoJy3N3YG3dFkaTHwS04%3D) 5. Register Website URLs 항목에 **게임팟 API 도메인**과 **Return URL** 를 입력합니다. 예시) Return URL 이 [https://gpapps.gamepot.ntruss.com/v1/auth/apple/callback/{projectid}] 일 경우 API 도메인은 [gpapps.gamepot.ntruss.com] 이 됩니다. ![gamepot-apple-Login11.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-apple-Login11.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A35Z&se=2026-11-14T07%3A18%3A35Z&sr=c&sp=r&sig=GfsxhTdobYj4IH8ff5F75DrmoJy3N3YG3dFkaTHwS04%3D) 1. 생성된 Services ID의 IDENTIFIER를 게임팟 대시보드 > 프로젝트 설정 > 일반 > Apple ID Login > Clien ID 항목에 추가합니다. ![console_apple07.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/console_apple07(1).png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A35Z&se=2026-11-14T07%3A18%3A35Z&sr=c&sp=r&sig=GfsxhTdobYj4IH8ff5F75DrmoJy3N3YG3dFkaTHwS04%3D) ### 3. Team ID 확인하기 - [Apple developer console](https://developer.apple.com/account) > account > 하단의 멤버십 세부사항에서 확인할 수 있습니다. ![gamepot-appleLogin21.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-appleLogin21.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A35Z&se=2026-11-14T07%3A18%3A35Z&sr=c&sp=r&sig=GfsxhTdobYj4IH8ff5F75DrmoJy3N3YG3dFkaTHwS04%3D) - 혹은 Certificates, Identifiers & Profiles 페이지의 우측 상단에서도 TeamId를 확인하실 수 있습니다. ![gamepot-apple-Team01.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-apple-Team01.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A35Z&se=2026-11-14T07%3A18%3A35Z&sr=c&sp=r&sig=GfsxhTdobYj4IH8ff5F75DrmoJy3N3YG3dFkaTHwS04%3D) ### 4. Key 설정하기 1. [Apple developer console](https://developer.apple.com/account/resources/authkeys/list) > Certificates, Identifiers & Profiles > Keys 에서 '+' 버튼을 클립합니다. ![gamepot-apple-Key01.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-apple-Key01.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A35Z&se=2026-11-14T07%3A18%3A35Z&sr=c&sp=r&sig=GfsxhTdobYj4IH8ff5F75DrmoJy3N3YG3dFkaTHwS04%3D) 1. Key Name 입력 > Sign in with Apple 체크 후 Configure 버튼을 클릭합니다. ![gamepot-apple-Key02png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-apple-Key02.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A35Z&se=2026-11-14T07%3A18%3A35Z&sr=c&sp=r&sig=GfsxhTdobYj4IH8ff5F75DrmoJy3N3YG3dFkaTHwS04%3D) 1. **Primary App ID** 항목에 사용할 앱을 선택하고, Save 버튼을 클릭합니다. ![gamepot-appleLogin17.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-appleLogin17.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A35Z&se=2026-11-14T07%3A18%3A35Z&sr=c&sp=r&sig=GfsxhTdobYj4IH8ff5F75DrmoJy3N3YG3dFkaTHwS04%3D) 1. Register 버튼 클릭 > **Download** 버튼을 클릭하여 .p8 파일을 다운로드 합니다. ![gamepot-appleLogin18.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-appleLogin18.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A35Z&se=2026-11-14T07%3A18%3A35Z&sr=c&sp=r&sig=GfsxhTdobYj4IH8ff5F75DrmoJy3N3YG3dFkaTHwS04%3D) 1. 다운로드 한 .p8 파일을 오픈하여 전체 내용을 복사하여 게임팟 대시보드 > 프로젝트 설정 > 일반 > Apple ID Login > Private Key 항목에 입력합니다. - 파일은 xcode 또는 메모장 등을 통해 오픈할 수 있습니다. ![console_apple08.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/console_apple08(1).png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A35Z&se=2026-11-14T07%3A18%3A35Z&sr=c&sp=r&sig=GfsxhTdobYj4IH8ff5F75DrmoJy3N3YG3dFkaTHwS04%3D){height="" width="50%"}' 1. 생성된 Key의 ‘Key ID’ 항목을 Apple ID Login > Key ID 항목에 입력합니다. ![gamepot-appleLogin20.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-appleLogin20.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A35Z&se=2026-11-14T07%3A18%3A35Z&sr=c&sp=r&sig=GfsxhTdobYj4IH8ff5F75DrmoJy3N3YG3dFkaTHwS04%3D) ### 5. 애플 영수증 검증 강화 게임팟 대시보드 > 프로젝트 설정 > 일반 > **애플스토어 결제 영수증 검증** ![console_apple09.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/console_apple09(1).png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A35Z&se=2026-11-14T07%3A18%3A35Z&sr=c&sp=r&sig=GfsxhTdobYj4IH8ff5F75DrmoJy3N3YG3dFkaTHwS04%3D) - 허용 번들 ID : 영수증 검증시 애플 영수증의 번들 ID ( XX.XX.XX ) 를 비교 하여 틀린 경우 불법 결제로 판단하고 결제 실패 처리합니다. => 필수 사항은 아니지만, 해외에서 불법 결제 사례가 많으므로 설정하시길 권장합니다. - 앱 공유 암호 : 해당 정보를 추가로 있으면 추가 페이크 결제 검증을 진행 후 맞지 않은 경우 결제 실패 처리 진행을 합니다. #### 앱 공유 암호(Apple Password) 확인 방법 1. 앱스토어 - 프로젝트 선택 - 앱 정보 - 앱 공유 암호 - 관리 글씨 클릭 ![gamepot-AppStore02.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-AppStore02.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A35Z&se=2026-11-14T07%3A18%3A35Z&sr=c&sp=r&sig=GfsxhTdobYj4IH8ff5F75DrmoJy3N3YG3dFkaTHwS04%3D) 2. 사용자 및 액세스 - 공유 암호 ![gamepot-AppStore03.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-AppStore03.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A35Z&se=2026-11-14T07%3A18%3A35Z&sr=c&sp=r&sig=GfsxhTdobYj4IH8ff5F75DrmoJy3N3YG3dFkaTHwS04%3D) ### 6. App Store 서버 알림 해당 부분은 결제 취소 정보를 가져올때 사용되는 용도로 게임팟 에서는 V1 알림 타입만 지원을 합니다. 알림 주소는 > 게임팟 대시보드 > 결제 > 결제 취소 > AppStore > 주소 복사 버튼 클릭 하면 관련 정보를 확보 가능합니다. ( 대시보드 리전에 따라 관련 주소가 달라집니다. ) ![console_apple10.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/console_apple10(1).png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A35Z&se=2026-11-14T07%3A18%3A35Z&sr=c&sp=r&sig=GfsxhTdobYj4IH8ff5F75DrmoJy3N3YG3dFkaTHwS04%3D) ![gamepot-AppStore13.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-AppStore13.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A35Z&se=2026-11-14T07%3A18%3A35Z&sr=c&sp=r&sig=GfsxhTdobYj4IH8ff5F75DrmoJy3N3YG3dFkaTHwS04%3D) ### 7. 인앱 결제 StoreKit 설정 1. SyncedProducts.storekit 이런 파일 만들어서 싱크합니다. ![gamepot-AppStore14.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-AppStore14.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A35Z&se=2026-11-14T07%3A18%3A35Z&sr=c&sp=r&sig=GfsxhTdobYj4IH8ff5F75DrmoJy3N3YG3dFkaTHwS04%3D) 2. Product -> Scheme -> Edit Scheme -> Run 에 StoreKit Configuration 에 연결되어 있는지 확인합니다. ![gamepot-AppStore15.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-AppStore15.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A35Z&se=2026-11-14T07%3A18%3A35Z&sr=c&sp=r&sig=GfsxhTdobYj4IH8ff5F75DrmoJy3N3YG3dFkaTHwS04%3D) - Root folder 에서 New File 한 후에 StoreKit 선택해서 만들면 됩니다.