From 38471e5d7b503431d3e1cb42ab2ad00a7e69844d Mon Sep 17 00:00:00 2001 From: intenscia Date: Sun, 7 Jul 2024 23:02:33 +1000 Subject: [PATCH] Fixed formatting issues --- public/en-us/console-platforms/apple.md | 15 ++++++++++++--- public/en-us/console-platforms/google.md | 18 ++++++++++++++---- 2 files changed, 26 insertions(+), 7 deletions(-) diff --git a/public/en-us/console-platforms/apple.md b/public/en-us/console-platforms/apple.md index 2a88276..862f2a0 100755 --- a/public/en-us/console-platforms/apple.md +++ b/public/en-us/console-platforms/apple.md @@ -28,29 +28,38 @@ It takes about 48 hours for your Apple developer account to be verified. Once it ### Setting up Apple SSO through the Apple Developer Account 1. Sign in to your Apple developer account and click on your **[account](https://developer.apple.com/account/)**. + ![apple_developer_account_settings.png](images/apple/apple_developer_account_settings.png) 2. In the **Certificates, Identifiers & Profiles** section, click on **[Identifiers](https://developer.apple.com/account/resources/identifiers/list)**. Click on the "+" button to create a new identifier and select the **App IDs** option. + ![apple_select_appid.png](images/apple/apple_select_appid.png) 3. Under register a new identifier, select **App** type and click on **Continue**. + ![apple_register_new_identifier.png](images/apple/apple_register_new_identifier.png) -4. Fill in the App ID Description and Bundle ID, then scroll down to the **Capabilities** section. Take note of the **Bundle ID** as you will need to [enter it on mod.io later](#modio-setup). Enable the **Sign in with Apple** capability and click on **Continue**. +4. Fill in the App ID Description and Bundle ID, then scroll down to the **Capabilities** section. Take note of the **Bundle ID** as you will need to [enter it on mod.io later](#configuring-your-games-apple-bundle-id-on-modio). Enable the **Sign in with Apple** capability and click on **Continue**. + ![apple_register_appid.png](images/apple/apple_register_appid.png) 5. Review the information and click on **Register**. A new App ID will be created, and you should be redirected back to the **identifiers** page. + ![apple_enable_signin_capability.png](images/apple/apple_enable_signin_capability.png) 6. Open your Xcode project and follow the steps [here](https://help.apple.com/xcode/mac/11.0/#/devaf282080a) to add your Apple Developer account to Xcode if it's not already connected. 7. Update the **Bundle Identifier** to match the one you created in the Apple Developer account. Update the **Team** to match your Apple Developer account. + ![apple_signin_capability_xcode.png](images/apple/apple_signin_capability_xcode.png) -8. Next, navigate to the **Signing & Capabilities** tab. Select your team and then click on the "+" button to add a new capability. +8. Next, navigate to the **Signing & Capabilities** tab. Select your team and then click on the "+" button to add a new capability. + ![apple_sso_setup_xcode_config.png](images/apple/apple_sso_setup_xcode_config.png) 9. Scroll down the list to locate the **Sign in with Apple** capability, click to add this to your project. Update your App ID in the **Signing & Capabilities** tab. + ![apple_xcode_enable_signin_capability.png](images/apple/apple_xcode_enable_signin_capability.png) ## Configuring your games Apple Bundle ID on mod.io 1. On the mod.io website, navigate to your [game's admin dashboard](https://mod.io/content) and go to the **Settings** tab. 2. Under **Admin > General Settings** find and click on the **Platform Authentication**. + ![modio_apple_sso_game_settings.png](images/apple/modio_apple_sso_game_settings.png) -3. Enter the **Bundle ID** of your app in the **Apple** field and **Save Changes**. +3. Enter the **Bundle ID** of your app in the **Apple** field and **Save Changes**. ## Sign in players to mod.io using Apple diff --git a/public/en-us/console-platforms/google.md b/public/en-us/console-platforms/google.md index 3d54ff4..b26096e 100755 --- a/public/en-us/console-platforms/google.md +++ b/public/en-us/console-platforms/google.md @@ -30,7 +30,7 @@ We require the following scopes to authenticate a user against your Google proje * openid :::note -Play games services version 2 (PGSV2) no longer supports additional OAuth2.0 scopes out of the box, therefore it is recommended to use Google sign-in SDK as outlined here: [OAuth scopes on PGSV2](https://developer.android.com/games/pgs/signin#oauth-scopes) and here: [OAuth scopes and PGSV1](https://developers.google.com/games/services/common/concepts/v1/sign-in#oauth-scopes). +Play games services version 2 (PGSV2) no longer supports additional OAuth2.0 scopes out of the box, therefore it is recommended to use Google sign-in SDK as outlined here: [OAuth scopes on PGSV2](https://developer.android.com/games/pgs/signin#oauth-scopes) and here: [OAuth scopes and PGSV1](https://developers.google.com/games/services/common/concepts/v1/sign-in#oauth-scopes). ::: To authenticate to mod.io via a Google Play account, we support the following credential flows: @@ -42,17 +42,22 @@ To authenticate to mod.io via a Google Play account, we support the following cr 1. Create or open a project on Google’s APIs Console: [Google API Console](https://console.cloud.google.com/).  2. Navigate to the OAuth consent screen page and fill out the App Information that will display on the consent screen for users of your Game. 3. Fill out the **App Information** section with your **App Name**, **User support email** and upload an **App logo**. + ![Google Cloud Console Oauth Consent Screen Step 1a](images/google/google_oauth_screen_app_info_section.png) 4. Next, fill out the **App domain** section by inserting your application homepage, privacy policy and terms of service URLs. + ![Google Cloud Console Oauth Consent Screen Step 1b](images/google/google_oauth_screen_app_domain.png) 5. Enter your developer contact information then, click **save and continue**. 6. Next, select the scopes required for your project by clicking **Add or Remove Scopes**, make sure you select .../auth/userinfo.email, .../auth/userinfo.profile, .../auth/games, .../auth/drive.appdata and .../auth/games_lite, openid then click **save and continue**. 7. Cross-check the OAuth consent screen page to verify that the information there is correct for your project.  -8. Navigate to the credentials page and create credentials, making sure you select OAuth Client ID as the credential type.   +8. Navigate to the credentials page and create credentials, making sure you select OAuth Client ID as the credential type. + ![Google Cloud Console Oauth client configuration screen](images/google/create_google_oauth_client.png) -9. Create an OAuth ClientID set application type as web application, add a name, and an authorised Redirect URI. Click create (note your Client ID, Redirect URI and Client Secret as these are required to [enter on mod.io later](#modio-setup)). +9. Create an OAuth ClientID set application type as web application, add a name, and an authorised Redirect URI. Click create (note your Client ID, Redirect URI and Client Secret as these are required to [enter on mod.io later](#configuring-your-games-google-client-id-secret-and-redirect-uri-on-modio)). + ![Google Cloud Console Oauth client configuration screen](images/google/google_create_oauth_web_application.png) 10. Create an OAuth ClientID for Android - select application type as Android from the dropdown, for the package name enter the name of your game as appears in your [AndroidManifest.xml](https://developer.android.com/guide/topics/manifest/manifest-intro) file, and [SHA-1 fingerprint](https://developers.google.com/android/guides/client-auth). + ![Google Cloud Console Android Oauth client configuration screen](images/google/google_setup_adroid_clientId.png) ### Setting Up Play Games Services @@ -60,20 +65,25 @@ To authenticate to mod.io via a Google Play account, we support the following cr 1. Navigate to the Google Play Console and sign in. 2. Create a game or select your app/game from the list of games ([official guide](https://support.google.com/googleplay/android-developer/answer/9859152)). 3. Within the console of your game, navigate to **Play Games Services > Setup and management > Configuration** tab. Select **Create new Play Games Services project** then use the dropdown to select the Google cloud project we set up in previous steps, or if you have and click **use**. + ![Google play games services configuration screen](images/google/google_play_games_services_configuration_screen.png) 5. Click on **Edit properties** and fill out the display name, description, category, icon, feature graphic and scroll down to make sure that the cloud project platform project is listed under **External Integrations** for your game, **save changes**. + ![Google play external integrations](images/google/google_play_console_external_integrations.png) 6. Click on **Add Credential** then select **Game Server**. On the following page, fill out the details and select the OAuth 2.0 client ID set up (on Step 4, previous section) **save changes**. + ![Google play external integrations](images/google/google_PGS_config_game_server_oauth_client.png)  7. Return to the play games services setup page and click on **Add Credential**, then select the **Android** option and the Android OAuth2.0 client ID from the dropdown (Step 5, previous section) **save changes**. + ![Google play external integrations](images/google/google_PGS_config_android_oauth_client.png) ## Configuring your games Google Client ID, Secret and Redirect URI on mod.io 1. On the mod.io website, navigate to your [game's admin dashboard](https://mod.io/content) and go to the **Settings** tab. 2. Under **Admin > General Settings** find and click on the **Platform Authentication**. + ![mod.io set up external authentication configuration screen](images/google/modio_setup_external_platform_authentication_settings_page.png) -3. Enter the **Google Client ID**, **Google Client Secret**, and **Google Redirect URI** and **Save Changes**. +3. Enter the **Google Client ID**, **Google Client Secret**, and **Google Redirect URI** and **Save Changes**. ## Sign in players to mod.io using Google