Použití Office 365 Content Delivery Network (CDN) se SharePointem Online

K hostování statických prostředků můžete použít integrovanou službu Office 365 Content Delivery Network (CDN) a zajistit tak lepší výkon pro stránky SharePointu Online. Office 365 CDN zlepšuje výkon tím, že ukládá statické prostředky do mezipaměti blíže prohlížečům, které je požadují, což pomáhá urychlit stahování a snížit latenci. Také Office 365 CDN používá protokol HTTP/2 pro vylepšenou kompresi a směrování HTTP. Služba Office 365 CDN je součástí vašeho předplatného SharePointu Online.

Upozornění

Vzhledem k tomu, že se image automaticky spravují v privátní síti CDN spravované službou SharePointu Online, je ručně nakonfigurovaná privátní síť CDN zastaralá. To znamená, že zákazníci už nemusí konfigurovat privátní síť CDN. Doporučený postup zůstává beze změny, protože image se budou hostovat prostřednictvím privátní sítě CDN spravované službou automaticky a veřejná síť CDN bude dál dostupná pro všechny ostatní typy souborů, jako jsou css a JS. Každý zákazník, který používá privátní CDN pro jiné typy souborů než image, bude muset tyto soubory přesunout do veřejné sítě CDN. Pro tyto typy souborů se kvůli zvýšení výkonu doporučuje veřejná síť CDN.

Poznámka

Office 365 CDN je k dispozici pouze pro tenanty v produkčním (celosvětovém) cloudu. Tenanti v cloudech pro státní správu USA a Čínu v současné době nepodporují Office 365 CDN.

Office 365 CDN se skládá z několika sítí CDN, které umožňují hostovat statické prostředky ve více umístěních nebo zdrojích a obsluhovat je z globálních vysokorychlostních sítí. V závislosti na typu obsahu, který chcete hostovat v Office 365 CDN, můžete přidat veřejné zdroje, soukromé zdroje nebo obojí. Další informace o rozdílu mezi veřejnými a soukromými zdroji najdete v tématu Volba, jestli má být každý zdroj veřejný nebo soukromý .

Office 365 koncepční diagram CDN.

Pokud už víte, jak sítě CDN fungují, stačí provést několik kroků, abyste pro svého tenanta povolili Office 365 CDN. Toto téma popisuje, jak na to. Přečtěte si informace o tom, jak začít hostovat statické prostředky.

Tip

Existují i jiné sítě CDN hostované Microsoftem, které se dají použít s Office 365 pro specializované scénáře použití, ale v tomto tématu se o nich nezabírá, protože nespadají do rozsahu Office 365 CDN. Další informace najdete v tématu Jiné sítě CDN společnosti Microsoft.

Vraťte se k části Plánování sítě a ladění výkonu pro Office 365.

Přehled práce s Office 365 CDN v SharePointu Online

Pokud chcete pro svoji organizaci nastavit Office 365 CDN, postupujte podle těchto základních kroků:

Po dokončení instalace můžete spravovat Office 365 CDN v průběhu času pomocí následujících možností:

  • Přidávání, aktualizace a odebírání prostředků
  • Přidávání a odebírání původů
  • Konfigurace zásad CDN
  • V případě potřeby zakažte síť CDN.

Nakonec si přečtěte téma Použití prostředků CDN , kde najdete informace o přístupu k prostředkům CDN z veřejného i soukromého zdroje.

Pokyny k řešení běžných problémů najdete v tématu Řešení potíží s Office 365 CDN.

Plánování nasazení Office 365 CDN

Než pro tenanta Office 365 nasadíte Office 365 CDN, měli byste v rámci procesu plánování zvážit následující faktory.

Určení statických prostředků, které chcete hostovat ve službě CDN

Sítě CDN jsou obecně nejúčinnější pro hostování statických prostředků nebo prostředků, které se příliš často nemění. Dobrým pravidlem je identifikovat soubory, které splňují některé nebo všechny tyto podmínky:

  • Statické soubory vložené do stránky (jako jsou skripty a obrázky), které můžou mít významný přírůstkový dopad na dobu načítání stránky
  • Velké soubory, jako jsou spustitelné soubory a instalační soubory
  • Knihovny prostředků, které podporují kód na straně klienta

Například malé soubory, které jsou opakovaně požadovány, jako jsou obrázky webů a skripty, mohou výrazně zlepšit výkon vykreslování webu a přírůstkově snížit zatížení webů SharePointu Online, když je přidáte do zdroje CDN. Větší soubory, jako jsou instalační spustitelné soubory, se dají stáhnout ze sítě CDN, což přináší pozitivní dopad na výkon a následné snížení zatížení webu SharePointu Online, i když se k nim tak často nepřistupuje.

Zvýšení výkonu na základě jednotlivých souborů závisí na mnoha faktorech, včetně blízkosti klienta k nejbližšímu koncovému bodu CDN, přechodných podmínek v místní síti atd. Mnoho statických souborů je poměrně malých a je možné je stáhnout z Office 365 za méně než sekundu. Webová stránka však může obsahovat mnoho vložených souborů s kumulativní dobou stahování v řádu sekund. Obsluha těchto souborů z CDN může výrazně zkrátit celkovou dobu načítání stránky. Příklad najdete v tématu Jaké zvýšení výkonu cdn poskytuje?

Určení, kam chcete ukládat prostředky

CDN načte vaše prostředky z umístění označovaného jako zdroj. Zdrojem může být sharepointový web, knihovna dokumentů nebo složka, která je přístupná přes adresu URL. Při zadávání původů pro vaši organizaci máte velkou flexibilitu. Můžete například zadat více zdrojů nebo jeden zdroj, do kterého chcete vložit všechny prostředky CDN. Pro vaši organizaci můžete mít veřejný i soukromý původ. Většina organizací se rozhodne implementovat kombinaci těchto dvou možností.

Můžete vytvořit nový kontejner pro původy, jako jsou složky nebo knihovny dokumentů, a přidat soubory, které chcete zpřístupnit ze sítě CDN. Tento přístup je vhodný, pokud máte konkrétní sadu prostředků, které chcete mít k dispozici ze sítě CDN, a chcete omezit sadu prostředků CDN jenom na soubory v kontejneru.

Můžete také nakonfigurovat existující kolekci webů, web, knihovnu nebo složku jako zdroj, který zpřístupní všechny oprávněné prostředky v kontejneru ze sítě CDN. Než přidáte existující kontejner jako zdroj, je důležité se ujistit, že znáte jeho obsah a oprávnění, abyste nechtěně nezpřístupnili prostředky anonymním uživatelům nebo neoprávněným uživatelům.

Můžete definovat zásady CDN , které z CDN vyloučí obsah ve vašich zdrojích. Zásady CDN vylučují prostředky ve veřejném nebo privátním původu podle atributů, jako je typ souboru a klasifikace webu, a použijí se na všechny původy cdnType (privátní nebo veřejné), které zadáte v zásadách. Pokud například přidáte soukromý zdroj skládající se z webu, který obsahuje více podřízených webů, můžete definovat zásadu pro vyloučení webů označených jako důvěrné , takže obsah z webů s použitou klasifikací nebude ze sítě CDN obsluhovat. Zásady se budou vztahovat na obsah ze všech soukromých zdrojů, které jste přidali do CDN.

Mějte na paměti, že větší je počet původů, tím větší má dopad na čas, který službě CDN trvá zpracování požadavků. Doporučujeme co nejvíce omezit počet původů.

Zvolte, jestli má být každý zdroj veřejný nebo soukromý.

Při identifikaci původu určíte, zda má být veřejný nebo soukromý. Přístup k prostředkům CDN ve veřejných zdrojích je anonymní a obsah CDN v privátních zdrojích je zabezpečen dynamicky generovanými tokeny pro větší zabezpečení. Bez ohledu na to, kterou možnost zvolíte, Microsoft udělá všechny těžké práce za vás, pokud jde o správu samotné sítě CDN. Později můžete také změnit názor, jakmile nastavíte síť CDN a identifikujete původ.

Veřejné i soukromé možnosti poskytují podobné zvýšení výkonu, ale každá z nich má jedinečné atributy a výhody.

Veřejné zdroje v rámci Office 365 CDN jsou přístupné anonymně a k hostovaným prostředkům může přistupovat každý, kdo má adresu URL prostředku. Vzhledem k tomu, že přístup k obsahu ve veřejných zdrojích je anonymní, měli byste ho používat jenom k ukládání do mezipaměti necitlivě obecného obsahu, jako jsou soubory JavaScriptu, skripty, ikony a obrázky.

Soukromé zdroje v rámci Office 365 CDN poskytují soukromý přístup k uživatelskému obsahu, jako jsou knihovny dokumentů SharePointu Online, weby a proprietární obrázky. Přístup k obsahu v privátních zdrojích je zabezpečen dynamicky generovanými tokeny, takže k němu mají přístup jenom uživatelé s oprávněními k původní knihovně dokumentů nebo umístění úložiště. Privátní zdroje v Office 365 CDN se dají použít jenom pro obsah SharePointu Online a k prostředkům v privátních zdrojích můžete přistupovat jenom prostřednictvím přesměrování z tenanta SharePointu Online.

Další informace o tom, jak funguje přístup CDN k prostředkům v privátním zdroji, si můžete přečíst v tématu Použití prostředků v privátních zdrojích.

Atributy a výhody hostování prostředků ve veřejných zdrojích

  • Prostředky vystavené ve veřejném zdroji jsou přístupné všem anonymně.

    Důležité

    Nikdy byste neměli umisťovat prostředky, které obsahují informace o uživatelích nebo jsou považovány za citlivé pro vaši organizaci, do veřejného zdroje.

  • Pokud odeberete prostředek z veřejného zdroje, může být k dispozici až 30 dnů od mezipaměti. Během 15 minut však zrušíme platnost odkazů na prostředek v CDN.

  • Když hostujete šablony stylů (soubory CSS) ve veřejném původu, můžete v kódu použít relativní cesty a identifikátory URI. To znamená, že můžete odkazovat na umístění obrázků na pozadí a dalších objektů vzhledem k umístění prostředku, který ho volá.

  • I když můžete vytvořit adresu URL veřejného zdroje, měli byste postupovat s opatrností a ujistěte se, že používáte vlastnost kontextu stránky a postupujte podle pokynů k tomu. Důvodem je to, že pokud přístup k CDN přestane být dostupný, adresa URL se automaticky nepřeloží vaší organizaci v SharePointu Online a může vést k nefunkčním odkazům a dalším chybám. Adresa URL se také může změnit, a proto by neměla být pevně zakódovaná na aktuální hodnotu.

  • Výchozí typy souborů, které jsou zahrnuté pro veřejné zdroje, jsou .css, .eot, .gif, .ico, .jpeg, .jpg, .js, .map, .png, .svg, .ttf, .woff a .woff2. Můžete zadat další typy souborů.

  • Zásady můžete nakonfigurovat tak, aby vylučovaly prostředky, které byly identifikovány klasifikacemi webu, které zadáte. Můžete například vyloučit všechny prostředky, které jsou označené jako "důvěrné" nebo "omezené", i když se jedná o povolený typ souboru a nachází se ve veřejném původu.

Atributy a výhody hostování prostředků v privátních zdrojích

  • Soukromé zdroje se dají použít jenom pro prostředky SharePointu Online.

  • Uživatelé mají přístup k prostředkům z privátního zdroje pouze v případě, že mají oprávnění pro přístup ke kontejneru. Anonymní přístup k těmto prostředkům je zabráněný.

  • Prostředky v privátních zdrojích se musí odkazovat z tenanta SharePointu Online. Přímý přístup k privátním prostředkům CDN nefunguje.

  • Pokud odeberete prostředek z privátního zdroje, může být prostředek z mezipaměti dostupný až hodinu. Do 15 minut od odebrání prostředku však zrušíme platnost odkazů na prostředek v CDN.

  • Výchozí typy souborů, které jsou součástí privátních zdrojů, jsou .gif, .ico, .jpeg, .jpg, .js a .png. Můžete zadat další typy souborů.

  • Stejně jako u veřejných zdrojů můžete zásady nakonfigurovat tak, aby vylučovaly prostředky, které byly identifikovány klasifikacemi webu, které zadáte, i když pomocí zástupných znaků zahrnete všechny prostředky ve složce nebo knihovně dokumentů.

Další informace o tom, proč používat Office 365 CDN, obecné koncepty CDN a další sítě CDN od Microsoftu, které můžete používat se svým Office 365 tenantem, najdete v tématu Sítě pro doručování obsahu.

Výchozí zdroje CDN

Pokud neurčíte jinak, Office 365 při povolení Office 365 CDN nastaví některé výchozí zdroje. Pokud se původně rozhodnete je nezřizovat, můžete je po dokončení instalace přidat. Pokud nerozumíte důsledkům přeskočení nastavení výchozích zdrojů a nemáte k tomu konkrétní důvod, měli byste je při povolení CDN povolit.

Výchozí privátní zdroje CDN:

  • */siteassets

Výchozí veřejné zdroje CDN:

  • */Masterpage
  • */knihovna stylů
  • */hodnocení na straně klienta

Poznámka

clientsideassets je výchozí veřejný zdroj, který byl přidán do služby Office 365 CDN v prosinci 2017. Tento původ musí být přítomen, aby SharePoint Framework řešení v CDN fungovala. Pokud jste Office 365 CDN povolili před prosincem 2017 nebo pokud jste při povolení CDN vynechali nastavení výchozích zdrojů, můžete ho přidat ručně. Další informace najdete v článku Webová část nebo řešení SharePoint Framework na straně klienta nefunguje.

Nastavení a konfigurace Office 365 CDN pomocí prostředí SharePoint Online Management Shell

Postupy v této části vyžadují, abyste pro připojení k SharePointu Online použili prostředí SharePoint Online Management Shell. Pokyny najdete v tématu Připojení k PowerShellu SharePointu Online.

Pomocí těchto kroků nastavte a nakonfigurujte síť CDN pro hostování vašich prostředků v SharePointu Online pomocí prostředí SharePoint Online Management Shell.

Kliknutím rozbalíte

Povolení používání Office 365 CDN ve vaší organizaci

Než provedete změny nastavení CDN tenanta, měli byste načíst aktuální stav konfigurace privátní sítě CDN ve vašem Office 365 tenantovi. Připojte se ke svému tenantovi pomocí prostředí SharePoint Online Management Shell:

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

Teď pomocí rutiny Get-SPOTenantCdnEnabled načtěte nastavení stavu CDN z tenanta:

Get-SPOTenantCdnEnabled -CdnType <Public | Private>

Stav CDN zadaného CdnType se zobrazí na obrazovce.

Pomocí rutiny Set-SPOTenantCdnEnabled umožníte vaší organizaci používat Office 365 CDN. Organizaci můžete povolit, aby používala veřejné zdroje, soukromé zdroje nebo obojí najednou. CdN můžete také nakonfigurovat tak, aby při povolení přeskočí nastavení výchozích zdrojů. Tyto původy můžete vždy přidat později, jak je popsáno v tomto tématu.

V Windows PowerShell pro SharePoint Online:

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

Pokud například chcete, aby vaše organizace mohla používat veřejné i soukromé zdroje, zadejte následující příkaz:

Set-SPOTenantCdnEnabled -CdnType Both -Enable $true

Pokud chcete, aby vaše organizace mohla používat veřejné i privátní zdroje, ale chcete přeskočit nastavení výchozích zdrojů, zadejte následující příkaz:

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

Informace o zdrojích, které jsou ve výchozím nastavení zřízené při povolení Office 365 CDN, a potenciální dopad přeskočení nastavení výchozích zdrojů najdete v tématu Výchozí zdroje CDN.

Pokud chcete, aby vaše organizace používala veřejné zdroje, zadejte následující příkaz:

Set-SPOTenantCdnEnabled -CdnType Public -Enable $true

Pokud chcete, aby vaše organizace mohla používat privátní zdroje, zadejte následující příkaz:

Set-SPOTenantCdnEnabled -CdnType Private -Enable $true

Další informace o této rutině najdete v tématu Set-SPOTenantCdnEnabled.

Změna seznamu typů souborů, které se mají zahrnout do Office 365 CDN (volitelné)

Tip

Při definování typů souborů pomocí rutiny Set-SPOTenantCdnPolicy přepíšete aktuálně definovaný seznam. Pokud chcete do seznamu přidat další typy souborů, nejprve pomocí rutiny zjistěte, jaké typy souborů jsou už povolené, a přidejte je do seznamu spolu s novými typy souborů.

Pomocí rutiny Set-SPOTenantCdnPolicy definujte typy statických souborů, které mohou být hostovány veřejnými a privátními zdroji ve službě CDN. Ve výchozím nastavení jsou povolené běžné typy prostředků, například .css, .gif, .jpg a .js.

V Windows PowerShell pro SharePoint Online:

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

Pokud chcete například povolit cdn hostovat soubory .css a .png, zadejte příkaz:

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

Pokud chcete zjistit, jaké typy souborů jsou aktuálně povolené sítí CDN, použijte rutinu Get-SPOTenantCdnPolicies :

Get-SPOTenantCdnPolicies -CdnType <Public | Private>

Další informace o těchto rutinách najdete v tématech Set-SPOTenantCdnPolicy a Get-SPOTenantCdnPolicies.

Změna seznamu klasifikací webů, které chcete vyloučit z Office 365 CDN (volitelné)

Tip

Když vyloučíte klasifikace webu pomocí rutiny Set-SPOTenantCdnPolicy , přepíšete aktuálně definovaný seznam. Pokud chcete vyloučit další klasifikace webu, pomocí rutiny nejprve zjistěte, jaké klasifikace jsou už vyloučené, a pak je přidejte spolu s novými klasifikacemi.

Pomocí rutiny Set-SPOTenantCdnPolicy vyloučíte klasifikace webů, které nechcete zpřístupnit přes CDN. Ve výchozím nastavení nejsou vyloučeny žádné klasifikace webů.

V Windows PowerShell pro SharePoint Online:

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

Pokud chcete zjistit, jaké klasifikace webů jsou aktuálně omezené, použijte rutinu Get-SPOTenantCdnPolicies :

Get-SPOTenantCdnPolicies -CdnType <Public | Private>

Vlastnosti, které budou vráceny jsou IncludeFileExtensions, ExcludeRestrictedSiteClassifications a ExcludeIfNoScriptDisabled.

IncludeFileExtensions Vlastnost obsahuje seznam přípon souborů, které budou obsluhovány z CDN.

Poznámka

Výchozí přípony souborů se liší mezi veřejnými a soukromými.

ExcludeRestrictedSiteClassifications Vlastnost obsahuje klasifikace webu, které chcete vyloučit z CDN. Můžete například vyloučit weby označené jako Důvěrné , takže obsah z webů s použitou klasifikací nebude ze sítě CDN obsluhovat.

ExcludeIfNoScriptDisabled Vlastnost vylučuje obsah z CDN na základě nastavení atributu NoScript na úrovni webu. Ve výchozím nastavení je atribut NoScript nastavený na Povoleno pro moderní weby a Zakázáno pro klasické weby. To závisí na nastavení vašeho tenanta.

Další informace o těchto rutinách najdete v tématech Set-SPOTenantCdnPolicy a Get-SPOTenantCdnPolicies.

Přidání zdroje pro vaše prostředky

K definování původu použijte rutinu Add-SPOTenantCdnOrigin . Můžete definovat více původů. Původ je adresa URL, která odkazuje na sharepointovou knihovnu nebo složku obsahující prostředky, které chcete hostovat v CDN.

Důležité

Nikdy byste neměli umisťovat prostředky, které obsahují informace o uživatelích nebo jsou považovány za citlivé pro vaši organizaci, do veřejného zdroje.

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

Hodnota path je relativní cesta ke knihovně nebo složce, která obsahuje prostředky. Kromě relativních cest můžete použít zástupné é ou. Origins podporují zástupné cardy předefinované k adrese URL. To vám umožní vytvořit původy, které zahrnují více webů. Pokud chcete například zahrnout všechny prostředky ve složce masterpages pro všechny weby jako veřejný zdroj v rámci CDN, zadejte následující příkaz:

Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
  • Modifikátor zástupného znaku */ lze použít pouze na začátku cesty a bude odpovídat všem segmentům adresy URL pod zadanou adresou URL.
  • Cesta může odkazovat na knihovnu dokumentů, složku nebo web. Například cesta */site1 bude odpovídat všem knihovnám dokumentů v rámci webu.

Můžete přidat původ s konkrétní relativní cestou. Nelze přidat původ pomocí úplné cesty.

Tento příklad přidá privátní zdroj knihovny siteassets na konkrétní web:

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

Tento příklad přidá privátní zdroj složky folder1 v knihovně prostředků webů kolekce webů:

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

Pokud je v cestě mezera, můžete ji buď obehnou dvojitými uvozovkami, nebo nahradit mezeru kódováním adresy URL %20. Následující příklady přidají soukromý původ složky 1 v knihovně prostředků webů kolekce webů:

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

Další informace o tomto příkazu a jeho syntaxi najdete v tématu Add-SPOTenantCdnOrigin.

Poznámka

V privátních zdrojích musí mít prostředky sdílené z původu publikovanou hlavní verzi, aby k nim bylo možné získat přístup z CDN.

Po spuštění příkazu systém synchronizuje konfiguraci napříč datovým centrem. Může to trvat až 15 minut.

Příklad: Konfigurace veřejného zdroje pro stránky předlohy a pro knihovnu stylů pro SharePoint Online

Za normálních okolností se tyto zdroje nastaví ve výchozím nastavení, když povolíte Office 365 CDN. Pokud je ale chcete povolit ručně, postupujte takto.

  • Pomocí rutiny Add-SPOTenantCdnOrigin definujte knihovnu stylů jako veřejný zdroj.

    Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */style%20library
    
  • Pomocí rutiny Add-SPOTenantCdnOrigin definujte stránky předlohy jako veřejný zdroj.

    Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
    

Další informace o tomto příkazu a jeho syntaxi najdete v tématu Add-SPOTenantCdnOrigin.

Po spuštění příkazu systém synchronizuje konfiguraci napříč datovým centrem. Může to trvat až 15 minut.

Příklad: Konfigurace privátního zdroje pro prostředky webu, stránky webu a obrázky publikování pro SharePoint Online

  • Pomocí rutiny Add-SPOTenantCdnOrigin definujte složku prostředků webu jako privátní zdroj.

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */siteassets
    
  • Pomocí rutiny Add-SPOTenantCdnOrigin definujte složku stránek webu jako privátní zdroj.

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */sitepages
    
  • Pomocí rutiny Add-SPOTenantCdnOrigin definujte složku imagí publikování jako privátní zdroj.

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */publishingimages
    

Další informace o tomto příkazu a jeho syntaxi najdete v tématu Add-SPOTenantCdnOrigin.

Po spuštění příkazu systém synchronizuje konfiguraci napříč datovým centrem. Může to trvat až 15 minut.

Příklad: Konfigurace privátního zdroje pro kolekci webů pro SharePoint Online

Pomocí rutiny Add-SPOTenantCdnOrigin definujte kolekci webů jako privátní zdroj. Příklad:

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

Další informace o tomto příkazu a jeho syntaxi najdete v tématu Add-SPOTenantCdnOrigin.

Po spuštění příkazu systém synchronizuje konfiguraci napříč datovým centrem. Může se zobrazit zpráva Čekající na konfiguraci , která se očekává, když se tenant SharePointu Online připojuje ke službě CDN. Může to trvat až 15 minut.

Správa Office 365 CDN

Po nastavení CDN můžete měnit konfiguraci při aktualizaci obsahu nebo při změnách vašich potřeb, jak je popsáno v této části.

Přidání, aktualizace nebo odebrání prostředků z Office 365 CDN

Po dokončení instalačních kroků můžete přidat nové prostředky a aktualizovat nebo odebrat existující prostředky, kdykoli budete chtít. Stačí provést změny v prostředcích ve složce nebo knihovně SharePointu, které jste identifikovali jako původ. Pokud přidáte nový prostředek, bude okamžitě dostupný prostřednictvím sítě CDN. Pokud ale prostředek aktualizujete, bude trvat až 15 minut, než se nová kopie rozšíří a zpřístupní ve službě CDN.

Pokud potřebujete načíst umístění původu, můžete použít rutinu Get-SPOTenantCdnOrigins . Informace o použití této rutiny najdete v tématu Get-SPOTenantCdnOrigins.

Odebrání zdroje ze Office 365 CDN

Přístup ke složce nebo knihovně SharePointu, které jste identifikovali jako původ, můžete odebrat. K tomu použijte rutinu Remove-SPOTenantCdnOrigin .

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

Informace o použití této rutiny najdete v tématu Remove-SPOTenantCdnOrigin.

Úprava původu v Office 365 CDN

Původ, který jste vytvořili, nemůžete změnit. Místo toho odeberte původ a přidejte nový. Další informace najdete v tématech Odebrání zdroje ze Office 365 CDN a Přidání zdroje pro prostředky.

Zakázání Office 365 CDN

Pomocí rutiny Set-SPOTenantCdnEnabled zakažte síť CDN pro vaši organizaci. Pokud máte pro CDN povolený veřejný i privátní původ, musíte rutinu spustit dvakrát, jak je znázorněno v následujících příkladech.

Pokud chcete zakázat používání veřejných zdrojů ve službě CDN, zadejte následující příkaz:

Set-SPOTenantCdnEnabled -CdnType Public -Enable $false

Pokud chcete zakázat používání privátních zdrojů ve službě CDN, zadejte následující příkaz:

Set-SPOTenantCdnEnabled -CdnType Private -Enable $false

Další informace o této rutině najdete v tématu Set-SPOTenantCdnEnabled.

Nastavení a konfigurace Office 365 CDN pomocí PowerShellu PnP

Postupy v této části vyžadují, abyste pro připojení k SharePointu Online použili PowerShell PnP. Pokyny najdete v tématu Začínáme s PnP PowerShellem.

Pomocí těchto kroků nastavte a nakonfigurujte síť CDN pro hostování vašich prostředků v SharePointu Online pomocí PnP PowerShellu.

Kliknutím rozbalíte

Povolení používání Office 365 CDN ve vaší organizaci

Než provedete změny nastavení CDN tenanta, měli byste načíst aktuální stav konfigurace privátní sítě CDN ve vašem Office 365 tenantovi. Připojte se k tenantovi pomocí PowerShellu PnP:

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

Teď pomocí rutiny Get-PnPTenantCdnEnabled načtěte nastavení stavu CDN z tenanta:

Get-PnPTenantCdnEnabled -CdnType <Public | Private>

Stav CDN zadaného CdnType se zobrazí na obrazovce.

Pomocí rutiny Set-PnPTenantCdnEnabled umožníte vaší organizaci používat Office 365 CDN. Organizaci můžete povolit, aby používala veřejné zdroje, soukromé zdroje nebo obojí najednou. CdN můžete také nakonfigurovat tak, aby při povolení přeskočí nastavení výchozích zdrojů. Tyto původy můžete vždy přidat později, jak je popsáno v tomto tématu.

V PowerShellu PnP:

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

Pokud například chcete, aby vaše organizace mohla používat veřejné i soukromé zdroje, zadejte následující příkaz:

Set-PnPTenantCdnEnabled -CdnType Both -Enable $true

Pokud chcete, aby vaše organizace mohla používat veřejné i privátní zdroje, ale chcete přeskočit nastavení výchozích zdrojů, zadejte následující příkaz:

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

Informace o zdrojích, které jsou ve výchozím nastavení zřízené při povolení Office 365 CDN, a potenciální dopad přeskočení nastavení výchozích zdrojů najdete v tématu Výchozí zdroje CDN.

Pokud chcete, aby vaše organizace používala veřejné zdroje, zadejte následující příkaz:

Set-PnPTenantCdnEnabled -CdnType Public -Enable $true

Pokud chcete, aby vaše organizace mohla používat privátní zdroje, zadejte následující příkaz:

Set-PnPTenantCdnEnabled -CdnType Private -Enable $true

Další informace o této rutině najdete v tématu Set-PnPTenantCdnEnabled.

Změna seznamu typů souborů, které se mají zahrnout do Office 365 CDN (volitelné)

Tip

Při definování typů souborů pomocí rutiny Set-PnPTenantCdnPolicy přepíšete aktuálně definovaný seznam. Pokud chcete do seznamu přidat další typy souborů, nejprve pomocí rutiny zjistěte, jaké typy souborů jsou už povolené, a přidejte je do seznamu spolu s novými typy souborů.

Pomocí rutiny Set-PnPTenantCdnPolicy definujte statické typy souborů, které mohou být hostovány veřejnými a privátními zdroji ve službě CDN. Ve výchozím nastavení jsou povolené běžné typy prostředků, například .css, .gif, .jpg a .js.

V PowerShellu PnP:

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

Pokud chcete například povolit cdn hostovat soubory .css a .png, zadejte příkaz:

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

Pokud chcete zjistit, jaké typy souborů jsou aktuálně povolené sítí CDN, použijte rutinu Get-PnPTenantCdnPolicies :

Get-PnPTenantCdnPolicies -CdnType <Public | Private>

Další informace o těchto rutinách najdete v tématech Set-PnPTenantCdnPolicy a Get-PnPTenantCdnPolicies.

Změna seznamu klasifikací webů, které chcete vyloučit z Office 365 CDN (volitelné)

Tip

Když vyloučíte klasifikace webu pomocí rutiny Set-PnPTenantCdnPolicy , přepíšete aktuálně definovaný seznam. Pokud chcete vyloučit další klasifikace webu, pomocí rutiny nejprve zjistěte, jaké klasifikace jsou už vyloučené, a pak je přidejte spolu s novými klasifikacemi.

Pomocí rutiny Set-PnPTenantCdnPolicy vyloučíte klasifikace webů, které nechcete zpřístupnit přes CDN. Ve výchozím nastavení nejsou vyloučeny žádné klasifikace webů.

V PowerShellu PnP:

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

Pokud chcete zjistit, jaké klasifikace webů jsou aktuálně omezené, použijte rutinu Get-PnPTenantCdnPolicies :

Get-PnPTenantCdnPolicies -CdnType <Public | Private>

Vlastnosti, které budou vráceny jsou IncludeFileExtensions, ExcludeRestrictedSiteClassifications a ExcludeIfNoScriptDisabled.

IncludeFileExtensions Vlastnost obsahuje seznam přípon souborů, které budou obsluhovány z CDN.

Poznámka

Výchozí přípony souborů se liší mezi veřejnými a soukromými.

ExcludeRestrictedSiteClassifications Vlastnost obsahuje klasifikace webu, které chcete vyloučit z CDN. Můžete například vyloučit weby označené jako Důvěrné , takže obsah z webů s použitou klasifikací nebude ze sítě CDN obsluhovat.

ExcludeIfNoScriptDisabled Vlastnost vylučuje obsah z CDN na základě nastavení atributu NoScript na úrovni webu. Ve výchozím nastavení je atribut NoScript nastavený na Povoleno pro moderní weby a Zakázáno pro klasické weby. To závisí na nastavení vašeho tenanta.

Další informace o těchto rutinách najdete v tématech Set-PnPTenantCdnPolicy a Get-PnPTenantCdnPolicies.

Přidání zdroje pro vaše prostředky

K definování původu použijte rutinu Add-PnPTenantCdnOrigin . Můžete definovat více původů. Původ je adresa URL, která odkazuje na sharepointovou knihovnu nebo složku obsahující prostředky, které chcete hostovat v CDN.

Důležité

Nikdy byste neměli umisťovat prostředky, které obsahují informace o uživatelích nebo jsou považovány za citlivé pro vaši organizaci, do veřejného zdroje.

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

Hodnota path je relativní cesta ke knihovně nebo složce, která obsahuje prostředky. Kromě relativních cest můžete použít zástupné é ou. Origins podporují zástupné cardy předefinované k adrese URL. To vám umožní vytvořit původy, které zahrnují více webů. Pokud chcete například zahrnout všechny prostředky ve složce masterpages pro všechny weby jako veřejný zdroj v rámci CDN, zadejte následující příkaz:

Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
  • Modifikátor zástupného znaku */ lze použít pouze na začátku cesty a bude odpovídat všem segmentům adresy URL pod zadanou adresou URL.
  • Cesta může odkazovat na knihovnu dokumentů, složku nebo web. Například cesta */site1 bude odpovídat všem knihovnám dokumentů v rámci webu.

Můžete přidat původ s konkrétní relativní cestou. Nelze přidat původ pomocí úplné cesty.

Tento příklad přidá privátní zdroj knihovny prostředků webu na konkrétním webu:

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

Tento příklad přidá privátní zdroj složky folder1 v knihovně prostředků webů kolekce webů:

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

Pokud je v cestě mezera, můžete ji buď obehnou dvojitými uvozovkami, nebo nahradit mezeru kódováním adresy URL %20. Následující příklady přidají soukromý původ složky 1 v knihovně prostředků webů kolekce webů:

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

Další informace o tomto příkazu a jeho syntaxi najdete v tématu Add-PnPTenantCdnOrigin.

Poznámka

V privátních zdrojích musí mít prostředky sdílené z původu publikovanou hlavní verzi, aby k nim bylo možné získat přístup z CDN.

Po spuštění příkazu systém synchronizuje konfiguraci napříč datovým centrem. Může to trvat až 15 minut.

Příklad: Konfigurace veřejného zdroje pro stránky předlohy a pro knihovnu stylů pro SharePoint Online

Za normálních okolností se tyto zdroje nastaví ve výchozím nastavení, když povolíte Office 365 CDN. Pokud je ale chcete povolit ručně, postupujte takto.

  • Pomocí rutiny Add-PnPTenantCdnOrigin definujte knihovnu stylů jako veřejný zdroj.

    Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */style%20library
    
  • Pomocí rutiny Add-PnPTenantCdnOrigin definujte stránky předlohy jako veřejný zdroj.

    Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
    

Další informace o tomto příkazu a jeho syntaxi najdete v tématu Add-PnPTenantCdnOrigin.

Po spuštění příkazu systém synchronizuje konfiguraci napříč datovým centrem. Může to trvat až 15 minut.

Příklad: Konfigurace privátního zdroje pro prostředky webu, stránky webu a obrázky publikování pro SharePoint Online

  • Pomocí rutiny Add-PnPTenantCdnOrigin definujte složku prostředků webu jako privátní zdroj.

    Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */siteassets
    
  • Pomocí rutiny Add-PnPTenantCdnOrigin definujte složku stránek webu jako privátní zdroj.

    Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */sitepages
    
  • Pomocí rutiny Add-PnPTenantCdnOrigin definujte složku imagí publikování jako privátní zdroj.

    Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */publishingimages
    

Další informace o tomto příkazu a jeho syntaxi najdete v tématu Add-PnPTenantCdnOrigin.

Po spuštění příkazu systém synchronizuje konfiguraci napříč datovým centrem. Může to trvat až 15 minut.

Příklad: Konfigurace privátního zdroje pro kolekci webů pro SharePoint Online

Pomocí rutiny Add-PnPTenantCdnOrigin definujte kolekci webů jako privátní zdroj. Příklad:

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

Další informace o tomto příkazu a jeho syntaxi najdete v tématu Add-PnPTenantCdnOrigin.

Po spuštění příkazu systém synchronizuje konfiguraci napříč datovým centrem. Může se zobrazit zpráva Čekající na konfiguraci , která se očekává, když se tenant SharePointu Online připojuje ke službě CDN. Může to trvat až 15 minut.

Správa Office 365 CDN

Po nastavení CDN můžete měnit konfiguraci při aktualizaci obsahu nebo při změnách vašich potřeb, jak je popsáno v této části.

Přidání, aktualizace nebo odebrání prostředků z Office 365 CDN

Po dokončení instalačních kroků můžete přidat nové prostředky a aktualizovat nebo odebrat existující prostředky, kdykoli budete chtít. Stačí provést změny v prostředcích ve složce nebo knihovně SharePointu, které jste identifikovali jako původ. Pokud přidáte nový prostředek, bude okamžitě dostupný prostřednictvím sítě CDN. Pokud ale prostředek aktualizujete, bude trvat až 15 minut, než se nová kopie rozšíří a zpřístupní ve službě CDN.

Pokud potřebujete načíst umístění původu, můžete použít rutinu Get-PnPTenantCdnOrigin . Informace o použití této rutiny najdete v tématu Get-PnPTenantCdnOrigin.

Odebrání zdroje ze Office 365 CDN

Přístup ke složce nebo knihovně SharePointu, které jste identifikovali jako původ, můžete odebrat. K tomu použijte rutinu Remove-PnPTenantCdnOrigin .

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

Informace o použití této rutiny najdete v tématu Remove-PnPTenantCdnOrigin.

Úprava původu v Office 365 CDN

Původ, který jste vytvořili, nemůžete změnit. Místo toho odeberte původ a přidejte nový. Další informace najdete v tématech Odebrání zdroje ze Office 365 CDN a Přidání zdroje pro prostředky.

Zakázání Office 365 CDN

Pomocí rutiny Set-PnPTenantCdnEnabled zakažte síť CDN pro vaši organizaci. Pokud máte pro CDN povolený veřejný i privátní původ, musíte rutinu spustit dvakrát, jak je znázorněno v následujících příkladech.

Pokud chcete zakázat používání veřejných zdrojů ve službě CDN, zadejte následující příkaz:

Set-PnPTenantCdnEnabled -CdnType Public -Enable $false

Pokud chcete zakázat používání privátních zdrojů ve službě CDN, zadejte následující příkaz:

Set-PnPTenantCdnEnabled -CdnType Private -Enable $false

Další informace o této rutině najdete v tématu Set-PnPTenantCdnEnabled.

Nastavení a konfigurace Office 365 CDN pomocí rozhraní příkazového řádku pro Microsoft 365

Postupy v této části vyžadují, abyste nainstalovali rozhraní příkazového řádku pro Microsoft 365. Pak se pomocí příkazu login připojte ke svému tenantovi Office 365.

Pomocí těchto kroků nastavte a nakonfigurujte síť CDN pro hostování vašich prostředků v SharePointu Online pomocí rozhraní příkazového řádku pro Microsoft 365.

Kliknutím rozbalíte

Povolení Office 365 CDN

Stav Office 365 CDN ve vašem tenantovi můžete spravovat pomocí příkazu spo cdn set.

Pokud chcete povolit Office 365 veřejnou síť CDN ve vašem tenantovi, spusťte následující příkaz:

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

Pokud chcete povolit Office 365 SHAREPoint CDN, spusťte:

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

Zobrazení aktuálního stavu Office 365 CDN

Pokud chcete zkontrolovat, jestli je konkrétní typ Office 365 CDN povolený nebo zakázaný, použijte příkaz spo cdn get.

Pokud chcete zkontrolovat, jestli je Office 365 veřejná síť CDN povolená, spusťte:

m365 spo cdn get --type Public

Zobrazení Office 365 původů CDN

Chcete-li zobrazit aktuálně nakonfigurované zdroje Office 365 veřejných zdrojů CDN, spusťte:

m365 spo cdn origin list --type Public

Informace o původech, které jsou ve výchozím nastavení zřízené při povolení Office 365 CDN, najdete v tématu Výchozí zdroje CDN.

Přidání zdroje Office 365 CDN

Důležité

Nikdy byste neměli umisťovat prostředky, které jsou považovány za citlivé pro vaši organizaci, do sharepointové knihovny dokumentů nakonfigurované jako veřejný zdroj.

Pomocí příkazu spo cdn origin add definujte původ CDN. Můžete definovat více původů. Původ je adresa URL, která odkazuje na sharepointovou knihovnu nebo složku obsahující prostředky, které chcete hostovat v CDN.

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

Kde path je relativní cesta ke složce, která obsahuje prostředky. Kromě relativních cest můžete použít zástupné é ou.

Pokud chcete zahrnout všechny prostředky do galerie stránek předlohy všech webů jako veřejný zdroj, spusťte:

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

Pokud chcete nakonfigurovat privátní zdroj pro konkrétní kolekci webů, spusťte:

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

Poznámka

Po přidání zdroje CDN může trvat až 15 minut, než budete moct načíst soubory prostřednictvím služby CDN. Pomocí příkazu spo cdn origin list můžete ověřit, jestli už je konkrétní původ povolený.

Odebrání zdroje Office 365 CDN

Pomocí příkazu spo cdn origin remove odeberte zdroj CDN pro zadaný typ CDN.

Pokud chcete z konfigurace CDN odebrat veřejný zdroj, spusťte následující příkaz:

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

Poznámka

Odebrání zdroje CDN nemá vliv na soubory uložené v žádné knihovně dokumentů, která odpovídá danému původu. Pokud se na tyto prostředky odkazuje pomocí sharepointové adresy URL, SharePoint se automaticky přepne zpět na původní adresu URL odkazující na knihovnu dokumentů. Pokud se ale na prostředky odkazuje pomocí veřejné adresy URL CDN, odebráním původu se odkaz přeruší a budete je muset ručně změnit.

Úprava původu Office 365 CDN

Není možné upravit existující původ CDN. Místo toho byste měli odebrat dříve definovaný původ CDN pomocí spo cdn origin remove příkazu a přidat nový pomocí příkazu spo cdn origin add .

Změna typů souborů, které se mají zahrnout do Office 365 CDN

Ve výchozím nastavení jsou do CDN zahrnuty následující typy souborů: .css, .eot, .gif, .ico, .jpeg, .jpg, .js, .map, .png, .svg, .ttf, .woff a .woff2. Pokud potřebujete do sítě CDN zahrnout další typy souborů, můžete konfiguraci CDN změnit pomocí příkazu spo cdn policy set .

Poznámka

Při změně seznamu typů souborů přepíšete aktuálně definovaný seznam. Pokud chcete zahrnout další typy souborů, nejprve pomocí příkazu spo cdn policy list zjistěte, které typy souborů jsou aktuálně nakonfigurované.

Pokud chcete přidat typ souboru JSON do výchozího seznamu typů souborů zahrnutých ve veřejné síti CDN, spusťte:

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

Změna seznamu klasifikací webů, které chcete vyloučit z Office 365 CDN

Pomocí příkazu spo cdn policy set vyloučíte klasifikace webu, které nechcete zpřístupnit přes CDN. Ve výchozím nastavení nejsou vyloučeny žádné klasifikace webů.

Poznámka

Při změně seznamu vyloučených klasifikací webu přepíšete aktuálně definovaný seznam. Pokud chcete vyloučit další klasifikace, nejprve pomocí příkazu spo cdn policy list zjistěte, které klasifikace jsou aktuálně nakonfigurované.

Pokud chcete z veřejné sítě CDN vyloučit lokality klasifikované jako HBI , spusťte příkaz

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

Zakázání Office 365 CDN

Pokud chcete zakázat Office 365 CDN, použijte spo cdn set například příkaz:

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

Použití prostředků CDN

Teď, když jste povolili CDN a nakonfigurovali původy a zásady, můžete začít používat prostředky CDN.

Tato část vám pomůže pochopit, jak používat adresy URL CDN na sharepointových stránkách a v obsahu, aby SharePoint přesměrovává žádosti o prostředky veřejného i soukromého původu do cdn.

Informace o tom, jak používat síť CDN k hostování webových částí na straně klienta, najdete v tématu Hostování webové části na straně klienta z Office 365 CDN (Hello World část 4).

Poznámka

Pokud přidáte složku ClientSideAssets do seznamu zdrojů privátní sítě CDN, vlastní webové části hostované sítí CDN se nepodaří vykreslit. Soubory používané webovými částmi SPFX můžou využívat pouze veřejnou síť CDN a složka ClientSideAssets je výchozím zdrojem pro veřejnou síť CDN.

Pokud chcete použít prostředky, které jste přidali do zdroje, stačí aktualizovat odkazy na původní soubor s cestou k souboru v původním zdroji.

  • Upravte stránku nebo obsah, který obsahuje odkazy na prostředky, které jste přidali do zdroje. Pokud chcete aktualizovat odkaz na daný prostředek všude, kde se zobrazí, můžete použít také jednu z několika metod ke globálnímu vyhledávání a nahrazení odkazů na zadaný web nebo kolekci webů.
  • U každého odkazu na prostředek v počátku nahraďte cestu cestou k souboru v zdroji CDN. Můžete použít relativní cesty.
  • Uložte stránku nebo obsah.

Představte si například obrázek /site/SiteAssets/images/image.png, který jste zkopírovali do složky knihovny dokumentů /site/CDN_origins/public/. Pokud chcete použít prostředek CDN, nahraďte původní cestu k umístění souboru obrázku cestou ke zdroji, aby se nová adresa URL /site/CDN_origins/public/image.png.

Pokud chcete místo relativní cesty použít úplnou adresu URL k prostředku, vytvořte odkaz takto:

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

Poznámka

Obecně platí, že adresy URL byste neměli pevně zakódovat přímo k prostředkům ve službě CDN. V případě potřeby ale můžete ručně vytvořit adresy URL pro prostředky ve veřejných zdrojích. Další informace najdete v tématu Pevné kódování adres URL CDN pro veřejné prostředky.

Informace o tom, jak ověřit, že se prostředky obsluhují ze sítě CDN, najdete v tématu Návody potvrzení, že prostředky obsluhuje CDN? v tématu Řešení potíží s Office 365 CDN.

Použití prostředků ve veřejných zdrojích

Funkce Publikování v SharePointu Online automaticky přepíše adresy URL prostředků uložených ve veřejných zdrojích na jejich ekvivalenty CDN, aby se prostředky obsluhovaly ze služby CDN místo ze SharePointu.

Pokud je váš původ na webu s povolenou funkcí Publikování a prostředky, které chcete přesměrovat do CDN, jsou v jedné z následujících kategorií, SharePoint automaticky přepíše adresy URL pro prostředky v původu za předpokladu, že prostředek nebyl vyloučen zásadami CDN.

Tady je přehled toho, které odkazy jsou automaticky přepsány funkcí publikování SharePointu:

  • Adresy URL IMG/LINK/CSS v klasických odpovědích HTML stránek publikování
    • To zahrnuje obrázky přidané autory v rámci html obsahu stránky.
  • Snímky knihovny obrázkůShow adresy URL obrázků webových částí
  • Pole obrázků ve výsledcích rozhraní SPList REST API (RenderListDataAsStream)
    • Pomocí nové vlastnosti ImageFieldsToTryRewriteToCdnUrls zadejte seznam polí oddělených čárkami.
    • Podporuje pole hypertextových odkazů a pole PublishingImage.
  • Verze obrázků SharePointu

Následující diagram znázorňuje pracovní postup, když SharePoint obdrží požadavek na stránku obsahující prostředky z veřejného zdroje.

Diagram pracovního postupu: Načítání Office 365 prostředků CDN z veřejného zdroje

Tip

Pokud chcete zakázat automatické přepisování pro konkrétní adresy URL na stránce, můžete se podívat na stránku a přidat parametr řetězce dotazu ? NoAutoReWrites=true na konec každého odkazu, který chcete zakázat.

Vytváření adres URL CDN pro veřejné prostředky

Pokud funkce publikování není povolená pro veřejný zdroj nebo prostředek není jedním z typů odkazů podporovaných funkcí automatického přepisu služby CDN, můžete ručně vytvořit adresy URL pro umístění cdn prostředků a použít tyto adresy URL ve svém obsahu.

Poznámka

Nelze pevně zakódovat ani vytvořit adresy URL CDN k prostředkům v privátním zdroji, protože požadovaný přístupový token, který tvoří poslední část adresy URL, se generuje v okamžiku, kdy je prostředek požadován. Můžete vytvořit adresu URL pro veřejné CDN a adresa URL by neměla být pevně zakódovaná, protože se může změnit.

U veřejných prostředků CDN bude formát adresy URL vypadat takto:

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

Nahraďte TenantHostName názvem vašeho tenanta. Příklad:

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

Poznámka

Vlastnost kontextu stránky by se měla použít k vytvoření předpony místo pevného kódování "https://publiccdn.sharepointonline.com". Adresa URL se může změnit a neměla by být pevně zakódovaná. Pokud používáte šablony zobrazení s klasickým SharePointem Online, můžete použít vlastnost "window._spPageContextInfo.publicCdnBaseUrl" v šabloně zobrazení pro předponu adresy URL. Pokud jste webové části SPFx pro moderní a klasické SharePoint, můžete použít vlastnost "this.context.pageContext.legacyPageContext.publicCdnBaseUrl". Tím se předpona poskytne, takže pokud se změní, vaše implementace se s ní aktualizuje. Jako příklad pro SPFx lze adresu URL vytvořit pomocí vlastnosti "this.context.pageContext.legacyPageContext.publicCdnBaseUrl" + "/" + "host" + "/" + "relativeURL pro položku". Projděte si téma Použití CDN v kódu na straně klienta , který je součástí série výkonu 1. sezóny.

Použití prostředků v privátních zdrojích

K použití prostředků v privátních zdrojích není nutná žádná další konfigurace. SharePoint Online automaticky přepisuje adresy URL prostředků v privátních zdrojích, takže žádosti o tyto prostředky budou vždy obslouženy ze sítě CDN. Adresy URL pro prostředky CDN v privátních zdrojích nelze vytvářet ručně, protože tyto adresy URL obsahují tokeny, které musí SharePoint Online automaticky vygenerovat v okamžiku, kdy je prostředek požadován.

Přístup k prostředkům v privátních zdrojích je chráněn dynamicky generovanými tokeny na základě uživatelských oprávnění ke zdroji s upozorněními popsanými v následujících částech. Uživatelé musí mít alespoň přístup ke čtení původů, aby cdn vykreslovat obsah.

Následující diagram znázorňuje pracovní postup, když SharePoint obdrží požadavek na stránku obsahující prostředky ze soukromého zdroje.

Diagram pracovního postupu: Načítání Office 365 prostředků CDN ze soukromého zdroje

Autorizace založená na tokenech v privátních zdrojích

Přístup k prostředkům v privátních zdrojích ve Office 365 CDN je udělován tokeny vygenerovanými SharePointem Online. Uživatelům, kteří už mají oprávnění pro přístup ke složce nebo knihovně určené zdrojem, se automaticky udělí tokeny, které uživateli umožní přístup k souboru na základě jejich úrovně oprávnění. Tyto přístupové tokeny jsou platné 30 až 90 minut po vygenerování, aby se zabránilo útokům na opakované přehrání tokenů.

Po vygenerování přístupového tokenu vrátí SharePoint Online klientovi vlastní identifikátor URI obsahující dva parametry autorizace ( hraniční autorizační token) a oat (autorizační token původu). Struktura každého tokenu je <"doba vypršení platnosti ve formátu epochového času">__<'zabezpečený podpis'>. Příklad:

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

Poznámka

Kdokoli, kdo má token, má přístup k prostředku ve službě CDN. Adresy URL obsahující tyto přístupové tokeny se ale sdílí jenom přes HTTPS, takže pokud adresu URL explicitně nesdílí koncový uživatel před vypršením platnosti tokenu, nebude prostředek přístupný neoprávněným uživatelům.

U prostředků v privátních zdrojích se nepodporují oprávnění na úrovni položek.

Je důležité si uvědomit, že SharePoint Online nepodporuje oprávnění na úrovni položek pro prostředky v privátních zdrojích. Například pro soubor umístěný na adrese https://contoso.sharepoint.com/sites/site1/library1/folder1/image1.jpgmají uživatelé efektivní přístup k souboru za následujících podmínek:

User Oprávnění Efektivní přístup
Uživatel 1 Má přístup ke složce1. Má přístup k image1.jpg ze sítě CDN.
Uživatel 2 Nemá přístup ke složce folder1. Nejde získat přístup k image1.jpg z CDN
Uživatel 3 Nemá přístup ke složce folder1, ale má udělené explicitní oprávnění pro přístup k image1.jpg v SharePointu Online. Má přístup k image1.jpg prostředku přímo ze SharePointu Online, ale ne z CDN.
Uživatel 4 Má přístup ke složce folder1, ale explicitně mu byl odepřen přístup k image1.jpg v SharePointu Online. Nejde získat přístup k prostředku ze SharePointu Online, ale může k ho přistupovat z CDN, přestože mu byl odepřen přístup k souboru v SharePointu Online.

Řešení potíží s Office 365 CDN

Návody potvrdit, že cdn obsluhuje prostředky?

Jakmile na stránku přidáte odkazy na prostředky CDN, můžete ověřit, že se prostředek obsluhuje z CDN, a to tak, že přejdete na stránku, po vykreslení kliknete pravým tlačítkem na obrázek a zkontrolujete adresu URL obrázku.

Můžete také použít vývojářské nástroje prohlížeče k zobrazení adresy URL jednotlivých prostředků na stránce nebo použít nástroj pro trasování sítě třetí strany.

Poznámka

Pokud k otestování prostředků mimo vykreslení prostředku ze stránky SharePointu používáte síťový nástroj, jako je Fiddler, musíte ručně přidat hlavičku refereru "Referer: https://yourdomain.sharepoint.com" do požadavku GET, kde adresa URL je kořenová adresa URL vašeho tenanta SharePointu Online.

Adresy URL sítě CDN nemůžete testovat přímo ve webovém prohlížeči, protože musíte mít referenční adresu pocházející ze SharePointu Online. Pokud ale přidáte adresu URL prostředku CDN na stránku SharePointu a pak stránku otevřete v prohlížeči, zobrazí se na stránce vygenerovaný prostředek CDN.

Další informace o používání vývojářských nástrojů v prohlížeči Microsoft Edge najdete v tématu Vývojářské nástroje Microsoft Edge.

Pokud se chcete podívat na krátké video hostované v kanálu SharePoint Developer Patterns and Practices Na YouTube , které ukazuje, jak ověřit, že cdn funguje, přečtěte si téma Ověření využití sítě CDN a zajištění optimálního síťového připojení.

Proč jsou prostředky z nového zdroje nedostupné?

Prostředky v nových zdrojích nebudou k dispozici okamžitě k použití, protože určitou dobu trvá, než se registrace rozšíří prostřednictvím CDN a prostředky se nahrají z původního zdroje do úložiště CDN. Doba potřebná k tomu, aby byly prostředky dostupné ve službě CDN, závisí na počtu prostředků a velikostech souborů.

Webová část nebo řešení SharePoint Framework na straně klienta nefunguje

Když povolíte Office 365 CDN pro veřejné zdroje, služba CDN automaticky vytvoří tyto výchozí zdroje:

  • */MASTERPAGE
  • */KNIHOVNA STYLŮ
  • */CLIENTSIDEASSETS

Pokud chybí původ */clientsideassets, SharePoint Framework řešení se nezdaří a nevygenerují se žádné varovné nebo chybové zprávy. Tento původ může chybět buď proto, že cdn byl povolen s parametrem -NoDefaultOrigins nastaveným na $true, nebo protože původ byl ručně odstraněn.

Původy můžete zkontrolovat pomocí následujícího příkazu PowerShellu:

Get-SPOTenantCdnOrigins -CdnType Public

Nebo to můžete zkontrolovat pomocí rozhraní příkazového řádku pro Microsoft 365:

m365 spo cdn origin list

Přidání zdroje v PowerShellu:

Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */CLIENTSIDEASSETS

Přidání původu pomocí rozhraní příkazového řádku pro Microsoft 365:

m365 spo cdn origin add --origin */CLIENTSIDEASSETS

Jaké moduly PowerShellu a prostředí rozhraní příkazového řádku potřebuji pro práci s Office 365 CDN?

S Office 365 CDN můžete pracovat pomocí modulu PowerShellu sharepointu Online Management Shell nebo rozhraní příkazového řádku pro Microsoft 365.

Viz také

Sítě pro doručování obsahu

Network planning and performance tuning for Office 365

Řada videí o výkonu SharePointu – Office 365 cdn