Sitios y Alias¶

Descripción General¶

En una instalación predeterminada, Vinyl acepta y responde a solicitudes HTTP independientemente de la URL. Esto es conveniente al comenzar, pero puede generar problemas en el futuro. Los problemas surgen de los diferentes tratamientos de las URLs.

Las cookies HTTP se pueden restringir a una ruta específica, por ejemplo /Vinyl. El navegador web del cliente considera que las rutas de las cookies distinguen entre mayúsculas y minúsculas; el servidor web, puede que no.
De manera similar, los proveedores de autenticación externos pueden tratar la ruta entre mayúsculas y minúsculas al validar las URLs de redireccionamiento, como https://example.com/Vinyl/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 tomar medidas para canonicalizar la URL. Aunque esto se puede lograr mediante reglas de reescritura del servidor web, Vinyl brinda 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 solo sitio. El sitio no tiene una URL específica. En cambio, la URL se deduce de la solicitud HTTP.

Es posible definir varios sitios y, por tanto, varias URLs canónicas. Esto puede resultar útil, por ejemplo, al enmarcar una aplicación de Vinyl. Consulte Encuadre a continuación.

Sólo se puede configurar un sitio como sitio "predeterminado". El sitio predeterminado se utiliza al 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 se puede utilizar para acceder a la instancia de Vinyl.

Por ejemplo, es posible que la instancia de Vinyl se haya publicado en la dirección interna https://machinename/Vinyl antes de que fuera publicado 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, Vinyl redirigirá automáticamente los navegadores del cliente desde la dirección interna a la dirección externa.

Configuración¶

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

Cambie a la aplicación Vinyl IDE.
En el panel Conectar, haga clic en el botón Conectar a su empresa.
En el menú de la izquierda, haga clic en el botón Proveedores de seguridad.
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 y totalmente 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. Consulte Coincidencia a continuación.
Redireccionar: indica que Vinyl 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. Consulte Redireccionamiento a continuación.
Aliases: lista de URLs alternativas asociadas con el sitio. Se utilizan para hacer coincidir una solicitud HTTP con un sitio. Consulte Coincidencia a continuación.

Para hacer que un sitio sea el sitio "predeterminado", haga clic en el botón Establecer como predeterminado. Tenga 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, Vinyl relaciona la solicitud HTTP con un sitio. Luego, Vinyl redirige el navegador web del cliente a la URL canónica si es necesario.

Pareo¶

Cuando Vinyl recibe una solicitud HTTP, intenta hacer coincidir la URL con un sitio o alias. Vinyl comienza realizando un partido "suelto". Un partido flojo 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: /Vinyl.

Tenga en cuenta que Vinyl 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/Vinyl - Esquema HTTPS, ruta de mayúsculas y minúsculas mixtas.

Tenga en cuenta que este algoritmo no permite que un sitio Vinyl exista dentro de otro. No se admite lo siguiente:

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

Vinyl elige la mejor combinación con la siguiente prioridad:

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.

Redirigir¶

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

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

En esta etapa, Vinyl realiza una pelea "estricta". Una coincidencia estricta se diferencia de una coincidencia flexible en que:

La ruta se trata entre mayúsculas y minúsculas.
Se considera el esquema.

A 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/Vinyl - Esquema HTTPS, ruta de mayúsculas y minúsculas mixtas.

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

Proxies Inversos y Balanceadores de Carga¶

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

Casos de Uso¶

Requerir HTTPS¶

Cada instancia de Vinyl DEBE estar protegida mediante HTTPS. La conexión segura se puede terminar en el servidor web o en un proxy inverso. De todos modos, una vez configurado, se recomienda encarecidamente a los administradores que exijan que todos los clientes se conecten con 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/Vinyl y habilite la opción Redireccionar.

Revisar información sobre Proxies Inversos y Balanceadores de Carga cuando se utiliza HTTPS

Enmarcado¶

Vinyl se basa en cookies HTTP. Los navegadores web suelen bloquear las cookies de externo. Esto puede causar problemas al renderizar Vinyl en un marco HTML.

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

https://registration.example.com/

Y el Vinyl se publica en un dominio diferente:

https://vinyl.example.net/

El navegador web tratará las cookies configuradas por Vinyl como cookies de externo y las bloqueará en consecuencia. Para solucionar este problema, publique Vinyl en un subdominio del dominio del sitio de enmarcado.

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

Crea un sitio en Vinyl con esta URL. No lo convierta en el sitio Predeterminado. Habilite la opción Redireccionar para requerir HTTPS.