Megosztás a következőn keresztül:

A Office 365 Content Delivery Network (CDN) használata a SharePoint Online-nal

  • Cikk

A beépített Office 365 Content Delivery Network (CDN) segítségével statikus objektumokat üzemeltethet, hogy jobb teljesítményt nyújtson a SharePoint Online-lapok számára. A Office 365 CDN javítja a teljesítményt azáltal, hogy a statikus objektumokat a kérő böngészőkhöz közelebb gyorsítótáraz, ami segít felgyorsítani a letöltéseket és csökkenteni a késést. Emellett a Office 365 CDN a HTTP/2 protokollt használja a jobb tömörítéshez és a HTTP-pipelininghez. A Office 365 CDN szolgáltatás a SharePoint Online-előfizetés részeként érhető el.

Figyelem!

Mivel a rendszerképek kezelése mostantól automatikusan történik egy SharePoint Online szolgáltatás által felügyelt privát CDN-ben, a manuálisan konfigurált privát CDN elavult. Ez a viselkedés azt jelenti, hogy az ügyfeleknek már nem kell privát CDN-t konfigurálnia. Az ajánlott eljárás változatlan marad, mivel a rendszerképek automatikusan a szolgáltatás által felügyelt privát CDN-en keresztül futnak. A nyilvános CDN továbbra is elérhető minden más fájltípushoz (például CSS és JS). A privát CDN-t nem képekhez használó ügyfeleknek át kell helyeznie ezeket a fájlokat a nyilvános CDN-be. A teljesítmény növelése érdekében a nyilvános CDN-t javasoljuk ezekhez a fájltípusokhoz.

Megjegyzés:

A Office 365 CDN csak a production (worldwide) felhőben lévő bérlők számára érhető el. Az USA kormányzati és kínai felhőinek bérlői jelenleg nem támogatják a Office 365 CDN-t.

A Office 365 CDN több CDN-ből áll, amelyek lehetővé teszik, hogy statikus objektumokat tároljon több helyen vagy forrásban, és globális nagy sebességű hálózatokból szolgálja ki őket. Attól függően, hogy milyen típusú tartalmat szeretne üzemeltetni a Office 365 CDN-ben, hozzáadhat nyilvános forrásokat, privát forrásokat vagy mindkettőt. A nyilvános és a privát források közötti különbségről további információt a Válassza ki, hogy az egyes forrásoknak nyilvánosnak vagy privátnak kell-e lenniük című témakörben talál.

Office 365 CDN fogalmi diagramja.

Ha már ismeri a CDN-ek működését, csak néhány lépést kell elvégeznie ahhoz, hogy engedélyezze a Office 365 CDN-t a bérlő számára. Ez a cikk azt ismerteti, hogyan. További információ a statikus objektumok üzemeltetésének első lépéseiről.

Tipp

Léteznek más, a Microsoft által üzemeltetett CDN-ekkel is, amelyek speciális használati forgatókönyvekhez használhatók Office 365, de a jelen témakörben nem tárgyaljuk őket, mert kívül esnek a Office 365 CDN hatókörén. További információ: Egyéb Microsoft CDN-ek.

Lépjen vissza a hálózattervezéshez és teljesítményhangoláshoz a Office 365.

A Office 365 CDN használata a SharePoint Online-ban – áttekintés

A Office 365 CDN beállításához kövesse az alábbi alapvető lépéseket:

Ha végzett a beállítással, a következő lépésekkel kezelheti a Office 365 CDN-t:

  • Objektumok hozzáadása, frissítése és eltávolítása
  • Források hozzáadása és eltávolítása
  • CDN-szabályzatok konfigurálása
  • Ha szükséges, tiltsa le a CDN-t

Végül tekintse meg A CDN-eszközök használata című témakört, amelyből megtudhatja, hogyan férhet hozzá a CDN-eszközökhöz mind a nyilvános, mind a privát forrásból.

A gyakori problémák megoldásához lásd: A Office 365 CDN hibaelhárítása.

A Office 365 CDN üzembe helyezésének megtervezése

Mielőtt üzembe helyezené a Office 365 CDN-t a Office 365-bérlőhöz, a tervezési folyamat részeként vegye figyelembe az alábbi tényezőket.

A CDN-en üzemeltetni kívánt statikus objektumok meghatározása

Általánosságban elmondható, hogy a CDN-ek a leghatékonyabbak statikus vagy nem gyakran változó objektumok üzemeltetésére. Egy jó hüvelykujjszabály az, hogy azonosítsa azokat a fájlokat, amelyek megfelelnek az alábbi feltételeknek:

  • A lapba ágyazott statikus fájlok (például szkriptek és képek), amelyek jelentős hatással lehetnek az oldalbetöltési időkre.
  • Nagyméretű fájlok, például végrehajtható fájlok és telepítési fájlok.
  • Ügyféloldali kódot támogató erőforrástárak.

Az ismétlődően kért kis fájlok (webhelyképek és parancsfájlok) CDN-forráshoz való hozzáadása például jelentősen javíthatja a webhelymegjelenítési teljesítményt, és növekményesen csökkentheti a SharePoint Online-webhelyek terhelését. A nagyobb fájlok (telepítő végrehajtható fájlok) letölthetők a CDN-ből, ami pozitív hatással van a teljesítményre, és később csökkenti a SharePoint Online-webhely terhelését, még akkor is, ha nem érik el őket olyan gyakran.

A teljesítmény fájlonkénti javulása számos tényezőtől függ, például az ügyfélnek a legközelebbi CDN-végponthoz való közelségétől, a helyi hálózat átmeneti feltételeitől stb. Sok statikus fájl kicsi, és kevesebb mint egy másodperc alatt letölthető Office 365. A weblapok azonban sok beágyazott fájlt tartalmazhatnak, amelyek összesített letöltési ideje néhány másodperc. Ezeknek a fájloknak a CDN-ből való kiszolgálása jelentősen csökkentheti a lapbetöltés teljes idejét. Példa: Milyen teljesítménynövekedést biztosít a CDN?

Annak meghatározása, hogy hol szeretné tárolni az objektumokat

A CDN egy forrásnak nevezett helyről kéri le az objektumokat. A forrás lehet egy URL-címmel elérhető SharePoint-webhely, dokumentumtár vagy mappa. Nagy rugalmasságot biztosít, ha megadja a szervezet forrását. Megadhat például több forrást vagy egyetlen forrást, ahová az összes CDN-adategységet el szeretné helyezni. Dönthet úgy, hogy nyilvános vagy privát forrással is rendelkezik a szervezet számára. A legtöbb szervezet úgy dönt, hogy a kettő kombinációját valósítja meg.

Létrehozhat új tárolót a forrásokhoz, például mappákhoz vagy dokumentumtárakhoz, és hozzáadhatja a CDN-ből elérhetővé tenni kívánt fájlokat. Ez egy jó módszer a CDN-ből elérhetővé tenni kívánt adategységek adott készletéhez, és a CDN-adategységek készletét csak a tárolóban lévő fájlokra szeretné korlátozni.

A meglévő webhelycsoportokat, webhelyeket, tárakat vagy mappákat forrásként is konfigurálhatja, így a tárolóban lévő összes jogosult adategység elérhetővé válik a CDN-ből. Mielőtt hozzáad egy meglévő tárolót forrásként, fontos, hogy tisztában legyen annak tartalmával és engedélyeivel, hogy véletlenül ne tegye elérhetővé az objektumokat névtelen hozzáférés vagy jogosulatlan felhasználók számára.

A CDN-szabályzatokkal kizárhatja a forrásban lévő tartalmakat a CDN-ből. A CDN-házirendek kizárják a nyilvános vagy privát eredetű objektumokat attribútumok, például fájltípus és webhelybesorolás alapján, és a házirendben megadott CdnType (magán- vagy nyilvános) összes forrására érvényesek. Ha például egy több alwebhelyet tartalmazó webhelyből álló privát forrást ad hozzá, megadhat egy szabályzatot, amely kizárja a Bizalmasként megjelölt webhelyeket, így az ilyen besorolású webhelyek tartalmai nem lesznek kiszolgálva a CDN-ből. A szabályzat a CDN-hez hozzáadott összes privát forrásból származó tartalomra vonatkozik.

Ne feledje, hogy minél nagyobb a források száma, annál nagyobb hatással van arra az időre, amellyel a CDN szolgáltatás feldolgozhatja a kéréseket. Javasoljuk, hogy a lehető legnagyobb mértékben korlátozza a források számát.

Válassza ki, hogy az egyes források nyilvánosak vagy privátak legyenek-e

Ha azonosít egy forrást, meg kell adnia, hogy nyilvánossá vagy privátsá kell-e tenni. A nyilvános forrásokban lévő CDN-objektumokhoz való hozzáférés névtelen, a privát eredetű CDN-tartalmakat pedig dinamikusan generált jogkivonatok védik a nagyobb biztonság érdekében. Függetlenül attól, hogy melyik lehetőséget választja, a Microsoft mindent megtesz a CDN adminisztrációja során. A CDN beállítása és a forrás azonosítása után később is meggondolhatja magát.

A nyilvános és a privát lehetőségek is hasonló teljesítménynövekedést biztosítanak, de mindegyik egyedi attribútumokkal és előnyökkel rendelkezik.

A Office 365 CDN-en belüli nyilvános források névtelenül érhetők el, és az üzemeltetett eszközöket bárki elérheti, aki rendelkezik az objektum URL-címével. Mivel a nyilvános forrásokban lévő tartalmakhoz való hozzáférés névtelen, csak nem érzéketlen általános tartalmak, például JavaScript-fájlok, parancsfájlok, ikonok és képek gyorsítótárazására használható.

A Office 365 CDN privát forráskódjai privát hozzáférést biztosítanak a felhasználói tartalmakhoz, például a SharePoint Online-dokumentumtárakhoz, webhelyekhez és jogvédett képekhez. A privát forrásokban lévő tartalmakhoz való hozzáférést dinamikusan generált jogkivonatok védik, így csak az eredeti dokumentumtárhoz vagy tárhelyhez engedélyekkel rendelkező felhasználók férhetnek hozzá. A Office 365 CDN-ben található privát források csak SharePoint Online-tartalmakhoz használhatók, és a SharePoint Online-bérlőről való átirányítással csak privát forrásokban lévő objektumokhoz férhet hozzá.

A CDN privát eredetű objektumokhoz való hozzáféréséről az Eszközök használata privát forrásokban című témakörben olvashat bővebben.

A nyilvános forrásokban található eszközök üzemeltetésének attribútumai és előnyei

  • A nyilvános forrásokban közzétett eszközöket mindenki névtelenül érheti el.

    Fontos

    Soha ne helyezzen el olyan erőforrásokat, amelyek felhasználói adatokat tartalmaznak, vagy amelyek bizalmasnak minősülnek a szervezet számára egy nyilvános forrásban.

  • Ha eltávolít egy objektumot egy nyilvános forrásból, előfordulhat, hogy az eszköz legfeljebb 30 napig lesz elérhető a gyorsítótárból; azonban 15 percen belül érvénytelenítjük az adategységre mutató hivatkozásokat a CDN-ben.

  • Ha stíluslapokat (CSS-fájlokat) üzemeltet egy nyilvános forrásban, relatív elérési utakat és URI-kat használhat a kódban. Ez az eredmény azt jelenti, hogy hivatkozhat a háttérképek és más objektumok helyére az azt meghívó objektum helyéhez viszonyítva.

  • Bár létrehozhatja egy nyilvános forrás URL-címét, körültekintően járjon el, használja a lapkörnyezet tulajdonságát, és kövesse az útmutatást ehhez. Ha a CDN-hez való hozzáférés elérhetetlenné válik, az URL-cím nem oldja fel automatikusan a szervezet számára a SharePoint Online-ban, és hibás hivatkozásokat és egyéb hibákat okozhat. Az URL-cím is változhat, ezért nem szabad nehéz az aktuális értékre kódba tenni.

  • A nyilvános források alapértelmezett fájltípusai a következők: , , , , , , .jpg, .js.svg.ttf.png.woff.mapés ..woff2.jpeg.ico.gif.eot.css További fájltípusokat is megadhat.

  • Konfigurálhat olyan szabályzatot, amely kizárja az objektumokat a megadott webhelybesorolások alapján. Kizárhat például minden olyan objektumot, amely "bizalmas" vagy "korlátozott" jelöléssel rendelkezik, még akkor is, ha engedélyezett fájltípus, és nyilvános forrásban találhatók.

A privát eredetű objektumok üzemeltetésének attribútumai és előnyei

  • A privát források csak SharePoint Online-objektumokhoz használhatók.

  • A felhasználók csak akkor férhetnek hozzá az objektumokhoz egy privát forrásból, ha rendelkeznek a tároló elérésére vonatkozó engedélyekkel. Ezekhez az objektumokhoz nem lehet névtelenül hozzáférni.

  • A privát forrásokban lévő eszközöket a SharePoint Online-bérlőből kell átirányítani. A privát CDN-objektumokhoz való közvetlen hozzáférés nem működik.

  • Ha eltávolít egy objektumot a privát forrásból, előfordulhat, hogy az objektum akár egy óráig is elérhető lesz a gyorsítótárból. A CDN-ben lévő objektumra mutató hivatkozások azonban az eszköz eltávolításától számított 15 percen belül érvénytelenek.

  • A privát források alapértelmezett fájltípusai a következők: .gif, .ico, .jpeg, .jpg, .js és .png. További fájltípusokat is megadhat.

  • A nyilvános forrásokhoz hasonlóan konfigurálhat egy házirendet is, amely kizárja a megadott webhelybesorolások által azonosított objektumokat, még akkor is, ha helyettesítő karakterekkel foglalja bele az összes objektumot egy mappába vagy dokumentumtárba.

A Office 365-bérlőjével használható Office 365 CDN-ekkel, általános CDN-fogalmakkal és egyéb Microsoft CDN-ekkel kapcsolatos további információkért lásd: Tartalomkézbesítési hálózatok.

Alapértelmezett CDN-források

Ha másként nem adja meg, Office 365 beállít néhány alapértelmezett forrást az Office 365 CDN engedélyezésekor. Ha kezdetben úgy dönt, hogy nem építi ki őket, a telepítés befejezése után hozzáadhatja ezeket a forrásokat. Ha nem ismeri az alapértelmezett források beállításának kihagyásának következményeit, és nincs konkrét oka ennek, engedélyeznie kell a létrehozásukat a CDN engedélyezésekor.

Alapértelmezett privát CDN-források:

  • */siteassets

Alapértelmezett nyilvános CDN-források:

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

Megjegyzés:

A clientsideassets egy alapértelmezett nyilvános forrás, amely 2017 decemberében lett hozzáadva a Office 365 CDN szolgáltatáshoz. Ennek a forrásnak jelen kell lennie ahhoz, hogy a CDN-ben SharePoint-keretrendszer megoldások működjenek. Ha 2017 decembere előtt engedélyezte a Office 365 CDN-t, vagy ha a CDN engedélyezésekor kihagyta az alapértelmezett források beállítását, manuálisan hozzáadhatja ezt az forrást. További információ: Az ügyféloldali kijelző vagy SharePoint-keretrendszer megoldás nem működik.

A Office 365 CDN beállítása és konfigurálása a SharePoint Online felügyeleti rendszerhéj használatával

Az ebben a szakaszban ismertetett eljárások megkövetelik, hogy a SharePoint Online felügyeleti rendszerhéj használatával csatlakozzon a SharePoint Online-hoz. Útmutatásért lásd: Csatlakozás a SharePoint Online-hoz PowerShell.

Ezeket a lépéseket követve állítsa be és konfigurálja a CDN-t az objektumok SharePoint Online-ban való üzemeltetéséhez a SharePoint Online felügyeleti rendszerhéj használatával.

Kijelölés a kibontásához

A Office 365 CDN használatának engedélyezése a szervezet számára

A bérlői CDN-beállítások módosítása előtt le kell kérnie a privát CDN-konfiguráció aktuális állapotát a Office 365 bérlőben. Csatlakozzon a bérlőhöz a SharePoint Online felügyeleti rendszerhéj használatával:

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

Most használja a Get-SPOTenantCdnEnabled parancsmagot a CDN állapotbeállításainak lekéréséhez a bérlőtől:

Get-SPOTenantCdnEnabled -CdnType <Public | Private>

A megadott CdnType CDN-jének állapota megjelenik a képernyőn.

A Set-SPOTenantCdnEnabled parancsmaggal engedélyezheti a szervezet számára a Office 365 CDN használatát. Engedélyezheti a szervezet számára, hogy egyszerre használjon nyilvános forrást, privát forrást vagy mindkettőt. A CDN-t úgy is konfigurálhatja, hogy az engedélyezéskor kihagyja az alapértelmezett források beállítását. Ezeket a forrásokat később is felveheti a cikkben leírtak szerint.

A SharePoint Online-hoz készült Windows PowerShell:

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

Ha például engedélyezni szeretné, hogy a szervezet nyilvános és privát forrást is használjon, írja be a következő parancsot:

Set-SPOTenantCdnEnabled -CdnType Both -Enable $true

Ha azt szeretné, hogy a szervezet nyilvános és privát forrásokat is használhasson, de ne állítsa be az alapértelmezett forrásokat, írja be a következő parancsot:

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

A cdn-Office 365 engedélyezésekor alapértelmezés szerint kiépített forrásokkal, valamint az alapértelmezett forrásbeállítások kihagyásának lehetséges hatásával kapcsolatos információkért lásd: Alapértelmezett CDN-források.

Ha engedélyezni szeretné a szervezet számára a nyilvános források használatát, írja be a következő parancsot:

Set-SPOTenantCdnEnabled -CdnType Public -Enable $true

Ha engedélyezni szeretné a szervezet számára a privát források használatát, írja be a következő parancsot:

Set-SPOTenantCdnEnabled -CdnType Private -Enable $true

További információ erről a parancsmagról: Set-SPOTenantCdnEnabled.

A Office 365 CDN-be felvenni kívánt fájltípusok listájának módosítása (nem kötelező)

Tipp

Ha a Set-SPOTenantCdnPolicy parancsmaggal definiál fájltípusokat, felülírja az aktuálisan definiált listát. Ha további fájltípusokat szeretne hozzáadni a listához, először a parancsmaggal állapítsa meg, hogy mely fájltípusok engedélyezettek, és vegye fel őket a listára az újakkal együtt.

A Set-SPOTenantCdnPolicy parancsmaggal határozhatja meg a nyilvános és privát források által üzemeltethető statikus fájltípusokat a CDN-ben. Alapértelmezés szerint a gyakori objektumtípusok engedélyezettek, például .css, .gif, .jpg és .js.

A SharePoint Online-hoz készült Windows PowerShell:

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

Ha például engedélyezni szeretné, hogy a CDN .css és .png fájlokat tároljon, írja be a következő parancsot:

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

A CDN által jelenleg engedélyezett fájltípusok megtekintéséhez használja a Get-SPOTenantCdnPolicies parancsmagot:

Get-SPOTenantCdnPolicies -CdnType <Public | Private>

További információ ezekről a parancsmagokról: Set-SPOTenantCdnPolicy és Get-SPOTenantCdnPolicies.

A Office 365 CDN-ből kizárni kívánt webhelybesorolások listájának módosítása (nem kötelező)

Tipp

Ha a Set-SPOTenantCdnPolicy parancsmaggal kizárja a webhelybesorolásokat, felülírja az aktuálisan definiált listát. Ha további webhelybesorolásokat szeretne kizárni, először a parancsmaggal állapítsa meg, hogy mely besorolások vannak már kizárva, majd adja hozzá őket az újakkal együtt.

A Set-SPOTenantCdnPolicy parancsmaggal zárja ki azokat a webhelybesorolásokat, amelyeket nem szeretne elérhetővé tenni a CDN-en keresztül. Alapértelmezés szerint nincsenek kizárva webhelybesorolások.

A SharePoint Online-hoz készült Windows PowerShell:

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

A jelenleg korlátozott webhelybesorolások megtekintéséhez használja a Get-SPOTenantCdnPolicies parancsmagot:

Get-SPOTenantCdnPolicies -CdnType <Public | Private>

A visszaadott tulajdonságok: IncludeFileExtensions, ExcludeRestrictedSiteClassifications és ExcludeIfNoScriptDisabled.

Az IncludeFileExtensions tulajdonság tartalmazza a CDN által kiszolgált fájlkiterjesztések listáját.

Megjegyzés:

Az alapértelmezett fájlkiterjesztések különböznek a nyilvános és a privát fájltól.

Az ExcludeRestrictedSiteClassifications tulajdonság tartalmazza azokat a webhelybesorolásokat, amelyeket ki szeretne zárni a CDN-ből. Kizárhatja például a Bizalmasként megjelölt webhelyeket, így az ilyen besorolású webhelyek tartalmai nem lesznek kiszolgálva a CDN-ből.

Az ExcludeIfNoScriptDisabled tulajdonság a webhelyszintű NoScript attribútumbeállítások alapján kizárja a tartalmat a CDN-ből. A NoScript attribútum alapértelmezés szerint Engedélyezve a modern webhelyekhez és a Letiltva értékre van állítva a klasszikus webhelyek esetében. Ez a bérlői beállításoktól függ.

További információ ezekről a parancsmagokról: Set-SPOTenantCdnPolicy és Get-SPOTenantCdnPolicies.

Forrás hozzáadása az objektumokhoz

Forrás meghatározásához használja az Add-SPOTenantCdnOrigin parancsmagot. Több forrást is meghatározhat. A forrás egy OLYAN URL-cím, amely a CDN által üzemeltetni kívánt objektumokat tartalmazó SharePoint-tárra vagy -mappára mutat.

Fontos

Soha ne helyezzen el olyan erőforrásokat, amelyek felhasználói adatokat tartalmaznak, vagy amelyek bizalmasnak minősülnek a szervezet számára egy nyilvános forrásban.

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

Az elérési út értéke az objektumokat tartalmazó könyvtár vagy mappa relatív elérési útja. A relatív elérési utak mellett helyettesítő karaktereket is használhat. Az origins támogatja az URL-címhez előtagolt helyettesítő karaktereket. Ez lehetővé teszi, hogy több helyre kiterjedő forrásokat hozzon létre. Ha például az összes webhely masterpages mappájában lévő összes objektumot nyilvános forrásként szeretné szerepeltetni a CDN-ben, írja be a következő parancsot:

Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
  • A */ helyettesítő karakteres módosító csak az elérési út elején használható, és megfelel a megadott URL-cím összes URL-szegmensének.
  • Az elérési út egy dokumentumtárra, mappára vagy webhelyre mutathat. A */site1 elérési út például megegyezik a webhely összes dokumentumtárával.

Egy adott relatív elérési úttal rendelkező forrást adhat hozzá. Nem adhat hozzá forrást a teljes elérési úttal.

Ez a példa hozzáadja a siteassets kódtár privát forrását egy adott webhelyen:

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

Ez a példa hozzáadja a mappa1 mappa privát forrását a webhelycsoport webhelyeszközök tárába:

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

Ha az elérési út tartalmaz szóközt, az elérési utat idézőjelek között is elhelyezheti, vagy lecserélheti a szóközt a(z) %20 URL-kódolással. Az alábbi példák a webhelycsoport webhely-objektumtárában lévő 1. mappa magánjellegű forrását adhatja hozzá:

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

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

További információ erről a parancsról és szintaxisáról: Add-SPOTenantCdnOrigin.

Megjegyzés:

A privát forrásokban a forrásból megosztott objektumoknak közzé kell tenniük egy főverziót ahhoz, hogy elérhetők legyenek a CDN-ből.

A parancs futtatása után a rendszer szinkronizálja a konfigurációt az adatközpontban. Ez az eredmény akár 15 percet is igénybe vehet.

Példa: Nyilvános forrás konfigurálása a mesterlapokhoz és a Stílustárhoz a SharePoint Online-hoz

Ezek a források alapértelmezés szerint be vannak állítva, amikor engedélyezi a Office 365 CDN-t. Ha azonban manuálisan szeretné engedélyezni őket, kövesse az alábbi lépéseket.

  • Az Add-SPOTenantCdnOrigin parancsmaggal nyilvános forrásként definiálhatja a stílustárat.

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

  • Az Add-SPOTenantCdnOrigin parancsmaggal nyilvános forrásként definiálhatja a mesterlapokat.

    Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */masterpage

További információ erről a parancsról és szintaxisáról: Add-SPOTenantCdnOrigin.

A parancs futtatása után a rendszer szinkronizálja a konfigurációt az adatközpontban. Ez az eredmény akár 15 percet is igénybe vehet.

Példa: Privát forrás konfigurálása a sharePoint Online-beli webhelyeszközökhöz, webhelylapokhoz és közzétételi képekhez

  • Az Add-SPOTenantCdnOrigin parancsmaggal privát forrásként definiálhatja a helyegységek mappáját.

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */siteassets

  • Az Add-SPOTenantCdnOrigin parancsmaggal privát forrásként definiálhatja a webhelylapok mappát.

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */sitepages

  • Az Add-SPOTenantCdnOrigin parancsmaggal privát forrásként definiálhatja a közzétételi képek mappát.

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */publishingimages

További információ erről a parancsról és szintaxisáról: Add-SPOTenantCdnOrigin.

A parancs futtatása után a rendszer szinkronizálja a konfigurációt az adatközpontban. Ez az eredmény akár 15 percet is igénybe vehet.

Példa: Privát forrás konfigurálása webhelycsoporthoz a SharePoint Online-hoz

Az Add-SPOTenantCdnOrigin parancsmaggal privát forrásként definiálhat egy webhelycsoportot. Például:

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

További információ erről a parancsról és szintaxisáról: Add-SPOTenantCdnOrigin.

A parancs futtatása után a rendszer szinkronizálja a konfigurációt az adatközpontban. Előfordulhat, hogy megjelenik egy Függőben lévő konfiguráció üzenet. Ez az üzenet várhatóan akkor jelenik meg, amikor a SharePoint Online-bérlő csatlakozik a CDN szolgáltatáshoz. Ez az eredmény akár 15 percet is igénybe vehet.

A Office 365 CDN kezelése

A CDN beállítása után módosíthatja a konfigurációt a tartalom frissítése során vagy az igények változásakor, az ebben a szakaszban leírtak szerint.

Objektumok hozzáadása, frissítése vagy eltávolítása a Office 365 CDN-ből

A beállítási lépések elvégzése után bármikor hozzáadhat új objektumokat, és frissítheti vagy eltávolíthatja a meglévő objektumokat. Csak végezze el a módosításokat a forrásként azonosított mappában vagy SharePoint-tárban lévő objektumokon. Ha új objektumot ad hozzá, az azonnal elérhető lesz a CDN-en keresztül. Ha azonban frissíti az objektumot, az új példány propagálása és a CDN-ben való elérhetővé tétele akár 15 percet is igénybe vehet.

Ha le kell kérnie a forrás helyét, használhatja a Get-SPOTenantCdnOrigins parancsmagot. További információ a parancsmag használatáról: Get-SPOTenantCdnOrigins.

Forrás eltávolítása a Office 365 CDN-ből

A Remove-SPOTenantCdnOrigin parancsmaggal eltávolíthatja a forrásként azonosított mappákhoz vagy SharePoint-tárakhoz való hozzáférést.

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

További információ a parancsmag használatáról: Remove-SPOTenantCdnOrigin.

Forrás módosítása a Office 365 CDN-ben

A létrehozás után nem módosíthatja a forrást. Ehelyett távolítsa el a forrást, majd adjon hozzá egy újat. További információ: Forrás eltávolítása a Office 365 CDN-ből és Forrás hozzáadása az objektumokhoz.

A Office 365 CDN letiltása

A Set-SPOTenantCdnEnabled parancsmaggal tiltsa le a CDN-t a szervezet számára. Ha a CDN-hez mind a nyilvános, mind a privát forrás engedélyezve van, kétszer kell futtatnia a parancsmagot az alábbi példákban látható módon.

Ha le szeretné tiltani a nyilvános források használatát a CDN-ben, írja be a következő parancsot:

Set-SPOTenantCdnEnabled -CdnType Public -Enable $false

Ha le szeretné tiltani a privát források használatát a CDN-ben, írja be a következő parancsot:

Set-SPOTenantCdnEnabled -CdnType Private -Enable $false

További információ erről a parancsmagról: Set-SPOTenantCdnEnabled.

A Office 365 CDN beállítása és konfigurálása a PnP PowerShell használatával

Az ebben a szakaszban ismertetett eljárások megkövetelik, hogy a PnP PowerShell használatával csatlakozzon a SharePoint Online-hoz. Útmutatásért lásd: A PnP PowerShell használatának első lépései.

Az alábbi lépésekkel beállíthatja és konfigurálhatja a CDN-t az objektumok SharePoint Online-ban való üzemeltetéséhez a PnP PowerShell használatával.

Kijelölés a kibontásához

A Office 365 CDN használatának engedélyezése a szervezet számára

A bérlői CDN-beállítások módosítása előtt le kell kérnie a privát CDN-konfiguráció aktuális állapotát a Office 365 bérlőben. Csatlakozzon a bérlőhöz a PnP PowerShell használatával:

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

Most használja a Get-PnPTenantCdnEnabled parancsmagot a CDN állapotbeállításainak lekéréséhez a bérlőből:

Get-PnPTenantCdnEnabled -CdnType <Public | Private>

A megadott CdnType CDN-jének állapota megjelenik a képernyőn.

A Set-PnPTenantCdnEnabled parancsmaggal engedélyezheti a szervezet számára a Office 365 CDN használatát. Engedélyezheti a szervezet számára, hogy egyszerre használjon nyilvános forrásokat, privát forrásokat vagy mindkettőt. A CDN-t úgy is konfigurálhatja, hogy az engedélyezéskor kihagyja az alapértelmezett források beállítását. Ezeket a forrásokat később is felveheti a cikkben leírtak szerint.

A PnP PowerShellben:

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

Ha például engedélyezni szeretné, hogy a szervezet nyilvános és privát forrást is használjon, írja be a következő parancsot:

Set-PnPTenantCdnEnabled -CdnType Both -Enable $true

Ha azt szeretné, hogy a szervezet nyilvános és privát forrásokat is használhasson, de ne állítsa be az alapértelmezett forrásokat, írja be a következő parancsot:

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

A cdn-Office 365 engedélyezésekor alapértelmezés szerint kiépített forrásokkal, valamint az alapértelmezett forrásbeállítások kihagyásának lehetséges hatásával kapcsolatos információkért lásd: Alapértelmezett CDN-források.

Ha engedélyezni szeretné a szervezet számára a nyilvános források használatát, írja be a következő parancsot:

Set-PnPTenantCdnEnabled -CdnType Public -Enable $true

Ha engedélyezni szeretné a szervezet számára a privát források használatát, írja be a következő parancsot:

Set-PnPTenantCdnEnabled -CdnType Private -Enable $true

További információ erről a parancsmagról: Set-PnPTenantCdnEnabled.

A Office 365 CDN-be felvenni kívánt fájltípusok listájának módosítása (nem kötelező)

Tipp

Ha a Set-PnPTenantCdnPolicy parancsmaggal definiál fájltípusokat, felülírja az aktuálisan definiált listát. Ha további fájltípusokat szeretne hozzáadni a listához, először a parancsmaggal állapítsa meg, hogy mely fájltípusok engedélyezettek, és vegye fel őket a listára az újakkal együtt.

A Set-PnPTenantCdnPolicy parancsmaggal határozhatja meg a nyilvános és privát forrásokkal üzemeltethető statikus fájltípusokat a CDN-ben. Alapértelmezés szerint a gyakori objektumtípusok engedélyezettek, például .css, .gif, .jpg és .js.

A PnP PowerShellben:

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

Ha például engedélyezni szeretné, hogy a CDN .css és .png fájlokat tároljon, írja be a következő parancsot:

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

A CDN által jelenleg engedélyezett fájltípusok megtekintéséhez használja a Get-PnPTenantCdnPolicies parancsmagot:

Get-PnPTenantCdnPolicies -CdnType <Public | Private>

További információ ezekről a parancsmagokról: Set-PnPTenantCdnPolicy és Get-PnPTenantCdnPolicies.

A Office 365 CDN-ből kizárni kívánt webhelybesorolások listájának módosítása (nem kötelező)

Tipp

Ha kizárja a webhelybesorolásokat a Set-PnPTenantCdnPolicy parancsmaggal, felülírja az aktuálisan definiált listát. Ha további webhelybesorolásokat szeretne kizárni, először a parancsmaggal állapítsa meg, hogy mely besorolások vannak már kizárva, majd adja hozzá őket az újakkal együtt.

A Set-PnPTenantCdnPolicy parancsmaggal kizárhatja azokat a webhelybesorolásokat, amelyeket nem szeretne elérhetővé tenni a CDN-en keresztül. Alapértelmezés szerint nincsenek kizárva webhelybesorolások.

A PnP PowerShellben:

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

A Get-PnPTenantCdnPolicies parancsmaggal megtekintheti, hogy jelenleg mely webhelybesorolások vannak korlátozva:

Get-PnPTenantCdnPolicies -CdnType <Public | Private>

A visszaadott tulajdonságok: IncludeFileExtensions, ExcludeRestrictedSiteClassifications és ExcludeIfNoScriptDisabled.

Az IncludeFileExtensions tulajdonság tartalmazza a CDN által kiszolgált fájlkiterjesztések listáját.

Megjegyzés:

Az alapértelmezett fájlkiterjesztések különböznek a nyilvános és a privát fájltól.

Az ExcludeRestrictedSiteClassifications tulajdonság tartalmazza azokat a webhelybesorolásokat, amelyeket ki szeretne zárni a CDN-ből. Kizárhatja például a Bizalmasként megjelölt webhelyeket, így az ilyen besorolású webhelyek tartalmai nem lesznek kiszolgálva a CDN-ből.

Az ExcludeIfNoScriptDisabled tulajdonság a webhelyszintű NoScript attribútumbeállítások alapján kizárja a tartalmat a CDN-ből. A NoScript attribútum alapértelmezés szerint Engedélyezve a modern webhelyekhez és a Letiltva értékre van állítva a klasszikus webhelyek esetében. Ez a bérlői beállításoktól függ.

További információ ezekről a parancsmagokról: Set-PnPTenantCdnPolicy és Get-PnPTenantCdnPolicies.

Forrás hozzáadása az objektumokhoz

Forrás meghatározásához használja az Add-PnPTenantCdnOrigin parancsmagot. Több forrást is meghatározhat. A forrás egy OLYAN URL-cím, amely a CDN által üzemeltetni kívánt objektumokat tartalmazó SharePoint-tárra vagy -mappára mutat.

Fontos

Soha ne helyezzen el olyan erőforrásokat, amelyek felhasználói adatokat tartalmaznak, vagy amelyek bizalmasnak minősülnek a szervezet számára egy nyilvános forrásban.

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

Az elérési út értéke az objektumokat tartalmazó könyvtár vagy mappa relatív elérési útja. A relatív elérési utak mellett helyettesítő karaktereket is használhat. Az origins támogatja az URL-címhez előtagolt helyettesítő karaktereket. Ez lehetővé teszi, hogy több helyre kiterjedő forrásokat hozzon létre. Ha például az összes webhely masterpages mappájában lévő összes objektumot nyilvános forrásként szeretné szerepeltetni a CDN-ben, írja be a következő parancsot:

Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
  • A */ helyettesítő karakteres módosító csak az elérési út elején használható, és megfelel a megadott URL-cím összes URL-szegmensének.
  • Az elérési út egy dokumentumtárra, mappára vagy webhelyre mutathat. A */site1 elérési út például megegyezik a webhely összes dokumentumtárával.

Egy adott relatív elérési úttal rendelkező forrást adhat hozzá. Nem adhat hozzá forrást a teljes elérési úttal.

Ez a példa hozzáadja a webhelyeszközök tárának privát forrását egy adott webhelyen:

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

Ez a példa hozzáadja a mappa1 mappa privát forrását a webhelycsoport webhelyeszközök tárába:

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

Ha az elérési út tartalmaz szóközt, az elérési utat idézőjelek között is elhelyezheti, vagy lecserélheti a szóközt a(z) %20 URL-kódolással. Az alábbi példák a webhelycsoport webhely-objektumtárában lévő 1. mappa magánjellegű forrását adhatja hozzá:

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

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

További információ erről a parancsról és szintaxisáról: Add-PnPTenantCdnOrigin.

Megjegyzés:

A privát forrásokban a forrásból megosztott objektumoknak közzé kell tenniük egy főverziót, mielőtt elérhetők lennének a CDN-ből.

A parancs futtatása után a rendszer szinkronizálja a konfigurációt az adatközpontban. Ez az eredmény akár 15 percet is igénybe vehet.

Példa: Nyilvános forrás konfigurálása a mesterlapokhoz és a Stílustárhoz a SharePoint Online-hoz

Ezek a források alapértelmezés szerint be vannak állítva, amikor engedélyezi a Office 365 CDN-t. Ha azonban manuálisan szeretné engedélyezni őket, kövesse az alábbi lépéseket.

  • Az Add-PnPTenantCdnOrigin parancsmaggal nyilvános forrásként definiálhatja a stílustárat.

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

  • Az Add-PnPTenantCdnOrigin parancsmaggal nyilvános forrásként definiálhatja a mesterlapokat.

    Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */masterpage

További információ erről a parancsról és szintaxisáról: Add-PnPTenantCdnOrigin.

A parancs futtatása után a rendszer szinkronizálja a konfigurációt az adatközpontban. Ez az eredmény akár 15 percet is igénybe vehet.

Példa: Privát forrás konfigurálása a sharePoint Online-beli webhelyeszközökhöz, webhelylapokhoz és közzétételi képekhez

  • Az Add-PnPTenantCdnOrigin parancsmaggal privát forrásként definiálhatja a webhelyeszközök mappát.

    Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */siteassets

  • Az Add-PnPTenantCdnOrigin parancsmaggal privát forrásként definiálhatja a webhelylapok mappát.

    Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */sitepages

  • Az Add-PnPTenantCdnOrigin parancsmaggal privát forrásként definiálhatja a közzétételi képek mappát.

    Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */publishingimages

További információ erről a parancsról és szintaxisáról: Add-PnPTenantCdnOrigin.

A parancs futtatása után a rendszer szinkronizálja a konfigurációt az adatközpontban. Ez az eredmény akár 15 percet is igénybe vehet.

Példa: Privát forrás konfigurálása webhelycsoporthoz a SharePoint Online-hoz

Az Add-PnPTenantCdnOrigin parancsmaggal privát forrásként definiálhat egy webhelycsoportot. Például:

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

További információ erről a parancsról és szintaxisáról: Add-PnPTenantCdnOrigin.

A parancs futtatása után a rendszer szinkronizálja a konfigurációt az adatközpontban. Előfordulhat, hogy megjelenik egy Függőben lévő konfiguráció üzenet. Ez az eredmény várható, mivel a SharePoint Online-bérlő csatlakozik a CDN szolgáltatáshoz. Ez az eredmény akár 15 percet is igénybe vehet.

A Office 365 CDN kezelése

A CDN beállítása után módosíthatja a konfigurációt a tartalom frissítése során vagy az igények változásakor, az ebben a szakaszban leírtak szerint.

Objektumok hozzáadása, frissítése vagy eltávolítása a Office 365 CDN-ből

A beállítási lépések elvégzése után bármikor hozzáadhat új objektumokat, és frissítheti vagy eltávolíthatja a meglévő objektumokat. Csak végezze el a módosításokat a forrásként azonosított mappában vagy SharePoint-tárban lévő objektumokon. Ha új objektumot ad hozzá, az azonnal elérhető lesz a CDN-en keresztül. Ha azonban frissíti az objektumot, az új példány propagálása és a CDN-ben való elérhetővé tétele akár 15 percet is igénybe vehet.

Ha le kell kérnie a forrás helyét, használhatja a Get-PnPTenantCdnOrigin parancsmagot. További információ a parancsmag használatáról: Get-PnPTenantCdnOrigin.

Forrás eltávolítása a Office 365 CDN-ből

Eltávolíthatja a forrásként azonosított mappákhoz vagy SharePoint-tárakhoz való hozzáférést. A művelet végrehajtásához használja a Remove-PnPTenantCdnOrigin parancsmagot.

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

További információ a parancsmag használatáról: Remove-PnPTenantCdnOrigin.

Forrás módosítása a Office 365 CDN-ben

A létrehozás után nem módosíthatja a forrást. Ehelyett távolítsa el a forrást, majd adjon hozzá egy újat. További információ: Forrás eltávolítása a Office 365 CDN-ből és Forrás hozzáadása az objektumokhoz.

A Office 365 CDN letiltása

A Set-PnPTenantCdnEnabled parancsmaggal tiltsa le a CDN-t a szervezet számára. Ha a CDN-hez mind a nyilvános, mind a privát forrás engedélyezve van, kétszer kell futtatnia a parancsmagot az alábbi példákban látható módon.

Ha le szeretné tiltani a nyilvános források használatát a CDN-ben, írja be a következő parancsot:

Set-PnPTenantCdnEnabled -CdnType Public -Enable $false

Ha le szeretné tiltani a privát források használatát a CDN-ben, írja be a következő parancsot:

Set-PnPTenantCdnEnabled -CdnType Private -Enable $false

További információ erről a parancsmagról: Set-PnPTenantCdnEnabled.

A Office 365 CDN beállítása és konfigurálása a Microsoft 365 parancssori felületével

Az ebben a szakaszban ismertetett eljárásokhoz a Microsoft 365 parancssori felületére van szükség. Csatlakozzon a Office 365-bérlőhöz a bejelentkezési paranccsal.

Ezeket a lépéseket követve állítsa be és konfigurálja a CDN-t az objektumok SharePoint Online-ban való üzemeltetéséhez a Microsoft 365 parancssori felületének használatával.

Kijelölés a kibontásához

A Office 365 CDN engedélyezése

A bérlőben lévő Office 365 CDN állapotát az spo cdn set paranccsal kezelheti.

A Office 365 nyilvános CDN bérlőben való engedélyezéséhez futtassa a következő parancsot:

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

A Office 365 SharePoint CDN engedélyezéséhez futtassa a következő parancsot:

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

A Office 365 CDN aktuális állapotának megtekintése

Annak ellenőrzéséhez, hogy az adott típusú Office 365 CDN engedélyezve van-e vagy le van-e tiltva, használja az spo cdn get parancsot.

Annak ellenőrzéséhez, hogy a Office 365 nyilvános CDN engedélyezve van-e, futtassa a következő parancsot:

m365 spo cdn get --type Public

Az Office 365 CDN-források megtekintése

A jelenleg konfigurált Office 365 nyilvános CDN-források megtekintéséhez futtassa a következő parancsot:

m365 spo cdn origin list --type Public

A CDN-Office 365 engedélyezésekor alapértelmezés szerint kiépített forrásokkal kapcsolatos információkért lásd: Alapértelmezett CDN-források.

Office 365 CDN-forrás hozzáadása

Fontos

Nyilvános forrásként konfigurált SharePoint-dokumentumtárakban soha ne helyezzen a szervezet számára bizalmasnak ítélt erőforrásokat.

A CDN-forrás meghatározásához használja az spo cdn origin add parancsot. Több forrást is meghatározhat. A forrás egy OLYAN URL-cím, amely egy SharePoint-tárra vagy -mappára mutat, amely a CDN által üzemeltetni kívánt objektumokat tartalmazza.

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

Hol path található az adategységeket tartalmazó mappa relatív elérési útja. A relatív elérési utak mellett helyettesítő karaktereket is használhat.

Ha az összes objektumot nyilvános forrásként szeretné szerepeltetni az összes webhely mesterlaptárában , futtassa a következő parancsot:

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

Ha privát forrást szeretne konfigurálni egy adott webhelycsoporthoz, futtassa a következő parancsot:

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

Megjegyzés:

A CDN-forrás hozzáadása után akár 15 percig is eltarthat, amíg a CDN szolgáltatáson keresztül lekérheti a fájlokat. Az spo cdn origin list paranccsal ellenőrizheti, hogy az adott forrás engedélyezve van-e.

Office 365 CDN-forrás eltávolítása

Az spo cdn origin remove paranccsal távolítson el egy CDN-forrást a megadott CDN-típushoz.

Ha el szeretne távolítani egy nyilvános forrást a CDN-konfigurációból, futtassa a következő parancsot:

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

Megjegyzés:

A CDN-forrás eltávolítása nem befolyásolja a forrásnak megfelelő dokumentumtárakban tárolt fájlokat. Ha ezekre az objektumokra a SharePoint URL-címével hivatkozik, a SharePoint automatikusan visszaáll a dokumentumtárra mutató eredeti URL-címre. Ha az objektumokra nyilvános CDN URL-címmel hivatkozik, a forrás eltávolítása megszakítja a hivatkozást, és manuálisan kell módosítania őket.

Office 365 CDN-forrás módosítása

Meglévő CDN-forrás nem módosítható. Ehelyett távolítsa el a korábban definiált CDN-forrást a spo cdn origin remove paranccsal, és adjon hozzá egy újat a spo cdn origin add paranccsal.

A Office 365 CDN-be felvenni kívánt fájltípusok módosítása

Alapértelmezés szerint a cdn a következő fájltípusokat tartalmazza: , , , , , .jpeg, .jpg, , .js, .map.svg.ttf.png.woffés ..woff2.ico.gif.eot.css Ha további fájltípusokat kell hozzáadnia a CDN-hez, a CDN konfigurációját az spo cdn policy set paranccsal módosíthatja .

Megjegyzés:

A fájltípusok listájának módosításakor felülírja az aktuálisan definiált listát. Ha további fájltípusokat szeretne felvenni, először használja az spo cdn policy list parancsot annak kiderítéséhez, hogy jelenleg mely fájltípusok vannak konfigurálva.

Ha hozzá szeretné adni a JSON-fájltípust a nyilvános CDN alapértelmezett fájltípuslistájához, futtassa a következő parancsot:

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

A Office 365 CDN-ből kizárni kívánt webhelybesorolások listájának módosítása

Az spo cdn policy set paranccsal zárja ki azokat a webhelybesorolásokat, amelyeket nem szeretne elérhetővé tenni a CDN-en keresztül. Alapértelmezés szerint nincsenek kizárva webhelybesorolások.

Megjegyzés:

A kizárt webhelybesorolások listájának módosításakor felülírja az aktuálisan definiált listát. Ha további besorolásokat szeretne kizárni, először használja az spo cdn policy list parancsot annak kiderítéséhez, hogy jelenleg mely besorolások vannak konfigurálva.

Ha ki szeretné zárni a HBI-ként besorolt helyeket a nyilvános CDN-ből, futtassa a következő parancsot:

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

A Office 365 CDN letiltása

A Office 365 CDN letiltásához használja a spo cdn set parancsot, például:

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

A CDN-eszközök használata

Most, hogy engedélyezte a CDN-t, valamint a konfigurált forrásokat és szabályzatokat, megkezdheti a CDN-eszközök használatát.

Ebből a szakaszból megtudhatja, hogyan használhatJA a CDN URL-címeket a SharePoint-lapokon és -tartalmakban, hogy a SharePoint a nyilvános és privát forrású objektumokra vonatkozó kérelmeket a CDN-re irányítsa át.

A CDN ügyféloldali kijelzők üzemeltetéséhez való használatáról az Ügyféloldali kijelző üzemeltetése Office 365 CDN-ből ("Helló világ!" alkalmazás 4. rész) című cikkben talál további információt.

Megjegyzés:

Ha hozzáadja a ClientSideAssets mappát a privát CDN-források listájához, a CDN által üzemeltetett egyéni kijelzők renderelése sikertelen lesz. Az SPFX kijelzők által használt fájlok csak a nyilvános CDN-t használhatják, és a ClientSideAssets mappa a nyilvános CDN alapértelmezett forrása.

Ha egy forráshoz hozzáadott objektumokat szeretne használni, egyszerűen frissítse az eredeti fájlra mutató hivatkozásokat a forrásfájl elérési útjával.

  • Szerkessze a forráshoz hozzáadott objektumokra mutató hivatkozásokat tartalmazó lapot vagy tartalmat. A számos módszer egyikével globálisan kereshet és cserélhet le hivatkozásokat egy enter-webhelyen vagy webhelycsoportban, ha mindenhol frissíteni szeretné egy adott objektumra mutató hivatkozást mindenhol, ahol megjelenik.
  • Egy forrásban lévő objektumra mutató minden hivatkozásnál cserélje le az elérési utat a CDN-forrásban lévő fájl elérési útjára. Relatív elérési utakat is használhat.
  • Mentse a lapot vagy a tartalmat.

Vegyük például a /site/SiteAssets/images/image.pngképet, amelyet a /site/CDN_origins/public/ dokumentumtármappába másolt. A CDN-adategység használatához cserélje le a képfájl helyének eredeti elérési útját a forrás elérési útjára az új URL-cím / site/CDN_origins/public/image.pnglétrehozásához.

Ha relatív elérési út helyett az objektum teljes URL-címét szeretné használni, hozza létre a hivatkozást a következőképpen:

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

Megjegyzés:

Általánosságban elmondható, hogy az URL-címeket nem szabad közvetlenül a CDN-ben lévő objektumokra kódolni. Szükség esetén azonban manuálisan is létrehozhat URL-címeket a nyilvános forrásokban lévő objektumokhoz. További információ: CDN URL-címek módosítása nyilvános eszközökhöz.

Ha meg szeretné tudni, hogyan ellenőrizheti, hogy az adategységeket a CDN szolgáltatja-e, olvassa el a Hogyan ellenőrizze, hogy a CDN szolgálja-e ki az objektumokat? című részt a Office 365 CDN hibaelhárítása című témakörben.

Eszközök használata nyilvános forrásokban

A SharePoint Online Közzététel funkciója automatikusan átírja a nyilvános forrásban tárolt objektumok URL-címeit a CDN-ekvivalensekre, így az eszközök a SharePoint helyett a CDN szolgáltatásból lesznek kiszolgálva.

Ha a forrás olyan webhelyen található, amelyen engedélyezve van a Közzététel funkció, és a CDN-re kiosztani kívánt objektumok az alábbi kategóriák egyikében találhatók, a SharePoint automatikusan újraírja a forrásban lévő objektumok URL-címét, ha az objektumot nem zárja ki a CDN-szabályzat.

Az alábbi példa egy áttekintést nyújt, amelyben a sharepoint-közzétételi szolgáltatás automatikusan újraírta a hivatkozásokat:

  • IMG/LINK/CSS URL-címek a klasszikus közzétételi lap HTML-válaszaiban.
    • Ide tartoznak a szerzők által a lap HTML-tartalmaiban hozzáadott képek is.
  • Képtár Diavetítés kijelző képÉNEK URL-címei.
  • Képmezők az SPList REST API (RenderListDataAsStream) eredményeiben.
    • Az ImageFieldsToTryRewriteToCdnUrls tulajdonság használatával adja meg a mezők vesszővel tagolt listáját.
    • Támogatja a hivatkozásmezőket és a PublishingImage mezőket.
  • SharePoint-képmegjelenítések.

Az alábbi ábra azt a munkafolyamatot mutatja be, amikor a SharePoint egy nyilvános forrásból származó objektumokat tartalmazó lapra vonatkozó kérést kap.

Munkafolyamat-diagram: Office 365 CDN-adategységek lekérése nyilvános forrásból.

Tipp

Ha le szeretné tiltani az automatikus újraírást adott URL-címekhez egy lapon, akkor vegye ki az oldalt, és adja hozzá a lekérdezési sztring paraméterét ? NoAutoReWrites=true a letiltani kívánt hivatkozások végéig.

CDN URL-címek létrehozása nyilvános eszközökhöz

Ha a Közzététel funkció nincs engedélyezve nyilvános forráshoz, vagy az objektum nem a CDN szolgáltatás automatikus újraírási funkciója által támogatott hivatkozástípusok egyike, manuálisan hozhat létre URL-címeket az objektumok CDN-helyére, és használhatja ezeket az URL-címeket a tartalomban.

Megjegyzés:

Nem kódolhatja és nem hozhat létre CDN URL-címeket privát forrású objektumokhoz, mert az URL utolsó szakaszát képező szükséges hozzáférési jogkivonat az erőforrás kérésének időpontjában jön létre. Létrehozhatja a nyilvános CDN URL-címét, és az URL-cím nem módosítható, mert változhat.

Nyilvános CDN-objektumok esetén az URL-formátum a következő példához hasonlóan néz ki:

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

Cserélje le a TenantHostName elemet a bérlő nevére. Például:

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

Megjegyzés:

A lapkörnyezet tulajdonsággal az előtagot hozhatja létre a rögzített kódolás https://publiccdn.sharepointonline.comhelyett, mivel az URL-cím változhat. Ha megjelenítési sablonokat használ a klasszikus SharePoint Online-ban, használhatja a megjelenítési sablon tulajdonságát window._spPageContextInfo.publicCdnBaseUrl az URL-cím előtagjához. Ha SPFx kijelzőket használ a modern és klasszikus SharePointhoz, használhatja a tulajdonságot this.context.pageContext.legacyPageContext.publicCdnBaseUrl, amely az előtagot is tartalmazza. Ha az előtag megváltozik, az implementáció is frissül.

Az SPFx példaként a tulajdonság this.context.pageContext.legacyPageContext.publicCdnBaseUrlhost - - relativeURL for the item/ - / - használatával hozhatja létre az URL-címet. További információ: Using CDN in Client-side code (CDN használata ügyféloldali kódban), amely az 1. évad teljesítménysorozatának része.

Objektumok használata privát forrásokban

A privát forrásokban lévő objektumok használatához nincs szükség további konfigurációra. A SharePoint Online automatikusan átírja a privát eredetű objektumok URL-címeit, így az ilyen objektumokra vonatkozó kéréseket mindig a CDN kézbesíti. Nem hozhat létre manuálisan URL-címeket a privát forrásokban lévő CDN-objektumokhoz, mert ezek az URL-címek olyan jogkivonatokat tartalmaznak, amelyeket a SharePoint Online-nak automatikusan kell létrehoznia az objektum kérelmezésekor.

A privát forrásokban lévő objektumokhoz való hozzáférést dinamikusan generált jogkivonatok védik a forráshoz való felhasználói engedélyek alapján, az alábbi szakaszokban ismertetett kikötésekkel. A tartalom megjelenítéséhez a felhasználóknak legalább olvasási hozzáféréssel kell rendelkezniük a CDN forrásához.

Az alábbi ábra azt a munkafolyamatot mutatja be, amikor a SharePoint egy privát forrásból származó objektumokat tartalmazó lapra vonatkozó kérést kap.

Munkafolyamat-diagram: Office 365 CDN-adategységek beolvasása privát forrásból.

Jogkivonat-alapú engedélyezés privát forrásokban

A Office 365 CDN-ben található privát forrásokban lévő objektumokhoz a SharePoint Online által létrehozott jogkivonatok biztosítják a hozzáférést. Azok a felhasználók, akik már rendelkeznek engedéllyel a forrás által kijelölt mappához vagy tárhoz, automatikusan jogkivonatokat kapnak, amelyek lehetővé teszik a felhasználó számára a fájlhoz való hozzáférést a jogosultsági szintjük alapján. Ezek a hozzáférési jogkivonatok a létrehozásuk után 30–90 percig érvényesek, hogy megakadályozzák a jogkivonatok visszajátszására irányuló támadásokat.

A hozzáférési jogkivonat létrehozása után a SharePoint Online egy egyéni URI-t ad vissza az ügyfélnek, amely két engedélyezési paramétert tartalmaz : eat (edge authorization token) és oat (origin authorization token). Az egyes jogkivonatok struktúrája a következő:< "lejárati idő az alapidőszak időformátumában">__<'secure signature'>. Például:

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

Megjegyzés:

A jogkivonat birtokában bárki hozzáférhet az erőforráshoz a CDN-ben. Az ilyen hozzáférési jogkivonatokat tartalmazó URL-címek azonban csak HTTPS-en keresztül vannak megosztva, így hacsak az URL-címet nem osztja meg explicit módon egy végfelhasználó a jogkivonat lejárata előtt, az objektum nem lesz elérhető jogosulatlan felhasználók számára.

Az elemszintű engedélyek nem támogatottak a privát eredetű objektumok esetében

Fontos megjegyezni, hogy a SharePoint Online nem támogatja a privát eredetű objektumok elemszintű engedélyeit. A helyen https://contoso.sharepoint.com/sites/site1/library1/folder1/image1.jpgtalálható fájlok esetében például a felhasználók a következő feltételek mellett férhetnek hozzá a fájlhoz:

Felhasználó Engedélyek Hatékony hozzáférés
1. felhasználó Hozzáféréssel rendelkezik a mappa1 mappához Hozzáférhet image1.jpg a CDN-ből
2. felhasználó Nem rendelkezik hozzáféréssel a mappa1 mappához Nem lehet hozzáférni image1.jpg a CDN-ből
3. felhasználó Nem rendelkezik hozzáféréssel a folder1 mappához, de explicit engedélyt kap a SharePoint Online-beli image1.jpg elérésére Az eszköz image1.jpg közvetlenül a SharePoint Online-ból érheti el, a CDN-ből azonban nem
4. felhasználó Hozzáféréssel rendelkezik a mappa1 mappához, de kifejezetten megtagadta a hozzáférést a SharePoint Online-beli image1.jpg Nem lehet hozzáférni az objektumhoz a SharePoint Online-ból, de hozzáférhet az objektumhoz a CDN-ből annak ellenére, hogy megtagadták a fájlhoz való hozzáférést a SharePoint Online-ban

A Office 365 CDN hibaelhárítása

Hogyan győződjön meg arról, hogy a CDN kiszolgálja az eszközöket?

Miután a CDN-objektumokra mutató hivatkozásokat adott hozzá egy laphoz, ellenőrizheti, hogy az adategységet a CDN szolgáltatja-e. Ehhez nyissa meg az oldalt, kattintson a jobb gombbal a képre, miután az megjelenik, és tekintse át a kép URL-címét.

A böngésző fejlesztői eszközeivel megtekintheti az egyes objektumok URL-címét egy oldalon, vagy használhat egy külső hálózati nyomkövetési eszközt.

Megjegyzés:

Ha egy hálózati eszközzel, például a Fiddlerrel teszteli az objektumot a SharePoint-lapról való renderelésen kívül, manuálisan kell hozzáadnia a "Referer: https://yourdomain.sharepoint.com" hivatkozási fejlécet a GET-kérelemhez, ahol az URL-cím a SharePoint Online-bérlő gyökér URL-címe.

A CDN URL-címeket nem tesztelheti közvetlenül egy webböngészőben, mert a SharePoint Online-ból származó hivatkozónak kell lennie. Ha azonban hozzáadja a CDN-objektum URL-címét egy SharePoint-laphoz, majd megnyitja a lapot egy böngészőben, a CDN-objektum megjelenik a lapon.

A fejlesztői eszközök Microsoft Edge böngészőben való használatával kapcsolatos további információkért lásd: Microsoft Edge fejlesztői eszközök.

Ha egy rövid videót szeretne watch a SharePoint Fejlesztői minták és eljárások YouTube-csatornáján, amely bemutatja, hogyan ellenőrizheti a CDN működését, olvassa el A CDN-használat ellenőrzése és az optimális hálózati kapcsolat biztosítása című cikket.

Miért nem érhetők el az új forrásból származó objektumok?

Az új forrásokban lévő objektumok nem lesznek azonnal felhasználhatók, mivel időbe telik, amíg a regisztráció propagálása a CDN-en keresztül történik, és az eszközök a forrásból a CDN-tárolóba való feltöltéséhez. Az eszközök CDN-ben való rendelkezésre állásához szükséges idő attól függ, hogy hány adategység és a fájlok mérete van meg.

Az ügyféloldali kijelző vagy SharePoint-keretrendszer megoldás nem működik

Ha engedélyezi a Office 365 CDN-t a nyilvános forrásokhoz, a CDN szolgáltatás automatikusan létrehozza ezeket az alapértelmezett forrásokat:

  • */MASTERPAGE
  • */STÍLUSTÁR
  • */CLIENTSIDEASSETS

Ha a */clientsideassets forrás hiányzik, SharePoint-keretrendszer megoldások meghiúsulnak, és nem jönnek létre figyelmeztetések vagy hibaüzenetek. Előfordulhat, hogy a forrás hiányzik, mert a CDN engedélyezve lett a -NoDefaultOrigins paraméter $true értékre állítva, vagy azért, mert a forrást manuálisan törölték.

A következő PowerShell-paranccsal ellenőrizheti, hogy mely források találhatók:

Get-SPOTenantCdnOrigins -CdnType Public

Vagy a Microsoft 365 parancssori felületével is ellenőrizheti:

m365 spo cdn origin list

Forrás hozzáadása a PowerShellben:

Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */CLIENTSIDEASSETS

Forrás hozzáadása a Microsoft 365 parancssori felületével:

m365 spo cdn origin add --origin */CLIENTSIDEASSETS

Milyen PowerShell-modulokat és parancssori felületeket kell használnom a Office 365 CDN-nel?

A Office 365 CDN-t a SharePoint Online Management Shell PowerShell-moduljával vagy a Microsoft 365 parancssori felületével használhatja.

Lásd még

Tartalomkézbesítési hálózatok

Network planning and performance tuning for Office 365

SharePoint-teljesítménysorozat – CDN-videósorozat Office 365