Como gerenciar contas de usuário no Gerenciamento de API do Azure

No Gerenciamento de API, os desenvolvedores são os usuários das APIs que você expõe utilizando o Gerenciamento d API. Este guia mostra como criar e convidar desenvolvedores para usar as APIs e os produtos que você disponibilizar a eles com a sua instância do Gerenciamento de API. Para saber mais sobre como gerenciar contas de usuário por meio de programação, confira a documentação sobre Entidade de usuário na referência REST de Gerenciamento de API.

Disponibilidade

Importante

Este recurso está disponível nas camadas Premium, Standard, Básico e Desenvolvedor do Gerenciamento de API.

Pré-requisitos

Complete as tarefas neste artigo: Criar uma instância do Gerenciamento de API do Azure.

Navegar até a instância de Gerenciamento de API

  1. No portal do Azure, pesquise e selecione Serviços de Gerenciamento de API.

    Select API Management services

  2. Na página Serviços de Gerenciamento de API, selecione a sua instância de Gerenciamento de API.

    Select your API Management instance

Criar um novo desenvolvedor

Para adicionar um novo usuário, siga as etapas desta seção:

  1. Selecione a guia Usuários à esquerda da tela.

  2. Pressione +Adicionar.

  3. Insira as informações apropriadas para o usuário.

  4. Pressione Adicionar.

    Add a new user

Por padrão, as contas de desenvolvedor criadas recentemente têm o estado Ativa e são associadas ao grupo Desenvolvedores. As contas de desenvolvedor que estão com estado ativa podem ser utilizadas para acessar todas as APIs nas quais estão inscritas. Para associar um desenvolvedor recém-criado a grupos adicionais, consulte Como associar grupos a desenvolvedores.

Convidar um desenvolvedor

Para convidar um desenvolvedor, siga as etapas desta seção:

  1. Selecione a guia Usuários à esquerda da tela.
  2. Pressione +Convidar.

Uma mensagem de confirmação é exibida, mas o desenvolvedor recém-convidado não aparecerá na lista até que ele aceite o convite.

Quando um desenvolvedor é convidado, um email é enviado a ele. O email é gerado utilizando um modelo e pode ser personalizado. Para obter mais informações, consulte Configurar modelos de email.

Após o convite ser aceito, a conta se torna ativa.

O link do convite ficará ativo por dois dias.

Desativar ou reativar uma conta de desenvolvedor

Por padrão, as contas de desenvolvedor criadas ou convidadas recentemente têm o estado Ativa. 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 nem chamar APIs. Para excluir uma conta de usuário, clique em Excluir.

Para bloquear um usuário, siga as seguintes etapas.

  1. Selecione a guia Usuários à esquerda da tela.
  2. Clique no usuário que você deseja bloquear.
  3. Pressione Bloquear.

Redefinir a senha de um usuário

Para trabalhar de forma programática com contas de usuário, confira a documentação sobre Entidade de usuário na referência API REST de Gerenciamento de API. Para redefinir uma senha de conta de usuário para um valor específico, você pode usar a operação Atualizar um usuário e especificar a senha desejada.

Próximas etapas

Após criar uma conta de desenvolvedor, você pode associá-la a funções e inscrevê-la em produtos e APIs. Para obter mais informações, consulte Como criar e utilizar grupos.