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, a CDN Office 365 usa o protocolo HTTP/2 para melhor compactação e pipelining HTTP. O serviço de CDN do Office 365 faz parte da assinatura do SharePoint Online.

Cuidado

A configuração de CDN privada está em processo de preterição. Você não é mais necessário para configurar uma CDN privada. Os tipos de arquivo de imagem são servidos por meio de uma CDN privada fora da caixa. No entanto, se uma CDN privada estiver em uso para outros tipos de arquivo, como JS ou CSS, recomendamos usar uma CDN pública para melhor desempenho. Daqui para frente, não haverá suporte para tipos de arquivo que não sejam de imagem por meio de CDNs privadas.

Observação

A CDN Office 365 só está disponível para locatários na nuvem Produção (em todo o mundo). Atualmente, os locatários das nuvens do governo dos EUA e da China não dão suporte à CDN Office 365.

A CDN do Office 365 é composta por várias CDNs que permitem que você hospede ativos estáticos em vários locais ou origense 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. Consulte 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 diagrama conceitual da CDN.

Se você já estiver familiarizado com a forma como as CDNs funcionam, você só precisará concluir algumas etapas para habilitar a CDN Office 365 para seu locatário. Este tópico descreve como. Continue a ler 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 Office 365 para cenários de uso especializados, mas não são discutidas neste tópico porque estão fora do escopo da CDN Office 365. Para obter mais informações, consulte Outras CDNs da Microsoft.

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

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

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

Depois de terminar a instalação, você pode gerenciar a CDN Office 365 ao longo do tempo:

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

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

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

Planejar a implantação da CDN Office 365

Antes de implantar a CDN Office 365 para seu locatário Office 365, você deve considerar os seguintes fatores como parte do processo de planejamento.

Determinar quais ativos estáticos você deseja hospedar na 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 atendam 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 carga da página
  • Arquivos grandes, como executáveis e arquivos de instalação
  • Bibliotecas de recursos que dão suporte ao 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 da renderização do site e reduzir incrementalmente a carga em seus sites do SharePoint Online quando você as adiciona a uma origem cdn. Arquivos maiores, como executáveis de instalação, podem ser baixados da CDN, fornecendo um impacto positivo no desempenho e uma redução subsequente da carga em seu site do SharePoint Online, mesmo que não sejam acessados com tanta 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 de Office 365 em menos de um segundo. No entanto, uma página da Web pode conter muitos arquivos inseridos com um tempo de download cumulativo de vários segundos. Servir esses arquivos da CDN pode reduzir significativamente o tempo de carga geral da página. Veja Quais ganhos de desempenho uma CDN fornece? para obter um exemplo.

Determinar onde você deseja armazenar seus ativos

A CDN busca seus ativos de um local chamado origem. Uma origem pode ser um site do SharePoint, uma biblioteca de documentos ou uma pasta acessível por uma URL. Você tem 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 ativos da CDN. Você pode optar por ter origens públicas ou privadas em 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 deseja disponibilizar na CDN. Essa é uma boa abordagem se você tiver um conjunto específico de ativos que deseja estar disponível na CDN e quiser restringir o conjunto de ativos CDN a apenas esses arquivos no contêiner.

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

Você pode definir políticas de CDN para excluir conteúdo em suas origens da CDN. As políticas da CDN 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) que você especifica na política. Por exemplo, se você adicionar uma origem privada que consiste em um site que contém vários subsites, você 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 atendido da CDN. A política se aplicará ao conteúdo de todas as origens privadas que você adicionou à CDN.

Tenha em mente que quanto maior o número de origens, maior o impacto sobre o tempo que o serviço CDN leva para processar solicitações. Recomendamos limitar 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 tornada pública ou privada. O acesso a ativos cdn em origens públicas é anônimo e o conteúdo da CDN 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 de administração da própria CDN. Além disso, você pode mudar de ideia mais tarde, depois de configurar a CDN e identificar suas origens.

As opções pública e privada fornecem ganhos de desempenho semelhantes, mas cada uma tem vantagens e atributos 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, como bibliotecas de documentos do SharePoint 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 local de armazenamento. As origens privadas no Office 365 CDN só podem ser usadas para conteúdo do SharePoint Online e você só pode acessar ativos em origens privadas por meio do redirecionamento do locatário do SharePoint Online.

Você pode ler mais sobre como o acesso da CDN 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 à 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 continuar com cuidado e garantir que você utilize a propriedade de contexto da página e siga as diretrizes para 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 apenas codificada com o 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 especificadas. 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

  • Origens privadas só podem ser usadas para ativos do SharePoint Online.

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

  • Os ativos em origens privadas devem ser encaminhados do locatário do SharePoint Online. O acesso direto a ativos 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 na 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 acontece com as 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 use curingas para incluir todos os ativos em uma pasta ou biblioteca de documentos.

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

Origens padrão da CDN

A menos que você especifique o contrário, Office 365 configure algumas origens padrão para você ao habilitar a CDN Office 365. Se você optar inicialmente por não provisioná-los, poderá adicionar essas origens depois de 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 isso, você deve permitir que elas sejam criadas quando você habilitar a CDN.

Origens da CDN privada padrão:

  • */siteassets

Origens da CDN pública padrão:

  • */Masterpage
  • */biblioteca de estilos
  • */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 na CDN funcionem. Se você habilitou a CDN Office 365 antes de dezembro de 2017 ou se você ignorou a instalação de origens padrão quando habilitou a CDN, poderá adicionar manualmente essa origem. Para obter mais informações, consulte Minha web part do lado do cliente ou Estrutura do SharePoint solução não está funcionando.

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

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

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

Clique para expandir

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

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

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

Agora, use o cmdlet Get-SPOTenantCdnEnabled para recuperar as configurações de status da CDN do locatário:

Get-SPOTenantCdnEnabled -CdnType <Public | Private>

O status da CDN para o CdnType especificado será gerado para a 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 ambos ao mesmo tempo. Você também pode configurar a CDN para ignorar a configuração de origens padrão ao habilitá-la. Você sempre pode adicionar essas origens posteriormente, conforme descrito neste tópico.

Em Windows PowerShell para o 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 Origens padrão da CDN para obter informações sobre as origens que são provisionadas por padrão quando você habilita a CDN Office 365 e o impacto potencial de ignorar a configuração de origens padrão.

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 a serem incluídos na CDN Office 365 (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 junto 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 na CDN. Por padrão, tipos de ativos comuns são permitidos, por exemplo, .css, .gif, .jpg e .js.

Em Windows PowerShell para o SharePoint Online:

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

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

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

Para ver quais tipos de arquivo são permitidos atualmente pela 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 da CDN Office 365 (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 adicione-as 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 o 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 atendidas da 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 da 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 atendido da CDN.

A propriedade ExcludeIfNoScriptDisabled exclui o conteúdo da 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 à 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 dão suporte a curingas pré-acrescentados à URL. Isso permite criar origens que abrangem vários sites. Por exemplo, para incluir todos os ativos na pasta de páginas mestras para todos os sites como uma origem pública dentro da CDN, digite o seguinte comando:

Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
  • O modificador 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. Você não pode 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 pasta folder1 na biblioteca de ativos do site da coleção de sites:

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

Se houver um espaço no caminho, você poderá cercar o caminho em aspas duplas ou substituir o espaço pela codificação de URL %20. Os exemplos a seguir adicionam uma origem privada da pasta pasta 1 na biblioteca de ativos do site da coleção 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 importante publicada antes de poderem ser acessados da CDN.

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

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

Normalmente, essas origens são configuradas para você por padrão quando você habilita a CDN Office 365. No entanto, se você quiser habilitá-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 de 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 os ativos do site, páginas do site e publicar imagens para o 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 páginas do site como uma origem privada.

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */sitepages
    
  • Use o cmdlet Add-SPOTenantCdnOrigin para definir a pasta 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 uma coleção de sites para o SharePoint Online

Use o cmdlet Add-SPOTenantCdnOrigin para definir uma coleção 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 pendente de configuração que é esperada à medida que o locatário do SharePoint Online se conecta ao serviço CDN. Isso pode levar até 15 minutos.

Gerenciar a CDN Office 365

Depois de configurar a CDN, você pode fazer alterações na configuração conforme atualiza o conteúdo ou conforme suas necessidades são alteradas, conforme descrito nesta seção.

Adicionar, atualizar ou remover ativos da CDN Office 365

Depois de concluir as etapas de instalação, você pode adicionar novos ativos e atualizar ou remover ativos existentes sempre que desejar. Basta fazer suas alterações nos ativos na pasta ou biblioteca do SharePoint que você identificou como uma origem. Se você adicionar um novo ativo, ele estará disponível por meio da CDN imediatamente. No entanto, se você atualizar o ativo, levará até 15 minutos para a nova cópia se propagar e ficar disponível na 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 da CDN Office 365

Você pode remover o acesso a uma pasta ou biblioteca do 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 na CDN Office 365

Você não pode modificar uma origem criada. Em vez disso, remova a origem e adicione uma nova. Para obter mais informações, consulte Para remover uma origem do Office 365 CDN e Para adicionar uma origem para seus ativos.

Desabilitar a CDN Office 365

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

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

Set-SPOTenantCdnEnabled -CdnType Public -Enable $false

Para desabilitar o uso das origens privadas na 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 a CDN Office 365 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 Introdução ao PnP PowerShell.

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

Clique para expandir

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

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

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

Agora use o cmdlet Get-PnPTenantCdnEnabled para recuperar as configurações de status da CDN do locatário:

Get-PnPTenantCdnEnabled -CdnType <Public | Private>

O status da CDN para o CdnType especificado será gerado para a tela.

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

No PowerShell PnP:

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 Origens padrão da CDN para obter informações sobre as origens que são provisionadas por padrão quando você habilita a CDN Office 365 e o impacto potencial de ignorar a configuração de origens padrão.

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 a serem incluídos na CDN Office 365 (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 junto 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 na CDN. Por padrão, tipos de ativos comuns são permitidos, por exemplo, .css, .gif, .jpg e .js.

No PowerShell PnP:

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

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

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

Para ver quais tipos de arquivo são permitidos atualmente pela 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 da CDN Office 365 (opcional)

Dica

Ao excluir classificações de site usando o cmdlet Set-PnPTenantCdnPolicy , 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 adicione-as junto com as novas.

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

No PowerShell PnP:

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 atendidas da 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 da 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 atendido da CDN.

A propriedade ExcludeIfNoScriptDisabled exclui o conteúdo da 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 à 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 dão suporte a curingas pré-acrescentados à URL. Isso permite criar origens que abrangem vários sites. Por exemplo, para incluir todos os ativos na pasta de páginas mestras para todos os sites como uma origem pública dentro da CDN, digite o seguinte comando:

Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
  • O modificador 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. Você não pode 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 pasta folder1 na biblioteca de ativos do site da coleção de sites:

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

Se houver um espaço no caminho, você poderá cercar o caminho em aspas duplas ou substituir o espaço pela codificação de URL %20. Os exemplos a seguir adicionam uma origem privada da pasta pasta 1 na biblioteca de ativos do site da coleção 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 importante publicada antes de poderem ser acessados da CDN.

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

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

Normalmente, essas origens são configuradas para você por padrão quando você habilita a CDN Office 365. No entanto, se você quiser habilitá-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 os ativos do site, páginas do site e publicar imagens para o 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 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 uma coleção de sites para o SharePoint Online

Use o cmdlet Add-PnPTenantCdnOrigin para definir uma coleção 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 pendente de configuração que é esperada à medida que o locatário do SharePoint Online se conecta ao serviço CDN. Isso pode levar até 15 minutos.

Gerenciar a CDN Office 365

Depois de configurar a CDN, você pode fazer alterações na configuração conforme atualiza o conteúdo ou conforme suas necessidades são alteradas, conforme descrito nesta seção.

Adicionar, atualizar ou remover ativos da CDN Office 365

Depois de concluir as etapas de instalação, você pode adicionar novos ativos e atualizar ou remover ativos existentes sempre que desejar. Basta fazer suas alterações nos ativos na pasta ou biblioteca do SharePoint que você identificou como uma origem. Se você adicionar um novo ativo, ele estará disponível por meio da CDN imediatamente. No entanto, se você atualizar o ativo, levará até 15 minutos para a nova cópia se propagar e ficar disponível na 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 da CDN Office 365

Você pode remover o acesso a uma pasta ou biblioteca do 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 na CDN Office 365

Você não pode modificar uma origem criada. Em vez disso, remova a origem e adicione uma nova. Para obter mais informações, consulte Para remover uma origem do Office 365 CDN e Para adicionar uma origem para seus ativos.

Desabilitar a CDN Office 365

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

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

Set-PnPTenantCdnEnabled -CdnType Public -Enable $false

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

Set-PnPTenantCdnEnabled -CdnType Private -Enable $false

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

Configurar e configurar a CDN Office 365 usando a CLI do Microsoft 365

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

Conclua estas etapas para configurar e configurar a CDN para hospedar seus ativos no SharePoint Online usando a CLI do Microsoft 365.

Clique para expandir

Habilitar a CDN Office 365

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 CDN do SharePoint, 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 origens da CDN Office 365

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

spo cdn origin list --type Public

Consulte Origens padrão da CDN para obter informações sobre as origens que são provisionadas por padrão quando você habilita a CDN Office 365.

Adicionar uma origem da CDN Office 365

Importante

Você nunca deve colocar recursos considerados confidenciais para sua organização em uma biblioteca de documentos do SharePoint configurada como de 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ágina Mestra de todos os sites como de 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 origem da CDN Office 365

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 da CDN, execute:

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

Observação

A remoção de uma origem CDN não afeta os arquivos armazenados em nenhuma biblioteca de documentos que corresponda a essa origem. Se esses ativos tiverem sido referenciados usando sua URL do SharePoint, o SharePoint retornará automaticamente para a URL original que aponta para a biblioteca de documentos. Se, no entanto, os ativos tiverem sido referenciados usando uma URL de CDN pública, a remoção da origem quebrará o link e você precisará alterá-los manualmente.

Modificar uma origem da CDN Office 365

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 serem incluídos na CDN Office 365

Por padrão, os seguintes tipos de arquivo são incluídos na 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 na CDN pública, 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 a CDN Office 365

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

spo cdn set --type Public --enabled false

Usando seus ativos cdn

Agora que você habilitou a CDN e configurou origens e políticas, você pode começar a usar seus ativos cdn.

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

Para obter informações sobre como usar a CDN para hospedar web parts do lado do cliente, consulte o tópico Hospedar sua Web Part do lado do cliente de Office 365 CDN (Olá, Mundo parte 4).

Observação

Se você adicionar a pasta ClientSideAssets à lista de origens da CDN privada, as Web Parts personalizadas hospedadas pela CDN não serão renderizadas. Os arquivos usados por web parts SPFX só podem utilizar a CDN pública e a pasta ClientSideAssets é uma origem padrão para CDN pública.

Para usar ativos que você adicionou 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 e substituir links globalmente em um site de entrada ou coleção de sites se quiser atualizar o link para um determinado ativo em todos os lugares em que ele aparece.
  • Para cada link para um ativo em uma origem, substitua o caminho pelo caminho para o arquivo na origem da CDN. 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 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 até 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 na CDN. No entanto, você pode construir manualmente URLs para ativos em origens públicas, se necessário. Para obter mais informações, consulte URLs de CDN de codificação para ativos públicos.

Para saber mais sobre como verificar se os ativos estão sendo atendidos na CDN, consulte Como fazer confirmar se os ativos estão sendo atendidos pela CDN? em Solucionar problemas do Office 365 CDN.

Usando ativos em origens públicas

O recurso De publicação no SharePoint Online reescreve 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 do SharePoint.

Se sua origem estiver em um site com o recurso Publicar habilitado e os ativos que você deseja descarregar para a CDN estiverem 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 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 de campos separados por vírgulas
    • Dá suporte a campos de hiperlink e campos PublishingImage
  • Representações de imagem do SharePoint

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

Diagrama de fluxo de trabalho: recuperando Office 365 ativos cdn de uma origem pública.

Dica

Se você quiser desabilitar a reescrita automática para URLs específicas em uma página, poderá verificar a 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.

Construir URLs de CDN para ativos públicos

Se o recurso Publicar não estiver habilitado para uma origem pública ou o ativo não for um dos tipos de link compatíveis com o recurso de reescrita automática do serviço CDN, você poderá construir manualmente URLs para a localização cdn dos ativos e usar essas URLs em seu conteúdo.

Observação

Você não pode codificar ou construir URLs de CDN 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ública e a URL não deve ser codificada com código rígido, pois está sujeita a alterações.

Para ativos públicos da CDN, o formato de URL será semelhante ao seguinte:

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 dura "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ássico, poderá usar a propriedade "window._spPageContextInfo.publicCdnBaseUrl" em seu modelo de exibição para o prefixo da URL. Se você for web parts SPFx para SharePoint moderno e clássico, poderá utilizar a propriedade "this.context.pageContext.legacyPageContext.publicCdnBaseUrl". Isso fornecerá o prefixo para que, se ele for alterado, sua implementação será atualizada com ele. Como exemplo para o SPFx, a URL pode ser construída usando a propriedade "this.context.pageContext.legacyPageContext.publicCdnBaseUrl" + "/" + "host" + "/" + "relativeURL para o item". Confira Usando CDN no 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. O SharePoint Online reescreve automaticamente URLs para ativos em origens privadas para que as solicitações desses ativos sempre sejam atendidas da CDN. Você não pode criar URLs manualmente em ativos CDN 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 em permissões de usuário para a origem, com as ressalvas descritas nas seções a seguir. Os usuários devem ter pelo menos acesso de leitura às origens da CDN para renderizar o conteúdo.

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

Diagrama de fluxo de trabalho: recuperando Office 365 ativos cdn de uma 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 recebem automaticamente tokens que permitem que o usuário acesse o arquivo com base no nível de permissão. Esses tokens de acesso são válidos por 30 a 90 minutos após serem gerados para ajudar a evitar ataques de reproduçã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 comer (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 de tempo de época'>__<'assinatura segura'>. 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 em posse do token pode acessar o recurso na CDN. No entanto, as URLs que contêm esses tokens de acesso são compartilhadas apenas por HTTPS, portanto, a menos que a URL seja compartilhada explicitamente por um usuário final antes do token expirar, o ativo não estará acessível a usuários não autorizados.

Não há suporte para permissões no nível do item para ativos em origens privadas

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

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

Solução de problemas da CDN Office 365

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

Depois de adicionar links aos ativos da CDN a uma página, você pode confirmar que o ativo está sendo servido da CDN navegando até a página, clicando com o botão direito do mouse na imagem depois de renderizado e revisando 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ê deverá adicionar manualmente o cabeçalho do referenciador "Referer: https://yourdomain.sharepoint.com" à solicitação GET em que a URL é a URL raiz do locatário do SharePoint Online.

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

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

Para assistir a um pequeno vídeo hospedado no canal do YouTube Padrões e Práticas do Desenvolvedor do SharePoint demonstrando como verificar se sua CDN está funcionando, consulte Verificar o uso da CDN e garantir a conectividade de rede ideal.

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

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

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

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

  • */MASTERPAGE
  • */STYLE LIBRARY
  • */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 a CDN foi habilitada 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 a CLI Office 365:

spo cdn origin list

Para adicionar a origem no PowerShell:

Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */CLIENTSIDEASSETS

Para adicionar a origem na CLI Office 365:

spo cdn origin add --origin */CLIENTSIDEASSETS

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

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

Confira também

Redes de Distribuição de Conteúdo

Planejamento de rede e ajuste de desempenho para o Office 365

Série de desempenho do SharePoint – série de vídeos Office 365 CDN