Você está lendo a documentação do Apigee Edge.
Acesse a documentação da
Apigee X. info
Este tópico explica como criar e gerenciar usuários da organização. Você precisa ser um administrador da organização para realizar essas tarefas.
O que são usuários da organização?
Os usuários da organização recebem permissão explícita do administrador para criar, ler, editar e/ou excluir entidades em uma organização do Apigee Edge. As permissões são baseadas em papéis, em que um papel transmite um conjunto específico e direcionado de permissões. Esse esquema de permissões também é chamado de controle de acesso baseado em papéis, ou RBAC, na sigla em inglês.
Com quais entidades do Edge os usuários da organização trabalham?
Os usuários da organização interagem com várias entidades, incluindo:
- Proxies de API
- Produtos de API
- Apps para desenvolvedores
- Desenvolvedores
- Ambientes (sessões e implantações da ferramenta Trace)
- Relatórios personalizados (Analytics)
O grau de interação permitido depende da função ou das funções atribuídas ao usuário pelo administrador da organização. Consulte também Atribuição de papéis.
Como explorar a página "Usuários"
Acesse a página "Usuários", conforme descrito abaixo.
Edge
Para acessar a página "Usuários" usando a interface do Edge:
- Faça login em https://apigee.com/edge como um administrador da organização.
- Selecione Administrador > Usuários.
Se você não for administrador da organização, esse menu não estará disponível.
A página "Usuário" aparece, conforme mostrado na figura a seguir.
Conforme destacado na figura, a página "Usuários" permite que você:
- Confira os usuários atuais, incluindo nome, e-mail principal e funções. Por padrão, todos os usuários têm uma função que dá acesso total a todos os recursos da Apigee. Consulte também Atribuição de papéis.
- Adicionar um usuário
- Editar o perfil do usuário e as funções atribuídas
- Remover um usuário
Nova interface do Edge (nuvem privada)
Para acessar a página "Usuários" usando a nova interface do Edge:
- Faça login na nova interface do Edge em
http://host:3001/edgecomo um administrador da organização, em que host é o endereço IP ou o nome DNS do host que executa a nova interface do Edge. - Selecione Administrador > Usuários.
Se você não for administrador da organização, esse menu não estará disponível.
A página "Usuários" aparece, conforme mostrado na figura a seguir.

Conforme destacado na figura, a página "Usuários" permite que você:
- Confira os usuários atuais, incluindo nome, e-mail principal e funções. Por padrão, todos os usuários têm uma função que dá acesso total a todos os recursos da Apigee. Consulte também Atribuição de papéis.
- Adicionar um usuário
- Editar o perfil do usuário e as funções atribuídas
- Remover um usuário
Adicionar usuários
Para adicionar um usuário da organização:
- Acesse a página "Usuários"
- Clique em + Usuário.
A página "Novo usuário" é exibida.
- Insira o endereço de e-mail do usuário.
- Selecione os papéis que você quer atribuir ao usuário.
É possível adicionar mais de um papel a um usuário. - Clique em Salvar.
Se o usuário já tiver uma conta da Apigee, a nova organização vai aparecer depois que ele fizer login no Apigee Edge. Se o novo usuário ainda não tiver uma conta da Apigee, ele vai receber instruções por e-mail para ativação da conta, redefinição de senha e login.
Adicionar ou remover ZoneAdmin
A interface do Apigee Edge não permite adicionar administradores de zona. Para conceder ou revogar o acesso do ZoneAdmin usando a API Apigee, siga estas etapas:
- Use o utilitário get_token para receber o token.
- Exportar variáveis:
export TOKEN=token_from_above_step
export ENDPOINT=https://api.enterprise.apigee.com
export ORG=apigee_organization_name
export EMAIL=apigee_username
- Adicione o usuário à função ZoneAdmin:
curl -X POST -i -d '{"role" : [ {"name" : "zoneadmin"} ] }' "$ENDPOINT/v1/o/$ORG/users/$EMAIL/userroles" -H "Content-type:application/json" -H "Authorization: Bearer $TOKEN"
- Verifique a função do usuário:
curl -i "$ENDPOINT/v1/users/$EMAIL/userroles" -H "Content-type:application/json" -H "accept: application/json;charset=utf-8" -H "authorization: Bearer $TOKEN"
- Para remover o ZoneAdmin adicionado anteriormente:
curl -X DELETE -i -d '{"role" : [ {"name" : "zoneadmin"} ] }' "$ENDPOINT/v1/o/$ORG/userroles/zoneadmin/users/$EMAIL" -H "Content-type:application/json" -H "Authorization: Bearer $TOKEN"
Verificar ZoneAdmin
Para verificar se a função ZoneAdmin existe na sua organização, um usuário com a função de administrador da organização pode executar a seguinte chamada de gerenciamento de API:
curl -H "Authorization: Bearer $TOKEN" 'https://api.enterprise.apigee.com/v1/o/org-name/userroles/zoneadmin'
Se o papel existir, você verá a seguinte saída:
{
"name" : "zoneadmin"
}
Se a função não existir, você vai ver a seguinte saída:
{
"code" : "usersandroles.UserRoleDoesNotExist",
"message" : "Userrole zoneadmin does not exist",
"contexts" : [ ]
}
Se a função ZoneAdmin não existir na sua organização, entre em contato com o suporte da Apigee para criar a função. Os usuários administradores da organização não têm as permissões necessárias para criar a função ZoneAdmin e, portanto, não podem adicionar usuários a ela se ela não estiver presente.
Editar um perfil de usuário e as funções atribuídas
É possível editar um perfil de usuário e adicionar uma ou mais funções a um usuário ao criar um novo usuário ou editar um usuário existente. Consulte também Atribuição de papéis.
Para editar um perfil de usuário e as funções atribuídas:
- Acesse a página "Usuários"
- Clique no nome de um usuário.
- Clique em Editar.
- Você só pode modificar seu nome e sobrenome, não os de outros usuários.
- Adicione ou remova papéis:
- Para adicionar uma função, clique no campo Funções e selecione uma nova opção no menu suspenso.
- Para remover uma função, clique no "x" associado a ela.
- Repita a etapa anterior para adicionar outras funções, se quiser.
- Clique em Salvar.
Remover usuários de uma organização
Para remover um usuário de uma organização, você precisa ser um administrador dela.
- Acesse a página "Usuários"
- Clique em Remover na coluna "Ações" associada ao usuário que você quer remover.
Para remover um usuário da Apigee completamente, entre em contato com o suporte da Apigee.