Configuración de un dominio personalizado de sitio

Se deben realizar los siguientes pasos para configurar un dominio personalizado del sitio. Este proceso se puede repetir para sitios adicionales en el mismo dominio, en rutas diferentes o en dominios diferentes.

Configuración de un sitio con un dominio personalizado de sitio

Para que un sitio de Oracle Content Management se cargue correctamente al utilizar un dominio personalizado, debe configurar el sitio para hacerlo. Esto se realiza en las propiedades del sitio.

  1. En Oracle Content Management, haga clic en Sitios en la navegación lateral.

  2. Seleccione el sitio con el que desee usar un dominio personalizado y elija Propiedades en el menú contextual o en la barra de acciones.

  3. Introduzca el dominio personalizado en el campo de dominio personalizado y haga clic en Guardar.

Oracle Content Management puede tardar hasta una hora en estar listo para aceptar solicitudes en el dominio personalizado. Durante este tiempo, puede acceder al sitio en el dominio original. Puede supervisar el progreso en cualquier momento en el panel de propiedades del sitio.

Nota

Si utiliza la CDN de Oracle Content Management, no necesita realizar ninguna acción adicional. Si está utilizando una CDN de terceros diferente, consulte Configuración de la CDN para encaminar solicitudes a un sitio público y Configuración de la CDN para encaminar solicitudes a un sitio seguro. Si es necesario, consulte la CDN para obtener instrucciones específicas.

Configuración de la CDN para encaminar solicitudes a un sitio público

Una vez que Oracle Content Management esté correctamente configurado y listo para aceptarlas, las solicitudes realizadas mediante el dominio personalizado se encaminarán según las entradas de DNS a la CDN y la CDN reenviará las solicitudes a Oracle Content Management. Este enrutamiento se suele realizar con una entrada CNAME en los registros DNS. Consulte la CDN para obtener instrucciones específicas.

Por ejemplo, si un sitio de Oracle Content Management con una URL de sitio https://myinstance.cec.ocp.oraclecloud.com/site/MyCustomerSite/ se configura con un dominio personalizado https://www.example.com/store/, se debe configurar la CDN para que:

  • reconozca el dominio personalizado y la ruta personalizada: https://www.example.com/store/

  • especifique la instancia de Oracle Content Management de origen mediante el dominio personalizado: https://myinstance.cec.ocp.oraclecloud.com/

  • agregue la ruta del sitio específico, en este caso: /site/MyCustomerSite/

  • envíe la URL completa del sitio a la instancia de Oracle Content Management de origen: https://myinstance.cec.ocp.oraclecloud.com/site/MyCustomerSite/.

Oracle Content Management a continuación recibirá la solicitud y responderá a la CDN, que satisface la solicitud en el explorador web del visitante, mostrando solo el dominio personalizado y la ruta personalizada al visitante: https://www.example.com/store/

Los pasos de configuración de la CDN suelen ser específicos de la CDN, por lo que debe trabajar con el proveedor de CDN para configurar correctamente los comportamientos deseados.

Nota

La configuración de la CDN que modifica la ruta no se debe aplicar a ninguna solicitud que contenga las siguientes cadenas. El comodín final es necesario para la coincidencia correcta.
  • /documents*

  • /system*

  • /content/published*

  • /osn*

  • /pxysvc*

  • /_compdelivery/*

  • /_themes/*

  • /site*

  • /_sitesclouddelivery/*

  • /favicon.ico*

Las solicitudes a estas rutas no deben incluir la ruta del sitio, por lo que deben excluirse del comportamiento de modificación de la ruta. Deberían resolver a la raíz de la instancia de Oracle Content Management para estar correctamente gestionadas.

No está soportado el encaminamiento de solicitudes desde un único dominio personalizado a varias instancias de Oracle Content Management. Muchas solicitudes necesarias tienen rutas compartidas que no incluyen un identificador de sitio, por lo que no es posible direccionar correctamente las solicitudes a la instancia correcta. Se recomienda utilizar diferentes dominios o subdominios si está trabajando con varias instancias de Oracle Content Management.

Configuración de la CDN para direccionar solicitudes a un sitio seguro

Un sitio seguro requiere que los visitantes se autentiquen para que Oracle Content Management pueda confirmar que pueden ver el sitio antes de acceder a él. Esta autenticación se gestiona enviando al visitante a un gestor de identidades de Oracle como Oracle Cloud Infrastructure (OCI) Identity and Access Manager (IAM) y, a continuación, nuevamente al sitio una vez que se ha establecido una sesión adecuada. Esto significa que la configuración de CDN para un sitio seguro requiere algunos comportamientos más que para un sitio público. Consulte la CDN para obtener instrucciones específicas.

Por ejemplo, si un sitio de Oracle Content Management seguro con una URL de sitio https://myinstance.cec.ocp.oraclecloud.com/site/authsite/MySecureSite/ se configura con un dominio personalizado https://www.example.com/secure/, se debe configurar la CDN para que:

  • reconozca el dominio personalizado y la ruta personalizada: https://www.example.com/secure/

  • especifique la instancia de Oracle Content Management de origen mediante el dominio personalizado: https://myinstance.cec.ocp.oraclecloud.com/

  • agregue la ruta del sitio para este sitio específico: /site/authsite/MySecureSite/

  • envíe la URL completa del sitio a la instancia de Oracle Content Management de origen: https://myinstance.cec.ocp.oraclecloud.com/site/authsite/MySecureSite/

  • asegurarse de que la cabecera de host de reenvío coincida con el dominio personalizado mediante una opción de valor personalizado o de cabecera de host de entrada.

  • asegurarse de que todas las llamadas a la función del servidor activando los métodos HTTP DELETE, POST, PUT y PATCH, que a menudo no están activados por defecto en las configuraciones de CDN

  • cree una regla independiente que actualice la cabecera de ubicación de la respuesta /cloudgate/v1/oauth2/callback. Esto garantizará que el visitante termine en el dominio y la ruta correctos.

    Por defecto, el usuario autenticado se devolverá a una combinación del dominio personalizado y la ruta del sitio original, como https://www.example.com/site/authsite/MySecureSite/. Desea que el visitante vuelva a https://www.example.com/secure/. Para ello, esta regla se debe ejecutar en la solicitud /cloudgate/v1/oauth2/callback cuando la cabecera de ubicación de la respuesta incluya el nombre del sitio. En este caso, MySecureSite.

    A continuación, esta regla debería ejecutar una búsqueda y sustitución del valor de la cabecera de ubicación, sustituyendo /site/authsite/MySecureSite/ por /secure/. Una operación de búsqueda y sustitución permitirá que todas las páginas del sitio también se redirijan correctamente, donde como una sustitución de ruta simple siempre devolvería al usuario a la página inicial.

Cuando se implanta correctamente, Oracle Content Management recibirá la solicitud y responderá a la CDN, que satisface la solicitud al explorador del visitante, mostrando solo el dominio personalizado y la ruta al visitante. En este ejemplo: https://www.example.com/secure/

Los pasos de configuración de la CDN suelen ser específicos de la CDN, por lo que debe trabajar con el proveedor de CDN para configurar correctamente los comportamientos descritos.