Saltar al contenido

¡Transforma tus conexiones en dinero para el final del año con nuestro nuevo Programa de Indicación de Clientes! Descubre más

✕

Esta documentación es para la versión 4 y posteriores de App Builder, el nuevo nombre de Vinyl. Accede a la documentación de Vinyl aquí.

✕

Sitios y alias en Jitterbit App Builder

Descripción general

En una instalación predeterminada, App Builder acepta y responde a las solicitudes HTTP independientemente de la URL. Esto es práctico al principio, pero puede causar problemas más adelante. Los problemas surgen debido a los diferentes tratamientos de las URLs.

  • Las cookies HTTP se pueden restringir a una ruta específica, por ejemplo /App BuilderEl navegador web del cliente trata las rutas de las cookies como sensibles a mayúsculas y minúsculas; el servidor web puede no hacerlo.
  • De manera similar, los proveedores de autenticación externos pueden tratar la ruta como sensible a mayúsculas y minúsculas al validar URLs de redireccionamiento como https://example.com/App Builder/signin-SAML.
  • Además, el navegador web del cliente no permitirá que el servidor de aplicaciones sobrescriba una cookie insegura con una cookie segura.

Para evitar estos y otros problemas, los administradores deben canonizar la URL. Si bien esto se puede lograr mediante reglas de reescritura del servidor web, App Builder ofrece compatibilidad con la canonización de URL mediante la función Sitios y Alias.

Sitios

Un sitio define una URL canónica. Una instalación predeterminada incluye un solo sitio. El sitio no tiene una URL específica. En su lugar, la URL se infiere de la solicitud HTTP.

Es posible definir varios sitios y, por lo tanto, varias URLs canónicas. Esto puede ser útil, por ejemplo, al enmarcar una aplicación de App Builder. Consulte Enmarcar a continuación.

Solo se puede configurar un sitio como predeterminado. Este sitio se utiliza para determinar la URL canónica. Consulte "Coincidencia" a continuación.

Alias

Un sitio puede tener cero o más alias. Un alias es una URL alternativa, no canónica, que permite acceder a la instancia de App Builder.

Por ejemplo, es posible que la instancia de App Builder se haya publicado en la dirección interna https://machinename/App BuilderAntes de que se publicara en la dirección externa https://example.com/App BuilderLa dirección interna se puede configurar como un alias para la dirección externa. Si la opción Redireccionar está habilitada, App Builder redirigirá automáticamente los navegadores del cliente de la dirección interna a la externa.

Configuración

Para administrar sitios y alias, comience iniciando sesión en App Builder como administrador y luego:

  1. Cambie a la aplicación App Builder IDE.
  2. En el panel Conectar, haga clic en el botón Conectar a su empresa.
  3. En el menú de la izquierda, haga clic en el botón Proveedores de seguridad.
  4. En el panel Configuración, haga clic en el botón Administrar sitios.

Los sitios se componen de las siguientes propiedades:

  • URL - URL canónica completa. Ejemplo: https://example.com/App Builder.
  • Predeterminado: Indica si el sitio se considera predeterminado al hacer coincidir una solicitud HTTP con otro sitio. Consulte Coincidencia a continuación.
  • Redireccionar: Indica que App Builder debe redirigir los navegadores del cliente si una solicitud HTTP coincide con el sitio (o uno de sus alias), pero no con la URL canónica. Consulte Redireccionar a continuación.
  • Alias - Lista de URLs alternativas asociadas al sitio. Se utilizan para hacer coincidir una solicitud HTTP con un sitio. Consulte Coincidencia a continuación.

Para establecer un sitio como predeterminado, haga clic en el botón Establecer como predeterminado. Tenga en cuenta que este botón solo está visible si el sitio aún no es el predeterminado.

Canonicalización

La canonización consta de dos pasos. Primero, App Builder vincula la solicitud HTTP con un sitio. Luego, App Builder redirige el navegador web del cliente a la URL canónica si es necesario.

Coincidencia

Cuando App Builder recibe una solicitud HTTP, intenta hacer coincidir la URL con un sitio o alias. App Builder comienza realizando una coincidencia flexible. Esta coincidencia flexible considera los siguientes criterios:

  • Host - Nombre de alojar HTTP. Ejemplo: example.com
  • Puerto - Número de puerto HTTP. Ejemplo: 80, 443 Ruta - Componente de ruta URL. No distingue entre mayúsculas y minúsculas. Ejemplo: /App Builder.

Tenga en cuenta que App Builder no considera el esquema en esta etapa.

A los efectos de una coincidencia flexible, las siguientes URLs se consideran equivalentes:

  • http://example.com/vinyl- Esquema HTTP, ruta en minúsculas.
  • https://example.com/App Builder - Esquema HTTPS, ruta con mayúsculas y minúsculas.

Tenga en cuenta que este algoritmo no permite que un sitio de App Builder exista dentro de otro. No se admiten los siguientes casos:

  • https://example.com/App Builder- https://example.com/App Builder/App Builder2

App Builder elige la mejor coincidencia con la siguiente precedencia:

  1. Si la URL coincide con un sitio, se selecciona el sitio.
  2. Si la URL coincide con un alias, se selecciona el sitio del alias.
  3. De lo contrario, se selecciona el sitio predeterminado.

Redirigir

Una vez elegido el sitio, App Builder determina si se debe permitir que la solicitud continúe o si se debe emitir una redirección en su lugar.

  • Si la opción Redirigir está deshabilitada, se permite que la solicitud continúe.
  • Si la opción Redirigir está habilitada y la URL de la solicitud no coincide con la URL del sitio, App Builder cancelará la solicitud y responderá con una redirección HTTP.

En esta etapa, App Builder realiza una coincidencia estricta. Esta se diferencia de la coincidencia flexible en que:

  • La ruta se trata como sensible a mayúsculas y minúsculas.
  • Se considera el esquema.

A los efectos de una coincidencia estricta, las siguientes URLs no se consideran equivalentes:

  • http://example.com/vinyl- Esquema HTTP, ruta en minúsculas.
  • https://example.com/App Builder - Esquema HTTPS, ruta con mayúsculas y minúsculas.

Si la URL de la solicitud HTTP no coincide con la URL del sitio, App Builder responde con una redirección.

Proxies inversos y balanceadores de carga

App Builder admite proxies inversos y balanceadores de carga que finalizan la conexión SSL antes que el servidor web. Estos ambientes requieren configuración adicional. Consulte Proxies inversos para más información.

Casos de uso

Requerir HTTPS

Todas las instancias de App Builder DEBEN estar protegidas mediante HTTPS. La conexión segura puede finalizarse en el servidor web o en un proxy inverso. En cualquier caso, una vez configurada, se recomienda encarecidamente a los administradores que exijan a todos los clientes que se conecten mediante HTTPS.

Esto se puede lograr con sitios y alias. Configure la URL del sitio para que coincida con la URL segura, por ejemplo https://example.com/App Buildery activa la opción Redireccionar.

Consulta la información sobre proxies inversos y balanceadores de carga al usar HTTPS.

Enmarcado

App Builder utiliza cookies HTTP. Los navegadores web suelen bloquear las cookies de externo. Esto puede causar problemas al renderizar App Builder en un marco HTML.

Por ejemplo, si el sitio de encuadre se publica en la siguiente URL:

https://registration.example.com/

Y App Builder se publica en un dominio diferente:

https://vinyl.example.net/

El navegador web tratará las cookies establecidas por App Builder como cookies de externo y las bloqueará en consecuencia. Para solucionar este problema, publique App Builder en un subdominio del dominio del sitio web que lo enmarca.

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

Crea un sitio en App Builder con esta URL. No la configures como predeterminada. Activa la opción Redireccionar para que requiera HTTPS.