Gerenciar usuários na interface da Apigee

Esta página se aplica à Apigee e à Apigee híbrida.

Confira a documentação da Apigee Edge.

Neste tópico, descrevemos como adicionar usuários a um ambiente, remover usuários de um ambiente e atualizar papéis de usuários em um ambiente usando a interface da Apigee.

Sobre o escopo do papel

É possível adicionar usuários a organizações da Apigee usando o console Google Cloud . Ao fazer isso, o usuário recebe o mesmo acesso a todos os ambientes na organização. No entanto, é possível refinar o acesso de cada usuário usando a IU da Apigee.

A IU da Apigee permite atribuir papéis a usuários específicos de um determinado ambiente. Em vez de cada usuário ter o mesmo papel em todos os ambientes de uma organização, é possível atribuir um ou mais papéis específicos a ele para cada ambiente.

Ao configurar a Apigee pela primeira vez e criar o projeto do Google Cloud ao qual a organização da Apigee está vinculada, você normalmente adiciona alguns usuários com papéis diferentes, como API Admin e Environment Admin. Como esses usuários são definidos no nível do projeto do Cloud, eles podem acessar todos os ambientes com os papéis concedidos.

Se você conceder acesso usando a IU da Apigee, poderá definir papéis de usuários no nível do ambiente.

Observação:antes de adicionar um novo usuário (e especificar o acesso específico ao ambiente para ele) na UI da Apigee, é preciso conceder a esse usuário o acesso ao projeto do Google Cloud, conforme descrito em Como gerenciar o acesso no Google Cloud.

Os papéis atribuídos no projeto do Google Cloud se aplicam a todos os ambientes. Os papéis atribuídos na IU se aplicam somente ao ambiente selecionado.

A lista de papéis mostra apenas os papéis predefinidos.

Observação: os papéis atribuídos a ambientes específicos, conforme explicado neste tópico, só afetam os recursos que estão na hierarquia de recursos que inclui recursos do ambiente da Apigee. Para identificar quais recursos estão na hierarquia de recursos do ambiente, consulte a documentação da API Apigee. Por exemplo, o recurso organizations.environments.deployments está na hierarquia de recursos Environments.

Para todas as outras permissões de acesso a recursos da Apigee, consulte Como gerenciar o acesso no Google Cloud.

Adicionar contas de usuário na interface da Apigee

Para especificar permissões de usuário para um ambiente, faça o seguinte:

1. Verifique se você já adicionou o usuário ao projeto do Google Cloud. Para mais informações sobre como adicionar usuários a um projeto do Google Cloud, consulte Como conceder, alterar e revogar o acesso a recursos.

2. No console do Google Cloud , acesse a página Gerenciamento > Ambientes.

   Acessar "Ambientes"

   Note: se a mensagem abaixo for exibida na parte superior da IU, você vai precisar provisionar sua organização da Apigee antes de continuar.

   

   Depois de provisionar a Apigee, feche e reabra a UI.

3. Na lista de ambientes disponíveis, selecione aquele que você quer editar.
4. Clique na guia Acesso na página Detalhes do ambiente.

   A IU exibe uma lista de contas e papéis de usuário atuais para o ambiente selecionado.

5. Clique em +Conceder acesso.

   O painel Conceder acesso será exibido.

6. Digite a conta de e-mail do usuário no primeiro campo. Esse endereço de e-mail geralmente é um dos seguintes:
   • Uma Conta do Google individual (por exemplo, [e-mail]). Todas as contas do Gmail são do Google, mas também é possível registrar endereços de e-mail com domínios diferentes como contas do Google.
   • Um alias de Grupo do Google. Por exemplo, [e-mail]
   • Uma conta de serviço. Por exemplo, [e-mail]
   • Um domínio do Google Workspace. Por exemplo, [e-mail], em que example.com é um domínio usado quando você se assinou os serviços do Google Cloud.
7. Selecione uma função na lista Funções e clique em OK. É possível adicionar mais de um papel a cada usuário. Para detalhes sobre os papéis disponíveis, consulte Papéis da Apigee e Referência de permissões do IAM.
8. Clique em Conceder.
9. Repita esse processo para cada ambiente em que você queira especificar o papel do usuário.

É possível remover uma conta de usuário de um ambiente usando a interface. No entanto, essa conta de usuário ainda terá o acesso concedido no Console do Google Cloud, a menos que você também remova o usuário do Console por padrão.

remover contas de usuário;

A remoção de um usuário no nível do ambiente não remove o usuário do nível de projeto do Google Cloud. Como resultado, o usuário ainda pode acessar todos os ambientes com as permissões de nível de projeto do Google Cloud.

Para revogar totalmente o acesso do usuário, é necessário removê-lo do projeto do Google Cloud, conforme descrito em Como revogar o acesso ao Google Cloud Platform.

Para remover um usuário de um ambiente, faça o seguinte:

1. No console do Google Cloud , acesse a página Gerenciamento > Ambientes.

   Acessar "Ambientes"

2. Na lista de ambientes disponíveis, selecione aquele que você quer editar.
3. Clique na guia Acesso na página Detalhes do ambiente.

   A IU exibe uma lista de contas e papéis de usuário atuais para o ambiente selecionado.

4. Na linha do usuário, clique em Ações e selecione Remover.

   A IU exibe uma caixa de diálogo de confirmação.

5. Clique em Remover acesso.

   A IU remove esse usuário do ambiente.

   Observação: a remoção de um usuário no nível do ambiente não o remove do nível de projeto do Google Cloud. Para remover totalmente um usuário, também é preciso removê-lo do projeto do Google Cloud usando o Console, conforme descrito em Como revogar o acesso ao Google Cloud Platform.

Mudar papéis de usuário na interface da Apigee

É possível mudar o papel de um usuário em cada ambiente usando a IU da Apigee. Isso inclui adicionar outros papéis a uma conta de usuário ou remover um ou mais papéis da conta do usuário.

Para alterar os papéis de um usuário para um ambiente, faça o seguinte:

1. No console do Google Cloud , acesse a página Gerenciamento > Ambientes.

   Acessar "Ambientes"

2. Na lista de ambientes disponíveis, selecione aquele que você quer editar.
3. Clique na guia Acesso na página Detalhes do ambiente.

   A IU exibe uma lista de contas e papéis de usuário atuais para o ambiente selecionado.

4. Na linha do usuário, clique em Ações e selecione Editar.

   A IU exibe o painel Gerenciar papéis.

5. Escolha uma destas opções:
   1. Para remover uma função: desmarque a caixa de seleção ao lado dela.
   2. Para adicionar outro papel: marque a caixa de seleção ao lado do papel que você quer adicionar.
6. Clique em OK.
7. Clique em Atualizar.

   A IU aplica suas alterações ao usuário nesse ambiente.

   Observação: a alteração de papéis no nível do ambiente não afeta os papéis do usuário no nível de projeto do Google Cloud. Para informações sobre como alterar papéis no nível de projeto do Google Cloud, consulte Como conceder, alterar e revogar o acesso a recursos.