Depois de receber uma confirmação de que a organização do Apigee foi provisionada, será possível adicionar
mais contas de usuário ao projeto do Google Cloud. Faça isso usando o serviço IAM
no Console do Google Cloud.
Nesta seção, descrevemos como adicionar novas contas de usuário ao seu projeto do Google Cloud e gerenciar o acesso delas.
Essas contas podem ter papéis especializados, como alguém que cria relatórios de análise ou
alguém que é responsável por implantar e remover os proxies de API. Para descrição dos papéis do Apigee, incluindo detalhes de acesso à API, consulte
Gerenciar usuários, papéis e permissões usando a API.
Em projetos pequenos, não adicione novos usuários. Para projetos maiores, é provável que
você adicione pelo menos um novo principal para cada papel da Apigee. Tente limitar o número de papéis de administrador
da organização da Apigee atribuídos porque esse papel tem o nível mais alto de permissões.
Para adicionar um usuário e atribuir papéis da Apigee a ele no seu projeto do Google Cloud:
No menu de navegação no canto superior esquerdo do console, selecione IAM e administrador > IAM.
O Console exibe a visualização Permissões:
Para adicionar um novo usuário, clique no botão ADICIONAR.
O Console exibe a visualização Adicionar principais:
No campo Novos principais, digite o endereço de e-mail da conta do novo usuário.
O endereço de e-mail precisa ser um dos seguintes tipos:
Uma Conta do Google (por exemplo, fred@gmail.com). Todas as contas do Gmail são
Contas do Google, mas você também pode registrar endereços de e-mail com domínios diferentes
como Contas do Google.
O nome de um Grupo do Google. Por exemplo, my-group@googlegroups.com. Se você adicionar um
Grupo do Google como usuário, todos os membros do grupo terão esse papel.
Uma conta de serviço. Por exemplo, my-service-account@example.gserviceaccount.com.
Não é necessário adicionar suas contas de serviço aqui.
Um domínio do Google Workspace. Por exemplo, address@example-domain.com, em que example.com é um
domínio que você usou ao se inscrever nos serviços do Google Cloud.
É possível especificar mais de um endereço de e-mail no campo Novos principais e
atribuir o mesmo papel a todos eles. Para atribuir papéis diferentes a endereços de e-mail diferentes,
execute as etapas 4 e 5 para cada novo principal.
Atribua pelo menos um papel aos novos principais:
Expanda a lista suspensa Selecione um papel.
Selecione o papel que você quer atribuir. Para decidir quais papéis atribuir, consulte as
descrições em Papéis da Apigee.
Para atribuir um papel da Apigee, é possível inserir Apigee como um filtro para que a lista suspensa
exiba apenas papéis da Apigee, como neste exemplo:
Repita esse processo para cada papel que você quiser atribuir ao usuário.
Clique em Salvar para adicionar o novo usuário ao projeto do Google Cloud com os papéis atribuídos.
Repita esse processo para cada usuário que você quiser adicionar.
O Google Cloud permite que os novos usuários do projeto acessem todos os ambientes na organização com as
permissões atribuídas. Para limitar o acesso de um usuário a determinados ambientes, use os componentes híbridos da IU, conforme
descrito em
Adicionar contas de usuário na IU.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-03 UTC."],[[["\u003cp\u003eThis guide explains how to add new user accounts to a Google Cloud project for Apigee and Apigee hybrid organizations using the IAM service in the Google Cloud console.\u003c/p\u003e\n"],["\u003cp\u003eNew users added to the project in the Google Cloud console can access all environments by default, though their actions are restricted by their assigned roles.\u003c/p\u003e\n"],["\u003cp\u003eYou can assign different roles to users, which are described in detail in the linked Apigee roles documentation, including specific permissions like deploying API proxies or creating analytics reports.\u003c/p\u003e\n"],["\u003cp\u003eTo add a user, you must enter their email address (Google account, Google group, service account, or Google Workspace domain) in the "New principals" field and select at least one role for them to have.\u003c/p\u003e\n"],["\u003cp\u003eFor more granular control over user access, you can set resource conditions for each assigned role or refine access at the environment level using the hybrid UI.\u003c/p\u003e\n"]]],[],null,["# Managing access in Google Cloud\n\n*This page\napplies to **Apigee** and **Apigee hybrid**.*\n\n\n*View [Apigee Edge](https://docs.apigee.com/api-platform/get-started/what-apigee-edge) documentation.*\n\nAfter you receive a confirmation that your Apigee organization has been provisioned, you can add\nmore user accounts to the Google Cloud project. You do this by using the IAM service\nin the Google Cloud console.\n\nThis section describes how to add new user accounts to your Google Cloud project and manage their access.\nThese user accounts might have specialized roles, such as someone who creates analytics reports or\nsomeone who is responsible for deploying and undeploying API proxies. For description of Apigee\nroles, including API access details, see\n[Manage users, roles, and permissions using the API](/apigee/docs/api-platform/system-administration/manage-users-roles).\n| **Note:** When you add new users to your project in the Google Cloud console, the new user can by default access *all* environments in the organization. They are still limited in what they can do by their roles, though. To refine each user's access, override their roles at the environment level in the UI.\n\nFor small projects, you might not add any new users. For larger projects, it's likely that\nyou'll add at least one new principal for each Apigee role. Try to limit the number of Apigee\nOrganization Admin roles you assign because this role has the highest level of permissions.\n\n**To add a user and assign Apigee roles to it in your Google Cloud project:**\n\n1. In the Google Cloud console, go to the **IAM \\& Admin \\\u003e IAM** page.\n\n [Go to IAM](https://console.cloud.google.com/iam-admin/iam)\n\n The Console displays the **Permissions** view:\n\n2. To add a new user, click **ADD** . The Console displays the **Add principals** view:\n\n3. In the **New principals** field, enter the email address of the new user's account.\n\n The email address must be one of the following types:\n - A [Google account](https://support.google.com/accounts/answer/27441) (for example, *fred@gmail.com*). All Gmail accounts are Google accounts, but you can also register email addresses with different domains as Google accounts.\n - The name of a Google group. For example, *my-group@googlegroups.com*. If you add a Google group as a user, then all members of the group will have that role.\n - A service account. For example, *my-service-account@example.gserviceaccount.com*. (You do not need to add your service accounts here.)\n - A Google Workspace domain. For example, *address@example-domain.com*, where example.com is a domain that you used when you signed up for Google Cloud services.\n\n You can specify more than one email address in the **New principals** field and\n assign the same role to all of them. To assign different roles to different email addresses,\n perform steps 4 and 5 for each new principal.\n4. Assign at least one role to the new principals:\n 1. Expand the **Select a role** list.\n 2. Select the role that you want to assign. To decide which roles to assign, see the descriptions in [Apigee roles](/apigee/docs/api-platform/system-administration/apigee-roles).\n 3. To assign an Apigee role, you can enter `Apigee` as a filter so that the list displays only Apigee roles, as the following example shows:\n\n 4. Repeat this process for each role you want to assign to the user.\n\n | **Note:** To enable granular control over your resources, you can specify resource conditions for each role. To understand how to specify resource conditions, see [Adding resource\n | conditions in IAM policies](/apigee/docs/api-platform/system-administration/add-iam-conditions). If you don't specify any resource conditions for a role, the role will have blanket permissions on all the child resources.\n5. Click **Save** to add the new user to the Google Cloud project with the assigned roles.\n6. Repeat this process for each user that you want to add.\n\nGoogle Cloud allows the project's new users to access all environments in the organization with the\nassigned permissions. To limit a user's access to certain environments, use the hybrid UI's, as\ndescribed in [Add user accounts in the UI](/apigee/docs/api-platform/system-administration/manage-users#add-user-accounts-in-the-hybrid-ui)."]]