Skip to main content

Create a new role

Last updated on March 14, 2024

Overview

This article contains information on how to create a new role in your environment using the AccelByte Gaming Services (AGS) Admin Portal.

Prerequisites

  • You have access to the Admin Portal and have sufficient permissions for roles management.
AGS Starter

The ability to create a new role will be available soon.

Required permissions

Make sure your account has the following permissions before you attempt to manage roles in the Admin Portal.

UsageResourceAction
Create RoleADMIN:ROLECreate
Add Role PermissionsADMIN:ROLEUpdate
Invite User AdminADMIN:NAMESPACE:{namespace}:USER:INVITECreate
Admin Add User's RoleADMIN:NAMESPACE:{namespace}:ROLE:USER:Update

Create a new role

Follow the steps below to create a new role:

  1. In the Admin Portal, open the Platform Configurations dropdown in the top-right corner of the page and select the Roles menu.

    Roles

  2. On the Roles page, click Create New.

    Create a New Role 1

  3. Choose whether to clone an existing role or to create a new role from scratch.

    info

    The system default prompts you to clone an existing role. This enables you to quickly create new roles that carry over all the permissions from the cloned role.

    • To clone an existing role, fill in the Create New Role fields with the following information:

      • Type in a name for the role in the Role Name field.
      • Select the existing role that you want to clone from the Select Role dropdown.

    Create a New Role 2

    • To create a new role without cloning, select the I want to create a new role from scratch checkbox and fill in the fields with the following information:

      • Type in a name for the role in the Role Name field.
      • Select the Set as Admin Role checkbox if you want your role to have access to the Admin Portal.
      • Select the Set as Global Role checkbox if you want your role to be able to access all namespaces.

    Create a New Role 3

  4. Click Create.

You've successfully created a new role in your environment. You can now add permissions to it or assign in to a user.

What's next