Como gerir contas de utilizador na Gestão de API do AzureHow to manage user accounts in Azure API Management

Na Gestão da API, os desenvolvedores são os utilizadores das APIs que expõe usando a API Management.In API Management, developers are the users of the APIs that you expose using API Management. Este guia mostra como criar e convidar os desenvolvedores a utilizarem as APIs e os produtos que lhes disponibiliza com a sua instância de Gestão da API.This guide shows how to create and invite developers to use the APIs and products that you make available to them with your API Management instance. Para obter informações sobre a gestão das contas dos utilizadores programáticamente, consulte a documentação da entidade utilizadora na referência API Management REST.For information on managing user accounts programmatically, see the User entity documentation in the API Management REST reference.

DisponibilidadeAvailability

Importante

Esta funcionalidade está disponível nos níveis Premium, Standard, Basic e Developer da API Management.This feature is available in the Premium, Standard, Basic, and Developer tiers of API Management.

Pré-requisitosPrerequisites

Tarefas completas neste artigo: Criar uma instância de Gestão API Azure.Complete tasks in this article: Create an Azure API Management instance.

Vá para a sua instância de Gestão de APIGo to your API Management instance

  1. No portal Azure, procure e selecione os serviços de Gestão da API.In the Azure portal, search for and select API Management services.

    Selecione serviços de Gestão API

  2. Na página de serviços de Gestão da API, selecione a sua instância de Gestão de API.On the API Management services page, select your API Management instance.

    Selecione a sua instância de Gestão de API

Criar um novo desenvolvedor Create a new developer

Para adicionar um novo utilizador, siga os passos desta secção:To add a new user, follow the steps in this section:

  1. Selecione o separador Utilizadores à esquerda do ecrã.Select the Users tab to the left of the screen.

  2. Prima +Adicionar.Press +Add.

  3. Introduza informações apropriadas para o utilizador.Enter appropriate information for the user.

  4. Prima Adicionar.Press Add.

    Adicionar um novo utilizador

Por padrão, as contas de programadores recém-criadas são Ativas e associadas ao grupo Developers.By default, newly created developer accounts are Active, and associated with the Developers group. As contas de programadores que se encontrem num estado ativo podem ser usadas para aceder a todas as APIs para as quais têm subscrições.Developer accounts that are in an active state can be used to access all of the APIs for which they have subscriptions. Para associar o programador recém-criado a grupos adicionais, consulte Como associar grupos com desenvolvedores.To associate the newly created developer with additional groups, see How to associate groups with developers.

Convidar um desenvolvedor Invite a developer

Para convidar um desenvolvedor, siga os passos desta secção:To invite a developer, follow the steps in this section:

  1. Selecione o separador Utilizadores à esquerda do ecrã.Select the Users tab to the left of the screen.
  2. Prima +Convidar.Press +Invite.

Uma mensagem de confirmação é exibida, mas o programador recém-convidado só aparece na lista depois de aceitar o convite.A confirmation message is displayed, but the newly invited developer does not appear in the list until after they accept the invitation.

Quando um desenvolvedor é convidado, um e-mail é enviado para o desenvolvedor.When a developer is invited, an email is sent to the developer. Este e-mail é gerado usando um modelo e é personalizável.This email is generated using a template and is customizable. Para obter mais informações, consulte os modelos de e-mail configure.For more information, see Configure email templates.

Uma vez que o convite é aceite, a conta torna-se ativa.Once the invitation is accepted, the account becomes active.

Desativar ou reativar uma conta de programador Deactivate or reactivate a developer account

Por padrão, as contas de programadores recém-criadas ou convidadas são Ativas.By default, newly created or invited developer accounts are Active. Para desativar uma conta de programador, clique em Bloquear.To deactivate a developer account, click Block. Para reativar uma conta de programador bloqueada, clique em Ativar.To reactivate a blocked developer account, click Activate. Uma conta de programador bloqueada não pode aceder ao portal do desenvolvedor ou chamar APIs.A blocked developer account can't access the developer portal or call any APIs. Para eliminar uma conta de utilizador, clique em Eliminar.To delete a user account, click Delete.

Para bloquear um utilizador, siga os seguintes passos.To block a user, follow the following steps.

  1. Selecione o separador Utilizadores à esquerda do ecrã.Select the Users tab to the left of the screen.
  2. Clique no utilizador que pretende bloquear.Click on the user that you want to block.
  3. Bloco de Imprensa .Press Block.

Repor a palavra-passe de um utilizadorReset a user password

Para trabalhar programáticamente com contas de utilizador, consulte a documentação da entidade utilizadora na referência API Management REST API.To programmatically work with user accounts, see the User entity documentation in the API Management REST API reference. Para redefinir uma palavra-passe da conta de utilizador para um valor específico, pode utilizar a atualização de uma operação de utilizador e especificar a palavra-passe desejada.To reset a user account password to a specific value, you can use the Update a user operation and specify the desired password.

Passos seguintes Next steps

Uma vez criada uma conta de programador, pode associá-la a funções e subscrevê-la em produtos e APIs.Once a developer account is created, you can associate it with roles and subscribe it to products and APIs. Para obter mais informações, consulte Como criar e utilizar grupos.For more information, see How to create and use groups.