Apple ID integration

Available in Classic and VPC

This is a console user guide for using the Apple ID login feature.

For instructions on using the console other than integrating with GAMEPOT, see the following:

• App Store Connect
• App Store Platform: URL: https://appstoreconnect.apple.com/

Apple sign-in

You must be enrolled in the Apple Developer program, and implementing Apple's web login feature involves a few key steps.
Apple's "Sign in with Apple" feature allows users to log in to your website or application using their Apple ID. This requires an Apple Developer account and requires some setup and code implementation.

Checkpoints before setting up console

1. Make sure that the "Paid Apps Agreement" is enabled in Tax and Banking > Agreements.
   

2. You must have a bank account listed in Tax and Banking > Bank Accounts that you can transact with.
   

3. In the far right side of the Apps > In-App Purchases > In-app purchase list, make sure it says "Ready to Submit."
   

Set up Apple Developer account

The following describes how to set up an Apple Developer account.

1. Log in to Apple Developer account: Log in to the Apple Developer website.
2. Register application: Register a new application in the "Certificates, Identifiers & Profiles" section. This is where you create the application bundle ID.
3. Create service ID: Create a new "Service ID" in the "Identifiers" section. This ID is used as the OAuth 2.0 client ID.
4. Set redirect URI: Add the URI to redirect users to after logging in in the Service ID setting.
5. Create key: Create a key to use the "Sign in with Apple" feature in the "Keys" section.

Register App Store login authentication information on GAMEPOT dashboard

The following describes how to register an App Store login authentication key to the dashboard.
Click the GAMEPOT dashboard > Project settings > Authentication > App Store menus, in that order.

Set Apple ID login

To use Apple ID login, you need to enter the following six items in the GAMEPOT dashboard > Project settings > Authentication > App Store.

1. Client ID (iOS)
2. Service ID (Android)
3. Callback URL (for OAuth)
4. Team ID
5. Upload key ID + private key
6. Scope

1. Set up client ID

The following describes how to set a client ID.

1. Check the identifier of the app you want to apply in Apple Developer Console > Certificates, Identifiers & Profiles > Identifiers, and enter it in the Client ID (iOS) field.
   

   • If you do not have an app ID, proceed as follows:
     1-1. In Apple Developer Console > Certificates, Identifiers & Profiles > Identifiers, select "+".
     

     1-2. Select Register a New Identifier > App IDs.
     

     1-3. Enter the Platform, Description (game title), Bundle ID (explicit) for Register an App ID and click Continue.
     

2. On the Capabilities tab, select Sign In with Apple, and click the [Edit] button on the right.
   
3. Select Enable as a primary App ID, and then save it.
   
4. After selecting the identifier of the app you want to apply, enter the Bundle ID in the GAMEPOT dashboard > Project settings > Authentication > App Store Client ID.
   

2. Set service ID/callback URL

1. In Apple Developer Console > Certificates, Identifiers & Profiles > Identifiers, click the + button to select Services ID, and then click the Continue button.
   

   

2. Enter Description and Identifiers, click the Continue button, and click the Register button to complete the creation.

   • Description: Enter the app title.
   • Identifiers: Identifiers are used for Apple login, so it is recommended to write them based on Bundle ID for easy identification. Example: Bundle ID.webauth
     

3. Select the generated Services ID, and then click the [Configure] button for the Sign In with Apple field.
   

4. Select the app you want to use for the Primary App ID field, and click the [+] button next to the Website URLs field.
   

5. Enter GAMEPOT API domain and Return URL in the "Register Website URLs" field.
   Example: If Return URL is "https://example.com/v1/provider/apple/callback/{projectid}," the API domain becomes "example.com."
   

6. Add the Return URLs you entered above to the GAMEPOT dashboard > Project settings > Authentication>App Store callback URL (for OAuth) field.

7. Add the identifier of the created Services ID to the GAMEPOT dashboard > Project settings > Authentication > App Store Service ID (Android) field.
   

3. Check team ID

• You can find it in Apple Developer Console > Account > Membership details at the bottom.
  
• You can also find your TeamId in the top right corner of the Certificates, Identifiers & Profiles page.
  

1. Enter the confirmed "Team ID" in the Team ID field of GAMEPOT dashboard > Project settings > Authentication > App Store.

4. Set up key

1. In Apple Developer Console > Certificates, Identifiers & Profiles > Keys, click the [+] button.
   

2. Enter Key Name, select Sign in with Apple, and then click the [Configure] button.
   

3. Select the app to use in the Primary App ID field, and then click the [Save] button.
   

4. Click the [Register] button, and then click the Download button to download the .p8 file.
   

5. Upload the downloaded .p8 file to the GAMEPOT dashboard > Project settings > General > Apple ID login > Private key field.

6. Enter the key ID field of the created key into the GAMEPOT dashboard > Project settings > Authentication > App Store Key ID field.
   

5. Scope

1. Enter name email in the Scope field of GAMEPOT dashboard > Project settings>Authentication > App Store.