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

  • Artigo

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

Como as imagens agora são gerenciadas automaticamente em uma CDN privada gerenciada pelo serviço do SharePoint Online, a CDN privada configurada manualmente está no processo de ser preterida. Esse comportamento significa que os clientes não precisam mais configurar a CDN privada. A prática recomendada permanece inalterada, pois as imagens são hospedadas por meio da CDN privada gerenciada pelo serviço automaticamente. A CDN pública continua disponível para todos os outros tipos de arquivo (por exemplo, CSS e JS). Os clientes que usam CDN privada para tipos de arquivo que não sejam imagens, precisam mover esses arquivos para a CDN Pública. Recomendamos que a CDN pública para esses tipos de arquivo melhore o desempenho.

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á está familiarizado com a maneira como as CDNs funcionam, você só precisa concluir algumas etapas para habilitar a CDN Office 365 para seu locatário. Este artigo descreve como fazer isso. 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 são alterados com 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 efeito 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, adicionar arquivos pequenos solicitados repetidamente (imagens do site e scripts) a uma origem da CDN pode melhorar significativamente o desempenho de renderização do site e reduzir incrementalmente a carga em seus sites do SharePoint Online. Arquivos maiores (executáveis de instalação) podem ser baixados da CDN, fornecendo um efeito de desempenho positivo e uma redução subsequente da carga em seu site do SharePoint Online, mesmo que não sejam acessados com frequência.

O aprimoramento 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 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 opta 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 para um conjunto específico de ativos que você deseja estar disponível na CDN e deseja 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 torna todos os ativos qualificados no contêiner disponíveis na 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 o 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 servido da CDN. A política se aplica 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 efeito 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 em origens públicas é anônimo, você só deve usá-los para armazenar em cache conteúdo genérico sem sentido, 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, o ativo poderá continuar disponível por até 30 dias do cache; no entanto, invalidamos links para o ativo na CDN dentro de 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. Esse resultado significa que você pode referenciar o local de imagens em segundo plano e outros objetos relativos à localização do ativo que o está chamando.

  • Embora você possa construir uma URL de origem pública, você deve continuar com cuidado, usar a propriedade de contexto da página e seguir as diretrizes para isso. Se o acesso à CDN ficar indisponível, a URL não resolve automaticamente à sua organização no SharePoint Online e poderá resultar em links quebrados e outros erros. A URL também está sujeita a alterações, portanto, você não deve codificar com o valor atual.

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

  • Você pode configurar uma política para excluir ativos com base em classificações de site especificadas. Por exemplo, você pode excluir todos os ativos marcados como "confidenciais" ou "restritos", 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 privados da CDN não funciona.

  • Se você remover um ativo da origem privada, o ativo poderá continuar disponível por até uma hora do cache. Mas os links para o ativo na CDN são inválidos 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 identificados por classificações de site que você especificar mesmo se você usar 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.

Selecione 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 é mostrado 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 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 artigo.

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 o Office 365 CDN e o efeito 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 comuns de ativos 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 permitir que a CDN hospede arquivos .css e .png, insira 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 classificações de site que você não deseja disponibilizar por meio da 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 retornadas são IncludeFileExtensions, ExcludeRestrictedSiteClassifications e ExcludeIfNoScriptDisabled.

A propriedade IncludeFileExtensions contém a lista de extensões de arquivo que são servidas 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 corresponde 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 corresponde 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. Esse resultado pode levar até 15 minutos.

Exemplo: configurar uma origem pública para suas páginas de master 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 master 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. Esse resultado 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. Esse resultado 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 . Essa mensagem é esperada à medida que o locatário do SharePoint Online se conecta ao serviço CDN. Esse resultado 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 usando 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 depois de criá-la. 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 PowerShell PnP.

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

Selecione 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 a CDN status configurações do locatário:

Get-PnPTenantCdnEnabled -CdnType <Public | Private>

O status da CDN para o CdnType especificado é mostrado na 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 artigo.

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 o Office 365 CDN e o efeito 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 comuns de ativos 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 permitir que a CDN hospede arquivos .css e .png, insira 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 retornadas são IncludeFileExtensions, ExcludeRestrictedSiteClassifications e ExcludeIfNoScriptDisabled.

A propriedade IncludeFileExtensions contém a lista de extensões de arquivo que são servidas 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 corresponde 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 corresponde 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 compartilhados de uma origem devem ter uma versão importante publicada antes de serem acessíveis da CDN.

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

Exemplo: configurar uma origem pública para suas páginas de master 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 master como de 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. Esse resultado 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. Esse resultado 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 . Esse resultado é esperado à medida que o locatário do SharePoint Online se conecta ao serviço CDN. Esse resultado 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 tomar essa ação, 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 depois de criá-la. 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 a CLI do Microsoft 365. O, 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.

Selecione 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 Office 365 em seu locatário, execute o seguinte comando:

m365 spo cdn set --type Public --enabled true

Para habilitar o Office 365 CDN do SharePoint, execute o seguinte comando:

m365 spo cdn set --type Private --enabled true

Exiba o status atual da CDN do Office 365

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

Para marcar se a CDN pública Office 365 estiver habilitada, execute o seguinte comando:

m365 spo cdn get --type Public

Exibir as origens da CDN Office 365

Para exibir as origens da CDN pública Office 365 atualmente configuradas, execute o seguinte comando:

m365 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 que contém os ativos que você deseja que a CDN hospede.

m365 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 o seguinte comando:

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

Para configurar uma origem privada para uma coleção de sites específica, execute o seguinte comando:

m365 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 o seguinte comando:

m365 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 à origem. Se esses ativos forem referenciados usando sua URL do SharePoint, o SharePoint retornará automaticamente para a URL original apontando para a biblioteca de documentos. Se os ativos forem referenciados usando uma URL de CDN pública, a remoção da origem interromperá 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 o seguinte comando:

m365 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 classificações de site que você não deseja disponibilizar por meio da 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 o seguinte comando:

m365 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:

m365 spo cdn set --type Public --enabled false

Usando seus ativos cdn

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

Esta seção ajuda você a entender como usar URLs 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 artigo 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 adicionados 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 de 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, se o ativo não tiver sido excluído por uma política cdn.

O exemplo a seguir é uma visão geral em que os links são reescritos automaticamente pelo recurso publicação do SharePoint:

  • URLs IMG/LINK/CSS em respostas HTML clássicas da página de publicação.
    • Isso inclui imagens adicionadas por autores no conteúdo HTML de uma página.
  • URLs de imagem da webpart do SlideShow da Biblioteca de Imagens.
  • Campos de imagem nos resultados da API REST do 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á marcar 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 De publicação 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 no local da CDN dos ativos e usar essas URLs no 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 como está sujeita a alterações.

Para ativos públicos da CDN, o formato de URL se parece com o seguinte exemplo:

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

Substitua TenantHostName pelo nome do locatário. Por exemplo:

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

Observação

Use a propriedade de contexto de página para construir o prefixo em vez de codificação https://publiccdn.sharepointonline.comdura , porque a URL está sujeita a alterações. Se você usar 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ê usar web parts SPFx para SharePoint moderno e clássico, poderá usar a propriedade this.context.pageContext.legacyPageContext.publicCdnBaseUrl, que também fornece o prefixo. Se o prefixo for alterado, sua implementação será atualizada com ele.

Como exemplo para o SPFx, você pode construir a URL usando a propriedade this.context.pageContext.legacyPageContext.publicCdnBaseUrlrelativeURL for the item - - - / - /host. Para obter mais informações, confira o vídeo 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 sejam sempre 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 que 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.

Você não pode 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, o ativo CDN será 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 watch um vídeo curto hospedado no canal do YouTube Padrões e Práticas do Desenvolvedor do SharePoint que mostra 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 falharem e nenhuma mensagem de aviso ou erro for 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 marcar para ver quais origens estão presentes com o seguinte comando do PowerShell:

Get-SPOTenantCdnOrigins -CdnType Public

Ou você pode marcar com a CLI do Microsoft 365:

m365 spo cdn origin list

Para adicionar a origem no PowerShell:

Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */CLIENTSIDEASSETS

Para adicionar a origem usando a CLI para o Microsoft 365:

m365 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 SharePoint Online Management ou a CLI do Microsoft 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