Como gerir contas de utilizador na Gestão de API do Azure
APLICA-SE A: Developer | Básico | Básico v2 | Padrão | Padrão v2 | Prémio | Premium v2
No Gerenciamento de API, os desenvolvedores são os usuários das APIs que você expõe usando o Gerenciamento de API. Este guia mostra como criar e convidar desenvolvedores para usar as APIs e os produtos que você disponibiliza para eles com sua instância de Gerenciamento de API. Para obter informações sobre como gerenciar contas de usuário programaticamente, consulte a documentação da entidade do usuário na referência da API REST de gerenciamento de API.
Pré-requisitos
- Conclua as tarefas neste artigo: Criar uma instância de Gerenciamento de API do Azure.
- Se você criou sua instância em uma camada v2, habilite o portal do desenvolvedor. Para obter mais informações, consulte Tutorial: Acessar e personalizar o portal do desenvolvedor.
Vá para a sua instância de Gestão de API
No portal do Azure, procure e selecione serviços de Gerenciamento de API.
Na página Serviços de Gerenciamento de API, selecione sua instância de Gerenciamento de API.
Criar um novo desenvolvedor
Para adicionar um novo usuário, siga as etapas nesta seção:
No menu à esquerda, em Portal do desenvolvedor, selecione Usuários.
Selecione + Adicionar.
Insira as informações apropriadas para o usuário.
Selecione Adicionar.
Por padrão, as contas de desenvolvedor recém-criadas são Ativas e associadas ao grupo Desenvolvedores . As contas de desenvolvedor que estão em um estado Ativo podem ser usadas para acessar o portal do desenvolvedor e todas as APIs para as quais eles têm assinaturas. Para associar o desenvolvedor recém-criado a grupos adicionais, consulte Como associar grupos a desenvolvedores.
Convide um desenvolvedor
Para convidar um desenvolvedor, siga as etapas nesta seção:
- No menu à esquerda, em Portal do desenvolvedor, selecione Usuários.
- Selecione + Convidar.
- Insira as informações apropriadas para o usuário, incluindo o endereço de e-mail.
- Selecione Enviar convite.
Quando um desenvolvedor é convidado, por padrão, um e-mail é enviado para o desenvolvedor. Este e-mail é gerado usando um modelo e é personalizável. Para obter mais informações, consulte Configurar modelos de email.
O desenvolvedor pode aceitar o convite seguindo as instruções no e-mail. Assim que o convite for aceite, a conta torna-se Ativa.
O link de convite fica ativo por 2 dias.
Desativar ou reativar uma conta de programador
Para desativar uma conta de desenvolvedor no estado Ativo , selecione Bloquear. Para reativar uma conta de desenvolvedor bloqueada, selecione Ativar. Uma conta de desenvolvedor bloqueada não pode acessar o portal do desenvolvedor ou chamar nenhuma API. Para excluir uma conta de usuário, selecione Excluir.
Para bloquear um utilizador, siga os seguintes passos.
- No menu à esquerda, em Portal do desenvolvedor, selecione Usuários.
- Selecione o usuário que você deseja bloquear.
- Na barra superior, selecione Bloquear.
Repor a palavra-passe de um utilizador
Quando você cria uma conta de desenvolvedor ou um desenvolvedor é convidado, uma senha é definida. Você pode enviar um e-mail para um usuário para redefinir a senha:
- No menu à esquerda, em Portal do desenvolvedor, selecione Usuários.
- Selecione o usuário cuja senha você deseja redefinir.
- Na barra superior, selecione Redefinir senha.
- Para enviar um e-mail de redefinição de senha, selecione Sim.
Como o e-mail de convite, este e-mail é gerado usando um modelo e é personalizável.
O desenvolvedor pode redefinir sua senha seguindo as instruções no e-mail.
Para trabalhar programaticamente com contas de usuário, consulte a documentação da entidade do usuário na referência da API REST de gerenciamento de API. Para redefinir a senha de uma conta de usuário para um valor específico, você pode usar a operação Atualizar um usuário e especificar a senha desejada.
Conteúdos relacionados
Depois que uma conta de desenvolvedor é criada, você pode associá-la a funções e assiná-la em produtos e APIs. Para obter mais informações, consulte Como criar e utilizar grupos.