Como gerir contas de utilizador na Gestão de API do Azure
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 Usuário na referência REST de Gerenciamento de API.
Disponibilidade
Importante
Esta funcionalidade está disponível nos escalões Premium, Standard, Básico e Programador da Gestão de API.
Para saber a disponibilidade de recursos nas camadas v2 (visualização), consulte a visão geral das camadas v2.
Pré-requisitos
Conclua as tarefas neste artigo: Criar uma instância de Gerenciamento de API do Azure.
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:
Selecione a guia Usuários à esquerda da tela.
Pressione +Adicionar.
Insira as informações apropriadas para o usuário.
Prima 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 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:
- Selecione a guia Usuários à esquerda da tela.
- Pressione +Convidar.
Uma mensagem de confirmação é exibida, mas o desenvolvedor recém-convidado não aparece na lista até que aceite o convite.
Quando um desenvolvedor é convidado, um e-mail é enviado para ele. Este e-mail é gerado usando um modelo e é personalizável. Para obter mais informações, consulte Configurar modelos de email.
Assim que o convite for aceite, a conta torna-se ativa.
O link de convite ficará ativo por 2 dias.
Desativar ou reativar uma conta de programador
Por padrão, as contas de desenvolvedor recém-criadas ou convidadas são Ativas. Para desativar uma conta de desenvolvedor, clique em Bloquear. Para reativar uma conta de desenvolvedor bloqueada, clique em 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, clique em Excluir.
Para bloquear um utilizador, siga os seguintes passos.
- Selecione a guia Usuários à esquerda da tela.
- Clique no usuário que você deseja bloquear.
- Pressione Block.
Repor a palavra-passe de um utilizador
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.
Passos seguintes
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.