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. Pode impedir que isto aconteça ao mascarar o URL original nas respostas da API.

O exemplo da API do Census inclui sua URL dessa maneira. Quer garantir que todos os pedidos passam pela Gestão de API.

Nesta unidade, você aprende a mascarar alguns dos dados retornados no corpo da API do Censo. Use uma política de transformação para reescrever os dados de URL expostos no corpo da resposta.

Mascarar URLs

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

Captura de ecrã do separador Estrutura com o ícone Políticas realçado na secção Processamento de saída.

  1. Inicie sessão no portal do Azure com a mesma conta que utilizou para o 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 esquerdo, em APIs, selecione APIs e, no painel central, selecione Dados do censo.

  4. Na barra de menus superior, selecione o separador Estrutura e, em seguida, selecione Todas as operações.

  5. Na seção Processamento de saída, selecione o <ícone /> . O editor de políticas XML é exibido.

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

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

Testar a nova política

Podemos utilizar a ferramenta Testar no portal do Azure para verificar se a política tem o comportamento esperado:

  1. Selecione Dados do censo novamente e, na barra de menu superior, selecione a guia Teste .

  2. Selecione GetLatestCensus e, em seguida, 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 deverá ver como a política de transformação Mascarar URL alterou as ligações no corpo da resposta dos pontos finais da Gestão de API. Você deve ver o nome da sua instância de Gerenciamento de API na URL.

Captura de ecrã de uma resposta HTTP com o valor href realçado, mostrando que o URL foi mascarado.