Partilhar via


Criar subscrições na Gestão de API do Azure

APLICA-SE A: Todas as camadas de gerenciamento de API

Quando publica APIs através do Azure API Management, pode garantir o acesso a essas APIs usando chaves de subscrição. As aplicações cliente que precisam de consumir as APIs publicadas devem então incluir uma chave de subscrição válida nos pedidos HTTP quando fazem chamadas para essas APIs. Para obter uma chave de subscrição para aceder a APIs, precisa de uma subscrição. Para obter mais informações sobre assinaturas, consulte Assinaturas no Gerenciamento de API do Azure.

Este artigo guia-o pelos passos para criar subscrições no portal Azure.

Importante

A configuração Permitir rastreamento em assinaturas para habilitar rastreamentos de depuração foi preterida. Para melhorar a segurança, pode agora ativar o rastreio para pedidos específicos de API na Gestão de APIs. Para saber mais, consulte Habilitar o rastreamento para uma API.

Pré-requisitos

Para completar os passos deste artigo, precisa dos seguintes pré-requisitos:

Criar uma nova subscrição

Observação

Os editores de APIs (administradores ou utilizadores com permissões apropriadas para a instância de Gestão de APIs) criam e gerem subscrições. Os consumidores de APIs normalmente solicitam subscrições através do portal de programadores ou recebem-nas diretamente dos editores da API.

  1. Vai à tua instância de Gestão de API no portal Azure.
  2. Em APIs no menu da barra lateral, selecione Subscrições e, em seguida, selecione Adicionar subscrição.
  3. Insira um Nome e um Nome Exibido opcional para a subscrição.
  4. Selecione um Escopo da assinatura na lista suspensa. Para mais informações, consulte Âmbito das subscrições.
  5. Opcionalmente, escolha se a subscrição deve estar associada a um Utilizador.
    • Se não associares a subscrição a um utilizador específico, ela torna-se uma subscrição autónoma que pode ser partilhada entre vários programadores ou equipas.
    • Não pode atribuir assinaturas diretamente aos grupos de segurança do Microsoft Entra ID. Para fornecer acesso aos membros do grupo, criar uma subscrição autónoma e distribuir as chaves, ou usar autenticação Microsoft Entra ID com políticas para controlo de acesso baseado em grupos.
  6. Opcionalmente, escolha se deseja enviar uma notificação para utilização no portal do programador.
  7. Selecione Criar.

Captura de tela mostrando como criar uma assinatura de Gerenciamento de API no portal.

Depois de criar a assinatura, ela aparece na lista na página Assinaturas . Duas chaves de API são fornecidas para acessar as APIs. Uma chave é primária e outra é secundária.