Manage access in the GCP

After installation, your Google Cloud project has the following users associated with it:

After you receive a confirmation that your Apigee organization has been provisioned, you can add more user accounts to the Google Cloud Platform (GCP) project. You do this by using the IAM service in the GCP Console.

This section describes how to add new user accounts to your GCP project and manage their access. These user accounts might have specialized roles, such as someone who creates analytics reports or someone who is responsible for deploying and undeploying API proxies. For description of Apigee roles, including API access details, see Manage users and roles with the Apigee API.

For small projects, you might not add any new users. For larger projects, it’s likely that you’ll add at least one new member for each Apigee role. Try to limit the number of Apigee Organization Admin roles you assign because this role has the highest level of permissions.

To add a user and assign Apigee roles to it in your project:

  1. Open the Google Cloud Console and log in with your GCP account.
  2. Select your hybrid-enabled project.
  3. Select IAM & admin > IAM.

    The Console displays the Permissions view:

  4. To add a new user, click the +ADD button.

    The Console displays the Add members view:

  5. In the New members field, enter the email address of the new user’s account.

    The email address must be one of the following types:

    • A Google account (for example, All Gmail accounts are Google accounts, but you can also register email addresses with different domains as Google accounts.
    • The name of a Google group. For example, If you add a Google group as a user, then all members of the group will have that role.
    • A service account. For example, (You do not need to add your service accounts here.)
    • A G Suite domain. For example,, where is a domain that you used when you signed up for Google Cloud services.

    You can specify more than one email address in the New members field and assign the same role to all of them. To assign different roles to different email addresses, perform steps 4 and 5 for each new member.

  6. Assign at least one role to the new member(s):
    1. Expand the Select a role drop-down list.
    2. Select the role that you want to assign. To decide which roles to assign, see the descriptions in Apigee roles.
    3. To assign an Apigee role, you can enter “Apigee” as a filter so that the drop-down list displays only Apigee roles, as the following example shows:

    4. Repeat this process for each role you want to assign to the user.
  7. Click the Save button to add the new user to the GCP project with the assigned role(s).
  8. Repeat this process for each user that you want to add.

GCP now allows the project’s new users to access all environments in the organization with the assigned permissions. To limit a user's access to certain environments, use the UI, as described in Managing users in the UI.