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

Concluído

Se você hospedar uma API que inclua sua URL original em respostas, os clientes poderão ignorar suas políticas de 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ê deve ver como a política de transformação Mascarar URL altera 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 está mascarada.