Exercício – Mascarar URLs com uma política de transformação

Concluído

Se você hospedar uma API que inclua a URL original nas respostas, os clientes poderão ignorar as políticas do Gerenciamento de API conectando-se diretamente à API. Você pode impedir isso mascarando a URL original nas respostas da API.

O exemplo da API do Censo inclui sua URL desta maneira. Você deseja garantir que todas as solicitações passem pelo Gerenciamento de API.

Nesta unidade, você vai aprender a mascarar alguns dos dados retornados no corpo da API de censo. Você usa uma política de transformação para reescrever os dados da URL expostos no corpo da resposta.

Mascarar URLs

O exercício a seguir demonstra como aplicar a política de transformação Mascarar URL no Gerenciamento de API.

Captura de tela da guia Design com o ícone Políticas realçado na seção Processamento de saída.

  1. Entre no portal do Azure com a mesma conta usada no exercício anterior.

  2. No menu do portal do Azure ou na página Inicial, selecione Todos os recursos e selecione sua instância de Gerenciamento de API.

  3. No painel de menu à esquerda, em APIs, selecione APIs e, no painel central, selecione Dados de Censo.

  4. Na barra de menus superior, selecione a guia Design e escolha Todas as operações.

  5. Na seção de processamento Saída, selecione o ícone </>. O editor de política XML é exibido.

  6. Dentro do elemento <outbound>, abaixo do elemento <set-header-name> que você adicionou anteriormente, adicione o seguinte elemento:

    <redirect-content-urls />
    
  7. Selecione Salvar.

Testar a nova política

Podemos usar a ferramenta de Teste no portal do Azure para verificar se a política se comporta como desejamos:

  1. Selecione Dados de Censo novamente e, na barra de menus superior, selecione a guia Teste.

  2. Selecione GetLatestCensus e selecione Enviar.

    Captura de tela da tela de teste para a operação GetLatestCensus da API de Dados do Censo. O botão Enviar está realçado.

Agora, você deverá ver como a política de transformação Mascarar URL alterou os links no corpo da resposta para os pontos de extremidade do Gerenciamento de API. Você deverá ver o nome da instância do Gerenciamento de API na URL.

Captura de tela de uma resposta HTTP com o valor href realçado, mostrando que a URL foi mascarada.