Manage user accounts
Overview
User accounts allow people to access your platform. This includes not only your players, but also anyone at your organization who has access to the Admin Portal. This guide shows you how to manage user accounts in the AccelByte Gaming Services (AGS) Admin Portal.
Prerequisites
You will need access to the AGS Admin Portal and the permissions for user management to complete the steps in this article.
To manage the admin accounts in AGS Shared Cloud, you can go to Admin Task > Admin Management in your studio namespace.
Search for a user
The following outlines how to search for a user to manage.
AGS Shared Cloud (search)
In your studio namespace of the AGS Admin Portal, go to Admin Task > Lookup Users.
Select the search filter from the dropdown menu and type the user's credentials into the text box. Then, press Enter to search. The search results will appear.
If you choose to search for a player using third-party platform credentials (e.g., a Steam or Epic Games account), two new dropdown menus will appear. From the first dropdown menu, select the third-party platform your player comes from. In the second dropdown menu, you can select Platform User ID.
AGS Private Cloud (search)
In the desired namespace of the Admin Portal, go to Live Service Utilities > Lookup Users.
Select the search filter from the dropdown menu in the Search User panel that corresponds to the user's account information that you have on hand.
Then, type the user's credentials into the text box and press Enter to search. The search results will appear.
If you choose to search for a player using third-party platform credentials, two new dropdown menus will appear. From the first dropdown menu, select the third-party platform your player comes from, such as Steam or Epic Games. In the second dropdown menu, select either Platform Display Name or Platform User ID, depending on which credentials you have.
Invite an admin user
The following outlines how to invite a user to be an admin.
AGS Shared Cloud (invite admin)
In your studio namespace of the AGS Admin Portal, go to Admin Tasks > Admin Management and click Invite Admin.
Use the information below to fill out the Invite Admin form that appears:
Email Address: Enter the email address of each person you wish to give admin access to. You can invite more than one user at once by pressing Enter or Tab on your keyboard, or by separating each address by a comma.
Choose Roles: Choose the role(s) that you want the new admins to have. There will be three admin roles to choose from:
Studio Admin: If the inviter's role is Game Admin or View Only, they can't choose to grant a Studio Admin role. The Studio Admin role has the following capabilities:
- Full access to the studio namespace and all associated game namespaces
- The ability to invite team members to the studio namespace and all associated game namespaces
- The ability to assign and revoke roles for all users
Game Admin: The Game Admin role has the following capabilities:
- Access to specific game namespaces.
- The ability to invite users to specific game namespaces
- The ability to assign and revoke roles for users within the assigned game namespace(s)
View Only: The View Only role has access to view specific game namespaces, but does not have any role management capabilities.
Select Namespace: Select the checkbox next to each namespace you want the new admins to have access to.
noteIf the inviter chooses the Studio Admin role, there will be no field to select namespaces, as a Studio Admin has access to all of the game namespaces associated with the studio namespace.
When you're finished, click Invite, and the invitations will be sent to the email addresses you provided.
The invitation email is only valid for 24 hours by default. If the invited admin user does not complete account registration within 24 hours of receiving the email, you'll need to send them a new invitation.
AGS Private Cloud (invite admin)
You can also quickly invite your colleagues or community managers from your game to the Admin Portal. To do so, follow the steps below:
In the desired namespace of the Admin Portal, go to Admin Task > Admin Management.
On the Admins page, click the Invite Admin button. The Invite Admin form appears.
Fill in the fields with the following information:
In the Email Address field, enter the email address for each person that you wish to give admin access to. You can invite more than one user at once by pressing enter, tab, or comma on your keyboard to separate each email address.
In the Roles field, choose the roles that you want the new admins to have.
The Namespace field appears after you select your roles. In this field, select the checkbox next to each namespace you want the new admins to have access to.
noteThe Namespace field won't appear if you chose a global role in the previous step as global roles can access all namespaces.
When you're finished, click the Invite button. Invitations will be sent to the email addresses you provided.
noteThe invitation email is only valid for 24 hours by default. If the invited admin user does not complete account registration within 24 hours of receiving the email, you'll need to send them a new invitation.
Delete assigned admin role
The following outlines how to delete an admin role assigned to a user.
AGS Shared Cloud (delete role)
- In the your studio namespace of the AGS Admin Portal, go to Admin Tasks > Admin Management.
- Select the appropriate search filter from the dropdown menu, type the user's credentials into the text box, and press Enter. Click View next to the desired search result.
- On the details page, click Delete next to the role you'd like to delete from the account. Click Delete again on the pop-up that appears to confirm.
AGS Private Cloud (delete role)
- In your publisher namespace of the AGS Admin Portal, go to Live Service Utilities > Lookup Users.
- Select the appropriate search filter from the dropdown menu, type the user's credentials into the text box, and press Enter. Click View next to the desired search result.
- On the details page, click Delete next to the role you'd like to delete from the account. Click Delete again on the pop-up that appears to confirm.
Change a user's email address
You can follow the procedure below to change any user's email address, including your own:
In the Admin Portal, go to Live Service Utilities > Lookup Users.
Select the search filter from the dropdown menu in the Search User panel that corresponds to the player's account information that you have on hand. Then type that information in the text box and press enter on your keyboard to search.
noteFuzzy search is allowed here, so you can find the player you're looking for by typing just the first few characters of the player's credentials that you have.
The results of your search will appear. Browse the list to find the account you're looking for and click View in the Action column of the account listing to open it.
The User Overview will appear, giving you a quick look at the user's account data. Click Change under the user's email address to change it.
To change a user's email address, first you'll need to verify your identity. In the Change User's Email confirmation box that appears, click the Send Verification Code button to send a verification code to the email address with which you're logged into the Admin Portal.
The Change User's Email confirmation box changes to show two forms. Enter the verification code that was sent to your email address in the Verify your identity field, and enter a new email address for the user in the Set new email address for the user field. Once you're done, click the Confirm button.
You'll be redirected back to the User Overview page. The user will be sent a verification message to their old email address. After the user confirms the update, their email address will be changed automatically.
Link a third-party account
Use the following procedure to link third-party accounts.
Search the target user and go to the User Overview page. Select the Linked Accounts tab.
On the Linked Accounts tab, click the Link an Account button.
The Link an Account popup will appear. Fill in the following information:
In the Platform ID field, select the desired third-party platform from the dropdown menu.
Fill the Platform User ID with the player's account ID.
Once completed, click Link.
The new linked account will be added to the Linked Accounts list.
Unlink a third-party account
Search the target user and go to the User Overview page. Select the Linked Accounts tab.
On the Linked Accounts tab, select the third-party account you want to unlink and click Unlink under the Action column. The Delete Item confirmation message appears.
Click Unlink to proceed. The selected third-party account will be removed from the list.