AccelByte cloud integration

Last updated on November 15, 2024

Overview

You can integrate your AccelByte Cloud account with AccelByte Developer Toolkit (ADT) Web, enabling you to access more information about user sessions such as telemetry data. You can also log in to ADT Web with AccelByte Gaming Services (AGS) credentials and then launch the game from ADT Web without having to repeat logging in to the game.

Prerequisites

You need to have access to the AGS Admin Portal and ADT Web.

Instructions

To integrate your AGS and ADT accounts, complete these steps:

Create an IAM client

To create an Identity and Access Management (IAM) client in the AGS Admin Portal, follow these steps:

1. Go to the AGS Admin Portal.

2. Change the namespace to your Publisher namespace.

3. On the sidebar, select Game Setup > Games and Apps > IAM Clients.

   

4. Click the Create New button.

   

5. Change the Client Type to Confidential and click Generate Client Secret.

   

danger

Once the client secret is successfully created, you can't access the secret anymore. Ensure that you save the secret in a secure place.

6. Fill in the Redirect URI with this value:

https://blackbox.accelbyte.io/auth

7. Fill in the Base URI with this value:

https://blackbox.accelbyte.io

8. Click the Create button. The details of the newly created client display.

   

Set up the IAM client permissions

You need to add permissions to your newly created IAM client to work properly. Follow the instructions below:

1. On the details page of the new IAM Client, open the Permissions tab.

2. Click the + Add button to add a new permission.

   

3. Type in the following variables in the Resources field box.

ADMIN:NAMESPACE:*:CLIENT

4. Tick the Read checkbox.

   

5. Click the Confirm button.

   

Set up the new IAM client login in ADT

You need to log in as an Admin to do this.

1. In the Namespace dropdown, find and open your Namespace Area.

   

2. Click the Integrations menu on the sidebar.

3. Select AccelByte Cloud.

4. Complete the fields as follows:

   • AccelByte Cloud Base URL - Refers to the URL where AccelByte cloud deploys. Fill in the URL without a slash / at the end of it.

   • Publisher Namespace - Refers to the namespace of your company in the AGS Admin Portal.

   • Client ID and Client Secret - Refers to the IAM Client ID and Secret of the client you created in the AGS Admin Portal.

   

5. Click the Save Changes button. The status will be changed to Connected and a Revoke access button will be active.

   

Link your ADT games to the AccelByte Games Namespace

Once you have successfully integrated your AGS publisher namespace with the ADT namespace, you will also need to integrate the game namespaces. Your ADT games and AccelByte Cloud games can be linked by going to game settings found on the sidebar.

1. Log in to ADT Web.

2. Click on the Game Settings menu on the sidebar.

3. Select the AccelByte Game Namespace option.

   

4. Go to AGS Admin Portal and open your namespace setting then find your game namespace, click on the setting icon, then select edit from the dropdown, you will then find the game namespace ID.

   

5. You can also just go to your game namespace and then copy the namespace ID from the URL address. The namespace ID is the string after /namespaces/ in the URL.

   

6. Return to the ADT tab and paste the namespace ID into the Game Namespace field.

7. Go back to the Admin Portal and open the IAM details of the game.

8. Copy the Client ID and Redirect URI. Then, paste the values into the Client ID and Redirect URI fields, respectively.

   

9. Click the Save Changes button. The status will changed to Connected and the Revoke access button will be active.