Partilhar via

Como criar e utilizar grupos para gerir contas de programador na Gestão de API do Azure

APPLIES TO: Developer | Basic | Basic v2 | Standard | Standard v2 | Premium | Premium v2

No Gerenciamento de API, os grupos são usados para gerenciar a visibilidade dos produtos para os desenvolvedores no portal do desenvolvedor. Os produtos são primeiro tornados visíveis para grupos e, em seguida, os programadores nesses grupos podem ver e subscrever os produtos associados aos grupos.

O Gerenciamento de API tem os seguintes grupos imutáveis:

  • Administradores - Grupo interno que contém apenas a conta de e-mail do administrador fornecida no momento da criação do serviço. A sua composição é gerida pelo sistema; Os usuários não podem ser adicionados ou removidos do grupo. O objetivo principal da conta de administrador é acessar a interface administrativa do portal do desenvolvedor para personalizar e publicar o conteúdo do portal. Qualquer usuário que tenha permissões do RBAC do Azure para personalizar o portal do desenvolvedor pode se autenticar como administrador para personalizar o portal.

    Nota

    A qualquer momento, um proprietário de serviço pode atualizar as configurações de e-mail do administrador que são usadas nas notificações da sua instância de Gerenciamento de API.

  • Desenvolvedores - Os usuários autenticados do portal do desenvolvedor se enquadram nesse grupo. Os programadores são os clientes que criam aplicações utilizando as suas APIs. Os desenvolvedores recebem acesso ao portal de desenvolvedores para criar aplicações que utilizam as operações de uma API.

  • Convidados – os utilizadores não autenticados do portal do programador, tais como potenciais clientes que visitam o portal do programador de uma instância de API Management, enquadram-se neste grupo. Estes podem ter determinados acessos só de leitura, como a capacidade de ver APIs mas não de as invocar.

Além desses grupos de sistema, os administradores podem criar grupos personalizados ou usar grupos externos em locatários associados do Microsoft Entra. É possível utilizar grupos personalizados e externos em conjunto com grupos de sistema para dar aos programadores acesso e visibilidade a produtos de API. Por exemplo, pode criar um grupo personalizado para os programadores associados a uma organização parceira específica e permitir-lhes o acesso às APIs a partir de um produto que contém apenas APIs relevantes. Um utilizador pode ser membro de mais do que um grupo.

Este guia mostra como os administradores de uma instância de Gerenciamento de API podem adicionar novos grupos e associá-los a produtos e desenvolvedores.

In addition to creating and managing groups in the Azure portal, you can create and manage your groups using the API Management REST API Group entity.

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. In the Azure portal, search for and select API Management services:

    Captura de tela que mostra os serviços de Gerenciamento de API nos resultados da pesquisa.

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

    Captura de tela que mostra uma instância de Gerenciamento de API na página Serviços de Gerenciamento de API.

Criar um grupo

Esta seção mostra como adicionar um novo grupo à sua conta de Gerenciamento de API.

  1. Selecione o separador Grupos à esquerda do ecrã.

  2. Clique em +Adicionar.

  3. Insira um nome exclusivo para o grupo e uma descrição opcional.

  4. Selecione Criar.

    Captura de ecrã a mostrar a criação de um grupo no portal. Depois que o grupo é criado, ele é adicionado à lista Grupos .

    • Para editar o Nome ouDescrição do grupo, clique no nome do grupo e selecione Configurações

    • Para excluir o grupo, selecione o nome do grupo e pressione Delete.

Agora que o grupo é criado, ele pode ser associado a produtos e desenvolvedores.

Associar um grupo a um produto

  1. Select the Products tab to the left.

  2. Clique no nome do produto desejado.

  3. Press Access control>+ Add group.

  4. Selecione o grupo que deseja adicionar.

    Captura de ecrã a mostrar a adição de um grupo a um produto no portal.

Depois que um produto é associado a um grupo, os desenvolvedores desse grupo podem visualizar e assinar o produto.

Nota

Para adicionar grupos do Microsoft Entra, consulte Como autorizar contas de desenvolvedor usando a ID do Microsoft Entra no Gerenciamento de API do Azure.

Para remover um grupo do produto, clique em Excluir.

Captura de ecrã a mostrar a remoção de um grupo de um produto no portal.

Associar grupos a desenvolvedores

Esta seção mostra como associar grupos a membros.

  1. Select the Groups tab to the left of the screen, and then select a group.

  2. Selecione Membros+ Adicionar>.

  3. Selecione um membro.

    Captura de ecrã a mostrar a adição de um membro a um grupo no portal.

  4. Press Select.

Depois que a associação for adicionada entre o desenvolvedor e o grupo, você poderá visualizá-la na guia Usuários .

Conteúdo relacionado