Sitios y alias en Jitterbit App Builder

Descripción general

En una instalación predeterminada, App Builder acepta y responde a solicitudes HTTP independientemente de la URL. Esto es conveniente al comenzar, pero puede causar problemas más adelante. Los problemas surgen del tratamiento diferente de las URL.

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

Para evitar estos y otros problemas, los administradores deben tomar medidas para canonicalizar la URL. Aunque esto se puede lograr mediante reglas de reescritura del servidor web, App Builder proporciona soporte para la canonicalización de URL a través de la función Sitios y alias.

Sitios

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

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

Solo se puede configurar un sitio como el sitio "predeterminado". El sitio predeterminado se utiliza al determinar la URL canónica. Consulta Coincidencia a continuación.

Alias

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

Por ejemplo, la instancia de App Builder puede haberse publicado en la dirección interna https://machinename/Vinyl antes de publicarse en la dirección externa https://example.com/Vinyl. La 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 de los clientes desde la dirección interna a la dirección externa.

Configuración

Para gestionar Sitios y Alias, comienza iniciando sesión en App Builder como administrador, luego:

Cambia a la aplicación App Builder IDE.
En el panel Conectar, haz clic en el botón Proveedores de seguridad.
En el panel Configuración, haz clic en Más y selecciona Sitios.

Los sitios se componen de las siguientes propiedades:

URL - URL canónica completamente calificada. Ejemplo: https://example.com/Vinyl.
Predeterminado - Indica si el sitio se trata como el sitio predeterminado al hacer coincidir una solicitud HTTP con un sitio. Consulta Coincidencia a continuación.
Redireccionar - Indica que App Builder debe redirigir los navegadores de los clientes si una solicitud HTTP coincide con el sitio (o uno de los alias del sitio) pero no coincide con la URL canónica. Consulta Redirección a continuación.
Alias - Lista de URL alternativas asociadas con el sitio. Se utilizan para hacer coincidir una solicitud HTTP con un sitio. Consulta Coincidencia a continuación.

Para hacer que un sitio sea el sitio "predeterminado", haz clic en el botón Hacer predeterminado. Ten en cuenta que este botón solo es visible si el sitio aún no es el sitio predeterminado.

Canonicalización

La canonicalización consta de dos pasos. Primero, App Builder hace coincidir 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". Una coincidencia flexible considera los siguientes criterios:

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

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

Para los propósitos de una coincidencia flexible, se consideran que las siguientes URL son equivalentes:

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

Ten en cuenta que este algoritmo no permite que un sitio de App Builder exista dentro de otro. Lo siguiente no es compatible:

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

App Builder elige la mejor coincidencia con el siguiente orden de precedencia:

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

Redirect

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

Si la opción Redirect está deshabilitada, se permite que la solicitud continúe.
Si la opción Redirect 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". Una coincidencia estricta difiere de la coincidencia flexible en que:

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

Para los fines de una coincidencia estricta, las siguientes URLs no se consideran equivalentes:

http://example.com/vinyl - Esquema HTTP, ruta en minúsculas.
https://example.com/Vinyl - Esquema HTTPS, ruta en 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 es compatible con proxies inversos y balanceadores de carga que terminan la conexión SSL antes del servidor web. Estos entornos requieren configuración adicional. Consulta Proxies inversos para obtener más información.

Casos de uso

Requerir HTTPS

Cada instancia de App Builder DEBE protegerse mediante HTTPS. La conexión segura puede terminarse en el servidor web o en un proxy inverso. De cualquier manera, una vez configurado, se recomienda encarecidamente a los administradores que requieran que todos los clientes se conecten con HTTPS.

Esto se puede lograr con sitios y alias. Establece la URL del sitio para que coincida con la URL segura, por ejemplo https://example.com/Vinyl, y habilita la opción Redirect.

Revisa la información sobre Proxies inversos y Balanceadores de carga cuando uses HTTPS

Framing

App Builder se basa en cookies HTTP. Los navegadores web suelen bloquear cookies de terceros. Esto puede causar problemas al renderizar App Builder en un marco HTML.

Por ejemplo, si el sitio de framing 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á cualquier cookie establecida por App Builder como cookies de terceros y las bloqueará en consecuencia. Para solucionar este problema, publica App Builder en un subdominio del dominio del sitio de framing.

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

Crea un sitio en App Builder con esta URL. No lo hagas el sitio Default. Habilita la opción Redirect para requerir HTTPS.