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

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

Observação

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

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

Office 365 CDN diagrama conceitual.

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

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

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

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

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

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

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

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

Planejar a implantação do Office 365 CDN

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

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

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

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

Por exemplo, arquivos pequenos solicitados repetidamente, como imagens e scripts do site, podem melhorar significativamente o desempenho de renderização do site e reduzir incrementalmente a carga em seus sites do SharePoint Online quando você os adiciona a uma origem CDN dados. Arquivos maiores, como executáveis de instalação, podem ser baixados do CDN, fornecendo um impacto positivo no desempenho e redução subsequente da carga em seu site do SharePoint Online, mesmo que eles 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 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. O fornecimento desses arquivos do CDN pode reduzir significativamente o tempo de carregamento geral da página. Veja Quais ganhos de desempenho um CDN fornece? para obter um exemplo.

Determinar onde você deseja armazenar seus ativos

O CDN busca seus ativos de um local chamado origem. Uma origem pode ser SharePoint site, biblioteca de documentos ou 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 seus CDN ativos. Você pode optar por ter origens públicas ou privadas para sua organização. A maioria das organizações optará por implementar uma combinação dos dois.

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

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

Você pode definir CDN políticas para excluir o conteúdo em suas origens do CDN. CDN políticas excluem ativos em origens públicas ou privadas por atributos como tipo de arquivo e classificação de site e são aplicadas a todas as origens do CdnType (particular ou público) que você especificar na política. Por exemplo, se você adicionar uma origem privada que consiste em um site que contém vários subsites, poderá definir uma política para excluir sites marcados como Confidenciais para que o conteúdo de sites com essa classificação aplicada não seja atendido do CDN. A política será aplicada ao conteúdo de todas as origens privadas que você adicionou ao CDN.

Tenha em mente que quanto maior o número de origens, maior o impacto sobre o tempo que leva o serviço CDN para processar solicitações. Recomendamos que você limite o número de origens o máximo possível.

Escolha se cada origem deve ser pública ou privada

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

As opções pública e privada fornecem ganhos de desempenho semelhantes, mas cada uma tem atributos e vantagens exclusivos.

As origens públicas Office 365 CDN podem ser acessadas anonimamente e os ativos hospedados podem ser acessados por qualquer pessoa que tenha a URL para o 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 o 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 de seu locatário SharePoint Online.

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

Atributos e vantagens de hospedar ativos em origens públicas

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

    Importante

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

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

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

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

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

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

Atributos e vantagens de hospedar ativos em origens privadas

  • Origens privadas só podem ser usadas para SharePoint online.

  • Os usuários só poderão acessar os ativos de uma 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 referenciados do locatário SharePoint Online. O acesso direto aos ativos CDN privado 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 os links para o ativo no CDN dentro de 15 minutos após a remoção do ativo.

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

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

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

Origens CDN padrão

A menos que você especifique o contrário, Office 365 algumas origens padrão para você ao habilitar o Office 365 CDN. Se você inicialmente optar por não provisioná-las, 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 tiver um motivo específico para fazer isso, você deve permitir que elas sejam criadas quando você habilitar o CDN.

Origens de CDN privadas padrão:

  • */userphoto.aspx
  • */siteassets

Origens de CDN padrão:

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

Observação

clientsideassets é uma origem pública padrão que foi adicionada ao serviço Office 365 CDN em dezembro de 2017. Essa origem deve estar presente para que Estrutura do SharePoint soluções no CDN funcionem. Se você habilitou o Office 365 CDN antes de dezembro de 2017 ou se você ignorou a configuração de origens padrão ao habilitar o CDN, poderá adicionar manualmente essa origem. Para obter mais informações, consulte Minha Web Part do lado do cliente ou Estrutura do SharePoint solução não está funcionando.

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

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

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

Clique para expandir

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

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

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

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

Get-SPOTenantCdnEnabled -CdnType <Public | Private>

O status do CDN para o CdnType especificado será gerado na tela.

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

No Windows PowerShell para SharePoint Online:

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

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

Set-SPOTenantCdnEnabled -CdnType Both -Enable $true

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

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

Consulte as origens de CDN padrão para obter informações sobre as origens provisionadas por padrão quando você habilita o Office 365 CDN 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 no Office 365 CDN (opcional)

Dica

Ao definir tipos de arquivo usando o cmdlet Set-SPOTenantCdnPolicy , você substitui a lista definida no momento. Se você quiser adicionar tipos de arquivo adicionais à lista, use o cmdlet primeiro para descobrir quais tipos de arquivo já são permitidos e incluí-los na lista 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 no CDN. Por padrão, tipos de ativos comuns são permitidos, por exemplo, .css, .gif, .jpg e .js.

No Windows PowerShell para SharePoint Online:

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

Por exemplo, para habilitar o CDN para hospedar arquivos .css e .png, insira o comando:

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

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

Get-SPOTenantCdnPolicies -CdnType <Public | Private>

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

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

Dica

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

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

No Windows PowerShell para SharePoint Online:

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

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

Get-SPOTenantCdnPolicies -CdnType <Public | Private>

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

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

Observação

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

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

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

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

Adicionar uma origem para seus ativos

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

Importante

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

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

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

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

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

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

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

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

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

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

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

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

Observação

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

Depois de executar o comando, o sistema sincronizará 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 SharePoint Online

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

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

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

    Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
    

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

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

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

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

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

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

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */publishingimages
    

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

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

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

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

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

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

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

Gerenciar o Office 365 CDN

Depois de configurar o CDN, você poderá fazer alterações em sua configuração à medida que atualizar o conteúdo ou conforme suas necessidades forem alteradas, conforme descrito nesta seção.

Adicionar, atualizar ou remover ativos do Office 365 CDN

Depois de concluir as etapas de configuraçã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 na SharePoint que você identificou como uma origem. Se você adicionar um novo ativo, ele estará disponível por meio do CDN imediatamente. No entanto, se você atualizar o ativo, levará até 15 minutos para que a nova cópia se propague e fique disponível no CDN.

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

Remover uma origem do Office 365 CDN

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

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

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

Modificar uma origem no Office 365 CDN

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

Desabilitar o Office 365 CDN

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

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

Set-SPOTenantCdnEnabled -CdnType Public -Enable $false

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

Set-SPOTenantCdnEnabled -CdnType Private -Enable $false

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

Configurar e configurar o Office 365 CDN usando o PowerShell PnP

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 o CDN para hospedar seus ativos no SharePoint Online usando o PnP PowerShell.

Clique para expandir

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

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

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

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

Get-PnPTenantCdnEnabled -CdnType <Public | Private>

O status do CDN para o CdnType especificado será gerado na tela.

Use o cmdlet Set-PnPTenantCdnEnabled para permitir que sua organização use o Office 365 CDN. Você pode permitir que sua organização use origens públicas, origens privadas ou ambas ao mesmo tempo. Você também pode configurar o CDN para ignorar a configuração de origens padrão ao habilita-la. Você sempre pode adicionar essas origens 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 as origens de CDN padrão para obter informações sobre as origens provisionadas por padrão quando você habilita o Office 365 CDN 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 no Office 365 CDN (opcional)

Dica

Ao definir tipos de arquivo usando o cmdlet Set-PnPTenantCdnPolicy , você substitui a lista definida no momento. Se você quiser adicionar tipos de arquivo adicionais à lista, use o cmdlet primeiro para descobrir quais tipos de arquivo já são permitidos e incluí-los na lista 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 no 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 o CDN para hospedar arquivos .css e .png, insira o comando:

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

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

Get-PnPTenantCdnPolicies -CdnType <Public | Private>

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

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

Dica

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á foram excluídas e, em seguida, adicioná-las junto com as novas.

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

No 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 do CDN.

Observação

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

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

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

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

Adicionar uma origem para seus ativos

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

Importante

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

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

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

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

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

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

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

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

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

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

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

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

Observação

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

Depois de executar o comando, o sistema sincronizará 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 SharePoint Online

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

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

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

    Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
    

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

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

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

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

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

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

    Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */publishingimages
    

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

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

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

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

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

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

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

Gerenciar o Office 365 CDN

Depois de configurar o CDN, você poderá fazer alterações em sua configuração à medida que atualizar o conteúdo ou conforme suas necessidades forem alteradas, conforme descrito nesta seção.

Adicionar, atualizar ou remover ativos do Office 365 CDN

Depois de concluir as etapas de configuraçã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 na SharePoint que você identificou como uma origem. Se você adicionar um novo ativo, ele estará disponível por meio do CDN imediatamente. No entanto, se você atualizar o ativo, levará até 15 minutos para que a nova cópia se propague e fique disponível no CDN.

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

Remover uma origem do Office 365 CDN

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

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

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

Modificar uma origem no Office 365 CDN

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

Desabilitar o Office 365 CDN

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

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

Set-PnPTenantCdnEnabled -CdnType Public -Enable $false

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

Set-PnPTenantCdnEnabled -CdnType Private -Enable $false

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

Configurar e configurar o Office 365 CDN usando a CLI para Microsoft 365

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

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

Clique para expandir

Habilitar o Office 365 CDN

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

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

spo cdn set --type Public --enabled true

Para habilitar o Office 365 SharePoint CDN, execute:

spo cdn set --type Private --enabled true

Exiba o status atual da CDN do Office 365

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

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

spo cdn get --type Public

Exibir as origens Office 365 CDN dados

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

spo cdn origin list --type Public

Consulte As origens CDN padrão para obter informações sobre as origens provisionadas por padrão quando você habilita o Office 365 CDN.

Adicionar uma origem Office 365 CDN dados

Importante

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

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

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

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

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

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

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

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

Observação

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

Remover uma origem Office 365 CDN dados

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

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

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

Observação

Remover uma origem CDN dados não afeta os arquivos armazenados em nenhuma biblioteca de documentos que corresponda a essa origem. Se esses ativos tiverem sido referenciados usando a URL SharePoint, SharePoint retornará automaticamente para a URL original apontando para a biblioteca de documentos. No entanto, se os ativos tiverem sido referenciados usando uma URL de CDN pública, remover a origem interromperá o link e você precisará alterá-los manualmente.

Modificar uma origem Office 365 CDN dados

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 no Office 365 CDN

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

Observação

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

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

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

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

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

Observação

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

Para excluir sites classificados como HBI do público CDN, execute

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

Desabilitar o Office 365 CDN

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

spo cdn set --type Public --enabled false

Usando seus ativos CDN dados

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

Esta seção ajudará você a entender como usar URLs do 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 o CDN.

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

Observação

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

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 globalmente e substituir links em um site de entrada ou conjunto de sites se quiser atualizar o link para um determinado ativo em todos os lugares em que ele aparecer.
  • Para cada link para um ativo em uma origem, substitua o caminho pelo caminho para o arquivo na CDN origem. Você pode usar caminhos relativos.
  • Salve a página ou o conteúdo.

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

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

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

Observação

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

Para saber mais sobre como verificar se os ativos estão sendo atendidos do CDN, consulte Como fazer confirmar se os ativos estão sendo atendidos pelo CDN? na solução de 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 do CDN para que os ativos sejam atendidos do serviço CDN em vez de SharePoint.

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

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

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

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

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

Dica

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

Construindo URLs CDN para ativos públicos

Se o recurso de Publicação não estiver habilitado para uma origem pública ou se 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 o local CDN dos ativos e usar essas URLs em seu conteúdo.

Observação

Você não pode codificar nem 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 e a URL não deve ser codificada, pois ela está sujeita a alterações.

Para ativos CDN público, o formato da 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 codificar "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ê estiver SPFx Web Parts para SharePoint modernas e clássicas, 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 SPFx, a URL pode ser construída usando a propriedade "this.context.pageContext.legacyPageContext.publicCdnBaseUrl" + "/" + "host" + "/" + "relativeURL para o item". Consulte Usando CDN código do lado do cliente que faz parte da série de desempenho da 1ª temporada

Usando ativos em origens privadas

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

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

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

Diagrama de fluxo de trabalho: recuperando Office 365 CDN ativos 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 tokens automaticamente que permitem que o usuário acesse o arquivo com base em seu nível de permissão. Esses tokens de acesso são válidos por 30 a 90 minutos depois que são 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 eat (token de autorização de borda) e aveia (token de autorização de origem). A estrutura de cada token é< de expiração no formato de hora >__<'secure signature'>. Por exemplo:

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

Observação

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

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

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

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

Solução de problemas de Office 365 CDN

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

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

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

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

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

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

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

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

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

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

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

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

Get-SPOTenantCdnOrigins -CdnType Public

Ou você pode verificar com o Office 365 CLI:

spo cdn origin list

Para adicionar a origem no PowerShell:

Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */CLIENTSIDEASSETS

Para adicionar a origem no Office 365 CLI:

spo cdn origin add --origin */CLIENTSIDEASSETS

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

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

Confira também

Redes de Distribuição de Conteúdo

Planejamento de rede e ajuste de desempenho para o Office 365

SharePoint Série de Desempenho – Office 365 CDN vídeo