Reescrever URL

  • Artigo

O Azure Front Door dá suporte à reconfiguração de URL para alterar o caminho da solicitação que está sendo roteado para sua origem. A reconfiguração de URL permite que você defina condições para garantir que a URL ou os cabeçalhos especificados sejam reescritos somente quando determinadas condições forem atendidas. Estas condições baseiam-se nas informações do pedido e da resposta.

Com esse recurso, você pode redirecionar seus usuários finais para uma origem diferente com base em seus tipos de dispositivo ou no tipo de arquivo solicitado. A ação de reconfiguração de URL pode ser encontrada em uma configuração de conjunto de regras.

Captura de tela da ação de regravação de URL em uma configuração de conjunto de regras.

Padrão de origem

O padrão de origem é o caminho da URL na solicitação inicial que você deseja substituir. Atualmente, o padrão de origem usa uma correspondência baseada em prefixo. Para corresponder a todos os caminhos de URL, você pode definir uma barra (/) como o valor do padrão de origem.

Para o padrão de origem em uma ação de regravação de URL, somente o caminho após os padrões a serem correspondidos na configuração de rota é considerado. Por exemplo, você tem o seguinte formato contoso.com/pattern-to-match/source-patternde URL de entrada , só /source-pattern é considerado pelo conjunto de regras como o padrão de origem a ser reescrito. O formato do URL de saída após a regravação do URL ser aplicado é contoso.com/pattern-to-match/destination.

Para situação, quando você precisar remover o /pattern-to-match segmento da URL, defina o caminho de origem para o grupo de origem na configuração de rota como /.

Destino

O caminho de destino usado para substituir o padrão de origem. Por exemplo, se o caminho da URL da solicitação for contoso.com/foo/1.jpg, o padrão de origem for /foo/, e o destino for /bar/, o conteúdo será servido a partir da contoso.com/bar/1.jpg origem.

Preservar caminho incomparável

Preservar caminho incomparável permite acrescentar o caminho restante após o padrão de origem ao novo caminho. Quando preservar caminho incomparável é definido como Não (padrão), o caminho restante após o padrão de origem é removido.

Preservar caminho incomparável Padrão de origem Destino Pedido recebido Conteúdo veiculado desde a origem
Sim / /foo/ contoso.com/sub/1.jpg /foo/sub/1.jpg
Sim /sub/ /foo/ contoso.com/sub/image/1.jpg /foo/imagem/1.jpg
Não /sub/ /foo/2.jpg contoso.com/sub/image/1.jpg /foo/2.jpg

Importante

O Azure Front Door (clássico) será desativado em 31 de março de 2027. Para evitar qualquer interrupção do serviço, é importante migrar seus perfis do Azure Front Door (clássico) para a camada Azure Front Door Standard ou Premium até março de 2027. Para obter mais informações, consulte Aposentadoria (clássica) do Azure Front Door.

O Azure Front Door (clássico) dá suporte à reconfiguração de URL configurando um caminho de encaminhamento personalizado ao configurar a regra de tipo de roteamento de encaminhamento. Por padrão, se apenas uma barra (/*) for definida, o Front Door copiará o caminho da URL de entrada para a URL usada na solicitação encaminhada. O cabeçalho do host usado na solicitação encaminhada é conforme configurado para o back-end selecionado. Para obter mais informações, consulte Cabeçalho de host de back-end.

A parte robusta da reescrita de URL é que o caminho de encaminhamento personalizado copia qualquer parte do caminho de entrada que corresponda ao caminho curinga para o caminho encaminhado.

A tabela a seguir mostra um exemplo de uma solicitação de entrada e o caminho encaminhado correspondente ao usar um caminho de encaminhamento personalizado de para um caminho de /fwd/ correspondência com um curinga. A parte a/b/c do caminho representa a parte que substitui o curinga.

Caminho da URL de entrada Caminho de correspondência Caminho de encaminhamento personalizado Caminho encaminhado
/foo/a/b/c /foo/* /fwd/ /fwd/a/b/c

Exemplo de reescrita de URL

Considere uma regra de roteamento com a seguinte combinação de hosts frontend e caminhos configurados:

Anfitriões Caminhos
www.contoso.com /*
/foo
/foo/*
/foo/bar/*

A primeira coluna na tabela a seguir mostra exemplos de solicitações de entrada e a segunda coluna mostra qual seria a rota de correspondência mais específica definida. As próximas três colunas na tabela são exemplos de caminhos de encaminhamento personalizados.

Por exemplo, a segunda linha lê, para uma solicitação de entrada de , se o caminho de encaminhamento personalizado for /, então o caminho encaminhado www.contoso.com/subseria /sub. Se o caminho de encaminhamento personalizado foi /fwd/, então o caminho encaminhado é /fwd/sub. As partes enfatizadas dos caminhos representam as partes que fazem parte da correspondência curinga.

Pedido recebido Caminho de correspondência mais específico / /fwd/ /foo/ /foo/bar/
www.contoso.com/ /* / /fwd/ /foo/ /foo/bar/
www.contoso.com/ sub /* /sub /fwd/sub /foo/sub /foo/bar/sub
www.contoso.com/ a/b/c /* /a/gc /fwd/a/b/c /foo/a/b/c /foo/bar/a/b/c
www.contoso.com/foo /foo / /fwd/ /foo/ /foo/bar/
www.contoso.com/foo/ /foo/* / /fwd/ /foo/ /foo/bar/
www.contoso.com/foo/ bar /foo/* /bar /fwd/bar /foo/bar /foo/bar/bar

Nota

O Azure Front Door (clássico) suporta apenas a reescrita de URL de um caminho estático para outro caminho estático. Preservar caminho incomparável é suportado com o Azure Front Door Standard e Premium. Para obter mais informações, consulte Preservar caminho incomparável.

Configurações opcionais

Há configurações opcionais extras que você também pode especificar para qualquer configuração de regra de roteamento:

  • Configuração de cache - Se desabilitada ou não especificada, as solicitações que correspondem a essa regra de roteamento não tentam usar conteúdo armazenado em cache e, em vez disso, sempre buscam no back-end. Para obter mais informações, consulte Armazenamento em cache com o Azure Front Door.

Próximos passos