--- title: "애플 아이디 연동" slug: "game-gamepot3-apple-integration" tags: ["GAMEPOT 3.0"] updated: 2026-09-17T09:07:47Z published: 2026-09-17T09:07:47Z canonical: "guide.ncloud-docs.com/game-gamepot3-apple-integration" --- > ## 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. # 애플 아이디 연동 Classic/VPC 환경에서 이용 가능합니다. 애플 아이디 로그인 기능을 사용하기 위한 콘솔 사용 가이드입니다. 게임팟 연동 이외 콘솔 사용법은 다음을 참조해 주십시오. - [App Store Connect](https://appstoreconnect.apple.com/login) - App Store Platform: [URL: 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 Developer 계정 설정 Apple Developer 계정 설정 방법은 다음과 같습니다. 1. **Apple Developer 계정에 로그인**: [Apple Developer](https://developer.apple.com/) 웹사이트에 로그인해 주십시오. 2. **애플리케이션 등록**: 'Certificates, Identifiers & Profiles' 섹션에서 새로운 애플리케이션을 등록해 주십시오. 여기서 애플리케이션 번들 ID를 생성합니다. 3. **Service ID 생성**: 'Identifiers' 섹션에서 새로운 'Service ID'를 생성해 주십시오. 이 ID는 OAuth 2.0 클라이언트 ID로 사용됩니다. 4. **리다이렉트 URI 설정**: Service ID 설정에서 로그인 후 사용자를 리다이렉트할 URI를 추가해 주십시오. 5. **Key 생성**: 'Keys' 섹션에서 'Sign in with Apple' 기능을 사용하기 위한 Key를 생성합니다. ## GAMEPOT 대시보드에 App Store 로그인 인증정보 등록 App Store 인증 키를 대시보드에 등록하는 방법은 다음과 같습니다. GAMEPOT 대시보드 > **프로젝트 설정** > **인증** > **App Store** 메뉴를 차례대로 클릭해 주십시오. ![gamepot-apple-Login01.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-apple-Login01.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 로그인 설정 Apple ID 로그인을 사용하시려면 GAMEPOT 대시보드 > 프로젝트 설정 > 인증 > App Store에서 총 6가지 항목에 대해 입력해주시면 됩니다. ![gamepot-apple-Login14.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-apple-Login14.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 (iOS) 2. Service ID (Android) 3. Callback URL (for OAuth) 4. Team ID 5. KEY ID + Private Key 업로드 6. Scope ### 1. Client ID 설정 Client ID를 설정하는 방법은 다음과 같습니다. 1. [Apple developer console](https://developer.apple.com/account/resources/identifiers/list) > **Certificates, Identifiers & Profiles** > **Identifiers** 에서 적용하려는 앱의 IDENTIFIER를 확인한 후 Client ID (iOS) 항목에 입력해 주십시오. ![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) 2. 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) 4. 적용하려는 앱의 IDENTIFIER 선택한 후 **Bundle** **ID** 를 GAMEPOT 대시보드 > **프로젝트 설정** > **인증** > App Store **Client ID** 에 입력해 주십시오. ![gamepot-apple-Login13.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-apple-Login13.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://example.com/v1/provider/apple/callback/{projectid}'일 경우 API 도메인은 'example.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) | 리전 | Return URL | | --- | --- | | KR | https://gpapps.gamepot.ntruss.com/v1/provider/apple/callback/{projectId} | | JP | https://gamepot.apigw.ntruss.com/gpapps/jp-v1/v1/provider/apple/callback/{projectId} | | SG | https://gamepot.apigw.ntruss.com/gpapps/sg-v1/v1/provider/apple/callback/{projectId} | 1. 위에서 입력했던 Return URLs은 GAMEPOT 대시보드 > **프로젝트 설정** > **인증** >**App Store Callback URL (for OAuth)** 항목에 추가해 주십시오. 2. 생성된 Services ID의 IDENTIFIER를 GAMEPOT 대시보드 > **프로젝트 설정** > **인증** > App Store **Service ID (Android)** 항목에 추가해 주십시오. ![gamepot-apple-Login12.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-apple-Login12.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) 1. 확인된 'Team ID' 을 GAMEPOT 대시보드 > **프로젝트 설정** > **인증** > App Store의 **Team ID** 항목에 입력합니다. ### 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) 2. **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) 3. **[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) 4. 다운로드 한 .p8 파일은 GAMEPOT 대시보드 > **프로젝트 설정** > **일반** > **Apple ID Login** > **Private Key** 항목에 업로드해 주십시오. 5. 생성된 Key의 Key ID 항목을 GAMEPOT 대시보드 > **프로젝트 설정** > **인증** > App Store **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. Scope 1. GAMEPOT 대시보드 > **프로젝트 설정**> **인증** > App Store의 **Scope** 항목에는 **name email** 를 입력해 주십시오. ![gamepot-apple-Login15.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-apple-Login15.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)