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.

Screenshot of the Design tab with the Policies icon highlighted in the Outbound processing section.

  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.

    Screenshot of the test screen for the GetLatestCensus operation of the Census Data API. The Send button is highlighted.

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.

Screenshot of an HTTP response with the href value highlighted, showing that the URL has been masked.