Ir para o conteúdo

Sites e aliases no Jitterbit App Builder

Visão geral

Em uma instalação padrão, o App Builder aceita e responde a requisições HTTP independentemente da URL. Isso é conveniente no início, mas pode causar problemas posteriormente. Problemas surgem dos tratamentos diferentes de URLs.

  • Cookies HTTP podem ser restritos a um caminho específico, por exemplo /Vinyl. O navegador web do cliente trata caminhos de cookies como diferenciadores de maiúsculas e minúsculas; o servidor web pode não fazer isso.
  • Da mesma forma, provedores de autenticação externos podem tratar o caminho como diferenciador de maiúsculas e minúsculas ao validar URLs de redirecionamento, como https://example.com/Vinyl/signin-SAML.
  • Além disso, o navegador web do cliente não permitirá que o servidor de aplicativos sobrescreva um cookie não seguro com um cookie seguro.

Para evitar esses e outros problemas, os administradores devem tomar medidas para canonicalizar a URL. Embora isso possa ser alcançado através de regras de reescrita do servidor web, o App Builder oferece suporte à canonicalização de URL através do recurso Sites e Aliases.

Sites

Um site define uma URL canônica. Uma instalação padrão inclui um único site. O site não possui uma URL específica. Em vez disso, a URL é inferida da requisição HTTP.

É possível definir vários sites e, portanto, várias URLs canônicas. Isso pode ser útil, por exemplo, ao enquadrar um aplicativo App Builder. Consulte Framing abaixo.

Apenas um site pode ser configurado como o site "padrão". O site padrão é usado ao determinar a URL canônica. Consulte Matching abaixo.

Aliases

Um site pode ter zero ou mais aliases. Um alias é uma URL alternativa não canônica que pode ser usada para acessar a instância do App Builder.

Por exemplo, a instância do App Builder pode ter sido publicada no endereço interno https://machinename/Vinyl antes de ser publicada no endereço externo https://example.com/Vinyl. O endereço interno pode ser configurado como um alias para o endereço externo. Se a opção Redirect estiver ativada, o App Builder redirecionará automaticamente os navegadores dos clientes do endereço interno para o endereço externo.

Configuração

Para gerenciar Sites e Aliases, comece entrando no App Builder como administrador e, em seguida:

  1. Alterne para o aplicativo App Builder IDE.
  2. No painel Connect, clique no botão Security Providers.
  3. No painel Configuration, clique em More e selecione Sites.

Sites são compostos pelas seguintes propriedades:

  • URL - URL canônica totalmente qualificada. Exemplo: https://example.com/Vinyl.
  • Default - Indica se o site é tratado como o site padrão ao corresponder uma requisição HTTP a um site. Consulte Matching abaixo.
  • Redirect - Indica que o App Builder deve redirecionar os navegadores dos clientes se uma requisição HTTP corresponder ao site (ou a um dos aliases do site), mas não corresponder à URL canônica. Consulte Redirect abaixo.
  • Aliases - Lista de URLs alternativas associadas ao site. Essas são usadas para corresponder uma requisição HTTP a um site. Consulte Matching abaixo.

Para tornar um site o site "padrão", clique no botão Make Default. Observe que esse botão só fica visível se o site ainda não for o site padrão.

Canonicalização

A canonicalização consiste em duas etapas. Primeiro, o App Builder corresponde a requisição HTTP a um site. Em seguida, o App Builder redireciona o navegador web do cliente para a URL canônica, se necessário.

Matching

Quando o App Builder recebe uma requisição HTTP, tenta corresponder a URL a um site ou alias. O App Builder começa executando uma correspondência "flexível". Uma correspondência flexível considera os seguintes critérios:

  • Host - Nome do host HTTP. Exemplo: example.com
  • Port - Número da porta HTTP. Exemplo: 80, 443
  • Path - Componente do caminho da URL. Sem diferenciação de maiúsculas e minúsculas. Exemplo: /Vinyl.

Observe que o App Builder não considera o scheme nesta etapa.

Para os fins de uma correspondência flexível, as seguintes URLs são consideradas equivalentes:

  • http://example.com/vinyl - Scheme HTTP, caminho em minúsculas.
  • https://example.com/Vinyl - Scheme HTTPS, caminho em maiúsculas e minúsculas mistas.

Observe que este algoritmo não permite que um site do App Builder exista dentro de outro. O seguinte não é suportado:

  • https://example.com/Vinyl
  • https://example.com/Vinyl/Vinyl2

O App Builder escolhe a melhor correspondência com a seguinte precedência:

  1. Se a URL corresponder a um site, o site é selecionado.
  2. Se a URL corresponder a um alias, o site do alias é selecionado.
  3. Caso contrário, o site padrão é selecionado.

Redirecionamento

Após escolher o site, o App Builder determina se a solicitação deve ser permitida ou se um redirecionamento deve ser emitido.

  • Se a opção Redirect estiver desativada, a solicitação é permitida.
  • Se a opção Redirect estiver ativada e a URL da solicitação não corresponder à URL do site, o App Builder abortará a solicitação e responderá com um redirecionamento HTTP.

Neste estágio, o App Builder executa uma correspondência "rigorosa". Uma correspondência rigorosa difere da correspondência flexível em que:

  • O caminho é tratado como sensível a maiúsculas e minúsculas.
  • O esquema é considerado.

Para os fins de uma correspondência rigorosa, as seguintes URLs não são consideradas equivalentes:

  • http://example.com/vinyl - esquema HTTP, caminho em minúsculas.
  • https://example.com/Vinyl - esquema HTTPS, caminho em maiúsculas e minúsculas.

Se a URL da solicitação HTTP não corresponder à URL do site, o App Builder responderá com um redirecionamento.

Proxies reversos e balanceadores de carga

O App Builder oferece suporte a proxies reversos e balanceadores de carga que encerram a conexão SSL antes do servidor web. Esses ambientes requerem configuração adicional. Consulte Proxies reversos para obter mais informações.

Casos de uso

Exigir HTTPS

Todas as instâncias do App Builder DEVEM ser protegidas usando HTTPS. A conexão segura pode ser encerrada no servidor web ou em um proxy reverso. Independentemente disso, após a configuração, os administradores são fortemente encorajados a exigir que todos os clientes se conectem com HTTPS.

Isso pode ser conseguido com sites e aliases. Defina a URL do site para corresponder à URL segura, por exemplo https://example.com/Vinyl, e ative a opção Redirect.

Revise as informações sobre proxies reversos e balanceadores de carga ao usar HTTPS

Framing

O App Builder depende de cookies HTTP. Navegadores web normalmente bloqueiam cookies de terceiros. Isso pode causar problemas ao renderizar o App Builder em um frame HTML.

Por exemplo, se o site de framing for publicado na seguinte URL:

https://registration.example.com/

E o App Builder for publicado em um domínio diferente:

https://vinyl.example.net/

O navegador web tratará qualquer cookie definido pelo App Builder como um cookie de terceiros e os bloqueará. Para contornar esse problema, publique o App Builder em um subdomínio do domínio do site de framing.

https://vinyl.registration.example.com/

Crie um site no App Builder com esta URL. Não o defina como o site Default. Ative a opção Redirect para exigir HTTPS.