Skip to main content

AccelByte cloud integration

Last updated on

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 Authorizations and click the IAM Clients option from the dropdown.

    Namespace IAM Clients

  4. Click the Create New button.

    Create New IAM Clients

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

    Client type and client secret

warning

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

  1. Fill in the Redirect URI with this value:
https://blackbox.accelbyte.io/auth
  1. Fill in the Base URI with this value:
https://blackbox.accelbyte.io
![Fill redirect uri and base uri](/images/docs/developer-guides/06/01/fill-the-redirecturi-and-base-uri.png)

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

    IAM client successfully created

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.

    Add permissions

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

ADMIN:NAMESPACE:*:CLIENT

  1. Tick the Read checkbox.

    Filling the variable resources

  2. Click the Confirm button.

    Permissions is applied

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.

    Namespace setting

  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.

    Namespace setting

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

    AB cloud connected

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.

    ADT Games Setting

  4. Go to AGS Admin Portal and open your game namespace.

  5. Copy the namespace ID from the URL address. The namespace ID is the string after /namespaces/ in the URL.

    Justice namespace id

  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.

    Fill the value of AccelByte Game Namespace

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

    Success integrate AccelByte game namespace

Last updated on