Usar a Rede de Distribuição de Conteúdo (CDN) do Office 365 com o SharePoint Online

Você pode usar a Rede de Distribuição de Conteúdo (CDN) do Office 365 integrado para proporcionar melhor desempenho a suas páginas do SharePoint Online. A CDN do Office 365 melhora o desempenho ao armazenar em cache ativos estáticos mais próximos aos navegadores que os solicitaram, o que ajuda a acelerar downloads e reduzir a latência. Além disso, o Office 365 CDN usa o protocolo HTTP/2 para compactação aprimorada e pipelização HTTP. O serviço de CDN do Office 365 faz parte da assinatura do SharePoint Online.

Observação

O Office 365 CDN está disponível apenas para locatários na nuvem produção (em todo o mundo). Os locatários nas nuvens do Governo dos EUA, China e Alemanha atualmente não suportam o Office 365 CDN.

A CDN do Office 365 é composta por várias CDNs que permitem que você hospede ativos estáticos em vários locais ou origens e sirva-os de redes globais de alta velocidade. Dependendo do tipo de conteúdo você quiser hospedar na CDN do Office 365, você pode adicionar origens públicas, origens privadas ou ambas. Confira Escolher se cada origem deve ser pública ou privada para obter mais informações sobre a diferença entre origens públicas e privadas.

Office 365 CDN diagrama conceitual.

Se você já estiver familiarizado com a maneira como as CDNs funcionam, você só precisa concluir algumas etapas para habilitar o Office 365 CDN para seu locatário. Este tópico descreve como. Leia para obter informações sobre como começar a hospedar seus ativos estáticos.

Dica

Há outras CDNs hospedadas pela Microsoft que podem ser usadas com o Office 365 para cenários de uso especializados, mas não são discutidas neste tópico porque elas ficam fora do escopo do Office 365 CDN. Para obter mais informações, consulte Outras CDNs da Microsoft.

Volte para o planejamento de rede e ajuste de desempenho para Office 365.

Visão geral do trabalho com o Office 365 CDN no SharePoint Online

Para configurar o Office 365 CDN para sua organização, siga estas etapas básicas:

Depois de terminar a instalação, você poderá Gerenciar o Office 365 CDN ao longo do tempo:

  • Adicionar, atualizar e remover ativos
  • Adicionar e remover origens
  • Configurando CDN políticas
  • Se necessário, desabilite a CDN

Por fim, consulte Usando seus ativos CDN para saber mais sobre como acessar seus CDN ativos de origens públicas e privadas.

Consulte Solução de problemas da Office 365 CDN para obter orientações sobre como resolver problemas comuns.

Planejar a implantação do Office 365 CDN

Antes de implantar o Office 365 CDN para seu Office 365 locatário, considere os seguintes fatores como parte do seu processo de planejamento.

Determinar quais ativos estáticos você deseja hospedar no CDN

Em geral, as CDNs são mais eficazes para hospedar ativos estáticos ou ativos que não mudam com muita frequência. Uma boa regra geral é identificar arquivos que atendem a algumas ou todas essas condições:

  • Arquivos estáticos inseridos em uma página (como scripts e imagens) que podem ter um impacto incremental significativo nos tempos de carregamento da página
  • Arquivos grandes, como executáveis e arquivos de instalação
  • Bibliotecas de recursos que suportam código do lado do cliente

Por exemplo, arquivos pequenos que são solicitados repetidamente, como imagens de site e scripts, podem melhorar significativamente o desempenho de renderização do site e reduzir incrementalmente a carga em seus sites do SharePoint Online quando você os adiciona a uma origem CDN de usuário. Arquivos maiores, como executáveis de instalação, podem ser baixados do CDN, fornecendo um impacto positivo no desempenho e a redução subsequente da carga em seu site do SharePoint Online, mesmo que eles não sejam acessados com a mesma frequência.

A melhoria de desempenho por arquivo depende de muitos fatores, incluindo a proximidade do cliente com o ponto de extremidade CDN mais próximo, condições transitórias na rede local e assim por diante. Muitos arquivos estáticos são muito pequenos e podem ser baixados Office 365 em menos de um segundo. No entanto, uma página da Web pode conter muitos arquivos incorporados com um tempo de download cumulativo de vários segundos. Servir esses arquivos do CDN pode reduzir significativamente o tempo de carregamento geral da página. Veja Quais ganhos de desempenho um CDN fornece? para um exemplo.

Determinar onde você deseja armazenar seus ativos

O CDN busca seus ativos de um local chamado de origem. Uma origem pode ser um site SharePoint, biblioteca de documentos ou pasta acessível por uma URL. Você tem uma grande flexibilidade ao especificar origens para sua organização. Por exemplo, você pode especificar várias origens ou uma única origem em que deseja colocar todos os seus CDN ativos. Você pode optar por ter origens públicas ou privadas para sua organização. A maioria das organizações optará por implementar uma combinação dos dois.

Você pode criar um novo contêiner para suas origens, como pastas ou bibliotecas de documentos, e adicionar arquivos que você deseja disponibilizar no CDN. Essa é uma boa abordagem se você tiver um conjunto específico de ativos que deseja estar disponível no CDN e quiser restringir o conjunto de ativos CDN para apenas esses arquivos no contêiner.

Você também pode configurar um conjunto de sites, site, biblioteca ou pasta existente como uma origem, o que disponibiliza todos os ativos qualificados no contêiner CDN. Antes de adicionar um contêiner existente como origem, é importante ter certeza de que está ciente de seu conteúdo e permissões para que você não exponha inadvertidamente os ativos a acesso anônimo ou usuários não autorizados.

Você pode definir CDN políticas para excluir conteúdo em suas origens do CDN. CDN as políticas excluem ativos em origens públicas ou privadas por atributos como tipo de arquivo e classificação de site e são aplicadas a todas as origens do CdnType (privado ou público) especificado na política. Por exemplo, se você adicionar uma origem privada consistindo em um site que contenha vários subsites, poderá definir uma política para excluir sites marcados como Confidencial para que o conteúdo de sites com essa classificação aplicada não seja servido do CDN. A política se aplicará ao conteúdo de todas as origens privadas adicionadas ao CDN.

Lembre-se de que quanto maior o número de origens, maior será o impacto no tempo que o serviço CDN para processar solicitações. Recomendamos que você limite o número de origens o máximo possível.

Escolha se cada origem deve ser pública ou privada

Ao identificar uma origem, especifique se ela deve ser pública ou privada. O acesso CDN ativos em origens públicas é anônimo e CDN conteúdo em origens privadas é protegido por tokens gerados dinamicamente para maior segurança. Independentemente de qual opção você escolher, a Microsoft faz todo o trabalho pesado para você quando se trata da administração do CDN em si. Além disso, você pode mudar de ideia mais tarde, depois de configurar o CDN e identificar suas origens.

As opções públicas e privadas oferecem ganhos de desempenho semelhantes, mas cada uma delas tem atributos e vantagens exclusivos.

As origens públicas no Office 365 CDN são acessíveis anonimamente e os ativos hospedados podem ser acessados por qualquer pessoa que tenha a URL do ativo. Como o acesso ao conteúdo de origens públicas é anônimo, você só deve usá-lo para o armazenamento em cache de conteúdo genérico e não sensível como arquivos Javascript, scripts, ícones e imagens.

As origens privadas no Office 365 CDN fornecem acesso privado ao conteúdo do usuário, SharePoint como bibliotecas de documentos online, sites e imagens proprietárias. O acesso ao conteúdo em origens privadas é protegido por tokens gerados dinamicamente para que ele só possa ser acessado por usuários com permissões para a biblioteca de documentos original ou o local de armazenamento. As origens privadas no Office 365 CDN podem ser usadas apenas para o conteúdo SharePoint Online, e você só pode acessar ativos em origens privadas por meio de redirecionamento de seu locatário do SharePoint Online.

Você pode ler mais sobre como o CDN acesso a ativos em uma origem privada funciona em Usar ativos em origens privadas.

Atributos e vantagens de hospedar ativos em origens públicas

  • Os ativos exibidos em uma origem pública são acessíveis por todos os usuários anonimamente.

    Importante

    Você nunca deve colocar recursos que contenham informações do usuário ou sejam considerados confidenciais para sua organização em uma origem pública.

  • Se você remover um ativo de uma origem pública, ele pode seguir disponível em cache por até 30 dias; contudo, invalidaremos os links para o ativo na CDN em 15 minutos.

  • Quando você hospeda folhas de estilo (arquivos CSS) em uma origem pública, você pode usar os caminhos relativos e URIs dentro do código. Isso significa que você pode referenciar o local das imagens de fundo e outros objetos em relação ao local do ativo que faz a chamada.

  • Embora você possa construir uma URL de origem pública, você deve prosseguir com cautela e garantir que você utilize a propriedade de contexto de página e siga as diretrizes para fazer isso. O motivo é que se o acesso à CDN ficar indisponível, a URL não resolverá automaticamente para a sua organização no SharePoint Online e pode resultar em links quebrados e outros erros. A URL também está sujeita a alterações, e é por isso que ela não deve ser codificada apenas para seu valor atual.

  • Os tipos de arquivo padrão incluídos para origens públicas são .css, .eot, .gif, .ico, .jpeg, .jpg, .js, .map, .png, .svg, .ttf, .woff e .woff2. Você pode especificar tipos de arquivo adicionais.

  • Você pode configurar uma política para excluir ativos que foram identificados pelas classificações de site que você especificar. Por exemplo, você pode optar por excluir todos os ativos marcados como "restrito" ou "confidencial", mesmo que sejam um tipo de arquivo permitido e estejam localizados em uma origem pública.

Atributos e vantagens de hospedar ativos em origens privadas

  • As origens privadas só podem ser usadas para SharePoint ativos Online.

  • Os usuários só poderão acessar os ativos de origem privada se eles têm permissões para acessar o contêiner. O acesso anônimo a esses ativos é vetado.

  • Os ativos de origem privada devem ser referenciados do locatário SharePoint Online. O acesso direto aos CDN privados não funciona.

  • Se você remover um ativo da origem privada, o ativo poderá continuar disponível por até uma hora do cache; no entanto, invalidaremos links para o ativo no CDN dentro de 15 minutos após a remoção do ativo.

  • Os tipos de arquivo padrão incluídos para origens privadas são .gif, .ico, .jpeg, .jpg, .js e .png. Você pode especificar tipos de arquivo adicionais.

  • Assim como com origens públicas, você pode configurar uma política para excluir ativos que foram identificados por classificações de site que você especifica, mesmo que você use curingas para incluir todos os ativos em uma pasta ou biblioteca de documentos.

Para obter mais informações sobre por que usar o Office 365 CDN, os conceitos CDN gerais e outras CDNs da Microsoft que você pode usar com seu locatário Office 365, consulte Redes de Entrega de Conteúdo.

Origens CDN padrão

A menos que você especifique o contrário, Office 365 algumas origens padrão para você ao habilitar o Office 365 CDN. Se você optar inicialmente por não provisioná-las, poderá adicionar essas origens após concluir a instalação. A menos que você entenda as consequências de ignorar a configuração de origens padrão e ter um motivo específico para fazer isso, você deve permitir que eles sejam criados quando você habilitar o CDN.

Origens CDN privadas padrão:

  • */userphoto.aspx
  • */siteassets

Origens CDN públicas padrão:

  • */masterpage
  • */style library
  • */clientsideassets

Observação

clientsideassets é uma origem pública padrão que foi adicionada ao serviço Office 365 CDN em dezembro de 2017. Essa origem deve estar presente para que Estrutura do SharePoint soluções no CDN funcionem. Se você habilitar o Office 365 CDN antes de dezembro de 2017 ou se você ignorou a configuração de origens padrão ao habilitar o CDN, poderá adicionar manualmente essa origem. Para obter mais informações, consulte My client-side web part or Estrutura do SharePoint solution isn't working.

Configurar e configurar o Office 365 CDN usando o Shell de Gerenciamento SharePoint Online

Os procedimentos nesta seção exigem que você use o Shell de Gerenciamento SharePoint Online para se conectar ao SharePoint Online. Para obter instruções, consulte Conexão para SharePoint PowerShell Online.

Conclua estas etapas para configurar e configurar o CDN para hospedar seus ativos no SharePoint Online usando o Shell de Gerenciamento SharePoint Online.

Clique para expandir

Permitir que sua organização use o Office 365 CDN

Antes de fazer alterações nas configurações CDN locatários, você deve recuperar o status atual da configuração de CDN privada em seu locatário Office 365 locatário. Conexão seu locatário usando o Shell de Gerenciamento SharePoint Online:

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

Agora use o cmdlet Get-SPOTenantCdnEnabled para recuperar as CDN de status do locatário:

Get-SPOTenantCdnEnabled -CdnType <Public | Private>

O status da CDN do CdnType especificado será exibido na tela.

Use o cmdlet Set-SPOTenantCdnEnabled para permitir que sua organização use o Office 365 CDN. Você pode permitir que sua organização use origens públicas, origens privadas ou ambas ao mesmo tempo. Você também pode configurar o CDN para ignorar a configuração de origens padrão ao habilita-la. Você sempre pode adicionar essas origens mais tarde, conforme descrito neste tópico.

Em Windows PowerShell para SharePoint Online:

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

Por exemplo, para permitir que sua organização use origens públicas e privadas, digite o seguinte comando:

Set-SPOTenantCdnEnabled -CdnType Both -Enable $true

Para permitir que sua organização use origens públicas e privadas, mas ignore a configuração das origens padrão, digite o seguinte comando:

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

Consulte Default CDN origins for information about the origins that are provisioned by default when you enable the Office 365 CDN, and the potential impact of skipping the setup of default origins.

Para permitir que sua organização use origens públicas, digite o seguinte comando:

Set-SPOTenantCdnEnabled -CdnType Public -Enable $true

Para permitir que sua organização use origens privadas, digite o seguinte comando:

Set-SPOTenantCdnEnabled -CdnType Private -Enable $true

Para obter mais informações sobre esse cmdlet, consulte Set-SPOTenantCdnEnabled.

Alterar a lista de tipos de arquivo para incluir no Office 365 CDN (Opcional)

Dica

Ao definir tipos de arquivo usando o cmdlet Set-SPOTenantCdnPolicy, você substitui a lista definida no momento. Se você quiser adicionar tipos de arquivo adicionais à lista, use o cmdlet primeiro para descobrir quais tipos de arquivo já são permitidos e incluí-los na lista juntamente com os novos.

Use o cmdlet Set-SPOTenantCdnPolicy para definir tipos de arquivo estáticos que podem ser hospedados por origens públicas e privadas no CDN. Por padrão, os tipos de ativos comuns são permitidos, por exemplo, .css, .gif, .jpg e .js.

Em Windows PowerShell para SharePoint Online:

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

Por exemplo, para habilitar o CDN para hospedar arquivos .css e .png, você inseriria o comando:

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

Para ver quais tipos de arquivo atualmente são permitidos pelo CDN, use o cmdlet Get-SPOTenantCdnPolicies:

Get-SPOTenantCdnPolicies -CdnType <Public | Private>

Para obter mais informações sobre esses cmdlets, consulte Set-SPOTenantCdnPolicy e Get-SPOTenantCdnPolicies.

Alterar a lista de classificações de site que você deseja excluir do Office 365 CDN (Opcional)

Dica

Ao excluir classificações de site usando o cmdlet Set-SPOTenantCdnPolicy, você substitui a lista definida no momento. Se você quiser excluir classificações de site adicionais, use o cmdlet primeiro para descobrir quais classificações já estão excluídas e, em seguida, adicioná-las junto com as novas.

Use o cmdlet Set-SPOTenantCdnPolicy para excluir as classificações de site que não deseja disponibilizar na CDN. Por padrão, nenhuma classificação de sites é excluída.

Em Windows PowerShell para SharePoint Online:

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

Para ver quais classificações de site estão restritas no momento, use o cmdlet Get-SPOTenantCdnPolicies:

Get-SPOTenantCdnPolicies -CdnType <Public | Private>

As propriedades que serão retornadas são IncludeFileExtensions, ExcludeRestrictedSiteClassifications e ExcludeIfNoScriptDisabled.

A propriedade IncludeFileExtensions contém a lista de extensões de arquivo que serão servidas do CDN.

Observação

As extensões de arquivo padrão são diferentes entre público e privado.

A propriedade ExcludeRestrictedSiteClassifications contém as classificações de site que você deseja excluir do CDN. Por exemplo, você pode excluir sites marcados como Confidencial para que o conteúdo de sites com essa classificação aplicada não seja servido do CDN.

A propriedade ExcludeIfNoScriptDisabled exclui o conteúdo do CDN com base nas configurações de atributo NoScript no nível do site. Por padrão, o atributo NoScript é definido como Habilitado para Sites Modernos e Desabilitado para sites clássicos. Isso depende das configurações do locatário.

Para obter mais informações sobre esses cmdlets, consulte Set-SPOTenantCdnPolicy e Get-SPOTenantCdnPolicies.

Adicionar uma origem para seus ativos

Use o cmdlet Add-SPOTenantCdnOrigin para definir uma origem. Você pode definir várias origens. A origem é uma URL que aponta para uma biblioteca ou pasta do SharePoint contendo os ativos que você deseja hospedar na CDN.

Importante

Você nunca deve colocar recursos que contenham informações do usuário ou sejam considerados confidenciais para sua organização em uma origem pública.

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

O valor do caminho é o caminho relativo para a biblioteca ou pasta que contém os ativos. Você pode usar caracteres curinga, além de caminhos relativos. As origens suportam curingas pré-anexados à URL. Isso permite que você crie origens que abrangem vários sites. Por exemplo, para incluir todos os ativos na pasta páginas mestras de todos os seus sites como uma origem pública dentro do CDN, digite o seguinte comando:

Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
  • O modificador de caractere curinga * só pode ser usado no início do caminho e corresponderá a todos os / segmentos de URL na URL especificada.
  • O caminho pode apontar para uma biblioteca de documentos, pasta ou site. Por exemplo, o caminho */site1 corresponderá a todas as bibliotecas de documentos no site.

Você pode adicionar uma origem com um caminho relativo específico. Não é possível adicionar uma origem usando o caminho completo.

Este exemplo adiciona uma origem privada da biblioteca de sitesassets em um site específico:

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

Este exemplo adiciona uma origem privada da pasta1 na biblioteca de ativos de site do conjunto de sites:

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

Se houver um espaço no caminho, você poderá cercar o caminho entre aspas duplas ou substituir o espaço pela codificação de URL %20. Os exemplos a seguir adicionam uma origem privada da pasta 1 na biblioteca de ativos de site do conjunto de sites:

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

Para obter mais informações sobre esse comando e sua sintaxe, consulte Add-SPOTenantCdnOrigin.

Observação

Em origens privadas, os ativos que estão sendo compartilhados de uma origem devem ter uma versão principal publicada antes de serem acessados do CDN.

Depois de executar o comando, o sistema sincroniza a configuração no datacenter. Isso pode levar até 15 minutos.

Exemplo: configure uma origem pública para suas páginas mestras e para sua biblioteca de estilos para SharePoint Online

Normalmente, essas origens são configuradas para você por padrão quando você habilita o Office 365 CDN. No entanto, se você quiser habilita-los manualmente, siga estas etapas.

  • Use o cmdlet Add-SPOTenantCdnOrigin para definir a biblioteca de estilos como uma origem pública.

    Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */style%20library
    
  • Use o cmdlet Add-SPOTenantCdnOrigin para definir as páginas mestras como uma origem pública.

    Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
    

Para obter mais informações sobre esse comando e sua sintaxe, consulte Add-SPOTenantCdnOrigin.

Depois de executar o comando, o sistema sincroniza a configuração no datacenter. Isso pode levar até 15 minutos.

Exemplo: configurar uma origem privada para seus ativos de site, páginas de site e imagens de publicação para SharePoint Online

  • Use o cmdlet Add-SPOTenantCdnOrigin para definir a pasta de ativos do site como uma origem privada.

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */siteassets
    
  • Use o cmdlet Add-SPOTenantCdnOrigin para definir a pasta de páginas do site como uma origem privada.

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */sitepages
    
  • Use o cmdlet Add-SPOTenantCdnOrigin para definir a pasta de imagens de publicação como uma origem privada.

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */publishingimages
    

Para obter mais informações sobre esse comando e sua sintaxe, consulte Add-SPOTenantCdnOrigin.

Depois de executar o comando, o sistema sincroniza a configuração no datacenter. Isso pode levar até 15 minutos.

Exemplo: configurar uma origem privada para um conjunto de sites para SharePoint Online

Use o cmdlet Add-SPOTenantCdnOrigin para definir um conjunto de sites como uma origem privada. Por exemplo:

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

Para obter mais informações sobre esse comando e sua sintaxe, consulte Add-SPOTenantCdnOrigin.

Depois de executar o comando, o sistema sincroniza a configuração no datacenter. Você pode ver uma mensagem de configuração pendente que é esperada à medida que o locatário SharePoint Online se conecta ao serviço CDN de configuração. Isso pode levar até 15 minutos.

Gerenciar o Office 365 CDN

Depois de configurar o CDN, você poderá fazer alterações em sua configuração conforme atualiza o conteúdo ou conforme suas necessidades mudam, conforme descrito nesta seção.

Adicionar, atualizar ou remover ativos do Office 365 CDN

Depois de concluir as etapas de instalação, você pode adicionar novos ativos e atualizar ou remover ativos existentes sempre que quiser. Basta fazer suas alterações nos ativos na pasta ou SharePoint que você identificou como uma origem. Se você adicionar um novo ativo, ele estará disponível por meio do CDN imediatamente. No entanto, se você atualizar o ativo, levará até 15 minutos para que a nova cópia se propague e se torne disponível no CDN.

Se você precisar recuperar o local da origem, poderá usar o cmdlet Get-SPOTenantCdnOrigins. Para obter informações sobre como usar esse cmdlet, consulte Get-SPOTenantCdnOrigins.

Remover uma origem do Office 365 CDN

Você pode remover o acesso a uma pasta ou SharePoint que você identificou como uma origem. Para fazer isso, use o cmdlet Remove-SPOTenantCdnOrigin.

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

Para obter informações sobre como usar esse cmdlet, consulte Remove-SPOTenantCdnOrigin.

Modificar uma origem no Office 365 CDN

Não é possível modificar uma origem criada. Em vez disso, remova a origem e adicione um novo. Para obter mais informações, consulte To remove an origin from the Office 365 CDN and To add an origin for your assets.

Desabilitar o Office 365 CDN

Use o cmdlet Set-SPOTenantCdnEnabled para desabilitar o CDN para sua organização. Se você tiver as origens públicas e privadas habilitadas para o CDN, será necessário executar o cmdlet duas vezes, conforme mostrado nos exemplos a seguir.

Para desabilitar o uso de origens públicas no CDN, insira o seguinte comando:

Set-SPOTenantCdnEnabled -CdnType Public -Enable $false

Para desabilitar o uso das origens privadas no CDN, insira o seguinte comando:

Set-SPOTenantCdnEnabled -CdnType Private -Enable $false

Para obter mais informações sobre esse cmdlet, consulte Set-SPOTenantCdnEnabled.

Configurar e configurar o Office 365 CDN usando o PnP PowerShell

Os procedimentos nesta seção exigem que você use o PnP PowerShell para se conectar ao SharePoint Online. Para obter instruções, consulte Getting started with PnP PowerShell.

Conclua estas etapas para configurar e configurar o CDN para hospedar seus ativos no SharePoint Online usando o PnP PowerShell.

Clique para expandir

Permitir que sua organização use o Office 365 CDN

Antes de fazer alterações nas configurações CDN locatários, você deve recuperar o status atual da configuração de CDN privada em seu locatário Office 365 locatário. Conexão seu locatário usando o PnP PowerShell:

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

Agora use o cmdlet Get-PnPTenantCdnEnabled para recuperar as CDN de status do locatário:

Get-PnPTenantCdnEnabled -CdnType <Public | Private>

O status da CDN do CdnType especificado será exibido na tela.

Use o cmdlet Set-PnPTenantCdnEnabled para permitir que sua organização use o Office 365 CDN. Você pode permitir que sua organização use origens públicas, origens privadas ou ambas ao mesmo tempo. Você também pode configurar o CDN para ignorar a configuração de origens padrão ao habilita-la. Você sempre pode adicionar essas origens mais tarde, conforme descrito neste tópico.

No PnP PowerShell:

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

Por exemplo, para permitir que sua organização use origens públicas e privadas, digite o seguinte comando:

Set-PnPTenantCdnEnabled -CdnType Both -Enable $true

Para permitir que sua organização use origens públicas e privadas, mas ignore a configuração das origens padrão, digite o seguinte comando:

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

Consulte Default CDN origins for information about the origins that are provisioned by default when you enable the Office 365 CDN, and the potential impact of skipping the setup of default origins.

Para permitir que sua organização use origens públicas, digite o seguinte comando:

Set-PnPTenantCdnEnabled -CdnType Public -Enable $true

Para permitir que sua organização use origens privadas, digite o seguinte comando:

Set-PnPTenantCdnEnabled -CdnType Private -Enable $true

Para obter mais informações sobre esse cmdlet, consulte Set-PnPTenantCdnEnabled.

Alterar a lista de tipos de arquivo para incluir no Office 365 CDN (Opcional)

Dica

Ao definir tipos de arquivo usando o cmdlet Set-PnPTenantCdnPolicy, você substitui a lista definida no momento. Se você quiser adicionar tipos de arquivo adicionais à lista, use o cmdlet primeiro para descobrir quais tipos de arquivo já são permitidos e incluí-los na lista juntamente com os novos.

Use o cmdlet Set-PnPTenantCdnPolicy para definir tipos de arquivo estáticos que podem ser hospedados por origens públicas e privadas no CDN. Por padrão, os tipos de ativos comuns são permitidos, por exemplo, .css, .gif, .jpg e .js.

No PnP PowerShell:

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

Por exemplo, para habilitar o CDN para hospedar arquivos .css e .png, você inseriria o comando:

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

Para ver quais tipos de arquivo atualmente são permitidos pelo CDN, use o cmdlet Get-PnPTenantCdnPolicies:

Get-PnPTenantCdnPolicies -CdnType <Public | Private>

Para obter mais informações sobre esses cmdlets, consulte Set-PnPTenantCdnPolicy e Get-PnPTenantCdnPolicies.

Alterar a lista de classificações de site que você deseja excluir do Office 365 CDN (Opcional)

Dica

Quando você exclui classificações de site usando o cmdlet Set-PnPTenantCdnPolicy, substitui a lista definida no momento. Se você quiser excluir classificações de site adicionais, use o cmdlet primeiro para descobrir quais classificações já estão excluídas e, em seguida, adicioná-las junto com as novas.

Use o cmdlet Set-PnPTenantCdnPolicy para excluir classificações de site que você não deseja disponibilizar no CDN. Por padrão, nenhuma classificação de sites é excluída.

No PnP PowerShell:

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

Para ver quais classificações de site estão restritas no momento, use o cmdlet Get-PnPTenantCdnPolicies:

Get-PnPTenantCdnPolicies -CdnType <Public | Private>

As propriedades que serão retornadas são IncludeFileExtensions, ExcludeRestrictedSiteClassifications e ExcludeIfNoScriptDisabled.

A propriedade IncludeFileExtensions contém a lista de extensões de arquivo que serão servidas do CDN.

Observação

As extensões de arquivo padrão são diferentes entre público e privado.

A propriedade ExcludeRestrictedSiteClassifications contém as classificações de site que você deseja excluir do CDN. Por exemplo, você pode excluir sites marcados como Confidencial para que o conteúdo de sites com essa classificação aplicada não seja servido do CDN.

A propriedade ExcludeIfNoScriptDisabled exclui o conteúdo do CDN com base nas configurações de atributo NoScript no nível do site. Por padrão, o atributo NoScript é definido como Habilitado para Sites Modernos e Desabilitado para sites clássicos. Isso depende das configurações do locatário.

Para obter mais informações sobre esses cmdlets, consulte Set-PnPTenantCdnPolicy e Get-PnPTenantCdnPolicies.

Adicionar uma origem para seus ativos

Use o cmdlet Add-PnPTenantCdnOrigin para definir uma origem. Você pode definir várias origens. A origem é uma URL que aponta para uma biblioteca ou pasta do SharePoint contendo os ativos que você deseja hospedar na CDN.

Importante

Você nunca deve colocar recursos que contenham informações do usuário ou sejam considerados confidenciais para sua organização em uma origem pública.

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

O valor do caminho é o caminho relativo para a biblioteca ou pasta que contém os ativos. Você pode usar caracteres curinga, além de caminhos relativos. As origens suportam curingas pré-anexados à URL. Isso permite que você crie origens que abrangem vários sites. Por exemplo, para incluir todos os ativos na pasta páginas mestras de todos os seus sites como uma origem pública dentro do CDN, digite o seguinte comando:

Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
  • O modificador de caractere curinga * só pode ser usado no início do caminho e corresponderá a todos os / segmentos de URL na URL especificada.
  • O caminho pode apontar para uma biblioteca de documentos, pasta ou site. Por exemplo, o caminho */site1 corresponderá a todas as bibliotecas de documentos no site.

Você pode adicionar uma origem com um caminho relativo específico. Não é possível adicionar uma origem usando o caminho completo.

Este exemplo adiciona uma origem privada da biblioteca de ativos do site em um site específico:

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

Este exemplo adiciona uma origem privada da pasta1 na biblioteca de ativos de site do conjunto de sites:

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

Se houver um espaço no caminho, você poderá cercar o caminho entre aspas duplas ou substituir o espaço pela codificação de URL %20. Os exemplos a seguir adicionam uma origem privada da pasta 1 na biblioteca de ativos de site do conjunto de sites:

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

Para obter mais informações sobre esse comando e sua sintaxe, consulte Add-PnPTenantCdnOrigin.

Observação

Em origens privadas, os ativos que estão sendo compartilhados de uma origem devem ter uma versão principal publicada antes de serem acessados do CDN.

Depois de executar o comando, o sistema sincroniza a configuração no datacenter. Isso pode levar até 15 minutos.

Exemplo: configure uma origem pública para suas páginas mestras e para sua biblioteca de estilos para SharePoint Online

Normalmente, essas origens são configuradas para você por padrão quando você habilita o Office 365 CDN. No entanto, se você quiser habilita-los manualmente, siga estas etapas.

  • Use o cmdlet Add-PnPTenantCdnOrigin para definir a biblioteca de estilos como uma origem pública.

    Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */style%20library
    
  • Use o cmdlet Add-PnPTenantCdnOrigin para definir as páginas mestras como uma origem pública.

    Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
    

Para obter mais informações sobre esse comando e sua sintaxe, consulte Add-PnPTenantCdnOrigin.

Depois de executar o comando, o sistema sincroniza a configuração no datacenter. Isso pode levar até 15 minutos.

Exemplo: configurar uma origem privada para seus ativos de site, páginas de site e imagens de publicação para SharePoint Online

  • Use o cmdlet Add-PnPTenantCdnOrigin para definir a pasta de ativos do site como uma origem privada.

    Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */siteassets
    
  • Use o cmdlet Add-PnPTenantCdnOrigin para definir a pasta de páginas do site como uma origem privada.

    Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */sitepages
    
  • Use o cmdlet Add-PnPTenantCdnOrigin para definir a pasta de imagens de publicação como uma origem privada.

    Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */publishingimages
    

Para obter mais informações sobre esse comando e sua sintaxe, consulte Add-PnPTenantCdnOrigin.

Depois de executar o comando, o sistema sincroniza a configuração no datacenter. Isso pode levar até 15 minutos.

Exemplo: configurar uma origem privada para um conjunto de sites para SharePoint Online

Use o cmdlet Add-PnPTenantCdnOrigin para definir um conjunto de sites como uma origem privada. Por exemplo:

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

Para obter mais informações sobre esse comando e sua sintaxe, consulte Add-PnPTenantCdnOrigin.

Depois de executar o comando, o sistema sincroniza a configuração no datacenter. Você pode ver uma mensagem de configuração pendente que é esperada à medida que o locatário SharePoint Online se conecta ao serviço CDN de configuração. Isso pode levar até 15 minutos.

Gerenciar o Office 365 CDN

Depois de configurar o CDN, você poderá fazer alterações em sua configuração conforme atualiza o conteúdo ou conforme suas necessidades mudam, conforme descrito nesta seção.

Adicionar, atualizar ou remover ativos do Office 365 CDN

Depois de concluir as etapas de instalação, você pode adicionar novos ativos e atualizar ou remover ativos existentes sempre que quiser. Basta fazer suas alterações nos ativos na pasta ou SharePoint que você identificou como uma origem. Se você adicionar um novo ativo, ele estará disponível por meio do CDN imediatamente. No entanto, se você atualizar o ativo, levará até 15 minutos para que a nova cópia se propague e se torne disponível no CDN.

Se você precisar recuperar o local da origem, poderá usar o cmdlet Get-PnPTenantCdnOrigin. Para obter informações sobre como usar esse cmdlet, consulte Get-PnPTenantCdnOrigin.

Remover uma origem do Office 365 CDN

Você pode remover o acesso a uma pasta ou SharePoint que você identificou como uma origem. Para fazer isso, use o cmdlet Remove-PnPTenantCdnOrigin.

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

Para obter informações sobre como usar esse cmdlet, consulte Remove-PnPTenantCdnOrigin.

Modificar uma origem no Office 365 CDN

Não é possível modificar uma origem criada. Em vez disso, remova a origem e adicione um novo. Para obter mais informações, consulte To remove an origin from the Office 365 CDN and To add an origin for your assets.

Desabilitar o Office 365 CDN

Use o cmdlet Set-PnPTenantCdnEnabled para desabilitar o CDN para sua organização. Se você tiver as origens públicas e privadas habilitadas para o CDN, será necessário executar o cmdlet duas vezes, conforme mostrado nos exemplos a seguir.

Para desabilitar o uso de origens públicas no CDN, insira o seguinte comando:

Set-PnPTenantCdnEnabled -CdnType Public -Enable $false

Para desabilitar o uso das origens privadas no CDN, insira o seguinte comando:

Set-PnPTenantCdnEnabled -CdnType Private -Enable $false

Para obter mais informações sobre esse cmdlet, consulte Set-PnPTenantCdnEnabled.

Instalação e configuração da CDN do Office 365 usando a CLI do Office 365

Os procedimentos nesta seção exigem que você tenha instalado o Office 365 CLI. Em seguida, conecte-se ao seu locatário Office 365 usando o comando de logon.

Conclua estas etapas para configurar e configurar o CDN para hospedar seus ativos no SharePoint Online usando a CLI de Office 365.

Clique para expandir

Habilitar o Office 365 CDN

Você pode gerenciar o estado da CDN do Office 365 no locatário usando o comando spo cdn set.

Para habilitar a CDN pública do Office 365 no locatário:

spo cdn set --type Public --enabled true

Para habilitar o Office 365 SharePoint CDN, execute:

spo cdn set --type Private --enabled true

Exiba o status atual da CDN do Office 365

Para verificar se o tipo específico de Office 365 CDN está habilitado ou desabilitado, use o comando spo cdn get.

Para verificar se a CDN pública do Office 365 está habilitada:

spo cdn get --type Public

Exibir as Office 365 CDN origens

Para exibir as origens de CDN pública do Office 365 configuradas no momento:

spo cdn origin list --type Public

Consulte Default CDN origins for information about the origins that are provisioned by default when you enable the Office 365 CDN.

Adicionar uma Office 365 CDN de origem

Importante

Você nunca deve colocar recursos considerados confidenciais para sua organização em uma biblioteca de documentos SharePoint configurada como uma origem pública.

Use o adicionar comando spo cdn origem para definir uma origem de CDN. Você pode definir várias origens. A origem é uma URL que aponta para uma biblioteca ou pasta do SharePoint contendo os ativos que você deseja hospedar na CDN.

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

Onde path está o caminho relativo para a pasta que contém os ativos. Você pode usar caracteres curinga, além de caminhos relativos.

Para incluir todos os ativos na Galeria de Páginas Mestras de todos os sites como uma origem pública, execute:

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

Para configurar uma origem privada para um conjunto de sites específico:

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

Observação

Após adicionar uma origem de CDN, pode levar até 15 minutos para que você possa recuperar arquivos por meio do serviço de CDN. Você pode verificar se a origem específica já foi ativada usando o comando spo cdn origin list.

Remover uma Office 365 CDN de origem

Use o comando spo cdn origin remove para remover uma origem de CDN para o tipo de CDN especificado.

Para remover uma origem pública da configuração CDN, execute:

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

Observação

Remover uma CDN origem não afeta os arquivos armazenados em qualquer biblioteca de documentos que corresponde a essa origem. Se esses ativos foram referenciados usando SharePoint URL de SharePoint, o SharePoint alternará automaticamente para a URL original apontando para a biblioteca de documentos. Se, no entanto, os ativos foram referenciados usando uma URL de CDN pública, remover a origem quebrará o link e você precisará alterá-los manualmente.

Modificar uma Office 365 CDN de origem

Não é possível alterar uma origem de CDN. Em vez disso, você deve remover a origem de CDN definida anteriormente usando o comando spo cdn origin remove e adicionar outro usando o comando spo cdn origin add.

Alterar os tipos de arquivos a incluir no Office 365 CDN

Por padrão, os seguintes tipos de arquivo são incluídos no CDN: .css, .eot, .gif, .ico, .jpeg, .jpg, .js, .map, .png, .svg, .ttf, .woff e .woff2. Se precisar incluir outros tipos de arquivo na CDN, você pode alterar a configuração de CDN usando o comando spo cdn policy set.

Observação

Ao alterar a lista de tipos de arquivo, você substitui a lista definida no momento. Se quiser incluir outros tipos de arquivo, primeiro use o comando spo cdn policy list para descobrir quais tipos de arquivo estão configurados no momento.

Para adicionar o tipo de arquivo JSON à lista padrão de tipos de arquivo incluídos no arquivo CDN público, execute:

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

Altere a lista de classificações de site que você deseja excluir da CDN do Office 365

Use o comando spo cdn policy set para excluir as classificações de site que não deseja disponibilizar na CDN. Por padrão, nenhuma classificação de sites é excluída.

Observação

Ao alterar a lista de classificações de sites excluída, você substitui a lista definida no momento. Se desejar excluir outras classificações, primeiro use o comando spo cdn policy list para descobrir quais classificações estão configuradas no momento.

Para excluir sites classificados como HBI da CDN pública, execute

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

Desabilitar o Office 365 CDN

Para desabilitar a CDN do Office 365, use o comando spo cdn set, por exemplo:

spo cdn set --type Public --enabled false

Usando seus CDN ativos

Agora que você habilitar as CDN e as origens e políticas configuradas, você pode começar a usar seus CDN ativos.

Esta seção o ajudará a entender como usar urLs CDN em suas páginas de SharePoint e conteúdo para que o SharePoint redirecione solicitações de ativos em origens públicas e privadas para o CDN.

Para obter informações sobre como usar o CDN para hospedar Web Parts do lado do cliente, consulte o tópico Hospedar sua Web Part do lado do cliente Office 365 CDN (Hello World part 4).

Observação

Se você adicionar a pasta ClientSideAssets à lista de origens CDN particular, CDN web parts personalizadas hospedadas não serão renderizações. Os arquivos usados pelas Web Parts SPFX só podem usar o arquivo público CDN e a pasta ClientSideAssets é uma origem padrão para o público CDN.

Para usar ativos adicionados a uma origem, basta atualizar links para o arquivo original com o caminho para o arquivo na origem.

  • Edite a página ou o conteúdo que contém links para ativos que você adicionou a uma origem. Você também pode usar um dos vários métodos para pesquisar globalmente e substituir links em um site de entrada ou conjunto de sites se quiser atualizar o link para um determinado ativo em todos os lugares em que ele aparecer.
  • Para cada link para um ativo em uma origem, substitua o caminho pelo caminho para o arquivo na CDN origem. Você pode usar caminhos relativos.
  • Salve a página ou o conteúdo.

Por exemplo, considere a imagem /site/SiteAssets/images/image.png, que você copiou para a pasta da biblioteca de documentos /site/CDN_origins/public/. Para usar o ativo CDN, substitua o caminho original para o local do arquivo de imagem pelo caminho para a origem para tornar a nova URL /site/CDN_origins/public/image.png.

Se você quiser usar a URL completa para o ativo em vez de um caminho relativo, construa o link assim:

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

Observação

Em geral, você não deve codificar URLs diretamente para ativos no CDN. No entanto, você pode construir manualmente URLs para ativos em origens públicas, se necessário. Para obter mais informações, consulte Hardcoding CDN URLs para ativos públicos.

Para saber mais sobre como verificar se os ativos estão sendo atendidos no CDN, consulte Como confirmar se os ativos estão sendo atendidos pelo CDN? em Solução de problemas do Office 365 CDN.

Usando ativos em origens públicas

O recurso de publicação no SharePoint Online regrava automaticamente URLs de ativos armazenados em origens públicas para seus equivalentes CDN para que os ativos sejam atendidos do serviço CDN em vez de SharePoint.

Se sua origem estiver em um site com o recurso de Publicação habilitado e os ativos que você deseja descarregar para o CDN estão em uma das seguintes categorias, o SharePoint reescreverá automaticamente URLs para ativos na origem, desde que o ativo não tenha sido excluído por uma política de CDN.

Mostramos a seguir uma visão geral dos links reescritos automaticamente pelo recurso de Publicação do SharePoint:

  • URLs IMG/LINK/CSS em respostas de HTML de página de publicação clássica
    • Incluem-se imagens adicionadas por autores no conteúdo HTML de uma página
  • URLs de imagem da web part Apresentação de Slides da Biblioteca de Imagens
  • Campos de imagem nos resultados da API REST SPList (RenderListDataAsStream)
    • Use a nova propriedade ImageFieldsToTryRewriteToCdnUrls para fornecer uma lista separada de vírgulas de campos
    • Oferece suporte a campos de hiperlink e campos PublishingImage
  • SharePoint de imagem

O diagrama a seguir ilustra o fluxo de trabalho quando SharePoint recebe uma solicitação de uma página contendo ativos de origem pública.

Diagrama de fluxo de trabalho: recuperar Office 365 CDN ativos de origem pública.

Dica

Se você quiser desabilitar a reescrita automática para URLs específicas em uma página, pode fazer check-out da página e adicionar o parâmetro de cadeia de caracteres de consulta? NoAutoReWrites=true até o final de cada link que você deseja desabilitar.

Criar CDN URLs para ativos públicos

Se o recurso de Publicação não estiver habilitado para uma origem pública ou o ativo não for um dos tipos de link suportados pelo recurso de reescrita automática do serviço CDN, você poderá construir manualmente URLs para o local CDN dos ativos e usar essas URLs em seu conteúdo.

Observação

Você não pode codificar ou construir CDN URLs para ativos em uma origem privada porque o token de acesso necessário que forma a última seção da URL é gerado no momento em que o recurso é solicitado. Você pode construir a URL para CDN públicas e a URL não deve ser codificada em código, pois ela está sujeita a alterações.

Para ativos CDN públicos, o formato URL terá a seguinte aparência:

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

Substitua TenantHostName pelo nome do locatário. Exemplo:

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

Observação

A propriedade de contexto de página deve ser usada para construir o prefixo em vez de codificação " https://publiccdn.sharepointonline.com ". A URL está sujeita a alterações e não deve ser codificada. Se você estiver usando modelos de exibição com o SharePoint Online clássicos, poderá usar a propriedade "window._spPageContextInfo.publicCdnBaseUrl" em seu modelo de exibição para o prefixo da URL. Se você estiver SPFx web parts modernas e clássicas SharePoint a propriedade "this.context.pageContext.legacyPageContext.publicCdnBaseUrl". Isso fornecerá o prefixo para que, se for alterado, sua implementação será atualizada com ele. Como exemplo para SPFx, a URL pode ser construída usando a propriedade "this.context.pageContext.legacyPageContext.publicCdnBaseUrl" + "/" + "host" + "/" + "relativeURL para o item". Confira Usando CDN código do lado do cliente que faz parte da série de desempenho da 1ª temporada

Usando ativos em origens privadas

Nenhuma configuração adicional é necessária para usar ativos em origens privadas. SharePoint Online regrava automaticamente URLs para ativos em origens privadas, portanto, as solicitações para esses ativos sempre serão atendidas do CDN. Você não pode criar manualmente URLs para CDN ativos em origens privadas porque essas URLs contêm tokens que devem ser gerados automaticamente pelo SharePoint Online no momento em que o ativo é solicitado.

O acesso a ativos em origens privadas é protegido por tokens gerados dinamicamente com base nas permissões do usuário para a origem, com as advertências descritas nas seções a seguir. Os usuários devem ter pelo menos acesso de leitura às origens do CDN renderizar o conteúdo.

O diagrama a seguir ilustra o fluxo de trabalho quando SharePoint recebe uma solicitação de uma página contendo ativos de origem privada.

Diagrama de fluxo de trabalho: recuperar Office 365 CDN ativos de origem privada.

Autorização baseada em token em origens privadas

O acesso a ativos em origens privadas no Office 365 CDN é concedido por tokens gerados pelo SharePoint Online. Os usuários que já têm permissão para acessar a pasta ou biblioteca designada pela origem são automaticamente concedidos tokens que permitem que o usuário acesse o arquivo com base em seu nível de permissão. Esses tokens de acesso são válidos de 30 a 90 minutos depois que são gerados para ajudar a evitar ataques de repetição de token.

Depois que o token de acesso é gerado, o SharePoint Online retorna um URI personalizado para o cliente que contém dois parâmetros de autorização comam (token de autorização de borda) e aveia (token de autorização de origem). A estrutura de cada token é< tempo de expiração no formato época de >__<'secure signature'>. Por exemplo:

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

Observação

Qualquer pessoa que tenha o token pode acessar o recurso no CDN. No entanto, as URLs que contêm esses tokens de acesso são compartilhadas somente por HTTPS, portanto, a menos que a URL seja explicitamente compartilhada por um usuário final antes que o token expire, o ativo não estará acessível a usuários não autorizados.

Permissões de nível de item não são suportadas para ativos em origens privadas

É importante observar que o SharePoint Online não dá suporte a permissões de nível de item para ativos em origens privadas. Por exemplo, para um arquivo localizado em , os usuários têm acesso efetivo ao https://contoso.sharepoint.com/sites/site1/library1/folder1/image1.jpg arquivo dadas as seguintes condições:

Usuário Permissões Acesso efetivo
Usuário 1 Tem acesso à pasta1 Pode acessar image1.jpg do CDN
Usuário 2 Não tem acesso à pasta1 Não é possível acessar image1.jpg do CDN
Usuário 3 Não tem acesso à pasta1, mas tem permissão explícita para acessar image1.jpg no SharePoint Online Pode acessar o recurso image1.jpg diretamente do SharePoint Online, mas não do CDN
Usuário 4 Tem acesso à pasta1, mas foi explicitamente negado o acesso image1.jpg no SharePoint Online Não é possível acessar o ativo do SharePoint Online, mas pode acessar o ativo do CDN apesar de ter sido negado o acesso ao arquivo no SharePoint Online

Solução de problemas do Office 365 CDN

Como confirmar se os ativos estão sendo atendidos pelo CDN?

Depois de adicionar links para CDN ativos em uma página, você pode confirmar se o ativo está sendo servido do CDN navegando até a página, clicando com o botão direito do mouse na imagem depois de renderizado e revendo a URL da imagem.

Você também pode usar as ferramentas de desenvolvedor do navegador para exibir a URL de cada ativo em uma página ou usar uma ferramenta de rastreamento de rede de terceiros.

Observação

Se você usar uma ferramenta de rede como o Fiddler para testar seus ativos fora da renderização do ativo de uma página do SharePoint, você deve adicionar manualmente o header do referer "Referer: " à solicitação GET em que a URL é a URL raiz do locatário https://yourdomain.sharepoint.com do SharePoint Online.

Não é possível testar CDN URLs diretamente em um navegador da Web, pois você deve ter um referer vindo do SharePoint Online. No entanto, se você adicionar a URL do ativo CDN a uma página SharePoint e, em seguida, abrir a página em um navegador, você verá o ativo CDN renderizado na página.

Para obter mais informações sobre como usar as ferramentas de desenvolvedor no navegador Microsoft Edge, consulte Microsoft Edge Ferramentas de Desenvolvedor.

Para assistir a um vídeo curto hospedado no canal do SharePoint Developer Patterns and Practices do YouTube demonstrando como verificar se o CDN está funcionando, consulte Verifying your CDN usageand ensuring optimal network connectivity .

Por que os ativos de uma nova origem estão indisponíveis?

Os ativos em novas origens não estarão disponíveis imediatamente para uso, pois leva tempo para que o registro se propague pelo CDN e para que os ativos sejam carregados da origem para o armazenamento CDN. O tempo necessário para que os ativos estão disponíveis no CDN depende de quantos ativos e tamanhos de arquivos.

Minha web part do lado do cliente ou Estrutura do SharePoint solução não está funcionando

Quando você habilita o Office 365 CDN para origens públicas, o serviço CDN cria automaticamente essas origens padrão:

  • */MASTERPAGE
  • BIBLIOTECA */STYLE
  • */CLIENTSIDEASSETS

Se a origem */clientsideassets estiver ausente, Estrutura do SharePoint soluções falharão e nenhuma mensagem de aviso ou erro será gerada. Essa origem pode estar ausente porque o CDN foi habilitado com o parâmetro -NoDefaultOrigins definido como $true , ou porque a origem foi excluída manualmente.

Você pode verificar quais origens estão presentes com o seguinte comando do PowerShell:

Get-SPOTenantCdnOrigins -CdnType Public

Ou você pode verificar com o Office 365 CLI:

spo cdn origin list

Para adicionar a origem no PowerShell:

Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */CLIENTSIDEASSETS

Para adicionar a origem no Office 365 CLI:

spo cdn origin add --origin */CLIENTSIDEASSETS

Quais módulos e shells CLI do PowerShell preciso para trabalhar com o Office 365 CDN?

Você pode optar por trabalhar com a Office 365 CDN usando o módulo SharePoint Do Shell de Gerenciamento Online do PowerShell ou o Office 365 CLI.

Veja também

Redes de Distribuição de Conteúdo

Planejamento de rede e ajuste de desempenho para o Office 365

SharePoint Performance Series - Office 365 CDN de vídeo