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

  1. No portal do Azure, procure e selecione serviços de Gerenciamento de API.

    Select API Management services

  2. Na página Serviços de Gerenciamento de API, selecione 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 nesta 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. Prima Adicionar.

    Add a new user

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:

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

  1. Selecione a guia Usuários à esquerda da tela.
  2. Clique no usuário que você deseja bloquear.
  3. 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.