Utilizar a Rede de Entrega de Conteúdos (CDN) Office 365 com o SharePoint Online

  • Artigo

Pode utilizar a Rede de Entrega de Conteúdos (CDN) Office 365 incorporada para alojar recursos estáticos para proporcionar um melhor desempenho às suas páginas do SharePoint Online. O Office 365 CDN melhora o desempenho ao colocar em cache recursos estáticos mais próximos dos browsers que os solicitam, o que ajuda a acelerar as transferências e a reduzir a latência. Além disso, o Office 365 CDN utiliza o protocolo HTTP/2 para uma melhor compressão e pipelining HTTP. A Office 365 serviço CDN está incluída como parte da sua subscrição do SharePoint Online.

Atenção

Uma vez que as imagens são agora geridas automaticamente numa CDN Privada gerida pelo serviço SharePoint Online, a CDN Privada configurada manualmente está a ser preterida. Este comportamento significa que os clientes já não precisam de configurar a CDN privada. A prática recomendada permanece inalterada, uma vez que as imagens são alojadas automaticamente através da CDN Privada gerida pelo serviço. A CDN pública continua disponível para todos os outros tipos de ficheiro (por exemplo, CSS e JS). Os clientes que utilizam a CDN Privada para tipos de ficheiro que não imagens precisam de mover esses ficheiros para a CDN Pública. Recomendamos a CDN Pública para estes tipos de ficheiro para melhorar o desempenho.

Nota

O Office 365 CDN só está disponível para inquilinos na cloud de Produção (em todo o mundo). Os inquilinos nas clouds do Governo dos E.U.A. e da China não suportam atualmente a CDN Office 365.

O Office 365 CDN é composto por várias CDNs que lhe permitem alojar recursos estáticos em várias localizações ou origens e servi-los a partir de redes globais de alta velocidade. Consoante o tipo de conteúdo que pretende alojar no Office 365 CDN, 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 conceptual da CDN.

Se já estiver familiarizado com a forma como as CDNs funcionam, só precisa de concluir alguns passos para ativar o Office 365 CDN para o seu inquilino. Este artigo descreve como. Continue a ler para obter informações sobre como começar a alojar os seus recursos estáticos.

Sugestão

Existem outras CDNs alojadas na Microsoft que podem ser utilizadas com Office 365 para cenários de utilização especializados, mas não são abordadas neste tópico porque estão fora do âmbito do Office 365 CDN. Para obter mais informações, consulte Outras CDNs da Microsoft.

Regresse ao Planeamento de rede e otimização do desempenho para Office 365.

Descrição geral de como trabalhar com a CDN do Office 365 no SharePoint Online

Para configurar o Office 365 CDN para a sua organização, siga estes passos básicos:

Quando terminar a configuração, pode Gerir o Office 365 CDN ao longo do tempo ao:

  • Adicionar, atualizar e remover recursos
  • Adicionar e remover origens
  • Configurar políticas de CDN
  • Se necessário, desativar a CDN

Por fim, veja Utilizar os recursos da CDN para saber mais sobre como aceder aos recursos da CDN a partir de origens públicas e privadas.

Veja Resolver problemas da CDN do Office 365 para obter orientações sobre como resolver problemas comuns.

Planear a implementação da CDN do Office 365

Antes de implementar o Office 365 CDN para o seu inquilino Office 365, deve considerar os seguintes fatores como parte do processo de planeamento.

Determinar quais os recursos estáticos que pretende alojar na CDN

Em geral, as CDNs são mais eficazes para alojar recursos estáticos ou recursos que não mudam frequentemente. Uma boa regra é identificar ficheiros que cumpram algumas ou todas estas condições:

  • Ficheiros estáticos incorporados numa página (como scripts e imagens) que podem ter um efeito significativo nos tempos de carregamento da página.
  • Ficheiros grandes, como executáveis e ficheiros de instalação.
  • Bibliotecas de recursos que suportam código do lado do cliente.

Por exemplo, adicionar ficheiros pequenos pedidos repetidamente (imagens de site e scripts) a uma origem de CDN pode melhorar significativamente o desempenho de composição do site e reduzir incrementalmente a carga nos seus sites do SharePoint Online. Os ficheiros maiores (executáveis de instalação) podem ser transferidos a partir da CDN, proporcionando um efeito de desempenho positivo e uma redução subsequente da carga no seu site do SharePoint Online, mesmo que não sejam acedidos com frequência.

A melhoria do desempenho por ficheiro depende de muitos fatores, incluindo a proximidade do cliente com o ponto final da CDN mais próximo, condições transitórias na rede local, etc. Muitos ficheiros estáticos são pequenos e podem ser transferidos a partir de Office 365 em menos de um segundo. No entanto, uma página Web pode conter muitos ficheiros incorporados com um tempo de transferência cumulativo de vários segundos. Servir estes ficheiros da CDN pode reduzir significativamente o tempo de carregamento geral da página. Veja Que ganhos de desempenho uma CDN fornece? para obter um exemplo.

Determinar onde pretende armazenar os seus recursos

A CDN obtém os seus recursos a partir de uma localização denominada origem. Uma origem pode ser um site do SharePoint, biblioteca de documentos ou pasta acessível por um URL. Tem uma grande flexibilidade quando especifica origens para a sua organização. Por exemplo, pode especificar múltiplas origens ou uma única origem onde pretende colocar todos os recursos da CDN. Pode optar por ter origens públicas ou privadas para a sua organização. A maioria das organizações opta por implementar uma combinação dos dois.

Pode criar um novo contentor para as suas origens, como pastas ou bibliotecas de documentos, e adicionar ficheiros que pretende disponibilizar a partir da CDN. Esta é uma boa abordagem para um conjunto específico de recursos que pretende que estejam disponíveis a partir da CDN e quer restringir o conjunto de recursos da CDN apenas a esses ficheiros no contentor.

Também pode configurar uma coleção de sites, site, biblioteca ou pasta existente como origem, o que torna todos os recursos elegíveis no contentor disponíveis a partir da CDN. Antes de adicionar um contentor existente como origem, é importante certificar-se de que tem conhecimento dos respetivos conteúdos e permissões para que não exponha inadvertidamente recursos a acesso anónimo ou utilizadores não autorizados.

Pode definir políticas de CDN para excluir conteúdo nas suas origens da CDN. As políticas da CDN excluem recursos em origens públicas ou privadas por atributos como o tipo de ficheiro e a classificação de sites e são aplicadas a todas as origens do CdnType (privado ou público) que especificar na política. Por exemplo, se adicionar uma origem privada composta por um site que contém vários subsites, pode definir uma política para excluir sites marcados como Confidenciais para que os conteúdos de sites com essa classificação aplicada não sejam servidos a partir da CDN. A política aplica-se a conteúdos de todas as origens privadas que adicionou à CDN.

Tenha em atenção que quanto maior for o número de origens, maior será o efeito no tempo que o serviço da CDN demora a processar pedidos. Recomendamos que limite o número de origens o máximo possível.

Escolher se cada origem deve ser pública ou privada

Quando identifica uma origem, especifica se deve ser tornada pública ou privada. O acesso a recursos da 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 da opção que escolher, a Microsoft faz todo o trabalho pesado por si no que diz respeito à administração da própria CDN. Além disso, pode mudar de ideias mais tarde, depois de configurar a CDN e identificar as suas origens.

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

As origens públicas no Office 365 CDN são acessíveis de forma anónima e os recursos alojados podem ser acedidos por qualquer pessoa que tenha o URL do recurso. Uma vez que o acesso a conteúdos em origens públicas é anónimo, só deve utilizá-los para colocar em cache conteúdos genéricos sem sentido, como ficheiros JavaScript, scripts, ícones e imagens.

As origens privadas no Office 365 CDN fornecem acesso privado a conteúdos de utilizador, como bibliotecas de documentos, sites e imagens proprietárias do SharePoint Online. O acesso a conteúdos em origens privadas é protegido por tokens gerados dinamicamente, pelo que só pode ser acedido por utilizadores com permissões para a biblioteca de documentos original ou a localização de armazenamento. As origens privadas no Office 365 CDN só podem ser utilizadas para conteúdos do SharePoint Online e só pode aceder a recursos em origens privadas através do redirecionamento do seu inquilino do SharePoint Online.

Pode ler mais sobre como funciona o acesso da CDN a recursos numa origem privada em Utilizar recursos em origens privadas.

Atributos e vantagens de alojar recursos em origens públicas

  • Os recursos expostos numa origem pública são acessíveis por todos anonimamente.

    Importante

    Nunca deve colocar recursos que contenham informações de utilizador ou que sejam considerados confidenciais para a sua organização numa origem pública.

  • Se remover um recurso de origem pública, o recurso poderá continuar disponível até 30 dias a partir da cache; No entanto, invalidamos as ligações para o recurso na CDN no prazo de 15 minutos.

  • Quando aloja folhas de estilo (ficheiros CSS) numa origem pública, pode utilizar caminhos relativos e URIs no código. Este resultado significa que pode referenciar a localização de imagens de fundo e outros objetos em relação à localização do elemento que o está a chamar.

  • Embora possa construir o URL de uma origem pública, deve avançar com cuidado, utilizar a propriedade de contexto da página e seguir as orientações para o fazer. Se o acesso à CDN ficar indisponível, o URL não será resolvido automaticamente para a sua organização no SharePoint Online e poderá resultar em ligações quebradas e outros erros. O URL também está sujeito a alterações, pelo que não deve codificar o mesmo para o valor atual.

  • Os tipos de ficheiro predefinidos incluídos para origens públicas são: .css, .eot, .gif, .ico, .jpeg, .jpg, .js, .map, .png, .svg, , e .ttf.woff.woff2. Pode especificar tipos de ficheiro adicionais.

  • Pode configurar uma política para excluir recursos com base em classificações de sites especificadas. Por exemplo, pode excluir todos os recursos marcados como "confidenciais" ou "restritos", mesmo que sejam de tipo de ficheiro permitido e estejam localizados numa origem pública.

Atributos e vantagens de alojar recursos em origens privadas

  • As origens privadas só podem ser utilizadas para recursos do SharePoint Online.

  • Os utilizadores só podem aceder aos recursos de origem privada se tiverem permissões para aceder ao contentor. O acesso anónimo a estes recursos é impedido.

  • Os recursos em origens privadas têm de ser referenciados a partir do inquilino do SharePoint Online. O acesso direto a recursos privados da CDN não funciona.

  • Se remover um recurso da origem privada, o recurso poderá continuar disponível até uma hora a partir da cache. No entanto, as ligações para o recurso na CDN são inválidas no prazo de 15 minutos após a remoção do recurso.

  • Os tipos de ficheiro predefinidos incluídos para origens privadas são .gif, .ico, .jpeg, .jpg, .js e .png. Pode especificar tipos de ficheiro adicionais.

  • Tal como acontece com as origens públicas, pode configurar uma política para excluir recursos identificados pelas classificações de sites que especificar, mesmo que utilize carateres universais para incluir todos os recursos numa pasta ou biblioteca de documentos.

Para obter mais informações sobre o porquê de utilizar a CDN Office 365, conceitos gerais da CDN e outras CDNs da Microsoft que pode utilizar com o seu inquilino Office 365, consulte Redes de Entrega de Conteúdos.

Origens predefinidas da CDN

A menos que especifique o contrário, Office 365 configura algumas origens predefinidas quando ativa a CDN Office 365. Se optar inicialmente por não as aprovisionar, pode adicionar estas origens depois de concluir a configuração. A menos que compreenda as consequências de ignorar a configuração das origens predefinidas e tenha um motivo específico para o fazer, deve permitir que sejam criadas quando ativar a CDN.

Origens de CDN privadas predefinidas:

  • */siteassets

Origens predefinidas da CDN pública:

  • */página mestra
  • */biblioteca de estilos
  • */clientsideassets

Nota

clientsideassets é uma origem pública predefinida que foi adicionada ao serviço Office 365 CDN em dezembro de 2017. Esta origem tem de estar presente para que SharePoint Framework soluções na CDN funcionem. Se ativou o Office 365 CDN antes de dezembro de 2017 ou se ignorou a configuração das origens predefinidas quando ativou a CDN, pode adicionar manualmente esta origem. Para obter mais informações, consulte A minha peça Web do lado do cliente ou SharePoint Framework solução não está a funcionar.

Configurar o Office 365 CDN com a Shell de Gestão do SharePoint Online

Os procedimentos nesta secção exigem que utilize a Shell de Gestão do SharePoint Online para ligar ao SharePoint Online. Para obter instruções, consulte Ligar ao PowerShell do SharePoint Online.

Conclua estes passos para configurar e configurar a CDN para alojar os seus recursos no SharePoint Online com a Shell de Gestão do SharePoint Online.

Selecione para expandir

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

Antes de fazer alterações às definições da CDN do inquilino, deve obter o estado atual da configuração da CDN privada no seu inquilino Office 365. Ligue-se ao seu inquilino com a Shell de Gestão do SharePoint Online:

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

Agora, utilize o cmdlet Get-SPOTenantCdnEnabled para obter as definições de estado da CDN do inquilino:

Get-SPOTenantCdnEnabled -CdnType <Public | Private>

O estado da CDN para o CdnType especificado é apresentado no ecrã.

Utilize o cmdlet Set-SPOTenantCdnEnabled para permitir que a sua organização utilize o Office 365 CDN. Pode permitir que a sua organização utilize origens públicas, origens privadas ou ambas ao mesmo tempo. Também pode configurar a CDN para ignorar a configuração de origens predefinidas quando a ativar. Pode sempre adicionar estas origens mais tarde, conforme descrito neste artigo.

No Windows PowerShell do SharePoint Online:

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

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

Set-SPOTenantCdnEnabled -CdnType Both -Enable $true

Para permitir que a sua organização utilize origens públicas e privadas, mas ignore a configuração das origens predefinidas, escreva o seguinte comando:

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

Veja Origens predefinidas da CDN para obter informações sobre as origens que são aprovisionadas por predefinição quando ativa o Office 365 CDN e o potencial efeito de ignorar a configuração de origens predefinidas.

Para permitir que a sua organização utilize origens públicas, escreva o seguinte comando:

Set-SPOTenantCdnEnabled -CdnType Public -Enable $true

Para permitir que a sua organização utilize origens privadas, escreva o seguinte comando:

Set-SPOTenantCdnEnabled -CdnType Private -Enable $true

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

Alterar a lista de tipos de ficheiro a incluir na CDN do Office 365 (Opcional)

Sugestão

Quando define tipos de ficheiro com o cmdlet Set-SPOTenantCdnPolicy , substitui a lista atualmente definida. Se quiser adicionar tipos de ficheiro adicionais à lista, utilize primeiro o cmdlet para saber que tipos de ficheiro já são permitidos e inclua-os na lista juntamente com os novos.

Utilize o cmdlet Set-SPOTenantCdnPolicy para definir tipos de ficheiro estáticos que podem ser alojados por origens públicas e privadas na CDN. Por predefinição, são permitidos tipos de recursos comuns, por exemplo, .css, .gif, .jpg e .js.

No Windows PowerShell do SharePoint Online:

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

Por exemplo, para permitir que a CDN aloje .css e .png ficheiros, introduza o comando:

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

Para ver que tipos de ficheiro são atualmente permitidos pela CDN, utilize o cmdlet Get-SPOTenantCdnPolicies :

Get-SPOTenantCdnPolicies -CdnType <Public | Private>

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

Alterar a lista de classificações de sites que pretende excluir da CDN do Office 365 (Opcional)

Sugestão

Quando exclui as classificações de sites com o cmdlet Set-SPOTenantCdnPolicy , substitui a lista atualmente definida. Se quiser excluir classificações de sites adicionais, utilize primeiro o cmdlet para saber que classificações já estão excluídas e, em seguida, adicione-as juntamente com as novas.

Utilize o cmdlet Set-SPOTenantCdnPolicy para excluir classificações de sites que não pretende disponibilizar através da CDN. Por predefinição, não são excluídas classificações de sites.

No Windows PowerShell do SharePoint Online:

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

Para ver que classificações de sites estão atualmente restritas, utilize o cmdlet Get-SPOTenantCdnPolicies :

Get-SPOTenantCdnPolicies -CdnType <Public | Private>

As propriedades devolvidas são IncludeFileExtensions, ExcludeRestrictedSiteClassifications e ExcludeIfNoScriptDisabled.

A propriedade IncludeFileExtensions contém a lista de extensões de ficheiro que são fornecidas a partir da CDN.

Nota

As extensões de ficheiro predefinidas são diferentes entre públicas e privadas.

A propriedade ExcludeRestrictedSiteClassifications contém as classificações de sites que pretende excluir da CDN. Por exemplo, pode excluir sites marcados como Confidenciais para que o conteúdo de sites com essa classificação aplicada não seja servido a partir da CDN.

A propriedade ExcludeIfNoScriptDisabled exclui o conteúdo da CDN com base nas definições de atributo NoScript ao nível do site. Por predefinição, o atributo NoScript está definido como Ativado para sites Modernos e Desativado para sites Clássicos . Isto depende das definições do seu inquilino.

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

Adicionar uma origem para os seus recursos

Utilize o cmdlet Add-SPOTenantCdnOrigin para definir uma origem. Pode definir múltiplas origens. A origem é um URL que aponta para uma biblioteca ou pasta do SharePoint que contém os recursos que pretende que sejam alojados pela CDN.

Importante

Nunca deve colocar recursos que contenham informações de utilizador ou que sejam considerados confidenciais para a sua organização numa 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 recursos. Pode utilizar carateres universais para além de caminhos relativos. As origens suportam carateres universais pré-anexados ao URL. Isto permite-lhe criar origens que abrangem vários sites. Por exemplo, para incluir todos os recursos na pasta de páginas mestras de todos os sites como origem pública na CDN, escreva o seguinte comando:

Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
  • O modificador de carateres universais */ só pode ser utilizado no início do caminho e corresponde a todos os segmentos de URL no URL especificado.
  • 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.

Pode adicionar uma origem com um caminho relativo específico. Não pode adicionar uma origem com o caminho completo.

Este exemplo adiciona uma origem privada da biblioteca siteassets num site específico:

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

Este exemplo adiciona uma origem privada da pasta folder1 na biblioteca de recursos de sites da coleção de sites:

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

Se existir um espaço no caminho, pode colocar o caminho entre aspas duplas ou substituir o espaço pela codificação de URL %20. Os exemplos seguintes adicionam uma origem privada da pasta 1 na biblioteca de recursos de sites 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 este comando e a sua sintaxe, veja Add-SPOTenantCdnOrigin.

Nota

Em origens privadas, os recursos partilhados a partir de uma origem têm de ter uma versão principal publicada antes de poderem ser acedidos a partir da CDN.

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

Exemplo: Configurar uma origem pública para as suas páginas mestras e para a sua biblioteca de estilos do SharePoint Online

Normalmente, estas origens são configuradas automaticamente por predefinição quando ativa a CDN Office 365. No entanto, se quiser ativá-los manualmente, siga estes passos.

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

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

  • Utilize 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 este comando e a sua sintaxe, veja Add-SPOTenantCdnOrigin.

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

Exemplo: Configurar uma origem privada para os recursos do site, as páginas do site e as imagens de publicação do SharePoint Online

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

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */siteassets

  • Utilize o cmdlet Add-SPOTenantCdnOrigin para definir a pasta de páginas do site como uma origem privada.

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */sitepages

  • Utilize 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 este comando e a sua sintaxe, veja Add-SPOTenantCdnOrigin.

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

Exemplo: Configurar uma origem privada para uma coleção de sites para o SharePoint Online

Utilize 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 este comando e a sua sintaxe, veja Add-SPOTenantCdnOrigin.

Depois de executar o comando, o sistema sincroniza a configuração no datacenter. Poderá ver uma mensagem de Configuração pendente . Esta mensagem é esperada à medida que o inquilino do SharePoint Online se liga ao serviço CDN. Este resultado pode demorar até 15 minutos.

Gerir a CDN do Office 365

Depois de configurar a CDN, pode efetuar alterações à configuração à medida que atualiza o conteúdo ou à medida que as suas necessidades mudam, conforme descrito nesta secção.

Adicionar, atualizar ou remover recursos da CDN do Office 365

Depois de concluir os passos de configuração, pode adicionar novos recursos e atualizar ou remover recursos existentes sempre que quiser. Basta fazer as alterações aos recursos na pasta ou biblioteca do SharePoint que identificou como uma origem. Se adicionar um novo recurso, este estará imediatamente disponível através da CDN. No entanto, se atualizar o recurso, a propagação da nova cópia demora até 15 minutos e fica disponível na CDN.

Se precisar de obter a localização da origem, pode utilizar o cmdlet Get-SPOTenantCdnOrigins . Para obter informações sobre como utilizar este cmdlet, consulte Get-SPOTenantCdnOrigins.

Remover uma origem da CDN Office 365

Pode remover o acesso a uma pasta ou biblioteca do SharePoint que identificou como origem com o cmdlet Remove-SPOTenantCdnOrigin .

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

Para obter informações sobre como utilizar este cmdlet, consulte Remove-SPOTenantCdnOrigin.

Modificar uma origem na CDN do Office 365

Não pode modificar uma origem depois de a criar. Em vez disso, remova a origem e, em seguida, adicione uma nova. Para obter mais informações, veja Para remover uma origem do Office 365 CDN e Para adicionar uma origem aos seus recursos.

Desativar a CDN do Office 365

Utilize o cmdlet Set-SPOTenantCdnEnabled para desativar a CDN para a sua organização. Se tiver as origens públicas e privadas ativadas para a CDN, terá de executar o cmdlet duas vezes, conforme mostrado nos exemplos seguintes.

Para desativar a utilização de origens públicas na CDN, introduza o seguinte comando:

Set-SPOTenantCdnEnabled -CdnType Public -Enable $false

Para desativar a utilização das origens privadas na CDN, introduza o seguinte comando:

Set-SPOTenantCdnEnabled -CdnType Private -Enable $false

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

Configurar o Office 365 CDN com o PowerShell do PnP

Os procedimentos nesta secção exigem que utilize o PnP PowerShell para ligar ao SharePoint Online. Para obter instruções, veja Introdução ao PowerShell do PnP.

Conclua estes passos para configurar e configurar a CDN para alojar os seus recursos no SharePoint Online com o PowerShell PnP.

Selecione para expandir

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

Antes de fazer alterações às definições da CDN do inquilino, deve obter o estado atual da configuração da CDN privada no seu inquilino Office 365. Ligue-se ao seu inquilino com o PowerShell PnP:

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

Agora, utilize o cmdlet Get-PnPTenantCdnEnabled para obter as definições de estado da CDN do inquilino:

Get-PnPTenantCdnEnabled -CdnType <Public | Private>

O estado da CDN para o CdnType especificado é apresentado no ecrã.

Utilize o cmdlet Set-PnPTenantCdnEnabled para permitir que a sua organização utilize o Office 365 CDN. Pode permitir que a sua organização utilize origens públicas, origens privadas ou ambas ao mesmo tempo. Também pode configurar a CDN para ignorar a configuração de origens predefinidas quando a ativar. Pode sempre adicionar estas origens mais tarde, conforme descrito neste artigo.

No PowerShell PnP:

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

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

Set-PnPTenantCdnEnabled -CdnType Both -Enable $true

Para permitir que a sua organização utilize origens públicas e privadas, mas ignore a configuração das origens predefinidas, escreva o seguinte comando:

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

Veja Origens predefinidas da CDN para obter informações sobre as origens que são aprovisionadas por predefinição quando ativa o Office 365 CDN e o potencial efeito de ignorar a configuração de origens predefinidas.

Para permitir que a sua organização utilize origens públicas, escreva o seguinte comando:

Set-PnPTenantCdnEnabled -CdnType Public -Enable $true

Para permitir que a sua organização utilize origens privadas, escreva o seguinte comando:

Set-PnPTenantCdnEnabled -CdnType Private -Enable $true

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

Alterar a lista de tipos de ficheiro a incluir na CDN do Office 365 (Opcional)

Sugestão

Quando define tipos de ficheiro com o cmdlet Set-PnPTenantCdnPolicy , substitui a lista atualmente definida. Se quiser adicionar tipos de ficheiro adicionais à lista, utilize primeiro o cmdlet para saber que tipos de ficheiro já são permitidos e inclua-os na lista juntamente com os novos.

Utilize o cmdlet Set-PnPTenantCdnPolicy para definir tipos de ficheiro estáticos que podem ser alojados por origens públicas e privadas na CDN. Por predefinição, são permitidos tipos de recursos comuns, 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 aloje .css e .png ficheiros, introduza o comando:

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

Para ver que tipos de ficheiro são atualmente permitidos pela CDN, utilize o cmdlet Get-PnPTenantCdnPolicies :

Get-PnPTenantCdnPolicies -CdnType <Public | Private>

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

Alterar a lista de classificações de sites que pretende excluir da CDN do Office 365 (Opcional)

Sugestão

Quando exclui as classificações de sites com o cmdlet Set-PnPTenantCdnPolicy , substitui a lista atualmente definida. Se quiser excluir classificações de sites adicionais, utilize primeiro o cmdlet para saber que classificações já estão excluídas e, em seguida, adicione-as juntamente com as novas.

Utilize o cmdlet Set-PnPTenantCdnPolicy para excluir classificações de sites que não pretende disponibilizar através da CDN. Por predefinição, não são excluídas classificações de sites.

No PowerShell PnP:

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

Para ver que classificações de sites estão atualmente restritas, utilize o cmdlet Get-PnPTenantCdnPolicies :

Get-PnPTenantCdnPolicies -CdnType <Public | Private>

As propriedades devolvidas são IncludeFileExtensions, ExcludeRestrictedSiteClassifications e ExcludeIfNoScriptDisabled.

A propriedade IncludeFileExtensions contém a lista de extensões de ficheiro que são fornecidas a partir da CDN.

Nota

As extensões de ficheiro predefinidas são diferentes entre públicas e privadas.

A propriedade ExcludeRestrictedSiteClassifications contém as classificações de sites que pretende excluir da CDN. Por exemplo, pode excluir sites marcados como Confidenciais para que os conteúdos de sites com essa classificação aplicada não sejam servidos a partir da CDN.

A propriedade ExcludeIfNoScriptDisabled exclui o conteúdo da CDN com base nas definições de atributo NoScript ao nível do site. Por predefinição, o atributo NoScript está definido como Ativado para sites Modernos e Desativado para sites Clássicos . Isto depende das definições do seu inquilino.

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

Adicionar uma origem para os seus recursos

Utilize o cmdlet Add-PnPTenantCdnOrigin para definir uma origem. Pode definir múltiplas origens. A origem é um URL que aponta para uma biblioteca ou pasta do SharePoint que contém os recursos que pretende que sejam alojados pela CDN.

Importante

Nunca deve colocar recursos que contenham informações de utilizador ou que sejam considerados confidenciais para a sua organização numa 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 recursos. Pode utilizar carateres universais para além de caminhos relativos. As origens suportam carateres universais pré-anexados ao URL. Isto permite-lhe criar origens que abrangem vários sites. Por exemplo, para incluir todos os recursos na pasta de páginas mestras de todos os sites como origem pública na CDN, escreva o seguinte comando:

Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
  • O modificador de carateres universais */ só pode ser utilizado no início do caminho e corresponde a todos os segmentos de URL no URL especificado.
  • 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.

Pode adicionar uma origem com um caminho relativo específico. Não pode adicionar uma origem com o caminho completo.

Este exemplo adiciona uma origem privada da biblioteca de recursos do site num site específico:

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

Este exemplo adiciona uma origem privada da pasta folder1 na biblioteca de recursos de sites da coleção de sites:

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

Se existir um espaço no caminho, pode colocar o caminho entre aspas duplas ou substituir o espaço pela codificação de URL %20. Os exemplos seguintes adicionam uma origem privada da pasta 1 na biblioteca de recursos de sites 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 este comando e a sua sintaxe, veja Add-PnPTenantCdnOrigin.

Nota

Em origens privadas, os recursos partilhados a partir de uma origem têm de ter uma versão principal publicada antes de serem acessíveis a partir da CDN.

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

Exemplo: Configurar uma origem pública para as suas páginas mestras e para a sua biblioteca de estilos do SharePoint Online

Normalmente, estas origens são configuradas automaticamente por predefinição quando ativa a CDN Office 365. No entanto, se quiser ativá-los manualmente, siga estes passos.

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

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

  • Utilize 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 este comando e a sua sintaxe, veja Add-PnPTenantCdnOrigin.

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

Exemplo: Configurar uma origem privada para os recursos do site, as páginas do site e as imagens de publicação do SharePoint Online

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

    Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */siteassets

  • Utilize o cmdlet Add-PnPTenantCdnOrigin para definir a pasta de páginas do site como uma origem privada.

    Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */sitepages

  • Utilize 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 este comando e a sua sintaxe, veja Add-PnPTenantCdnOrigin.

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

Exemplo: Configurar uma origem privada para uma coleção de sites para o SharePoint Online

Utilize 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 este comando e a sua sintaxe, veja Add-PnPTenantCdnOrigin.

Depois de executar o comando, o sistema sincroniza a configuração no datacenter. Poderá ver uma mensagem de Configuração pendente . Este resultado é esperado, uma vez que o inquilino do SharePoint Online se liga ao serviço CDN. Este resultado pode demorar até 15 minutos.

Gerir a CDN do Office 365

Depois de configurar a CDN, pode efetuar alterações à configuração à medida que atualiza o conteúdo ou à medida que as suas necessidades mudam, conforme descrito nesta secção.

Adicionar, atualizar ou remover recursos da CDN do Office 365

Depois de concluir os passos de configuração, pode adicionar novos recursos e atualizar ou remover recursos existentes sempre que quiser. Basta fazer as alterações aos recursos na pasta ou biblioteca do SharePoint que identificou como uma origem. Se adicionar um novo recurso, este estará imediatamente disponível através da CDN. No entanto, se atualizar o recurso, a propagação da nova cópia demora até 15 minutos e fica disponível na CDN.

Se precisar de obter a localização da origem, pode utilizar o cmdlet Get-PnPTenantCdnOrigin . Para obter informações sobre como utilizar este cmdlet, consulte Get-PnPTenantCdnOrigin.

Remover uma origem da CDN Office 365

Pode remover o acesso a uma pasta ou biblioteca do SharePoint que identificou como uma origem. Para efetuar esta ação, utilize o cmdlet Remove-PnPTenantCdnOrigin .

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

Para obter informações sobre como utilizar este cmdlet, consulte Remove-PnPTenantCdnOrigin.

Modificar uma origem na CDN do Office 365

Não pode modificar uma origem depois de a criar. Em vez disso, remova a origem e, em seguida, adicione uma nova. Para obter mais informações, veja Para remover uma origem do Office 365 CDN e Para adicionar uma origem aos seus recursos.

Desativar a CDN do Office 365

Utilize o cmdlet Set-PnPTenantCdnEnabled para desativar a CDN para a sua organização. Se tiver as origens públicas e privadas ativadas para a CDN, terá de executar o cmdlet duas vezes, conforme mostrado nos exemplos seguintes.

Para desativar a utilização de origens públicas na CDN, introduza o seguinte comando:

Set-PnPTenantCdnEnabled -CdnType Public -Enable $false

Para desativar a utilização das origens privadas na CDN, introduza o seguinte comando:

Set-PnPTenantCdnEnabled -CdnType Private -Enable $false

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

Configurar o Office 365 CDN com a CLI do Microsoft 365

Os procedimentos nesta secção requerem a CLI do Microsoft 365. Ligue-se ao inquilino do Office 365 com o comando de início de sessão.

Conclua estes passos para configurar e configurar a CDN para alojar os seus recursos no SharePoint Online com a CLI do Microsoft 365.

Selecione para expandir

Ativar a CDN do Office 365

Pode gerir o estado do Office 365 CDN no inquilino com o comando spo cdn set.

Para ativar o Office 365 CDN Pública no seu inquilino, execute o seguinte comando:

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

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

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

Ver o estado atual da CDN do Office 365

Para verificar se o tipo específico de Office 365 CDN está ativado ou desativado, utilize o comando spo cdn get.

Para verificar se o Office 365 CDN Pública está ativado, execute o seguinte comando:

m365 spo cdn get --type Public

Ver as origens da CDN Office 365

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

m365 spo cdn origin list --type Public

Veja Origens predefinidas da CDN para obter informações sobre as origens que são aprovisionadas por predefinição quando ativa o Office 365 CDN.

Adicionar uma origem da CDN Office 365

Importante

Nunca deve colocar recursos considerados confidenciais para a sua organização numa biblioteca de documentos do SharePoint configurada como uma origem pública.

Utilize o comando spo cdn origin add para definir uma origem de CDN. Pode definir múltiplas origens. A origem é um URL que aponta para uma biblioteca ou pasta do SharePoint que contém os recursos que pretende que a CDN aloje.

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

Em path que é o caminho relativo para a pasta que contém os recursos. Pode utilizar carateres universais para além de caminhos relativos.

Para incluir todos os recursos na Galeria de Páginas Mestras de todos os sites como 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

Nota

Depois de adicionar uma origem de CDN, poderá demorar até 15 minutos para conseguir obter ficheiros através do serviço da CDN. Pode verificar se a origem específica já foi ativada com o comando spo cdn origin list .

Remover uma origem da CDN Office 365

Utilize o comando spo cdn origin remove para remover uma origem da 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

Nota

Remover uma origem da CDN não afeta os ficheiros armazenados em nenhuma biblioteca de documentos que corresponda à origem. Se estes recursos forem referenciados com o URL do SharePoint, o SharePoint muda automaticamente para o URL original que aponta para a biblioteca de documentos. Se os recursos forem referenciados através de um URL de CDN público, remover a origem interrompe a ligação e terá de alterá-los manualmente.

Modificar uma origem da CDN Office 365

Não é possível modificar uma origem de CDN existente. Em vez disso, deve remover a origem da CDN definida anteriormente com o spo cdn origin remove comando e adicionar uma nova com o spo cdn origin add comando .

Alterar os tipos de ficheiros a incluir na CDN do Office 365

Por predefinição, os seguintes tipos de ficheiro estão incluídos na CDN: .css, , .eot, .gif, .jpeg.ico, .jpg, , .js, .map, .png, .svg, .ttf, e .woff.woff2. Se precisar de incluir tipos de ficheiro adicionais na CDN, pode alterar a configuração da CDN com o comando spo cdn policy set .

Nota

Ao alterar a lista de tipos de ficheiro, substitui a lista atualmente definida. Se quiser incluir tipos de ficheiro adicionais, utilize primeiro o comando spo cdn policy list para saber que tipos de ficheiro estão atualmente configurados.

Para adicionar o tipo de ficheiro JSON à lista predefinida de tipos de ficheiro 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"

Alterar a lista de classificações de sites que pretende excluir da CDN do Office 365

Utilize o comando spo cdn policy set para excluir classificações de sites que não pretende disponibilizar através da CDN. Por predefinição, não são excluídas classificações de sites.

Nota

Ao alterar a lista de classificações de sites excluídos, substitui a lista atualmente definida. Se quiser excluir classificações adicionais, utilize primeiro o comando spo cdn policy list para saber que classificações estão atualmente configuradas.

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"

Desativar a CDN do Office 365

Para desativar o Office 365 CDN, utilize o spo cdn set comando , por exemplo:

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

Utilizar os recursos da CDN

Agora que ativou a CDN e configurou as origens e as políticas, pode começar a utilizar os recursos da CDN.

Esta secção ajuda-o a compreender como utilizar URLs de CDN nas suas páginas e conteúdos do SharePoint para que o SharePoint redirecione os pedidos de recursos em origens públicas e privadas para a CDN.

Para obter informações sobre como utilizar a CDN para alojar peças Web do lado do cliente, consulte o artigo Alojar a peça Web do lado do cliente do Office 365 CDN (Hello World parte 4).

Nota

Se adicionar a pasta ClientSideAssets à lista de origens privadas da CDN, as peças Web personalizadas alojadas na CDN não serão compostas. Os ficheiros utilizados pelas peças Web SPFX só podem utilizar a CDN pública e a pasta ClientSideAssets é uma origem predefinida para a CDN pública.

Para utilizar recursos que adicionou a uma origem, basta atualizar as ligações para o ficheiro original com o caminho para o ficheiro na origem.

  • Edite a página ou conteúdo que contém ligações para recursos que adicionou a uma origem. Também pode utilizar um de vários métodos para procurar e substituir ligações globalmente num site ou coleção de sites, se quiser atualizar a ligação para um determinado recurso em qualquer lugar que seja apresentado.
  • Para cada ligação a um recurso numa origem, substitua o caminho pelo caminho para o ficheiro na origem da CDN. Pode utilizar caminhos relativos.
  • Guarde a página ou o conteúdo.

Por exemplo, considere a imagem /site/SiteAssets/images/image.png, que copiou para a pasta da biblioteca de documentos /site/CDN_origins/public/. Para utilizar o recurso da CDN, substitua o caminho original para a localização do ficheiro de imagem pelo caminho para a origem para tornar o novo URL /site/CDN_origins/público/image.png.

Se quiser utilizar o URL completo para o recurso em vez de um caminho relativo, construa a ligação da seguinte forma:

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

Nota

Em geral, não deve codificar URLs diretamente para recursos na CDN. No entanto, pode construir manualmente URLs para recursos em origens públicas, se necessário. Para obter mais informações, veja Hardcoding CDN URLs for public assets (URLs de CDN de codificação para recursos públicos).

Para saber mais sobre como verificar se os recursos estão a ser servidos a partir da CDN, veja Como devo proceder para confirmar que os recursos estão a ser servidos pela CDN? em Resolver problemas da CDN Office 365.

Utilizar recursos em origens públicas

A funcionalidade Publicação no SharePoint Online reescreve automaticamente URLs de recursos armazenados em origens públicas para os respetivos equivalentes de CDN para que os recursos sejam servidos a partir do serviço da CDN em vez do SharePoint.

Se a sua origem estiver num site com a funcionalidade Publicação ativada e os recursos que pretende descarregar para a CDN estiverem numa das seguintes categorias, o SharePoint reescreverá automaticamente os URLs dos recursos na origem, se o recurso não tiver sido excluído por uma política de CDN.

O exemplo seguinte é uma descrição geral em que as ligações são reescritas automaticamente pela funcionalidade Publicação do SharePoint:

  • URLs de IMG/LINK/CSS nas respostas HTML da página de publicação clássica.
    • Isto inclui imagens adicionadas por autores dentro do conteúdo HTML de uma página.
  • UrLs de imagem da peça Web Apresentação de Diapositivos da Biblioteca de Imagens.
  • Campos de imagem nos resultados da API REST SPList (RenderListDataAsStream).
    • Utilize a nova propriedade ImageFieldsToTryRewriteToCdnUrls para fornecer uma lista separada por vírgulas de campos.
    • Suporta campos de hiperligação e campos PublishingImage.
  • Representações de imagens do SharePoint.

O diagrama seguinte ilustra o fluxo de trabalho quando o SharePoint recebe um pedido de uma página que contém recursos de origem pública.

Diagrama de fluxo de trabalho: a obter Office 365 recursos da CDN a partir de uma origem pública.

Sugestão

Se quiser desativar a reescrita automática para URLs específicos numa página, pode dar saída da página e adicionar o parâmetro da cadeia de consulta ? NoAutoReWrites=true até ao final de cada ligação que pretende desativar.

Construir URLs de CDN para recursos públicos

Se a funcionalidade Publicação não estiver ativada para uma origem pública ou se o recurso não for um dos tipos de ligação suportados pela funcionalidade de reescrita automática do serviço CDN, pode construir manualmente URLs para a localização da CDN dos recursos e utilizar estes URLs no seu conteúdo.

Nota

Não é possível codificar ou construir URLs de CDN para recursos numa origem privada porque o token de acesso necessário que forma a última secção do URL é gerado no momento em que o recurso é pedido. Pode construir o URL da CDN Pública e o URL não deve ser hard coded, uma vez que está sujeito a alterações.

Para recursos de CDN públicos, o formato de URL tem o seguinte aspeto:

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

Substitua TenantHostName pelo seu nome de inquilino. Por exemplo:

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

Nota

Utilize a propriedade de contexto da página para construir o prefixo em vez de codificação https://publiccdn.sharepointonline.comfixa, porque o URL está sujeito a alterações. Se utilizar modelos de apresentação com o SharePoint Online Clássico, pode utilizar a propriedade window._spPageContextInfo.publicCdnBaseUrl no seu modelo de apresentação para o prefixo do URL. Se utilizar peças Web SPFx para o SharePoint moderno e clássico, pode utilizar a propriedade this.context.pageContext.legacyPageContext.publicCdnBaseUrl, que também fornece o prefixo. Se o prefixo for alterado, a implementação será atualizada com o mesmo.

Como exemplo de SPFx, pode construir o URL com a propriedade this.context.pageContext.legacyPageContext.publicCdnBaseUrlhost - //relativeURL for the item - - - . Para obter mais informações, veja o vídeo Using CDN in Client-side code (Utilizar a CDN no código do lado do cliente), que faz parte da série de desempenho da 1ª temporada.

Utilizar recursos em origens privadas

Não é necessária qualquer configuração adicional para utilizar recursos em origens privadas. O SharePoint Online reescreve automaticamente OS URLs dos recursos em origens privadas para que os pedidos desses recursos sejam sempre servidos a partir da CDN. Não pode criar manualmente URLs para recursos da CDN em origens privadas porque estes URLs contêm tokens que têm de ser gerados automaticamente pelo SharePoint Online no momento em que o recurso é pedido.

O acesso a recursos em origens privadas é protegido por tokens gerados dinamicamente com base nas permissões de utilizador para a origem, com as limitações descritas nas secções seguintes. Os utilizadores têm de ter, pelo menos, acesso de leitura às origens para a CDN compor conteúdo.

O diagrama seguinte ilustra o fluxo de trabalho quando o SharePoint recebe um pedido de uma página que contém recursos de origem privada.

Diagrama de fluxo de trabalho: a obter Office 365 recursos da CDN a partir de uma origem privada.

Autorização baseada em tokens em origens privadas

O acesso a recursos em origens privadas no Office 365 CDN é concedido por tokens gerados pelo SharePoint Online. Os utilizadores que já têm permissão para aceder à pasta ou biblioteca designada pela origem recebem automaticamente tokens que permitem ao utilizador aceder ao ficheiro com base no respetivo nível de permissão. Estes tokens de acesso são válidos durante 30 a 90 minutos após serem gerados para ajudar a impedir ataques de repetição de tokens.

Assim que o token de acesso for gerado, o SharePoint Online devolve um URI personalizado ao cliente que contém dois parâmetros de autorização eat (token de autorização edge) e aveia (token de autorização de origem). A estrutura de cada token é <"tempo de expiração no formato de hora da época">__<"assinatura segura">. Por exemplo:

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

Nota

Qualquer pessoa na posse do token pode aceder ao recurso na CDN. No entanto, os URLs que contêm estes tokens de acesso só são partilhados através de HTTPS, pelo que, a menos que o URL seja explicitamente partilhado por um utilizador final antes de o token expirar, o recurso não estará acessível a utilizadores não autorizados.

As permissões ao nível do item não são suportadas para recursos em origens privadas

É importante ter em atenção que o SharePoint Online não suporta permissões ao nível do item para recursos em origens privadas. Por exemplo, para um ficheiro localizado em https://contoso.sharepoint.com/sites/site1/library1/folder1/image1.jpg, os utilizadores têm acesso efetivo ao ficheiro, dadas as seguintes condições:

Utilizador Permissões Acesso efetivo
Utilizador 1 Tem acesso à pasta1 Pode aceder a image1.jpg a partir da CDN
Utilizador 2 Não tem acesso à pasta1 Não é possível aceder a image1.jpg a partir da CDN
Utilizador 3 Não tem acesso à pasta1, mas é-lhe concedida permissão explícita para aceder a image1.jpg no SharePoint Online Pode aceder ao recurso image1.jpg diretamente a partir do SharePoint Online, mas não a partir da CDN
Utilizador 4 Tem acesso à pasta1, mas foi explicitamente negado o acesso ao image1.jpg no SharePoint Online Não é possível aceder ao recurso a partir do SharePoint Online, mas pode aceder ao recurso a partir da CDN, apesar de lhe ter sido negado o acesso ao ficheiro no SharePoint Online

Resolver problemas da CDN do Office 365

Como devo proceder para confirmar que os recursos estão a ser servidos pela CDN?

Depois de adicionar ligações a recursos da CDN a uma página, pode confirmar que o recurso está a ser servido a partir da CDN ao navegar para a página, clicando com o botão direito do rato na imagem depois de ser composto e ao rever o URL da imagem.

Também pode utilizar as ferramentas de programador do browser para ver o URL de cada recurso numa página ou utilizar uma ferramenta de rastreio de rede de terceiros.

Nota

Se utilizar uma ferramenta de rede como o Fiddler para testar os seus recursos fora da composição do recurso a partir de uma página do SharePoint, tem de adicionar manualmente o cabeçalho do referer "Referer: https://yourdomain.sharepoint.com" ao pedido GET em que o URL é o URL de raiz do seu inquilino do SharePoint Online.

Não pode testar os URLs da CDN diretamente num browser porque tem de ter um referenciador proveniente do SharePoint Online. No entanto, se adicionar o URL do recurso da CDN a uma página do SharePoint e, em seguida, abrir a página num browser, o recurso da CDN será composto na página.

Para obter mais informações sobre como utilizar as ferramentas de programador no browser Microsoft Edge, consulte Ferramentas de Programação do Microsoft Edge.

Para watch um breve vídeo alojado no canal do YouTube Padrões e Práticas do Programador do SharePoint que mostra como verificar se a CDN está a funcionar, consulte Verificar a utilização da CDN e garantir uma conectividade de rede ideal.

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

Os recursos em novas origens não estarão imediatamente disponíveis para utilização, pois demora algum tempo para que o registo se propague através da CDN e para que os recursos sejam carregados da origem para o armazenamento da CDN. O tempo necessário para que os recursos estejam disponíveis na CDN depende do número de recursos e dos tamanhos dos ficheiros.

A minha peça Web do lado do cliente ou a solução SharePoint Framework não está a funcionar

Quando ativa o Office 365 CDN para origens públicas, o serviço da CDN cria automaticamente estas origens predefinidas:

  • */PÁGINA MESTRA
  • */BIBLIOTECA DE ESTILOS
  • */CLIENTSIDEASSETS

Se a origem */clientsideassets estiver em falta, SharePoint Framework soluções falharão e não forem geradas mensagens de aviso ou erro. Esta origem pode estar em falta porque a CDN foi ativada com o parâmetro -NoDefaultOrigins definido como $true ou porque a origem foi eliminada manualmente.

Pode verificar que origens estão presentes com o seguinte comando do PowerShell:

Get-SPOTenantCdnOrigins -CdnType Public

Em alternativa, pode consultar 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 com a CLI do Microsoft 365:

m365 spo cdn origin add --origin */CLIENTSIDEASSETS

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

Pode optar por trabalhar com o Office 365 CDN através do módulo PowerShell da Shell de Gestão do SharePoint Online ou da CLI do Microsoft 365.

Consulte também

Redes de Entrega de Conteúdos

Network planning and performance tuning for Office 365

Série de Desempenho do SharePoint - Office 365 série de vídeos da CDN