Använda Office 365 Content Delivery Network (CDN) med SharePoint Online

Du kan använda den inbyggda Office 365 Content Delivery Network (CDN) som värd för statiska tillgångar för att få bättre prestanda för dina SharePoint onlinesidor. Med Office 365 CDN prestanda kan du cachelagra statiska tillgångar närmare de webbläsare som begär dem, vilket hjälper dig att snabba på hämtningar och minska svarstiden. Dessutom Office 365 CDN HTTP/2-protokollet för förbättrad komprimering och HTTP-pipelining. Tjänsten Office 365 CDN ingår som en del av din prenumeration SharePoint Online.

Anteckning

Klientorganisationen Office 365 CDN tillgänglig för klientorganisationen i molnet För produktion (globalt). Klientorganisationen i molnen för myndigheter i USA, Kina och Tyskland stöder för närvarande inte Office 365 CDN.

The Office 365 CDN består av flera CDN som gör att du kan ha statiska tillgångar på flera platser, eller ursprung, och hantera dem från globala nätverk med hög hastighet. Beroende på vilken typ av innehåll som du vill lagra i Office 365 CDN kan du lägga till offentliga ursprung, privata ursprung eller båda. Se Välj om varje ursprung ska vara offentligt eller privat för mer information om skillnaden mellan offentliga och privata ursprung.

Office 365 CDN konceptuellt diagram.

Om du redan är bekant med hur CDNs fungerar behöver du bara utföra några få steg för att aktivera Office 365 CDN för klientorganisationen. I det här avsnittet beskrivs hur du gör. Läs vidare för information om hur du kommer igång med värdskap för dina statiska tillgångar.

Tips

Det finns andra CDN med Microsoft-värd som kan användas med Office 365 för särskilda användningsscenarier, men som inte diskuteras i det här avsnittet eftersom de faller utanför Office 365 CDN. Mer information finns i Andra Microsoft CDN.

Gå tillbaka till Nätverksplanering och prestandajustering för Office 365.

Översikt över hur du arbetar med Office 365 CDN i SharePoint Online

Följ de här Office 365 CDN för att konfigurera organisationens tjänster:

När du är klar med konfigurationen kan du hantera programmet Office 365 CDN tiden genom att:

  • Lägga till, uppdatera och ta bort tillgångar
  • Lägga till och ta bort ursprung
  • Konfigurera CDN principer
  • Om det behövs inaktiverar du CDN

Slutligen kan du läsa Använda dina CDN för att lära dig mer om hur du kommer CDN tillgångar från både offentliga och privata ursprung.

I Felsöka Office 365 CDN information om hur du löser vanliga problem.

Planera distributionen av Office 365 CDN

Innan du distribuerar Office 365 CDN för Office 365-klientorganisationen bör du tänka på följande faktorer som en del av planeringsprocessen.

Bestäm vilka statiska tillgångar du vill ha på CDN

I allmänhet är CDN mest effektiva för värd för statiska tillgångar , eller tillgångar som inte ändras så ofta. En bra tumregel är att identifiera filer som uppfyller vissa eller alla dessa villkor:

  • Statiska filer som är inbäddade i en sida (till exempel skript och bilder) som kan ha en betydande stegvis inverkan på sidornas inläsningstider
  • Stora filer som körbara filer och installationsfiler
  • Resursbibliotek med stöd för klientkod

Till exempel kan små filer som upprepade gånger efterfrågas, t.ex. webbplatsbilder och skript, avsevärt förbättra prestanda för webbplatsåtergivning och stegvis minska inläsningen av SharePoint Online-webbplatser när du lägger till dem i ett CDN-ursprung. Större filer, till exempel körbara installationsfiler, kan laddas ned från CDN, vilket ger positiv prestanda, samtidigt som belastningen på din SharePoint Online-webbplats därefter minskar, även om de inte används så ofta.

Prestandaförbättringar per fil beror på många faktorer, inklusive klientens närhet till närmaste CDN-slutpunkt, tillfälliga villkor i det lokala nätverket och så vidare. Många statiska filer är ganska små och kan laddas ned från Office 365 på mindre än en sekund. En webbsida kan emellertid innehålla många inbäddade filer med en kumulativ nedladdningstid på flera sekunder. Att använda dessa filer från CDN filer kan avsevärt minska inläsningstiden för sidan. Se Vilka prestandaförbättringar tillhandahåller CDN för ett exempel.

Bestäm var du vill lagra tillgångarna

Data CDN dina tillgångar från en plats som kallas för ursprung. Ursprunget kan vara en SharePoint, ett dokumentbibliotek eller en mapp som kan nås via en URL. Du har stor flexibilitet när du anger ursprung för organisationen. Du kan till exempel ange flera ursprung eller ett enda ursprung där du vill placera alla CDN tillgångar. Du kan välja att ha både offentliga och privata ursprung för organisationen. De flesta organisationer väljer att implementera en kombination av de två.

Du kan skapa en ny behållare för ursprungen, till exempel mappar eller dokumentbibliotek, och lägga till filer som du vill göra tillgängliga från CDN. Det här är ett bra sätt om du har en särskild uppsättning tillgångar som du vill ska vara tillgänglig från CDN och vill begränsa uppsättningen CDN-tillgångar till endast de filerna i behållaren.

Du kan också konfigurera en befintlig webbplatssamling, webbplats, bibliotek eller mapp som ursprung, vilket gör alla kvalificerade tillgångar i behållaren tillgängliga från CDN. Innan du lägger till en befintlig behållare som ursprung är det viktigt att du är medveten om dess innehåll och behörigheter så att du inte oavsiktligt visar tillgångar för anonym åtkomst eller obehöriga användare.

Du kan CDN principer för att utesluta innehåll i dina ursprung från CDN. CDN-principer utesluter tillgångar i offentliga eller privata ursprung efter attribut, till exempel filtyp och webbplatsklassificering, och tillämpas på alla ursprung för den CdnType (privat eller offentlig) du anger i principen. Om du till exempel lägger till ett privat ursprung som består av en webbplats som innehåller flera underwebbplatser kan du definiera en princip för att utesluta webbplatser som markerats som konfidentiellt, så att innehåll från webbplatser med den klassificeringen inte kommer att användas från CDN. Principen gäller för innehåll från alla privata ursprung som du har lagt till i CDN.

Kom ihåg att ju fler ursprung, desto större inverkan på den tid det tar CDN att bearbeta förfrågningar. Vi rekommenderar att du så mycket som möjligt begränsar antalet ursprung.

Välj om varje ursprung ska vara offentligt eller privat

När du identifierar ett ursprung anger du om det ska göras offentligt eller privat. Åtkomsten CDN tillgångar i offentliga ursprung är anonym och CDN innehåll i privata ursprung skyddas av dynamiskt genererade token för större säkerhet. Oavsett vilket alternativ du väljer gör Microsoft allt grovjobb åt dig när det gäller administration av CDN själv. Du kan också ändra dig senare, när du har ställt in CDN och identifierat dina ursprung.

Både offentliga och privata alternativ ger liknande prestandaförbättringar, men var och en har unika attribut och fördelar.

Offentliga ursprung i Office 365 CDN är anonymt tillgängliga och värdtillgångar kan nås av alla som har URL-adressen till tillgången. Eftersom åtkomsten till innehåll i offentliga ursprung är anonym bör du bara använda dem för att cachelagra icke-känsligt allmänt innehåll som JavaScript-filer, skript, ikoner och bilder.

Privata ursprung i Office 365 CDN ger privat åtkomst till användarinnehåll, SharePoint Dokumentbibliotek, webbplatser och egenutvecklade bilder. Åtkomst till innehåll i privata ursprung skyddas av dynamiskt genererade tokens så att användare med behörighet till det ursprungliga dokumentbiblioteket eller lagringsplatsen endast kan komma åt det. Privata ursprung i Office 365 CDN kan endast användas för SharePoint Online-innehåll och du kan bara komma åt tillgångar i privata ursprung genom omdirigering från SharePoint Online-klienten.

Du kan läsa mer om hur CDN åtkomst till tillgångar i ett privat ursprung fungerar i Använda tillgångar i privata ursprung.

Attribut och fördelar med att ha tillgångar i offentliga ursprung

  • Tillgångar som exponeras i en offentlig tillgång är åtkomliga för alla anonymt.

    Viktigt

    Du ska aldrig placera resurser som innehåller användarinformation eller som anses vara känsliga för organisationen i ett offentligt ursprung.

  • Om du tar bort en tillgång från ett offentligt ursprung kan tillgången fortsätta att vara tillgänglig i upp till 30 dagar från cachen. Länkarna till tillgången blir ogiltiga under de CDN inom 15 minuter.

  • När du är värd för formatmallar (CSS-filer) i ett offentligt ursprung kan du använda relativa sökvägar och URI:er i koden. Det innebär att du kan referera till platsen för bakgrundsbilder och andra objekt i förhållande till platsen för tillgången som anropar den.

  • Du kan skapa URL-adressen för ett offentligt ursprung, men du bör vara försiktig och se till att du använder sidkontextegenskapen och följer instruktionerna för att göra det. Anledningen är att om åtkomsten till CDN blir otillgänglig matchas inte URL-adressen automatiskt med din organisation i SharePoint Online och kan leda till brutna länkar och andra fel. URL-adressen kan också komma att ändras, vilket är anledningen till att den inte bara ska vara hårdkodad till sitt nuvarande värde.

  • Standardfiltyperna som ingår för offentliga ursprung är .css, .eot, .gif, .ico, .jpeg, .jpg, .js, .map, .png, .svg, .ttf, .woff och .woff2. Du kan ange ytterligare filtyper.

  • Du kan konfigurera en princip för att utesluta tillgångar som har identifierats av webbplatsklassificeringarna som du anger. Du kan till exempel välja att utesluta alla tillgångar som markeras som "konfidentiell" eller "begränsad" även om de är en tillåten filtyp och finns i ett offentligt ursprung.

Attribut och fördelar med att ha tillgångar i privata ursprung

  • Privata ursprung kan endast användas för SharePoint och onlinetillgångar.

  • Användare kan bara komma åt tillgångarna från ett privat ursprung om de har behörighet att komma åt behållaren. Anonym åtkomst till tillgångarna förhindras.

  • Tillgångar i privata ursprung måste hänvisas från den SharePoint Online-klientorganisationen. Direkt åtkomst till privata CDN tillgångar fungerar inte.

  • Om du tar bort en tillgång från det privata ursprunget kan tillgången fortsätta att vara tillgänglig i upp till en timme från cachen. Länkarna till tillgången blir ogiltiga under de CDN inom 15 minuter från borttagningen av tillgången.

  • Standardfiltyperna som ingår för privata ursprung är .gif, .ico, .jpeg, .jpg, .js och .png. Du kan ange ytterligare filtyper.

  • Precis som för offentliga ursprung kan du konfigurera en princip för att utesluta tillgångar som har identifierats av webbplatsklassificeringarna som du anger även om du använder jokertecken för att inkludera alla tillgångar i en mapp eller ett dokumentbibliotek.

Mer information om varför du kan använda de Office 365 CDN, allmänna CDN-begreppen och andra Microsoft CDN:er som du kan använda med din Office 365-klientorganisation finns i Nätverk för innehållsleverans.

Standardprodukter CDN ursprung

Om du inte anger något Office 365 några standard ursprung åt dig när du aktiverar Office 365 CDN. Om du först väljer att inte tillhandahålla dem kan du lägga till dessa ursprung när du har slutfört konfigurationen. Om du inte förstår konsekvenserna av att hoppa över konfigurationen av standard ursprung och har en särskild orsak till det, bör du tillåta att de skapas när du aktiverar CDN.

Privata standardprodukter CDN ursprung:

  • */userphoto.aspx
  • */siteassets

Offentliga standardprodukter CDN ursprung:

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

Anteckning

clientsideassets är ett offentligt standard ursprung som lades till Office 365 CDN tjänsten i december 2017. Ursprunget måste finnas för att SharePoint Framework lösningarna i CDN ska fungera. Om du aktiverade Office 365 CDN före december 2017, eller om du hoppade över konfigurationen av standard ursprung när du aktiverade CDN, kan du manuellt lägga till det här ursprunget. Mer information finns i Min webbdel på klientsidan eller i SharePoint Framework en lösning inte fungerar.

Konfigurera och konfigurera Office 365 CDN med hjälp av SharePoint Online Management Shell

Procedurerna i det här avsnittet kräver att du använder SharePoint Online Management Shell för att ansluta till SharePoint Online. Instruktioner finns i Anslut för SharePoint PowerShell.

Utför de här stegen för att konfigurera och konfigurera CDN för att lagra dina tillgångar i SharePoint Online med hjälp av SharePoint Online Management Shell.

Klicka för att Visa

Aktivera organisationen för att använda Office 365 CDN

Innan du gör ändringar i CDN inställningar bör du hämta aktuell status för konfigurationen av privata CDN i Office 365 klientorganisation. Anslut till klientorganisationen med hjälp SharePoint Online Management Shell:

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

Använd nu cmdleten Get-SPOTenantCdnEnabled för att hämta CDN statusinställningar från klientorganisationen:

Get-SPOTenantCdnEnabled -CdnType <Public | Private>

Status för den CDN för den angivna CdnType matas ut på skärmen.

Använd cmdleten Set-SPOTenantCdnEnabled till att aktivera organisationen för att använda Office 365 CDN. Du kan aktivera organisationen för att använda offentliga ursprung, privata ursprung eller båda samtidigt. Du kan också konfigurera CDN att hoppa över konfigurationen av standard ursprung när du aktiverar det. Du kan alltid lägga till dessa ursprung senare enligt beskrivningen i det här avsnittet.

Gör Windows PowerShell för SharePoint Online:

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

Om du till exempel vill aktivera organisationen för att använda både offentliga och privata ursprung skriver du följande kommando:

Set-SPOTenantCdnEnabled -CdnType Both -Enable $true

Om du vill aktivera organisationen för att använda både offentliga och privata ursprung men hoppa över att konfigurera standard ursprung skriver du följande kommando:

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

Se Standardvärden CDN ursprung för information om ursprung som är etablerade som standard när du aktiverar Office 365 CDN och eventuell inverkan av att hoppa över konfigurationen av standard ursprung.

Om du vill aktivera organisationen för att använda offentliga ursprung skriver du följande kommando:

Set-SPOTenantCdnEnabled -CdnType Public -Enable $true

Om du vill aktivera din organisation för att använda privata ursprung skriver du följande kommando:

Set-SPOTenantCdnEnabled -CdnType Private -Enable $true

Mer information om den här cmdleten finns i Set-SPOTenantCdnEnabled.

Ändra listan över filtyper som ska ingå i listan Office 365 CDN (valfritt)

Tips

När du definierar filtyper med hjälp av cmdleten Set-SPOTenantCdnPolicy skriver du över den aktuella definierade listan. Om du vill lägga till ytterligare filtyper i listan använder du först cmdleten för att ta reda på vilka filtyper som redan är tillåtna och inkludera dem i listan tillsammans med dina nya.

Använd cmdleten Set-SPOTenantCdnPolicy till att definiera statiska filtyper som kan lagras av offentliga och privata ursprung i CDN. Som standard tillåts vanliga tillgångstyper, till exempel .css, .gif, .jpg och .js.

Gör Windows PowerShell för SharePoint Online:

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

Om du till exempel vill CDN CSS- och .png-filer anger du kommandot:

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

Om du vill se vilka filtyper som tillåts av CDN använder du cmdleten Get-SPOTenantCdnPolicies:

Get-SPOTenantCdnPolicies -CdnType <Public | Private>

Mer information om dessa cmdlets finns i Set-SPOTenantCdnPolicy och Get-SPOTenantCdnPolicies.

Ändra listan över webbplatsklassificeringarna som du vill utesluta från Office 365 CDN (valfritt)

Tips

När du utesluter webbplatsklassificeringarna med hjälp av cmdleten Set-SPOTenantCdnPolicy skriver du över den aktuella definierade listan. Om du vill utesluta ytterligare webbplatsklassificeringarna använder du cmdleten först för att ta reda på vilka klassificeringar som redan har uteslutits och sedan lägga till dem tillsammans med dina nya.

Använd cmdleten Set-SPOTenantCdnPolicy till att utesluta webbplatsklassificering som du inte vill ska vara tillgängliga via CDN. Som standard utesluts inga webbplatsklassificeringar.

Gör Windows PowerShell för SharePoint Online:

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

Om du vill se vilka webbplatsklassificeringarna som är begränsade använder du cmdleten Get-SPOTenantCdnPolicies:

Get-SPOTenantCdnPolicies -CdnType <Public | Private>

Egenskaperna som returneras är IncludeFileExtensions, ExcludeRestrictedSiteClassifications och ExcludeIfNoScriptDisabled.

Egenskapen IncludeFileExtensions innehåller listan över filnamnstillägg som kommer att användas från CDN.

Anteckning

Standardtilläggen för filer skiljer sig åt mellan offentliga och privata.

Egenskapen ExcludeRestrictedSiteClassifications innehåller webbplatsklassificeringarna som du vill utesluta från CDN. Du kan till exempel utesluta webbplatser som markerats som konfidentiella så att innehåll från webbplatser med den klassificering som tillämpas inte CDN.

Egenskapen ExcludeIfNoScriptDisabled utesluter innehåll från CDN baserat på inställningar för NoScript-attribut på webbplatsnivå. Som standard är attributet NoScript inställt på Aktiverad för moderna webbplatser och Inaktiverat för klassiska webbplatser. Det beror på klientorganisationens inställningar.

Mer information om dessa cmdlets finns i Set-SPOTenantCdnPolicy och Get-SPOTenantCdnPolicies.

Lägga till ett ursprung för dina tillgångar

Definiera ett ursprung med cmdleten Add-SPOTenantCdnOrigin. Du kan definiera flera ursprung. Ursprunget är en URL-adress som pekar på SharePoint bibliotek eller mapp som innehåller tillgångarna som du vill ska lagras av CDN.

Viktigt

Du ska aldrig placera resurser som innehåller användarinformation eller som anses vara känsliga för organisationen i ett offentligt ursprung.

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

Värdet på sökvägen är den relativa sökvägen till biblioteket eller mappen som innehåller tillgångarna. Du kan använda jokertecken utöver relativa sökvägar. Ursprung stöder jokertecken som finns i url-adressen. På så sätt kan du skapa ursprung som spänner över flera webbplatser. Om du till exempel vill ta med alla tillgångar i mappen masterpages för alla dina webbplatser som ett offentligt ursprung i CDN skriver du följande kommando:

Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
  • Jokertecknet * kan bara användas i början av sökvägen och matchar / alla URL-segment under den angivna URL:en.
  • Sökvägen kan peka på ett dokumentbibliotek, en mapp eller en webbplats. Sökvägen */webbplats1 matchar till exempel alla dokumentbibliotek under webbplatsen.

Du kan lägga till ett ursprung med en viss relativ sökväg. Du kan inte lägga till ett ursprung med den fullständiga sökvägen.

I det här exemplet läggs ett privat ursprung till webbplatssamlingsbiblioteket på en viss webbplats:

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

Det här exemplet lägger till ett privat ursprung för mappen mapp1 i webbplatssamlingens bibliotek för webbplatstillgångar:

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

Om det finns ett blanksteg i sökvägen kan du antingen omge sökvägen med dubbla citattecken eller ersätta blanksteget med URL-kodningen %20. Följande exempel lägger till ett privat ursprung för mappen mapp 1 i webbplatssamlingens bibliotek för webbplatstillgångar:

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

Mer information om kommandot och dess syntax finns i Add-SPOTenantCdnOrigin.

Anteckning

I privata ursprung måste tillgångar som delas från ett ursprung ha en huvudversion publicerad innan de kan nås från CDN.

När du har kört kommandot synkroniserar systemet konfigurationen i datacentret. Det kan ta upp till 15 minuter.

Exempel: Konfigurera ett offentligt ursprung för huvudsidorna och för formatbiblioteket för SharePoint Online

Normalt konfigureras dessa ursprung åt dig som standard när du aktiverar Office 365 CDN. Men om du vill aktivera dem manuellt följer du de här stegen.

  • Använd cmdleten Add-SPOTenantCdnOrigin till att definiera formatbiblioteket som ett offentligt ursprung.

    Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */style%20library
    
  • Använd cmdleten Add-SPOTenantCdnOrigin till att definiera huvudsidorna som ett offentligt ursprung.

    Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
    

Mer information om kommandot och dess syntax finns i Add-SPOTenantCdnOrigin.

När du har kört kommandot synkroniserar systemet konfigurationen i datacentret. Det kan ta upp till 15 minuter.

Exempel: Konfigurera ett privat ursprung för dina webbplatstillgångar, webbplatssidor och publiceringsbilder för SharePoint Online

  • Använd cmdleten Add-SPOTenantCdnOrigin till att definiera mappen för webbplatstillgångar som ett privat ursprung.

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */siteassets
    
  • Använd cmdleten Add-SPOTenantCdnOrigin till att definiera mappen för webbplatssidor som ett privat ursprung.

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */sitepages
    
  • Använd cmdleten Add-SPOTenantCdnOrigin till att definiera mappen för publiceringsbilder som ett privat ursprung.

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */publishingimages
    

Mer information om kommandot och dess syntax finns i Add-SPOTenantCdnOrigin.

När du har kört kommandot synkroniserar systemet konfigurationen i datacentret. Det kan ta upp till 15 minuter.

Exempel: Konfigurera ett privat ursprung för en webbplatssamling för SharePoint Online

Använd cmdleten Add-SPOTenantCdnOrigin till att definiera en webbplatssamling som ett privat ursprung. Till exempel:

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

Mer information om kommandot och dess syntax finns i Add-SPOTenantCdnOrigin.

När du har kört kommandot synkroniserar systemet konfigurationen i datacentret. Ett meddelande om väntande konfiguration visas, vilket förväntas när SharePoint Online-klienten ansluter till CDN tjänsten. Det kan ta upp till 15 minuter.

Hantera Office 365 CDN

När du har ställt CDN kan du göra ändringar i konfigurationen när du uppdaterar innehåll eller när dina behov ändras, enligt beskrivningen i det här avsnittet.

Lägga till, uppdatera eller ta bort tillgångar från Office 365 CDN

När du har slutfört konfigurationsstegen kan du lägga till nya tillgångar och uppdatera eller ta bort befintliga tillgångar när du vill. Gör bara ändringar av tillgångarna i mappen eller det SharePoint som du har identifierat som ursprung. Om du lägger till en ny tillgång är den tillgänglig via CDN omedelbart. Men om du uppdaterar tillgången tar det upp till 15 minuter för den nya kopian av spridas och bli tillgänglig i CDN.

Om du behöver hämta platsen för ursprunget kan du använda cmdleten Get-SPOTenantCdnOrigins. Information om hur du använder denna cmdlet finns i Get-SPOTenantCdnOrigins.

Ta bort ett ursprung från Office 365 CDN

Du kan ta bort åtkomst till en mapp SharePoint ett bibliotek som du har identifierat som ursprung. Det gör du med cmdleten Remove-SPOTenantCdnOrigin.

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

Information om hur du använder denna cmdlet finns i Remove-SPOTenantCdnOrigin.

Ändra ett ursprung i Office 365 CDN

Du kan inte ändra ett ursprung som du har skapat. Ta istället bort ursprunget och lägg sedan till ett nytt. Mer information finns i Ta bort ett ursprung från Office 365 CDN Lägga till ett ursprung för dina tillgångar.

Inaktivera Office 365 CDN

Använd cmdleten Set-SPOTenantCdnEnabled till att inaktivera CDN för organisationen. Om du har aktiverat både offentliga och privata ursprung för CDN, måste du köra cmdleten två gånger enligt följande exempel.

Inaktivera användningen av offentliga ursprung i CDN genom att ange följande kommando:

Set-SPOTenantCdnEnabled -CdnType Public -Enable $false

Inaktivera användningen av privata ursprung i CDN genom att ange följande kommando:

Set-SPOTenantCdnEnabled -CdnType Private -Enable $false

Mer information om den här cmdleten finns i Set-SPOTenantCdnEnabled.

Konfigurera och konfigurera Office 365 CDN med PnP PowerShell

Procedurerna i det här avsnittet kräver att du använder PnP PowerShell för att ansluta till SharePoint Online. Anvisningar finns i Komma igång med PnP PowerShell.

Utför de här stegen för att konfigurera och konfigurera CDN för att lagra dina tillgångar i SharePoint Online med PnP PowerShell.

Klicka för att Visa

Aktivera organisationen för att använda Office 365 CDN

Innan du gör ändringar i CDN inställningar bör du hämta aktuell status för konfigurationen av privata CDN i Office 365 klientorganisation. Anslut till klientorganisationen med PnP PowerShell:

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

Använd nu cmdleten Get-PnPTenantCdnEnabled för att hämta CDN statusinställningar från klientorganisationen:

Get-PnPTenantCdnEnabled -CdnType <Public | Private>

Status för den CDN för den angivna CdnType matas ut på skärmen.

Använd cmdleten Set-PnPTenantCdnEnabled till att aktivera organisationen för att använda Office 365 CDN. Du kan aktivera organisationen för att använda offentliga ursprung, privata ursprung eller både och på samma gång. Du kan också konfigurera CDN att hoppa över konfigurationen av standard ursprung när du aktiverar det. Du kan alltid lägga till dessa ursprung senare enligt beskrivningen i det här avsnittet.

I PnP PowerShell:

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

Om du till exempel vill aktivera organisationen för att använda både offentliga och privata ursprung skriver du följande kommando:

Set-PnPTenantCdnEnabled -CdnType Both -Enable $true

Om du vill aktivera organisationen för att använda både offentliga och privata ursprung men hoppa över att konfigurera standard ursprung skriver du följande kommando:

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

Se Standardvärden CDN ursprung för information om ursprung som är etablerade som standard när du aktiverar Office 365 CDN och eventuell inverkan av att hoppa över konfigurationen av standard ursprung.

Om du vill aktivera organisationen för att använda offentliga ursprung skriver du följande kommando:

Set-PnPTenantCdnEnabled -CdnType Public -Enable $true

Om du vill aktivera din organisation för att använda privata ursprung skriver du följande kommando:

Set-PnPTenantCdnEnabled -CdnType Private -Enable $true

Mer information om den här cmdleten finns i Set-PnPTenantCdnEnabled.

Ändra listan över filtyper som ska ingå i listan Office 365 CDN (valfritt)

Tips

När du definierar filtyper med hjälp av cmdleten Set-PnPTenantCdnPolicy skriver du över den aktuella definierade listan. Om du vill lägga till ytterligare filtyper i listan använder du först cmdleten för att ta reda på vilka filtyper som redan är tillåtna och inkludera dem i listan tillsammans med dina nya.

Använd cmdleten Set-PnPTenantCdnPolicy till att definiera statiska filtyper som kan lagras av offentliga och privata ursprung i CDN. Som standard tillåts vanliga tillgångstyper, till exempel .css, .gif, .jpg och .js.

I PnP PowerShell:

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

Om du till exempel vill CDN CSS- och .png-filer anger du kommandot:

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

Om du vill se vilka filtyper som tillåts av CDN använder du cmdleten Get-PnPTenantCdnPolicies:

Get-PnPTenantCdnPolicies -CdnType <Public | Private>

Mer information om dessa cmdlets finns i Set-PnPTenantCdnPolicy och Get-PnPTenantCdnPolicies.

Ändra listan över webbplatsklassificeringarna som du vill utesluta från Office 365 CDN (valfritt)

Tips

När du utesluter webbplatsklassificeringarna med hjälp av cmdleten Set-PnPTenantCdnPolicy skriver du över den aktuella definierade listan. Om du vill utesluta ytterligare webbplatsklassificeringarna använder du cmdleten först för att ta reda på vilka klassificeringar som redan har uteslutits och sedan lägga till dem tillsammans med dina nya.

Använd cmdleten Set-PnPTenantCdnPolicy till att utesluta webbplatsklassificering som du inte vill ska vara tillgängliga via CDN. Som standard utesluts inga webbplatsklassificeringar.

I PnP PowerShell:

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

Om du vill se vilka webbplatsklassificeringarna är begränsade använder du cmdleten Get-PnPTenantCdnPolicies:

Get-PnPTenantCdnPolicies -CdnType <Public | Private>

Egenskaperna som returneras är IncludeFileExtensions, ExcludeRestrictedSiteClassifications och ExcludeIfNoScriptDisabled.

Egenskapen IncludeFileExtensions innehåller listan över filnamnstillägg som ska användas för CDN.

Anteckning

Standardtilläggen för filer skiljer sig åt mellan offentliga och privata.

Egenskapen ExcludeRestrictedSiteClassifications innehåller webbplatsklassificeringarna som du vill utesluta från CDN. Du kan till exempel utesluta webbplatser som markerats som konfidentiella så att innehåll från webbplatser med den klassificering som tillämpas inte CDN.

Egenskapen ExcludeIfNoScriptDisabled utesluter innehåll från CDN baserat på inställningar för NoScript-attribut på webbplatsnivå. Som standard är attributet NoScript inställt på Aktiverad för moderna webbplatser och Inaktiverat för klassiska webbplatser. Det beror på klientorganisationens inställningar.

Mer information om dessa cmdlets finns i Set-PnPTenantCdnPolicy och Get-PnPTenantCdnPolicies.

Lägga till ett ursprung för dina tillgångar

Definiera ett ursprung med cmdleten Add-PnPTenantCdnOrigin. Du kan definiera flera ursprung. Ursprunget är en URL-adress som pekar på SharePoint bibliotek eller mapp som innehåller tillgångarna som du vill ska lagras av CDN.

Viktigt

Du ska aldrig placera resurser som innehåller användarinformation eller som anses vara känsliga för organisationen i ett offentligt ursprung.

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

Värdet på sökvägen är den relativa sökvägen till biblioteket eller mappen som innehåller tillgångarna. Du kan använda jokertecken utöver relativa sökvägar. Ursprung stöder jokertecken som finns i url-adressen. På så sätt kan du skapa ursprung som spänner över flera webbplatser. Om du till exempel vill ta med alla tillgångar i mappen masterpages för alla dina webbplatser som ett offentligt ursprung i CDN, skriver du följande kommando:

Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
  • Jokertecknet * kan bara användas i början av sökvägen och matchar / alla URL-segment under den angivna URL:en.
  • Sökvägen kan peka på ett dokumentbibliotek, en mapp eller en webbplats. Sökvägen */webbplats1 matchar till exempel alla dokumentbibliotek under webbplatsen.

Du kan lägga till ett ursprung med en viss relativ sökväg. Du kan inte lägga till ett ursprung med den fullständiga sökvägen.

I det här exemplet läggs ett privat ursprung till biblioteket med webbplatstillgångar till på en viss webbplats:

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

Det här exemplet lägger till ett privat ursprung för mappen mapp1 i webbplatssamlingens bibliotek för webbplatstillgångar:

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

Om det finns ett blanksteg i sökvägen kan du antingen omge sökvägen med dubbla citattecken eller ersätta blanksteget med URL-kodningen %20. Följande exempel lägger till ett privat ursprung för mappen mapp 1 i webbplatssamlingens bibliotek för webbplatstillgångar:

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

Mer information om kommandot och dess syntax finns i Add-PnPTenantCdnOrigin.

Anteckning

I privata ursprung måste tillgångar som delas från ett ursprung ha en huvudversion publicerad innan de kan nås från CDN.

När du har kört kommandot synkroniserar systemet konfigurationen i datacentret. Det kan ta upp till 15 minuter.

Exempel: Konfigurera ett offentligt ursprung för dina huvudsidor och för ditt formatbibliotek för SharePoint Online

Normalt konfigureras dessa ursprung åt dig som standard när du aktiverar Office 365 CDN. Men om du vill aktivera dem manuellt följer du de här stegen.

  • Använd cmdleten Add-PnPTenantCdnOrigin till att definiera formatbiblioteket som ett offentligt ursprung.

    Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */style%20library
    
  • Använd cmdleten Add-PnPTenantCdnOrigin till att definiera huvudsidorna som ett offentligt ursprung.

    Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
    

Mer information om kommandot och dess syntax finns i Add-PnPTenantCdnOrigin.

När du har kört kommandot synkroniserar systemet konfigurationen i datacentret. Det kan ta upp till 15 minuter.

Exempel: Konfigurera ett privat ursprung för dina webbplatstillgångar, webbplatssidor och publiceringsbilder för SharePoint Online

  • Använd cmdleten Add-PnPTenantCdnOrigin till att definiera mappen för webbplatstillgångar som ett privat ursprung.

    Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */siteassets
    
  • Använd cmdleten Add-PnPTenantCdnOrigin till att definiera mappen för webbplatssidor som ett privat ursprung.

    Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */sitepages
    
  • Använd cmdleten Add-PnPTenantCdnOrigin till att definiera mappen för publiceringsbilder som ett privat ursprung.

    Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */publishingimages
    

Mer information om kommandot och dess syntax finns i Add-PnPTenantCdnOrigin.

När du har kört kommandot synkroniserar systemet konfigurationen i datacentret. Det kan ta upp till 15 minuter.

Exempel: Konfigurera ett privat ursprung för en webbplatssamling för SharePoint Online

Använd cmdleten Add-PnPTenantCdnOrigin till att definiera en webbplatssamling som ett privat ursprung. Till exempel:

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

Mer information om kommandot och dess syntax finns i Add-PnPTenantCdnOrigin.

När du har kört kommandot synkroniserar systemet konfigurationen i datacentret. Ett meddelande om väntande konfiguration visas, vilket förväntas när SharePoint Online-klienten ansluter till CDN tjänsten. Det kan ta upp till 15 minuter.

Hantera Office 365 CDN

När du har ställt CDN kan du göra ändringar i konfigurationen när du uppdaterar innehåll eller när dina behov ändras, enligt beskrivningen i det här avsnittet.

Lägga till, uppdatera eller ta bort tillgångar från Office 365 CDN

När du har slutfört konfigurationsstegen kan du lägga till nya tillgångar och uppdatera eller ta bort befintliga tillgångar när du vill. Gör bara ändringar av tillgångarna i mappen eller det SharePoint som du har identifierat som ursprung. Om du lägger till en ny tillgång är den tillgänglig via CDN omedelbart. Men om du uppdaterar tillgången tar det upp till 15 minuter för den nya kopian av spridas och bli tillgänglig i CDN.

Om du behöver hämta platsen för ursprunget kan du använda cmdleten Get-PnPTenantCdnOrigin. Information om hur du använder denna cmdlet finns i Get-PnPTenantCdnOrigin.

Ta bort ett ursprung från Office 365 CDN

Du kan ta bort åtkomst till en mapp SharePoint ett bibliotek som du har identifierat som ursprung. Det gör du med cmdleten Remove-PnPTenantCdnOrigin.

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

Information om hur du använder denna cmdlet finns i Remove-PnPTenantCdnOrigin.

Ändra ett ursprung i Office 365 CDN

Du kan inte ändra ett ursprung som du har skapat. Ta istället bort ursprunget och lägg sedan till ett nytt. Mer information finns i Ta bort ett ursprung från Office 365 CDN Lägga till ett ursprung för dina tillgångar.

Inaktivera Office 365 CDN

Använd cmdleten Set-PnPTenantCdnEnabled till att inaktivera CDN för organisationen. Om du har aktiverat både offentliga och privata ursprung för CDN, måste du köra cmdleten två gånger enligt följande exempel.

Inaktivera användningen av offentliga ursprung i CDN genom att ange följande kommando:

Set-PnPTenantCdnEnabled -CdnType Public -Enable $false

Inaktivera användningen av privata ursprung i CDN genom att ange följande kommando:

Set-PnPTenantCdnEnabled -CdnType Private -Enable $false

Mer information om den här cmdleten finns i Set-PnPTenantCdnEnabled.

Konfigurera och konfigurera Office 365 CDN med hjälp av Office 365 CLI

För procedurerna i det här avsnittet krävs att du har installerat Office 365 CLI. Anslut sedan till Office 365 klientorganisation med kommandot inloggning.

Utför de här stegen för att konfigurera och konfigurera CDN att lagra dina tillgångar i SharePoint Online med hjälp av Office 365 CLI.

Klicka för att Visa

Aktivera Office 365 CDN

Du kan hantera statusen för Office 365 CDN klientorganisation med hjälp av kommandot för spo cdn-uppsättning.

Så här aktiverar Office 365 offentliga CDN i klientorganisationen:

spo cdn set --type Public --enabled true

Om du vill aktivera Office 365 SharePoint CDN kör du:

spo cdn set --type Private --enabled true

Visa aktuell status för Office 365 CDN

För att kontrollera om den specifika typen Office 365 CDN är aktiverad eller inaktiverad, använder du kommandot spo cdn get.

För att kontrollera om Office 365 offentliga CDN är aktiverad kör du:

spo cdn get --type Public

Visa Office 365 CDN ursprung

Om du vill visa de Office 365 offentliga CDN körs:

spo cdn origin list --type Public

Se Standard CDN ursprung för information om ursprung som är etablerade som standard när du aktiverar Office 365 CDN.

Lägga till ett Office 365 CDN ursprung

Viktigt

Du ska aldrig placera resurser som anses vara känsliga för organisationen i ett SharePoint-dokumentbibliotek som konfigurerats som ett offentligt ursprung.

Använd lägg till ett spo cdn-ursprung för att definiera ett CDN ursprung. Du kan definiera flera ursprung. Ursprunget är en URL-adress som pekar på SharePoint bibliotek eller mapp som innehåller tillgångarna som du vill ska lagras av CDN.

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

Var path finns den relativa sökvägen till mappen som innehåller tillgångarna. Du kan använda jokertecken utöver relativa sökvägar.

Om du vill ta med alla tillgångar i huvudsidesgalleriet för alla webbplatser som ett offentligt ursprung kör du:

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

Om du vill konfigurera ett privat ursprung för en viss webbplatssamling kör du:

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

Anteckning

När du har CDN ett ursprung kan det ta upp till 15 minuter innan du kan hämta filer via CDN tjänsten. Du kan kontrollera om det specifika ursprunget redan har aktiverats med hjälp av kommandot för spo cdn-ursprung.

Ta bort ett Office 365 CDN ursprung

Använd kommandot ta bort spo cdn-ursprung för att ta bort ett CDN ursprung för den angivna CDN typen.

Om du vill ta bort ett offentligt ursprung CDN konfigurationen kör du:

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

Anteckning

När du tar CDN ett ursprung påverkas inte de filer som lagrats i något dokumentbibliotek som matchar ursprunget. Om tillgångarna har refererats med sina URL-SharePoint, växlar SharePoint automatiskt tillbaka till den ursprungliga URL:en som pekar till dokumentbiblioteket. Om däremot tillgångar har refererats med en offentlig URL CDN bryts länken om du tar bort ursprunget och du måste ändra dem manuellt.

Ändra ett Office 365 CDN ursprung

Det går inte att ändra ett befintligt CDN ursprung. I stället bör du ta bort det tidigare CDN ursprunget med kommandot spo cdn origin remove och lägga till ett nytt med hjälp av spo cdn origin add kommandot.

Ändra vilka typer av filer som ska ingå i Office 365 CDN

Som standard ingår följande filtyper i CDN: .css, .eot, .gif, .ico, .jpeg, .jpg, .js, .map, .png, .svg, .ttf, .woff och .woff2. Om du behöver ta med ytterligare filtyper i CDN kan du CDN konfiguration med hjälp av kommandot för spo cdn-principuppsättning.

Anteckning

När du ändrar listan över filtyper skriver du över den aktuella definierade listan. Om du vill ta med ytterligare filtyper använder du först spo cdn-principlistan för att ta reda på vilka filtyper som är konfigurerade.

Om du vill lägga till JSON-filtypen i standardlistan över filtyper som ingår i den offentliga CDN kör du:

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

Ändra listan över webbplatsklassificeringarna som du vill utesluta från Office 365 CDN

Använd kommandot för spo cdn-principuppsättningen för att utesluta webbplatsklassificering som du inte vill ska vara tillgängliga via CDN. Som standard utesluts inga webbplatsklassificeringar.

Anteckning

När du ändrar listan med undantagna webbplatsklassificeringar skriver du över den definierade listan. Om du vill utesluta ytterligare klassificeringar använder du först listkommandot för spo cdn-principen för att ta reda på vilka klassificeringar som är konfigurerade.

Om du vill utesluta webbplatser som klassificerats som HBI från den offentliga CDN ska du utföra

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

Inaktivera Office 365 CDN

Om du vill Office 365 CDN du spo cdn set använda kommandot, till exempel:

spo cdn set --type Public --enabled false

Använda dina CDN tillgångar

Nu när du har aktiverat CDN och konfigurerade ursprung och principer kan du börja använda dina CDN tillgångar.

Det här avsnittet hjälper dig att förstå hur du använder URL-adresser för CDN på dina SharePoint-sidor och innehåll så att SharePoint omdirigerar förfrågningar om tillgångar i både offentliga och privata ursprung till CDN.

Information om hur du använder CDN för värd för klientwebbdelar finns i avsnittet Värd för din klientwebbdel från Office 365 CDN (Hello World del 4).

Anteckning

Om du lägger till mappen ClientSideAssets i CDN privata ursprungslista går det CDN anpassade webbdelar som är värd inte att återges. Filer som används av SPFX-webbdelar kan endast använda offentliga CDN och mappen ClientSideAssets är ett standard ursprung för offentliga CDN.

Om du vill använda tillgångar som du har lagt till i ett ursprung uppdaterar du bara länkar till den ursprungliga filen med sökvägen till filen i ursprunget.

  • Redigera sidan eller innehållet som innehåller länkar till tillgångar som du har lagt till i ett ursprung. Du kan också använda en av flera metoder för att globalt söka och ersätta länkar över en ange webbplats eller webbplatssamling om du vill uppdatera länken till en viss tillgång överallt där den visas.
  • För varje länk till en tillgång i ett ursprung ersätter du sökvägen med sökvägen till filen i CDN ursprung. Du kan använda relativa sökvägar.
  • Spara sidan eller innehållet.

Överväg till exempel bilden /site/SiteAssets/images/image.png, som du har kopierat till dokumentbiblioteksmappen /site/CDN_origins/public/. Om du vill använda CDN-tillgången ersätter du den ursprungliga sökvägen till bildfilens plats med sökvägen till ursprunget för att göra den nya URL:en /webbplats/CDN_origins/offentlig/image.png.

Om du vill använda den fullständiga URL:en till tillgången i stället för en relativ sökväg skapar du länken så här:

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

Anteckning

I allmänhet bör du inte hårdkoda URL-adresser direkt till tillgångar i CDN. Om det behövs kan du dock manuellt skapa URL-adresser för tillgångar i offentliga ursprung. Mer information finns i Hardcoding CDN URL:er för offentliga tillgångar.

Mer information om hur du verifierar att tillgångar kommer från CDN finns i Hur bekräftar jag att tillgångarna CDN? i Felsökning av Office 365 CDN.

Använda tillgångar i offentliga ursprung

Publiceringsfunktionen i SharePoint Online skriver automatiskt om URL-adresser för tillgångar som lagras i offentliga ursprung till sina CDN-motsvarigheter så att tillgångar hämtas från CDN-tjänsten i stället för SharePoint.

Om ditt ursprung är på en webbplats där publiceringsfunktionen är aktiverad och tillgångarna du vill lägga i förs över till CDN finns i någon av följande kategorier skriver SharePoint automatiskt om URL-adresser för tillgångar i ursprunget, förutsatt att tillgången inte har uteslutits av en CDN-princip.

Nedan följer en översikt över vilka länkar som automatiskt skrivs om av SharePoint Publiceringsfunktion:

  • HTML-svar för IMG/LINK/CSS
    • Det omfattar bilder som har lagts till av författare i HTML-innehåll på en sida
  • URL-adresser för webbdelen Bildspel för bildbibliotek
  • Bildfält i SPList REST API-resultat (RenderListDataAsStream)
    • Använda den nya egenskapen ImageFieldsToTryRewriteToCdnUrls till att ange en kommaavgränsad lista med fält
    • Stöd för hyperlänkfält och publiceringsbildfält
  • SharePoint bildåtergivningar

Följande diagram visar arbetsflödet när en SharePoint får en begäran om en sida som innehåller tillgångar från ett offentligt ursprung.

Arbetsflödesdiagram: Hämtar Office 365 CDN tillgångar från ett offentligt ursprung.

Tips

Om du vill inaktivera automatisk omskrivning av specifika URL:er på en sida kan du gå till sidan och lägga till frågesträngparametern ? NoAutoReWrites=true i slutet av varje länk du vill inaktivera.

Konstruera CDN URL:er för offentliga tillgångar

Om funktionen Publicera inte är aktiverad för ett offentligt ursprung, eller om tillgången inte är en av de länktyper som stöds av funktionen för automatisk omskrivning i CDN-tjänsten, kan du manuellt skapa URL-adresser till tillgångarnas CDN-plats och använda url:erna i innehållet.

Anteckning

Du kan inte hårdkoda eller skapa CDN URL-adresser till tillgångar i ett privat ursprung eftersom den obligatoriska åtkomsttoken som utgör url-adressens sista avsnitt genereras när resursen begärs. Du kan skapa URL-adressen för offentliga CDN och URL-adressen ska inte vara hårdkodad eftersom den kan komma att ändras.

För offentliga CDN tillgångar ser URL-formatet ut så här:

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

Ersätt TenantHostName med ditt klientnamn. Exempel:

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

Anteckning

Sidsammanhangsegenskapen ska användas för att skapa prefixet i stället för hårdkodning " https://publiccdn.sharepointonline.com ". URL-adressen kan komma att ändras och ska inte vara hårdkodad. Om du använder visningsmallar med Classic SharePoint Online kan du använda egenskapen "window._spPageContextInfo.publicCdnBaseUrl" i visningsmallen för prefixet på URL-adressen. Om du är SPFx-webbdelar för moderna och klassiska SharePoint kan du använda egenskapen "this.context.pageContext.legacyPageContext.publicCdnBaseUrl". Det ger prefixet så att din implementering uppdateras med den om den ändras. Som exempel för SPFx kan URL-adressen skapas med egenskapen "this.context.pageContext.legacyPageContext.publicCdnBaseUrl" + "/" + "host" + "/" + "relativeURL för objektet". Se Använda CDN i Klientkod som är en del av prestandaserien för säsong 1

Använda tillgångar i privata ursprung

Ingen ytterligare konfiguration krävs för att använda tillgångar i privata ursprung. SharePoint Online skriver automatiskt om URL-adresser för tillgångar i privata ursprung, så förfrågningar om dessa tillgångar kommer alltid att hämtas från CDN. Du kan inte skapa URL-adresser manuellt till CDN-tillgångar i privata ursprung eftersom dessa URL:er innehåller token som måste skapas automatiskt av SharePoint Online när tillgången begärs.

Åtkomst till tillgångar i privata ursprung skyddas av dynamiskt genererade token baserat på användarbehörigheter till ursprunget, med de varningar som beskrivs i följande avsnitt. Användarna måste ha minst läsbehörighet till ursprungen för att CDN återge innehåll.

Följande diagram visar arbetsflödet när en SharePoint får en begäran om en sida som innehåller tillgångar från ett privat ursprung.

Arbetsflödesdiagram: Hämtar Office 365 CDN tillgångar från ett privat ursprung.

Tokenbaserad auktorisering i privata ursprung

Åtkomst till tillgångar i privata ursprung i Office 365 CDN tilldelas med token som genereras av SharePoint Online. Användare som redan har åtkomst till mappen eller biblioteket som anges av ursprunget tilldelas automatiskt token som tillåter användaren att komma åt filen baserat på deras behörighetsnivå. Dessa åtkomsttoken är giltiga i 30 till 90 minuter efter att de har skapats för att förhindra attacker vid tokenuppspelning.

När åtkomsttoken har skapats returnerar SharePoint Online en anpassad URI till klienten som innehåller två auktoriseringsparametrar äter (edge authorization token) och oat (origin authorization token). Strukturen för varje token är< förfallotid i Epoch-tidsformatet som är >__< signaturens säkra >. Till exempel:

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

Anteckning

Alla som äger token kan komma åt resursen i CDN. Url-adresser som innehåller dessa åtkomsttoken delas däremot bara över HTTPS, så om inte URL-adressen uttryckligen delas av en slutanvändare innan tokenen löper ut kommer tillgången inte att vara tillgänglig för obehöriga användare.

Behörigheter på objektnivå stöds inte för tillgångar i privata ursprung

Det är viktigt att observera att SharePoint Online inte har stöd för behörigheter på objektnivå för tillgångar i privata ursprung. För en fil som finns på https://contoso.sharepoint.com/sites/site1/library1/folder1/image1.jpg , har användarna till exempel effektiv åtkomst till filen enligt följande villkor:

Användare Behörigheter Effektiv åtkomst
Användare 1 Har åtkomst till mapp1 Kan komma image1.jpg från CDN
Användare 2 Har inte åtkomst till mapp1 Det går inte image1.jpg åtkomst från CDN
Användare 3 Har inte åtkomst till mapp1, men tilldelas uttrycklig åtkomstbehörighet för image1.jpg i SharePoint Online Kan komma åt image1.jpg direkt SharePoint Online, men inte från CDN
Användare 4 Har åtkomst till mapp1, men har uttryckligen nekats åtkomst till image1.jpg i SharePoint Online Det går inte att komma åt tillgången från SharePoint Online, men kan komma åt tillgången från CDN trots att åtkomst till filen nekas i SharePoint Online

Felsöka Office 365 CDN

Hur bekräftar jag att tillgångar används av CDN?

När du har lagt till länkar till CDN-tillgångar på en sida kan du bekräfta att tillgången kommer från CDN genom att gå till sidan, högerklicka på bilden när den har återgets och granskar bild-URL:en.

Du kan också använda webbläsarens utvecklarverktyg för att visa URL-adressen för varje tillgång på en sida, eller använda ett nätverksspårningsverktyg från tredje part.

Anteckning

Om du använder ett nätverksverktyg, till exempel Fiddler, för att testa dina tillgångar utanför att återge tillgången från en SharePoint-sida, måste du manuellt lägga till refererhuvudet "Referer: " i Get https://yourdomain.sharepoint.com request where the URL is the root URL of your SharePoint Online tenant.

Du kan inte CDN url-adresser direkt i en webbläsare eftersom du måste ha en SharePoint Online. Men om du lägger till URL CDN för CDN-tillgång på en SharePoint-sida och sedan öppnar sidan i en webbläsare, ser du CDN tillgång återges på sidan.

Mer information om hur du använder utvecklarverktygen i webbläsaren Microsoft Edge finns i Microsoft Edge Utvecklarverktyg.

Om du vill titta på en kort video som finns i youTube-kanalen SharePoint Developer Patterns och Practices som visar hur du verifierar att din CDN fungerar kan du gå till Verifiera din CDN-användning och säkerställa optimal nätverksanslutning.

Varför är tillgångar från ett nytt ursprung inte tillgängliga?

Tillgångar i nya ursprung blir inte omedelbart tillgängliga för användning eftersom det tar tid för registreringen att spridas genom CDN och för att tillgångarna ska laddas upp från ursprunget till CDN lagring. Tiden som krävs för att tillgångar ska vara tillgänglig i CDN beror på hur många tillgångar och filstorlekar.

Min klientwebbdel eller SharePoint Framework inte fungerar

När du aktiverar Office 365 CDN för offentliga ursprung skapas CDN ursprung automatiskt:

  • */MASTERPAGE
  • */STYLE LIBRARY
  • */CLIENTSIDEASSETS

Om ursprunget */clientsideassets saknas kommer SharePoint Framework misslyckas och inga varningar eller felmeddelanden skapas. Det här ursprunget kan saknas antingen eftersom CDN var aktiverat med parametern -NoDefaultOrigins inställt på $true, eller för att ursprunget togs bort manuellt.

Du kan kontrollera vilka ursprung som finns med följande PowerShell-kommando:

Get-SPOTenantCdnOrigins -CdnType Public

Du kan också kontrollera med Office 365 CLI:

spo cdn origin list

Så här lägger du till ursprunget i PowerShell:

Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */CLIENTSIDEASSETS

Så här lägger du till ursprunget i Office 365 CLI:

spo cdn origin add --origin */CLIENTSIDEASSETS

Vilka PowerShell-moduler och CLI-gränssnitt behöver jag arbeta med Office 365 CDN?

Du kan välja att arbeta med Office 365 CDN med hjälp SharePoint Online Management Shell PowerShell-modulen eller Office 365 CLI.

Se även

Nätverk för innehållsleverans (CDN)

Network planning and performance tuning for Office 365

SharePoint Performance Series – Office 365 CDN videoserie