Falha ao atualizar os nomes de host do serviço de Gerenciamento de API

APLICA-SE A: todas as camadas do Gerenciamento de API

Este artigo descreve o erro "Falha ao atualizar os nomes de host do serviço de API Management" que você pode enfrentar ao adicionar um domínio personalizado ao serviço de API Management do Azure. Este artigo apresenta etapas para ajudar você a resolver esse problema.

Sintomas

Ao tentar adicionar um domínio personalizado ao serviço de API Management usando um certificado do Azure Key Vault, você receberá a seguinte mensagem de erro:

• Falha ao atualizar os nomes de host do serviço de API Management. A solicitação para o recurso "https://vaultname.vault.azure.net/secrets/secretname/?api-version=7.0" falhou com o Código de Status: Proibido para RequestId: . Mensagem da exceção: a operação retornou um código de status inválido, "Proibido".

Causa

O serviço de API Management não tem permissão para acessar o Key Vault que você está tentando usar para o domínio personalizado.

Solução

Para resolver esse problema, siga estas etapas:

1. Vá para o portal do Azure, selecione a sua instância de API Management e escolha Identidades gerenciadas. Verifique se a opção Registrar com o Microsoft Entra ID está definida como Sim.
2. No portal do Azure, abra o serviço do Key Vault e selecione o cofre de chaves que você está tentando usar para o domínio personalizado.
3. Selecione Políticas de acesso e verifique se há uma entidade de serviço que corresponde ao nome da instância do serviço de API Management. Se houver, selecione a entidade de serviço e verifique se ela tem a permissão Get listada em Permissões secretas.
   
4. Se o serviço de API Management não estiver na lista, selecione Adicionar política de acesso e crie a seguinte política de acesso:
   • Configurar do Modelo: nome
   • Selecionar entidade de segurança: pesquise o nome do serviço de API Management e escolha-o na lista
   • Principais permissões: nenhuma
   • Permissões de segredo: Get
   • Permissões de certificado: nenhuma
5. Selecione OK para criar a política de acesso.
6. Selecione Salvar para salvar as alterações.

Verifique se o problema foi resolvido. Para fazer isso, tente criar o domínio personalizado no serviço de API Management usando o certificado do Key Vault.

Próximas etapas

Saiba mais sobre o serviço de API Management:

• Confira mais vídeos sobre o Gerenciamento de API.

• Para outras maneiras de proteger seu serviço de back-end, confira Autenticação de certificado mútuo.

• Crie uma instância do serviço de Gerenciamento de API.

• Gerencie sua primeira API.