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.

Sobre o escopo do papel

É possível adicionar usuários a organizações da Apigee usando o console do 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 IU, você precisa conceder a esse usuário o acesso ao Google Cloud projeto, 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 suspensa de papéis exibe 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

Observação: há uma nova versão da IU da Apigee, que está integrada ao console do Google Cloud. A nova interface é chamada de Apigee no console do Cloud. As instruções nas duas primeiras guias abaixo explicam como usar a Apigee no console do Cloud ou a Apigee clássica.

Apigee no console do Cloud

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. Abra a interface da Apigee no console do Cloud em um navegador.
   Note: If you see the message below at the top of the UI, you need to provision your Apigee organization before proceeding further.

   

   Depois de provisionar a Apigee, feche a interface e reabra a interface da Apigee no console do Cloud.

3. No painel de navegação à esquerda, clique em Gerenciamento > Ambientes.
4. Na lista de ambientes disponíveis, selecione o que você quer editar.
5. 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.

6. Clique em +Conceder acesso.

   O painel Conceder acesso será exibido.

7. 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.
8. Selecione um papel na lista suspensa Papéis 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.
9. Clique em Conceder.
10. 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.

Apigee clássica

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. Abra a IU da Apigee em um navegador.
3. Selecione Admin > Environments > Access no menu de navegação à esquerda.
4. Selecione o nome do ambiente na lista suspensa.

   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 ao ambiente exibe o seguinte:

   

6. Digite o endereço de e-mail da conta do usuário no primeiro campo. Esse endereço de e-mail geralmente é um dos seguintes:
   • Uma Conta do Google (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 um papel na lista suspensa Papel e clique em Adicionar. É 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. 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 IU. 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.

Apigee no console do Cloud

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

1. Abra a interface da Apigee no console do Cloud em um navegador.
2. No painel de navegação à esquerda, clique em Gerenciamento > Ambientes.
3. Na lista de ambientes disponíveis, selecione o 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. Na linha do usuário, clique no menu de três pontos em Ações e selecione Remover.

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

6. 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.

Apigee clássica

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

1. Abra a IU da Apigee em um navegador.
2. Selecione Admin > Environments > Access no menu de navegação à esquerda.
3. Selecione o nome do ambiente na lista suspensa.

   A IU exibe uma lista de usuários atuais para o ambiente selecionado.

4. Na linha do usuário, clique em Excluir.

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

   

5. Clique em Revogar.

   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.

Alterar papéis de usuário na IU

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

Apigee no console do Cloud

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

1. Abra a interface da Apigee no console do Cloud em um navegador.
2. No painel de navegação à esquerda, clique em Gerenciamento > Ambientes.
3. Na lista de ambientes disponíveis, selecione o 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. Na linha do usuário, clique no menu de três pontos em Ações e selecione Editar.

   A IU exibe o painel Gerenciar papéis.

6. 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.
7. Clique em OK.
8. 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.

Apigee clássica

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

1. Abra a IU da Apigee em um navegador.
2. Selecione Admin > Environments > Access no menu de navegação à esquerda.
3. Selecione o nome do ambiente na lista suspensa.

   A IU exibe uma lista de usuários atuais para o ambiente selecionado.

4. Na linha do usuário, clique em Editar.

   A IU exibe a caixa de diálogo Manage Roles:

   

5. Escolha uma destas opções:
   1. Para remover um papel: clique em Cancelar ao lado dele.
   2. Para alterar um papel: selecione um novo papel na lista suspensa de papéis.
   3. Para adicionar outro papel: clique em Adicionar outro papel.
6. Clique em Aplicar.

   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.