Uso de la red de entrega de contenido (CDN) de Office 365 con SharePoint Online

  • Artículo
  • Tiempo de lectura: 21 minutos

Puede usar la red de entrega de contenido (CDN) de Office 365 integrada para hospedar archivos estáticos y mejorar el rendimiento de las páginas de SharePoint Online. La CDN de Office 365 mejora el rendimiento al almacenamiento en caché los archivos estáticos más cerca de los exploradores que los solicitan, lo que ayuda a acelerar descargas y reducir la latencia. Además, el Office 365 CDN usa el protocolo HTTP/2 para mejorar la compresión y la canalización HTTP. La red CDN de Office 365 se incluye como parte de la suscripción a SharePoint Online.

Nota

La Office 365 CDN solo está disponible para los inquilinos en la nube de producción (en todo el mundo). Actualmente, los inquilinos de las nubes de Estados Unidos, China y Alemania no admiten el Office 365 CDN.

La CDN de Office 365 se compone de varias redes CDN que permite hospedar archivos estáticos en varias ubicaciones u orígenes y a realizar la entrega desde redes de alta velocidad globales. Según el tipo de contenido que quiera hospedar en la CDN de Office 365, puede agregar orígenes públicos, privados o ambos. Vea Elegir si cada origen debe ser público o privado para obtener más información sobre la diferencia entre orígenes públicos y privados.

Office 365 CDN diagrama conceptual.

Si ya está familiarizado con la forma en que funcionan las CDN, solo tiene que completar unos pasos para habilitar el Office 365 CDN para el inquilino. En este tema se describe cómo. Sigue leyendo para obtener información sobre cómo empezar a hospedar los activos estáticos.

Sugerencia

Hay otras CDN hospedadas en Microsoft que se pueden usar con Office 365 para escenarios de uso especializado, pero no se abordan en este tema porque están fuera del ámbito de la Office 365 CDN. Para obtener más información, vea Other Microsoft CDNs.

Vuelva a Planificación de red yajuste del rendimiento para Office 365 .

Información general sobre cómo trabajar con el Office 365 CDN en SharePoint Online

Para configurar el Office 365 CDN para su organización, siga estos pasos básicos:

Una vez que haya terminado con la configuración, puede administrar el Office 365 CDN con el tiempo:

  • Agregar, actualizar y quitar activos
  • Agregar y quitar orígenes
  • Configuración de CDN directivas
  • Si es necesario, deshabilitar el CDN

Por último, consulte Uso de los CDN para obtener información sobre cómo obtener acceso a los CDN desde orígenes públicos y privados.

Consulte Troubleshooting the Office 365 CDN para obtener instrucciones sobre cómo resolver problemas comunes.

Planear la implementación del Office 365 CDN

Antes de implementar el Office 365 CDN para el inquilino Office 365, debe tener en cuenta los siguientes factores como parte del proceso de planeación.

Determine qué activos estáticos desea hospedar en el CDN

En general, las CDN son más eficaces para hospedar activos estáticos o activos que no cambian con mucha frecuencia. Una buena regla general es identificar los archivos que cumplen algunas o todas estas condiciones:

  • Archivos estáticos incrustados en una página (como scripts e imágenes) que pueden tener un impacto incremental significativo en los tiempos de carga de la página
  • Archivos grandes como archivos ejecutables y archivos de instalación
  • Bibliotecas de recursos que admiten código del lado cliente

Por ejemplo, los archivos pequeños que se solicitan repetidamente, como imágenes de sitio y scripts, pueden mejorar significativamente el rendimiento de representación del sitio y reducir incrementalmente la carga en los sitios de SharePoint Online al agregarlos a un origen de CDN. Los archivos más grandes, como los ejecutables de instalación, se pueden descargar desde el CDN, lo que proporciona un impacto positivo en el rendimiento y una reducción posterior de la carga en el sitio de SharePoint Online, incluso si no se tiene acceso a ellos con tanta frecuencia.

La mejora del rendimiento por archivo depende de muchos factores, como la proximidad del cliente al punto de conexión de CDN más cercano, las condiciones transitorias en la red local, etc. Muchos archivos estáticos son bastante pequeños y se pueden descargar desde Office 365 en menos de un segundo. Sin embargo, una página web puede contener muchos archivos incrustados con un tiempo de descarga acumulado de varios segundos. Servir estos archivos desde el CDN puede reducir significativamente el tiempo de carga de la página general. Vea ¿Qué mejoras de rendimiento CDN proporciona? para ver un ejemplo.

Determinar dónde desea almacenar los activos

El CDN recupera los activos de una ubicación denominada origen. Un origen puede ser un sitio SharePoint, biblioteca de documentos o carpeta a la que una dirección URL puede tener acceso. Tiene una gran flexibilidad al especificar orígenes para su organización. Por ejemplo, puede especificar varios orígenes o un único origen en el que desea colocar todos los CDN activos. Puede elegir tener orígenes públicos o privados para su organización. La mayoría de las organizaciones elegirán implementar una combinación de las dos.

Puede crear un nuevo contenedor para sus orígenes, como carpetas o bibliotecas de documentos, y agregar archivos que desee que estén disponibles desde el CDN. Este es un buen enfoque si tiene un conjunto específico de activos que desea que estén disponibles en el CDN y desea restringir el conjunto de activos de CDN solo a los archivos del contenedor.

También puede configurar una colección de sitios, un sitio, una biblioteca o una carpeta existentes como origen, lo que hará que todos los activos elegibles del contenedor estén disponibles en el CDN. Antes de agregar un contenedor existente como origen, es importante asegurarse de que está al tanto de su contenido y permisos para que no exponga de forma involuntaria los activos al acceso anónimo o a usuarios no autorizados.

Puede definir directivas de CDN para excluir el contenido de sus orígenes de la CDN. CDN excluyen activos en orígenes públicos o privados por atributos como el tipo de archivo y la clasificación de sitios, y se aplican a todos los orígenes de CdnType (privado o público) que especifique en la directiva. Por ejemplo, si agrega un origen privado que consta de un sitio que contiene varios subsitios, puede definir una directiva para excluir sitios marcados como confidenciales de modo que el contenido de los sitios con esa clasificación aplicada no se sirve desde el CDN. La directiva se aplicará al contenido de todos los orígenes privados que haya agregado al CDN.

Tenga en cuenta que, a mayor número de orígenes, mayor será el impacto en el tiempo que tarda el servicio CDN procesar las solicitudes. Se recomienda limitar el número de orígenes tanto como sea posible.

Elegir si cada origen debe ser público o privado

Al identificar un origen, se especifica si se debe hacer público o privado. El acceso CDN activos en orígenes públicos es anónimo y CDN contenido en orígenes privados se protege mediante tokens generados dinámicamente para mayor seguridad. Independientemente de la opción que elija, Microsoft hace todo el trabajo pesado para usted cuando se trata de la administración del CDN sí mismo. Además, puedes cambiar de opinión más adelante, después de configurar el CDN e identificar tus orígenes.

Las opciones públicas y privadas proporcionan ganancias de rendimiento similares, pero cada una tiene atributos y ventajas únicos.

Los orígenes públicos dentro del Office 365 CDN son accesibles de forma anónima y cualquier persona que tenga la dirección URL del activo puede acceder a los activos hospedados. Como el acceso al contenido en orígenes públicos es anónimo, solo debe usarlos para almacenar en caché contenido genérico y no confidencial, como archivos JavaScript, scripts, iconos e imágenes.

Los orígenes privados dentro del Office 365 CDN proporcionan acceso privado al contenido del usuario, como bibliotecas de documentos en línea, sitios e imágenes propietarias de SharePoint en línea. El acceso al contenido en orígenes privados está protegido por tokens generados dinámicamente para que solo puedan acceder a él los usuarios con permisos para la biblioteca de documentos original o la ubicación de almacenamiento. Los orígenes privados de la Office 365 CDN solo se pueden usar para el contenido de SharePoint Online y solo puede acceder a activos en orígenes privados mediante el redireccionamiento desde el inquilino de SharePoint Online.

Puede obtener más información sobre cómo CDN acceso a activos en un origen privado funciona en Uso de activos en orígenes privados.

Atributos y ventajas de hospedar activos en orígenes públicos

  • Cualquier persona puede acceder a los activos expuestos en un origen público de forma anónima.

    Importante

    Nunca debe colocar recursos que contengan información de usuario o que se consideren confidenciales para su organización en un origen público.

  • Si elimina un activo de un origen público, el activo podría continuar disponible durante un máximo de 30 días desde la memoria caché. Sin embargo, se invalidarán los vínculos a los activos en la red CDN en 15 minutos.

  • Si hospeda hojas de estilo (archivos CSS) en un origen público, puede usar las rutas relativas y URI dentro del código. Esto significa que puede hacer referencia a la ubicación de las imágenes de fondo y otros objetos con respecto a la ubicación del activo que está llamando.

  • Aunque puede crear la dirección URL de un origen público, debe proceder con precaución y asegurarse de usar la propiedad de contexto de página y seguir las instrucciones para hacerlo. El motivo de esto es que, si no está disponible el acceso a la red CDN, la dirección URL no resolverá automáticamente su organización en SharePoint Online y podría producir vínculos rotos y otros errores. La dirección URL también está sujeta a cambios, por lo que no debe codificarse de forma sencilla en su valor actual.

  • Los tipos de archivo predeterminados que se incluyen para orígenes públicos son .css, .eot, .gif, .ico, .jpeg, .jpg, .js, .map, .png, .svg, .ttf, .woff y .woff2. Puede especificar tipos de archivo adicionales.

  • Puede configurar una directiva para excluir los activos identificados por las clasificaciones de sitios que especifique. Por ejemplo, puede elegir excluir todos los activos que están marcados como restringidos o confidenciales aunque sean un tipo de archivo permitido y se encuentren en un origen público.

Atributos y ventajas de hospedar activos en orígenes privados

  • Los orígenes privados solo se pueden usar para SharePoint activos en línea.

  • Los usuarios solo pueden obtener acceso a los activos desde un origen privado si tienen permisos para acceder al contenedor. Se impide el acceso anónimo a estos activos.

  • Los activos de orígenes privados deben referirse desde el espacio empresarial SharePoint Online. El acceso directo a los CDN privados no funciona.

  • Si quita un activo del origen privado, el activo puede seguir estando disponible hasta una hora desde la memoria caché; sin embargo, invalidaremos los vínculos al activo en el CDN 15 minutos después de la eliminación del activo.

  • Los tipos de archivo predeterminados que se incluyen en el origen privado son .gif, .ico, .jpeg, .jpg, .js y .png. Puede especificar tipos de archivo adicionales.

  • Al igual que con los orígenes públicos, puede configurar una directiva para excluir los activos identificados por las clasificaciones de sitios que especifique incluso si usa caracteres comodín para incluir todos los activos de una carpeta o biblioteca de documentos.

Para obtener más información acerca de por qué usar los Office 365 CDN, los conceptos CDN generales y otras CDN de Microsoft que puede usar con su inquilino de Office 365, vea Redes de entrega de contenido.

Orígenes CDN predeterminado

A menos que especifique lo contrario, Office 365 configurar algunos orígenes predeterminados automáticamente al habilitar el Office 365 CDN. Si inicialmente opta por no aprovisionarlos, puede agregar estos orígenes después de completar la configuración. A menos que comprenda las consecuencias de omitir la configuración de orígenes predeterminados y tenga una razón específica para hacerlo, debe permitir que se cree cuando habilite el CDN.

Orígenes de CDN privados predeterminados:

  • */userphoto.aspx
  • */siteassets

Orígenes CDN públicos predeterminados:

  • */masterpage
  • *Biblioteca /style
  • */clientsideassets

Nota

clientsideassets es un origen público predeterminado que se agregó al servicio Office 365 CDN en diciembre de 2017. Este origen debe estar presente para que SharePoint Framework soluciones en el CDN funcionen. Si ha habilitado el Office 365 CDN anterior a diciembre de 2017 o si omitió la configuración de orígenes predeterminados al habilitar el CDN, puede agregar manualmente este origen. Para obtener más información, vea My client-side web part or SharePoint Framework solution isn't working.

Configurar y configurar el Office 365 CDN mediante el Shell SharePoint administración en línea

Los procedimientos de esta sección requieren que use el Shell de administración SharePoint Online para conectarse a SharePoint Online. Para obtener instrucciones, consulte Connect to SharePoint Online PowerShell.

Complete estos pasos para configurar y configurar el CDN para hospedar los activos en SharePoint Online mediante el Shell SharePoint administración en línea.

Haga clic para expandir

Permitir que la organización use el Office 365 CDN

Antes de realizar cambios en la configuración de CDN inquilino, debe recuperar el estado actual de la configuración de CDN privada en el Office 365 inquilino. Conectar a su inquilino mediante el Shell SharePoint administración en línea:

Connect-SPOService -Url https://contoso-admin.sharepoint.com

Ahora use el cmdlet Get-SPOTenantCdnEnabled para recuperar la configuración CDN estado del inquilino:

Get-SPOTenantCdnEnabled -CdnType <Public | Private>

El estado de la CDN para el CdnType especificado se mostrará en la pantalla.

Use el cmdlet Set-SPOTenantCdnEnabled para permitir que su organización use el Office 365 CDN. Puede permitir que su organización use orígenes públicos, orígenes privados o ambos a la vez. También puede configurar el CDN para omitir la configuración de orígenes predeterminados al habilitarlo. Siempre puede agregar estos orígenes más adelante, como se describe en este tema.

En Windows PowerShell para SharePoint Online:

Set-SPOTenantCdnEnabled -CdnType <Public | Private | Both> -Enable $true

Por ejemplo, para permitir que la organización use orígenes públicos y privados, escriba el siguiente comando:

Set-SPOTenantCdnEnabled -CdnType Both -Enable $true

Para permitir que la organización use orígenes públicos y privados, pero omitir la configuración de los orígenes predeterminados, escriba el siguiente comando:

Set-SPOTenantCdnEnabled -CdnType Both -Enable $true -NoDefaultOrigins

Consulte Default CDN origins para obtener información sobre los orígenes que se aprovisionan de forma predeterminada al habilitar el Office 365 CDN y el posible impacto de omitir la configuración de orígenes predeterminados.

Para permitir que la organización use orígenes públicos, escriba el siguiente comando:

Set-SPOTenantCdnEnabled -CdnType Public -Enable $true

Para permitir que la organización use orígenes privados, escriba el siguiente comando:

Set-SPOTenantCdnEnabled -CdnType Private -Enable $true

Para obtener más información acerca de este cmdlet, vea Set-SPOTenantCdnEnabled.

Cambiar la lista de tipos de archivo para incluir en el Office 365 CDN (opcional)

Sugerencia

Al definir tipos de archivo mediante el cmdlet Set-SPOTenantCdnPolicy, se sobrescribe la lista definida actualmente. Si desea agregar tipos de archivo adicionales a la lista, use primero el cmdlet para averiguar qué tipos de archivo ya están permitidos e incluirlos en la lista junto con los nuevos.

Use el cmdlet Set-SPOTenantCdnPolicy para definir tipos de archivo estáticos que pueden hospedarse en orígenes públicos y privados en el CDN. De forma predeterminada, se permiten tipos de activos comunes, como .css, .gif, .jpg y .js.

En Windows PowerShell para SharePoint Online:

Set-SPOTenantCdnPolicy -CdnType <Public | Private> -PolicyType IncludeFileExtensions -PolicyValue "<Comma-separated list of file types >"

Por ejemplo, para habilitar el CDN para hospedar archivos .css y .png, escribiría el comando:

Set-SPOTenantCdnPolicy -CdnType Private -PolicyType IncludeFileExtensions -PolicyValue "CSS,PNG"

Para ver qué tipos de archivo permiten actualmente los CDN, use el cmdlet Get-SPOTenantCdnPolicies:

Get-SPOTenantCdnPolicies -CdnType <Public | Private>

Para obtener más información acerca de estos cmdlets, vea Set-SPOTenantCdnPolicy y Get-SPOTenantCdnPolicies.

Cambiar la lista de clasificaciones de sitios que desea excluir del Office 365 CDN (opcional)

Sugerencia

Cuando se excluyen las clasificaciones de sitios mediante el cmdlet Set-SPOTenantCdnPolicy, se sobrescribe la lista definida actualmente. Si desea excluir clasificaciones de sitios adicionales, use el cmdlet primero para averiguar qué clasificaciones ya están excluidas y, a continuación, agregarlas junto con las nuevas.

Use el cmdlet Set-SPOTenantCdnPolicy para excluir las clasificaciones de sitio que no desee que estén disponibles en la red CDN. De forma predeterminada, no se excluyen clasificaciones de sitio.

En Windows PowerShell para SharePoint Online:

Set-SPOTenantCdnPolicy -CdnType <Public | Private> -PolicyType ExcludeRestrictedSiteClassifications  -PolicyValue "<Comma-separated list of site classifications >"

Para ver qué clasificaciones de sitios están restringidas actualmente, use el cmdlet Get-SPOTenantCdnPolicies:

Get-SPOTenantCdnPolicies -CdnType <Public | Private>

Las propiedades que se devolverán son IncludeFileExtensions, ExcludeRestrictedSiteClassifications y ExcludeIfNoScriptDisabled.

La propiedad IncludeFileExtensions contiene la lista de extensiones de archivo que se van a servir desde el CDN.

Nota

Las extensiones de archivo predeterminadas son diferentes entre lo público y lo privado.

La propiedad ExcludeRestrictedSiteClassifications contiene las clasificaciones de sitios que desea excluir del CDN. Por ejemplo, puede excluir sitios marcados como confidenciales para que el contenido de los sitios con esa clasificación aplicada no se pueda servir desde el CDN.

La propiedad ExcludeIfNoScriptDisabled excluye el contenido de la CDN según la configuración del atributo NoScript de nivel de sitio. De forma predeterminada, el atributo NoScript se establece en Habilitado para sitios modernos y Deshabilitado para sitios clásicos. Esto depende de la configuración del espacio empresarial.

Para obtener más información acerca de estos cmdlets, vea Set-SPOTenantCdnPolicy y Get-SPOTenantCdnPolicies.

Agregar un origen para los activos

Use el cmdlet Add-SPOTenantCdnOrigin para definir un origen. Puede definir varios orígenes. El origen es una dirección URL que apunta a una biblioteca de SharePoint o la carpeta que contiene los activos que desea que se hospeden mediante la red CDN.

Importante

Nunca debe colocar recursos que contengan información de usuario o que se consideren confidenciales para su organización en un origen público.

Add-SPOTenantCdnOrigin -CdnType <Public | Private> -OriginUrl <path>

El valor de path es la ruta de acceso relativa a la biblioteca o carpeta que contiene los activos. Puede usar caracteres comodín además de rutas relativas. Los orígenes admiten caracteres comodín anteponer a la dirección URL. Esto le permite crear orígenes que abarcan varios sitios. Por ejemplo, para incluir todos los activos en la carpeta masterpages de todos los sitios como origen público dentro del CDN, escriba el siguiente comando:

Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
  • El modificador de caracteres comodín * solo se puede usar al principio de la ruta de acceso y coincidirá con todos los / segmentos de dirección URL en la dirección URL especificada.
  • La ruta de acceso puede apuntar a una biblioteca de documentos, una carpeta o un sitio. Por ejemplo, la ruta */site1 coincidirá con todas las bibliotecas de documentos del sitio.

Puede agregar un origen con una ruta de acceso relativa específica. No se puede agregar un origen mediante la ruta de acceso completa.

En este ejemplo se agrega un origen privado de la biblioteca siteassets en un sitio específico:

Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl sites/site1/siteassets

En este ejemplo se agrega un origen privado de la carpeta folder1 de la biblioteca de activos de sitio de la colección de sitios:

Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl sites/test/siteassets/folder1

Si hay un espacio en la ruta de acceso, puede rodear la ruta entre comillas dobles o reemplazar el espacio con la codificación de dirección URL %20. En los ejemplos siguientes se agrega un origen privado de la carpeta 1 de la biblioteca de activos de sitio de la colección de sitios:

Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl sites/test/siteassets/folder%201

Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl "sites/test/siteassets/folder 1"

Para obtener más información acerca de este comando y su sintaxis, vea Add-SPOTenantCdnOrigin.

Nota

En orígenes privados, los activos que se comparten desde un origen deben tener una versión principal publicada para poder acceder a ellos desde el CDN.

Una vez ejecutado el comando, el sistema sincroniza la configuración en todo el centro de datos. Esto puede tardar hasta 15 minutos.

Ejemplo: configurar un origen público para las páginas maestras y para la biblioteca de estilos para SharePoint Online

Normalmente, estos orígenes se establecen automáticamente cuando se habilita el Office 365 CDN. Sin embargo, si desea habilitarlos manualmente, siga estos pasos.

  • Use el cmdlet Add-SPOTenantCdnOrigin para definir la biblioteca de estilos como un origen público.

    Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */style%20library

  • Use el cmdlet Add-SPOTenantCdnOrigin para definir las páginas maestras como un origen público.

    Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */masterpage

Para obtener más información acerca de este comando y su sintaxis, vea Add-SPOTenantCdnOrigin.

Una vez ejecutado el comando, el sistema sincroniza la configuración en todo el centro de datos. Esto puede tardar hasta 15 minutos.

Ejemplo: configurar un origen privado para los activos del sitio, páginas de sitio e imágenes de publicación para SharePoint Online

  • Use el cmdlet Add-SPOTenantCdnOrigin para definir la carpeta de activos del sitio como un origen privado.

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */siteassets

  • Use el cmdlet Add-SPOTenantCdnOrigin para definir la carpeta de páginas del sitio como un origen privado.

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */sitepages

  • Use el cmdlet Add-SPOTenantCdnOrigin para definir la carpeta de imágenes de publicación como un origen privado.

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */publishingimages

Para obtener más información acerca de este comando y su sintaxis, vea Add-SPOTenantCdnOrigin.

Una vez ejecutado el comando, el sistema sincroniza la configuración en todo el centro de datos. Esto puede tardar hasta 15 minutos.

Ejemplo: Configurar un origen privado para una colección de sitios para SharePoint Online

Use el cmdlet Add-SPOTenantCdnOrigin para definir una colección de sitios como un origen privado. Por ejemplo:

Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl sites/site1/siteassets

Para obtener más información acerca de este comando y su sintaxis, vea Add-SPOTenantCdnOrigin.

Una vez ejecutado el comando, el sistema sincroniza la configuración en todo el centro de datos. Es posible que vea un mensaje pendiente de configuración que se espera a medida que el inquilino de SharePoint Online se conecta al CDN cliente. Esto puede tardar hasta 15 minutos.

Administrar el Office 365 CDN

Una vez que haya configurado el CDN, puede realizar cambios en la configuración a medida que actualiza el contenido o a medida que cambian sus necesidades, como se describe en esta sección.

Agregar, actualizar o quitar activos de la Office 365 CDN

Una vez que hayas completado los pasos de configuración, puedes agregar nuevos activos y actualizar o quitar activos existentes cuando quieras. Solo tiene que realizar los cambios en los activos de la carpeta o SharePoint que identificó como origen. Si agrega un nuevo activo, está disponible a través del CDN inmediatamente. Sin embargo, si actualiza el activo, la nueva copia tardaría hasta 15 minutos en propagarse y estar disponible en el CDN.

Si necesita recuperar la ubicación del origen, puede usar el cmdlet Get-SPOTenantCdnOrigins. Para obtener información sobre cómo usar este cmdlet, vea Get-SPOTenantCdnOrigins.

Quitar un origen de la Office 365 CDN

Puede quitar el acceso a una carpeta o biblioteca SharePoint que identificó como origen. Para ello, use el cmdlet Remove-SPOTenantCdnOrigin.

Remove-SPOTenantCdnOrigin -OriginUrl <path> -CdnType <Public | Private | Both>

Para obtener información sobre cómo usar este cmdlet, vea Remove-SPOTenantCdnOrigin.

Modificar un origen en el Office 365 CDN

No puede modificar un origen que haya creado. En su lugar, quite el origen y, a continuación, agregue uno nuevo. Para obtener más información, vea Para quitar un origen de la Office 365 CDN y Para agregar un origen para los activos.

Deshabilitar el Office 365 CDN

Use el cmdlet Set-SPOTenantCdnEnabled para deshabilitar el CDN de la organización. Si tiene los orígenes públicos y privados habilitados para el CDN, debe ejecutar el cmdlet dos veces como se muestra en los ejemplos siguientes.

Para deshabilitar el uso de orígenes públicos en el CDN, escriba el siguiente comando:

Set-SPOTenantCdnEnabled -CdnType Public -Enable $false

Para deshabilitar el uso de los orígenes privados en el CDN, escriba el siguiente comando:

Set-SPOTenantCdnEnabled -CdnType Private -Enable $false

Para obtener más información acerca de este cmdlet, vea Set-SPOTenantCdnEnabled.

Configurar y configurar el Office 365 CDN mediante PowerShell pnP

Los procedimientos de esta sección requieren que use PnP PowerShell para conectarse a SharePoint Online. Para obtener instrucciones, consulte Getting started with PnP PowerShell.

Complete estos pasos para configurar y configurar el CDN para hospedar los activos en SharePoint Online con PowerShell pnP.

Haga clic para expandir

Permitir que la organización use el Office 365 CDN

Antes de realizar cambios en la configuración de CDN inquilino, debe recuperar el estado actual de la configuración de CDN privada en el Office 365 inquilino. Conectar a su inquilino con PnP PowerShell:

Connect-PnPOnline -Url https://contoso-admin.sharepoint.com -UseWebLogin

Ahora use el cmdlet Get-PnPTenantCdnEnabled para recuperar la CDN de estado del inquilino:

Get-PnPTenantCdnEnabled -CdnType <Public | Private>

El estado de la CDN para el CdnType especificado se mostrará en la pantalla.

Use el cmdlet Set-PnPTenantCdnEnabled para permitir que su organización use el Office 365 CDN. Puede permitir que su organización use orígenes públicos, orígenes privados o ambos al mismo tiempo. También puede configurar el CDN para omitir la configuración de orígenes predeterminados al habilitarlo. Siempre puede agregar estos orígenes más adelante, como se describe en este tema.

En PowerShell pnP:

Set-PnPTenantCdnEnabled -CdnType <Public | Private | Both> -Enable $true

Por ejemplo, para permitir que la organización use orígenes públicos y privados, escriba el siguiente comando:

Set-PnPTenantCdnEnabled -CdnType Both -Enable $true

Para permitir que la organización use orígenes públicos y privados, pero omitir la configuración de los orígenes predeterminados, escriba el siguiente comando:

Set-PnPTenantCdnEnabled -CdnType Both -Enable $true -NoDefaultOrigins

Consulte Default CDN origins para obtener información sobre los orígenes que se aprovisionan de forma predeterminada al habilitar el Office 365 CDN y el posible impacto de omitir la configuración de orígenes predeterminados.

Para permitir que la organización use orígenes públicos, escriba el siguiente comando:

Set-PnPTenantCdnEnabled -CdnType Public -Enable $true

Para permitir que la organización use orígenes privados, escriba el siguiente comando:

Set-PnPTenantCdnEnabled -CdnType Private -Enable $true

Para obtener más información acerca de este cmdlet, vea Set-PnPTenantCdnEnabled.

Cambiar la lista de tipos de archivo para incluir en el Office 365 CDN (opcional)

Sugerencia

Al definir tipos de archivo mediante el cmdlet Set-PnPTenantCdnPolicy, se sobrescribe la lista definida actualmente. Si desea agregar tipos de archivo adicionales a la lista, use primero el cmdlet para averiguar qué tipos de archivo ya están permitidos e incluirlos en la lista junto con los nuevos.

Use el cmdlet Set-PnPTenantCdnPolicy para definir tipos de archivo estáticos que pueden hospedarse en orígenes públicos y privados en el CDN. De forma predeterminada, se permiten tipos de activos comunes, como .css, .gif, .jpg y .js.

En PowerShell pnP:

Set-PnPTenantCdnPolicy -CdnType <Public | Private> -PolicyType IncludeFileExtensions -PolicyValue "<Comma-separated list of file types >"

Por ejemplo, para habilitar el CDN para hospedar archivos .css y .png, escribiría el comando:

Set-PnPTenantCdnPolicy -CdnType Private -PolicyType IncludeFileExtensions -PolicyValue "CSS,PNG"

Para ver qué tipos de archivo permiten actualmente los CDN, use el cmdlet Get-PnPTenantCdnPolicies:

Get-PnPTenantCdnPolicies -CdnType <Public | Private>

Para obtener más información acerca de estos cmdlets, vea Set-PnPTenantCdnPolicy y Get-PnPTenantCdnPolicies.

Cambiar la lista de clasificaciones de sitios que desea excluir del Office 365 CDN (opcional)

Sugerencia

Cuando se excluyen las clasificaciones de sitios mediante el cmdlet Set-PnPTenantCdnPolicy, se sobrescribe la lista definida actualmente. Si desea excluir clasificaciones de sitios adicionales, use el cmdlet primero para averiguar qué clasificaciones ya están excluidas y, a continuación, agregarlas junto con las nuevas.

Use el cmdlet Set-PnPTenantCdnPolicy para excluir las clasificaciones de sitios que no desea que estén disponibles en el CDN. De forma predeterminada, no se excluyen clasificaciones de sitio.

En PowerShell pnP:

Set-PnPTenantCdnPolicy -CdnType <Public | Private> -PolicyType ExcludeRestrictedSiteClassifications  -PolicyValue "<Comma-separated list of site classifications>"

Para ver qué clasificaciones de sitios están restringidas actualmente, use el cmdlet Get-PnPTenantCdnPolicies:

Get-PnPTenantCdnPolicies -CdnType <Public | Private>

Las propiedades que se devolverán son IncludeFileExtensions, ExcludeRestrictedSiteClassifications y ExcludeIfNoScriptDisabled.

La propiedad IncludeFileExtensions contiene la lista de extensiones de archivo que se van a servir desde el CDN.

Nota

Las extensiones de archivo predeterminadas son diferentes entre lo público y lo privado.

La propiedad ExcludeRestrictedSiteClassifications contiene las clasificaciones de sitios que desea excluir del CDN. Por ejemplo, puede excluir sitios marcados como confidenciales para que el contenido de los sitios con esa clasificación aplicada no se pueda servir desde el CDN.

La propiedad ExcludeIfNoScriptDisabled excluye el contenido de la CDN según la configuración del atributo NoScript de nivel de sitio. De forma predeterminada, el atributo NoScript se establece en Habilitado para sitios modernos y Deshabilitado para sitios clásicos. Esto depende de la configuración del espacio empresarial.

Para obtener más información acerca de estos cmdlets, vea Set-PnPTenantCdnPolicy y Get-PnPTenantCdnPolicies.

Agregar un origen para los activos

Use el cmdlet Add-PnPTenantCdnOrigin para definir un origen. Puede definir varios orígenes. El origen es una dirección URL que apunta a una biblioteca de SharePoint o la carpeta que contiene los activos que desea que se hospeden mediante la red CDN.

Importante

Nunca debe colocar recursos que contengan información de usuario o que se consideren confidenciales para su organización en un origen público.

Add-PnPTenantCdnOrigin -CdnType <Public | Private> -OriginUrl <path>

El valor de path es la ruta de acceso relativa a la biblioteca o carpeta que contiene los activos. Puede usar caracteres comodín además de rutas relativas. Los orígenes admiten caracteres comodín anteponer a la dirección URL. Esto le permite crear orígenes que abarcan varios sitios. Por ejemplo, para incluir todos los activos en la carpeta masterpages de todos los sitios como origen público dentro del CDN, escriba el siguiente comando:

Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
  • El modificador de caracteres comodín * solo se puede usar al principio de la ruta de acceso y coincidirá con todos los / segmentos de dirección URL en la dirección URL especificada.
  • La ruta de acceso puede apuntar a una biblioteca de documentos, una carpeta o un sitio. Por ejemplo, la ruta */site1 coincidirá con todas las bibliotecas de documentos del sitio.

Puede agregar un origen con una ruta de acceso relativa específica. No se puede agregar un origen mediante la ruta de acceso completa.

En este ejemplo se agrega un origen privado de la biblioteca de activos del sitio en un sitio específico:

Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl sites/site1/siteassets

En este ejemplo se agrega un origen privado de la carpeta folder1 de la biblioteca de activos de sitio de la colección de sitios:

Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl sites/test/siteassets/folder1

Si hay un espacio en la ruta de acceso, puede rodear la ruta entre comillas dobles o reemplazar el espacio con la codificación de dirección URL %20. En los ejemplos siguientes se agrega un origen privado de la carpeta 1 de la biblioteca de activos de sitio de la colección de sitios:

Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl sites/test/siteassets/folder%201

Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl "sites/test/siteassets/folder 1"

Para obtener más información acerca de este comando y su sintaxis, vea Add-PnPTenantCdnOrigin.

Nota

En orígenes privados, los activos que se comparten desde un origen deben tener una versión principal publicada para poder acceder a ellos desde el CDN.

Una vez ejecutado el comando, el sistema sincroniza la configuración en todo el centro de datos. Esto puede tardar hasta 15 minutos.

Ejemplo: configurar un origen público para las páginas maestras y para la biblioteca de estilos para SharePoint Online

Normalmente, estos orígenes se establecen automáticamente cuando se habilita el Office 365 CDN. Sin embargo, si desea habilitarlos manualmente, siga estos pasos.

  • Use el cmdlet Add-PnPTenantCdnOrigin para definir la biblioteca de estilos como un origen público.

    Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */style%20library

  • Use el cmdlet Add-PnPTenantCdnOrigin para definir las páginas maestras como un origen público.

    Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */masterpage

Para obtener más información acerca de este comando y su sintaxis, vea Add-PnPTenantCdnOrigin.

Una vez ejecutado el comando, el sistema sincroniza la configuración en todo el centro de datos. Esto puede tardar hasta 15 minutos.

Ejemplo: configurar un origen privado para los activos del sitio, páginas de sitio e imágenes de publicación para SharePoint Online

  • Use el cmdlet Add-PnPTenantCdnOrigin para definir la carpeta de activos del sitio como un origen privado.

    Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */siteassets

  • Use el cmdlet Add-PnPTenantCdnOrigin para definir la carpeta de páginas del sitio como un origen privado.

    Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */sitepages

  • Use el cmdlet Add-PnPTenantCdnOrigin para definir la carpeta de imágenes de publicación como un origen privado.

    Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */publishingimages

Para obtener más información acerca de este comando y su sintaxis, vea Add-PnPTenantCdnOrigin.

Una vez ejecutado el comando, el sistema sincroniza la configuración en todo el centro de datos. Esto puede tardar hasta 15 minutos.

Ejemplo: Configurar un origen privado para una colección de sitios para SharePoint Online

Use el cmdlet Add-PnPTenantCdnOrigin para definir una colección de sitios como un origen privado. Por ejemplo:

Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl sites/site1/siteassets

Para obtener más información acerca de este comando y su sintaxis, vea Add-PnPTenantCdnOrigin.

Una vez ejecutado el comando, el sistema sincroniza la configuración en todo el centro de datos. Es posible que vea un mensaje pendiente de configuración que se espera a medida que el inquilino de SharePoint Online se conecta al CDN cliente. Esto puede tardar hasta 15 minutos.

Administrar el Office 365 CDN

Una vez que haya configurado el CDN, puede realizar cambios en la configuración a medida que actualiza el contenido o a medida que cambian sus necesidades, como se describe en esta sección.

Agregar, actualizar o quitar activos de la Office 365 CDN

Una vez que hayas completado los pasos de configuración, puedes agregar nuevos activos y actualizar o quitar activos existentes cuando quieras. Solo tiene que realizar los cambios en los activos de la carpeta o SharePoint que identificó como origen. Si agrega un nuevo activo, está disponible a través del CDN inmediatamente. Sin embargo, si actualiza el activo, la nueva copia tardaría hasta 15 minutos en propagarse y estar disponible en el CDN.

Si necesita recuperar la ubicación del origen, puede usar el cmdlet Get-PnPTenantCdnOrigin. Para obtener información sobre cómo usar este cmdlet, vea Get-PnPTenantCdnOrigin.

Quitar un origen de la Office 365 CDN

Puede quitar el acceso a una carpeta o biblioteca SharePoint que identificó como origen. Para ello, use el cmdlet Remove-PnPTenantCdnOrigin.

Remove-PnPTenantCdnOrigin -OriginUrl <path> -CdnType <Public | Private | Both>

Para obtener información sobre cómo usar este cmdlet, vea Remove-PnPTenantCdnOrigin.

Modificar un origen en el Office 365 CDN

No puede modificar un origen que haya creado. En su lugar, quite el origen y, a continuación, agregue uno nuevo. Para obtener más información, vea Para quitar un origen de la Office 365 CDN y Para agregar un origen para los activos.

Deshabilitar el Office 365 CDN

Use el cmdlet Set-PnPTenantCdnEnabled para deshabilitar el CDN de la organización. Si tiene los orígenes públicos y privados habilitados para el CDN, debe ejecutar el cmdlet dos veces como se muestra en los ejemplos siguientes.

Para deshabilitar el uso de orígenes públicos en el CDN, escriba el siguiente comando:

Set-PnPTenantCdnEnabled -CdnType Public -Enable $false

Para deshabilitar el uso de los orígenes privados en el CDN, escriba el siguiente comando:

Set-PnPTenantCdnEnabled -CdnType Private -Enable $false

Para obtener más información acerca de este cmdlet, vea Set-PnPTenantCdnEnabled.

Instalar y configurar la red CDN de Office 365 con la CLI de Office 365

Los procedimientos de esta sección requieren que haya instalado el Office 365 CLI. Después, conéctese a su Office 365 con el comando de inicio de sesión.

Complete estos pasos para configurar y configurar el CDN para hospedar los activos en SharePoint Online mediante la CLI Office 365.

Haga clic para expandir

Habilitar el Office 365 CDN

Puede administrar el estado de la red CDN de Office 365 en su cuenta empresarial con el comando spo cdn set.

Para habilitar la red CDN pública de Office 365 en su cuenta empresarial ejecute:

spo cdn set --type Public --enabled true

Para habilitar la Office 365 SharePoint CDN, ejecute:

spo cdn set --type Private --enabled true

Vea el estado actual de la red CDN de Office 365.

Para comprobar si el tipo concreto de Office 365 CDN está habilitado o deshabilitado, use el comando spo cdn get.

Para comprobar si la red CDN pública de Office 365 está habilitada, ejecute:

spo cdn get --type Public

Ver los Office 365 CDN origen

Para ver los orígenes configurados actualmente de la red CDN pública de Office 365, ejecute:

spo cdn origin list --type Public

Consulte Default CDN origins para obtener información sobre los orígenes que se aprovisionan de forma predeterminada al habilitar el Office 365 CDN.

Agregar un Office 365 CDN de datos

Importante

Nunca debe colocar recursos que se consideren confidenciales para su organización en una biblioteca de documentos SharePoint configurada como un origen público.

Use el comando spo cdn origin add definir un origen de la red CDN. Puede definir varios orígenes. El origen es una dirección URL que apunta a una biblioteca de SharePoint o la carpeta que contiene los activos que desea que se hospeden mediante la red CDN.

spo cdn origin add --type [Public | Private] --origin <path>

Dónde path es la ruta de acceso relativa a la carpeta que contiene los activos. Puede usar caracteres comodín además de rutas relativas.

Para incluir todos los activos en la Galería de páginas maestras de todos los sitios como origen público, ejecute:

spo cdn origin add --type Public --origin */masterpage

Para configurar un origen privado para una colección de sitios específica, ejecute:

spo cdn origin add --type Private --origin sites/site1/siteassets

Nota

Después de agregar un origen de la red CDN, puede tardar hasta 15 minutos para poder recuperar archivos mediante el servicio de la red CDN. Puede comprobar si ya se ha habilitado el origen particular con el comando spo cdn origin list.

Quitar un Office 365 CDN origen

Use el comando spo cdn origin remove para eliminar un origen de la red CDN para el tipo de red CDN especificado.

Para quitar un origen público de la configuración CDN, ejecute:

spo cdn origin remove --type Public --origin */masterpage

Nota

Quitar un origen CDN no afecta a los archivos almacenados en ninguna biblioteca de documentos que coincida con ese origen. Si se hace referencia a estos activos mediante su dirección URL SharePoint, SharePoint volverá automáticamente a la dirección URL original que apunta a la biblioteca de documentos. Sin embargo, si se hace referencia a los activos mediante una dirección URL de CDN pública, quitar el origen romperá el vínculo y deberá cambiarlos manualmente.

Modificar un Office 365 CDN origen

No es posible modificar un origen de la red CDN existente. En su lugar, debe eliminar el origen de la red CDN definido anteriormente con el comando spo cdn origin remove y agregar uno nuevo con el comando spo cdn origin add.

Cambiar los tipos de archivos que se incluirán en el Office 365 CDN

De forma predeterminada, los siguientes tipos de archivo se incluyen en el CDN: .css, .eot, .gif, .ico, .jpeg, .jpg, .js, .map, .png, .svg, .ttf, .woff y .woff2. Si tiene que incluir otros tipos de archivo en la red CDN, puede cambiar la configuración de la red CDN con el comando spo cdn policy set.

Nota

Al cambiar la lista de tipos de archivo, se sobrescribe la lista definida actualmente. Si desea incluir otros tipos de archivo, use el comando spo cdn policy list para averiguar qué tipos de archivos están configurados en este momento.

Para agregar el tipo de archivo JSON a la lista predeterminada de tipos de archivo incluidos en la lista pública CDN, ejecute:

spo cdn policy set --type Public --policy IncludeFileExtensions --value "CSS,EOT,GIF,ICO,JPEG,JPG,JS,MAP,PNG,SVG,TTF,WOFF,JSON"

Cambiar la lista de clasificaciones de sitio que desea excluir de la red CDN de Office 365

Use el comando spo cdn policy set para excluir las clasificaciones de sitio que no desee que estén disponibles en la red CDN. De forma predeterminada, no se excluyen clasificaciones de sitio.

Nota

Al cambiar la lista de clasificaciones de sitio excluidas, se sobrescribe la lista definida actualmente. Si quiere excluir clasificaciones adicionales, use el comando spo cdn policy list para averiguar qué clasificaciones están configuradas en este momento.

Para excluir sitios clasificados como HBI de la CDN pública, ejecute

spo cdn policy set --type Public --policy ExcludeRestrictedSiteClassifications --value "HBI"

Deshabilitar el Office 365 CDN

Para deshabilitar la red CDN de Office 365, use el comando spo cdn set, por ejemplo:

spo cdn set --type Public --enabled false

Uso de los CDN de datos

Ahora que ha habilitado el CDN y configurado los orígenes y directivas, puede empezar a usar los activos CDN configuración.

Esta sección le ayudará a comprender cómo usar direcciones URL de CDN en las páginas y el contenido de SharePoint para que SharePoint redirija las solicitudes de activos en orígenes públicos y privados al CDN.

Para obtener información sobre cómo usar el CDN para hospedar elementos web del lado cliente, vea el tema Hospedar el elemento web del lado cliente desde Office 365 CDN (parte 4de Hello World).

Nota

Si agrega la carpeta ClientSideAssets a la lista de orígenes de CDN privados, los elementos web personalizados hospedados CDN no se representarán. Los archivos usados por los elementos web de SPFX solo pueden usar el CDN público y la carpeta ClientSideAssets es un origen predeterminado para las aplicaciones CDN.

Para usar activos que haya agregado a un origen, solo tiene que actualizar los vínculos al archivo original con la ruta de acceso al archivo en el origen.

  • Edite la página o el contenido que contiene vínculos a activos que ha agregado a un origen. También puede usar uno de varios métodos para buscar y reemplazar vínculos globalmente en un sitio o colección de sitios si desea actualizar el vínculo a un activo determinado en cualquier lugar en el que aparezca.
  • Para cada vínculo a un activo de un origen, reemplace la ruta de acceso por la ruta de acceso al archivo en el CDN origen. Puede usar rutas de acceso relativas.
  • Guarde la página o el contenido.

Por ejemplo, considere la imagen /site/SiteAssets/images/image.png, que ha copiado en la carpeta de biblioteca de documentos /site/CDN_origins/public/. Para usar el activo CDN, reemplace la ruta de acceso original a la ubicación del archivo de imagen por la ruta de acceso al origen para que la nueva dirección URL /site/CDN_origins/public/image.png.

Si desea usar la dirección URL completa para el activo en lugar de una ruta de acceso relativa, construya el vínculo de este modo:

https://<TenantHostName>.sharepoint.com/sites/site/CDN_origins/public/image.png

Nota

En general, no debe codificar las direcciones URL directamente a los activos de la CDN. Sin embargo, puede crear manualmente direcciones URL para activos en orígenes públicos si es necesario. Para obtener más información, vea Hardcoding CDN URL for public assets.

Para obtener información sobre cómo comprobar que los activos se sirven desde el CDN, vea How do I confirm that assets are being served by the CDN? in Troubleshooting the Office 365 CDN.

Uso de activos en orígenes públicos

La característica De publicación en SharePoint Online reescribe automáticamente las direcciones URL de los activos almacenados en orígenes públicos en sus equivalentes CDN para que los activos se atenúen desde el servicio CDN en lugar de SharePoint.

Si el origen se encuentra en un sitio con la característica publicación habilitada y los activos que desea descargar en el CDN se encuentran en una de las siguientes categorías, SharePoint reescribirá automáticamente las direcciones URL de los activos del origen, siempre que una directiva de CDN no excluya el activo.

A continuación, se muestra información general sobre los vínculos que la característica de publicación de SharePoint reescribe automáticamente:

  • URL de IMG/LINK/CSS en respuestas de HTML de página de publicación clásica
    • Esto incluye imágenes que han agregado autores en el contenido HTML de una página
  • URL de las imágenes del elemento web de presentación de la biblioteca de imágenes
  • Campos de imagen de los resultados de la API de REST SPList (RenderListDataAsStream)
    • Use la nueva propiedad ImageFieldsToTryRewriteToCdnUrls para proporcionar una lista separada por comas de campos
    • Admite campos de hipervínculo y campos PublishingImage
  • SharePoint representaciones de imágenes

El siguiente diagrama ilustra el flujo de trabajo cuando SharePoint una solicitud de una página que contiene activos de un origen público.

Diagrama de flujo de trabajo: recuperación Office 365 CDN activos desde un origen público.

Sugerencia

Si desea deshabilitar la reescritura automática para direcciones URL específicas de una página, puede desangre la página y agregar el parámetro de cadena de consulta ? NoAutoReWrites=true al final de cada vínculo que desea deshabilitar.

Construcción de CDN direcciones URL para activos públicos

Si la característica de publicación no está habilitada para un origen público o el activo no es uno de los tipos de vínculo admitidos por la característica de reescritura automática del servicio CDN, puede crear manualmente direcciones URL en la ubicación CDN de los activos y usar estas direcciones URL en el contenido.

Nota

No puede codificar o construir direcciones URL CDN activos en un origen privado porque el token de acceso necesario que forma la última sección de la dirección URL se genera en el momento en que se solicita el recurso. Puede crear la dirección URL de Public CDN y la dirección URL no debe estar codificada de forma dura, ya que está sujeta a cambios.

Para los activos CDN públicos, el formato de dirección URL tendrá el siguiente aspecto:

https://publiccdn.sharepointonline.com/<TenantHostName>/sites/site/library/asset.png

Reemplace TenantHostName por su nombre de inquilino. Ejemplo:

https://publiccdn.sharepointonline.com/contoso.sharepoint.com/sites/site/library/asset.png

Nota

La propiedad de contexto de página debe usarse para construir el prefijo en lugar de codificar de forma rígida " https://publiccdn.sharepointonline.com ". La dirección URL está sujeta a cambios y no debe estar codificada de forma dura. Si usa plantillas para mostrar con Classic SharePoint Online, puede usar la propiedad "window._spPageContextInfo.publicCdnBaseUrl" en la plantilla para mostrar para el prefijo de la dirección URL. Si está buscando SPFx web para elementos SharePoint modernos y clásicos, puede usar la propiedad "this.context.pageContext.legacyPageContext.publicCdnBaseUrl". Esto proporcionará el prefijo para que, si se cambia, la implementación se actualice con él. Como ejemplo para SPFx, la dirección URL se puede construir con la propiedad "this.context.pageContext.legacyPageContext.publicCdnBaseUrl" + "/" + "host" + "/" + "relativeURL para el elemento". Consulta Usar CDN código del lado cliente que forma parte de la serie de rendimiento de la temporada 1

Uso de activos en orígenes privados

No se requiere ninguna configuración adicional para usar activos en orígenes privados. SharePoint Online reescritura automáticamente las direcciones URL de los activos en orígenes privados para que las solicitudes de esos activos siempre se atenúe desde el CDN. No puede crear manualmente direcciones URL para CDN activos en orígenes privados porque estas direcciones URL contienen tokens que SharePoint Online debe generar automáticamente en el momento en que se solicita el activo.

El acceso a activos en orígenes privados está protegido por tokens generados dinámicamente en función de los permisos de usuario al origen, con las advertencias descritas en las secciones siguientes. Los usuarios deben tener al menos acceso de lectura a los orígenes de la CDN para representar contenido.

El diagrama siguiente ilustra el flujo de trabajo cuando SharePoint una solicitud de una página que contiene activos de un origen privado.

Diagrama de flujo de trabajo: recuperar Office 365 CDN activos de un origen privado.

Autorización basada en tokens en orígenes privados

Los tokens generados por SharePoint Online conceden acceso a los activos en orígenes privados Office 365 CDN la propiedad. A los usuarios que ya tienen permiso para acceder a la carpeta o biblioteca designadas por el origen se les conceden automáticamente tokens que permiten al usuario tener acceso al archivo en función de su nivel de permisos. Estos tokens de acceso son válidos de 30 a 90 minutos después de que se generen para ayudar a evitar ataques de reproducción de tokens.

Una vez generado el token de acceso, SharePoint Online devuelve un URI personalizado al cliente que contiene dos parámetros de autorización (token de autorización perimetral) y avena (token de autorización de origen). La estructura de cada token es< de expiración en el formato de tiempo de >__< la firma segura >. Por ejemplo:

https://privatecdn.sharepointonline.com/contoso.sharepoint.com/sites/site1/library1/folder1/image1.jpg?eat=1486154359_cc59042c5c55c90b26a2775323c7c8112718431228fe84d568a3795a63912840&oat=1486154359_7d73c2e3ba4b7b1f97242332900616db0d4ffb04312

Nota

Cualquier persona que posea el token puede tener acceso al recurso en el CDN. Sin embargo, las direcciones URL que contienen estos tokens de acceso solo se comparten a través de HTTPS, por lo que a menos que un usuario final comparta explícitamente la dirección URL antes de que expire el token, el activo no será accesible para usuarios no autorizados.

Los permisos de nivel de elemento no se admiten para activos en orígenes privados

Es importante tener en cuenta que SharePoint Online no admite permisos de nivel de elemento para activos en orígenes privados. Por ejemplo, para un archivo ubicado en , los usuarios tienen acceso efectivo https://contoso.sharepoint.com/sites/site1/library1/folder1/image1.jpg al archivo dadas las siguientes condiciones:

Usuario Permisos Acceso efectivo
Usuario 1 Tiene acceso a folder1 Puede acceder image1.jpg desde el CDN
Usuario 2 No tiene acceso a folder1 No se puede image1.jpg desde el CDN
Usuario 3 No tiene acceso a folder1, pero se le concede permiso explícito para acceder a image1.jpg en SharePoint Online Puede obtener acceso al recurso image1.jpg directamente desde SharePoint Online, pero no desde el CDN
Usuario 4 Tiene acceso a folder1, pero se ha denegado explícitamente el acceso a image1.jpg en SharePoint Online No se puede obtener acceso al activo desde SharePoint Online, pero puede acceder al activo desde el CDN a pesar de que se le deniegue el acceso al archivo en SharePoint Online

Solución de problemas de Office 365 CDN

¿Cómo confirmo que los activos están siendo atendidos por el CDN?

Una vez que haya agregado vínculos CDN activos CDN una página, puede confirmar que el activo se sirve desde el CDN explorando la página, haciendo clic con el botón secundario en la imagen una vez que se ha representado y revisando la dirección URL de la imagen.

También puede usar las herramientas de desarrollador del explorador para ver la dirección URL de cada activo de una página o usar una herramienta de seguimiento de red de terceros.

Nota

Si usa una herramienta de red como Fiddler para probar los activos fuera de representar el activo desde una página de SharePoint, debe agregar manualmente el encabezado de referencia "Referer: " a la solicitud GET donde la dirección URL es la dirección URL raíz del inquilino https://yourdomain.sharepoint.com de SharePoint Online.

No puede probar CDN direcciones URL directamente en un explorador web porque debe tener un referente procedente de SharePoint Online. Sin embargo, si agrega la dirección URL del activo CDN a una página de SharePoint y, a continuación, abre la página en un explorador, verá el activo CDN representado en la página.

Para obtener más información sobre el uso de las herramientas de desarrollador en el Microsoft Edge, vea Microsoft Edge Developer Tools.

Para ver un vídeo breve hospedado en el canal de YouTube de patrones y prácticas para desarrolladores de SharePoint que muestra cómo comprobar que su CDN funciona, consulte Verifying your CDN usage y ensuring optimal network connectivity.

¿Por qué los activos de un nuevo origen no están disponibles?

Los activos de nuevos orígenes no estarán disponibles inmediatamente para su uso, ya que el registro tarda en propagarse a través del CDN y para que los activos se carguen desde el origen a CDN almacenamiento. El tiempo necesario para que los activos estén disponibles en el CDN depende del número de activos y el tamaño de los archivos.

Mi elemento web del lado cliente o SharePoint Framework solución no funciona

Cuando se habilita el Office 365 CDN para orígenes públicos, el servicio CDN crea automáticamente estos orígenes predeterminados:

  • */MASTERPAGE
  • */BIBLIOTECA DE ESTILOS
  • */CLIENTSIDEASSETS

Si falta el origen */clientsideassets, SharePoint Framework se producirá un error en las soluciones y no se generarán mensajes de advertencia o error. Este origen puede faltar porque el CDN se ha habilitado con el parámetro -NoDefaultOrigins establecido en $true, o porque el origen se eliminó manualmente.

Puede comprobar qué orígenes están presentes con el siguiente comando de PowerShell:

Get-SPOTenantCdnOrigins -CdnType Public

O puede comprobar con la CLI Office 365:

spo cdn origin list

Para agregar el origen en PowerShell:

Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */CLIENTSIDEASSETS

Para agregar el origen en la CLI Office 365:

spo cdn origin add --origin */CLIENTSIDEASSETS

¿Qué módulos de PowerShell y shells de CLI necesito para trabajar con el Office 365 CDN?

Puede elegir trabajar con el Office 365 CDN mediante el módulo de PowerShell SharePoint Shell de administración en línea o la CLI Office 365 .

Vea también

Redes de entrega de contenido

Planeamiento de red y ajuste del rendimiento para Office 365

SharePoint Performance Series: Office 365 CDN de vídeo