Использование сети доставки содержимого Office 365 с SharePoint Online
Вы можете использовать встроенную сеть доставки содержимого (CDN) Office 365 для размещения статических ресурсов, чтобы повысить производительность страниц SharePoint Online. Сеть CDN Office 365 повышает производительность путем кэширования статических ресурсов ближе к браузерам, которые их запрашивают, что повышает скорость скачиваний и снижает задержку. Кроме того, Office 365 CDN использует протокол HTTP/2 для улучшения сжатия и конвейерной передачи HTTP. Служба CDN Office 365 входит в состав подписки на SharePoint Online.
Предостережение
Так как теперь образы автоматически управляются в частной сети CDN, управляемой службой SharePoint Online, настроенная вручную частная сеть CDN находится в процессе устаревания. Это означает, что клиентам больше не нужно настраивать частную сеть CDN. Рекомендуемая практика остается неизменной, так как образы размещаются через частную сеть CDN, управляемую службой, автоматически. Общедоступная сеть CDN по-прежнему доступна для всех других типов файлов (например, CSS и JS). Клиенты, использующие частную сеть CDN для типов файлов, отличных от изображений, должны переместить эти файлы в общедоступную сеть CDN. Мы рекомендуем использовать общедоступную сеть CDN для этих типов файлов, чтобы повысить производительность.
Примечание.
Office 365 CDN доступна только для клиентов в рабочем (во всем мире) облаке. Клиенты в облаках правительства США и Китая в настоящее время не поддерживают Office 365 CDN.
Сети доставки содержимого Office 365 состоит из нескольких сетей CDN, позволяющих размещать статические ресурсы в нескольких расположениях или источниках и использовать их из глобальных высокоскоростных сетей. В зависимости от типа содержимого, которое необходимо разместить в сети CDN Office 365, можно добавить общедоступные источники, закрытые источники или оба варианта. Дополнительные сведения о различиях между общедоступными и частными источниками см. в статье Выбор того, должен ли каждый источник быть общедоступным или частным .
Если вы уже знакомы с тем, как работают сети CDN, необходимо выполнить всего несколько действий, чтобы включить Office 365 CDN для вашего клиента. В этой статье описано, как это сделать. Ознакомьтесь с информацией о том, как приступить к размещению статических ресурсов.
Совет
Существуют другие сети CDN, размещенные корпорацией Майкрософт, которые можно использовать с Office 365 для специализированных сценариев использования, но не рассматриваются в этом разделе, так как они выходят за рамки область Office 365 CDN. Дополнительные сведения см. в разделе Другие сети CDN Майкрософт.
Вернитесь к планированию сети и настройке производительности для Office 365.
Общие сведения о работе с Office 365 CDN в SharePoint Online
Чтобы настроить Office 365 CDN для организации, выполните следующие основные действия.
Планирование развертывания Office 365 CDN
- Определите, какие статические ресурсы вы хотите разместить в СЕТИ CDN.
- Определите место хранения ресурсов. Это расположение может быть сайтом, библиотекой или папкой SharePoint и называется источником.
- Выберите, должен ли каждый источник быть общедоступным или частным. Можно добавить несколько источников как общедоступных, так и частных типов.
Настройка и настройка СЕТИ CDN с помощью PowerShell или CLI для Microsoft 365
- Настройка и настройка СЕТИ CDN с помощью командной консоли SharePoint Online
- Настройка и настройка СЕТИ CDN с помощью PnP PowerShell
- Настройка и настройка СЕТИ CDN с помощью интерфейса командной строки для Microsoft 365
По завершении этого шага вы получите следующие результаты:
- Сеть CDN включена для вашей организации.
- Вы добавили свои источники, идентифицируя каждый источник как общедоступный или частный.
Завершив настройку, вы можете управлять Office 365 CDN с течением времени следующими способами:
- Добавление, обновление и удаление ресурсов
- Добавление и удаление источников
- Настройка политик CDN
- При необходимости отключите CDN.
Наконец, ознакомьтесь с разделом Использование ресурсов CDN , чтобы узнать о доступе к ресурсам CDN из общедоступных и частных источников.
Рекомендации по устранению распространенных проблем см. в статье Устранение неполадок с Office 365 CDN.
Планирование развертывания Office 365 CDN
Перед развертыванием Office 365 CDN для клиента Office 365 следует учитывать следующие факторы в процессе планирования.
- Определение статических ресурсов, которые требуется разместить в СЕТИ CDN
- Определение места хранения ресурсов
- Выберите, должен ли каждый источник быть общедоступным или частным.
Определение статических ресурсов, которые требуется разместить в СЕТИ CDN
Как правило, сети CDN наиболее эффективны для размещения статических ресурсов или ресурсов, которые не часто меняются. Хорошее правило заключается в определении файлов, которые соответствуют некоторым или всем из этих условий:
- Статические файлы, внедренные в страницу (например, скрипты и изображения), которые могут оказать значительное влияние на время загрузки страницы.
- Большие файлы, такие как исполняемые файлы и файлы установки.
- Библиотеки ресурсов, поддерживающие код на стороне клиента.
Например, добавление многократно запрашиваемых небольших файлов (образов сайтов и скриптов) в источник CDN может значительно повысить производительность отрисовки сайта и постепенно уменьшить нагрузку на сайты SharePoint Online. Большие файлы (исполняемые файлы установки) можно скачать из сети CDN, что положительно сказывается на производительности и последующее снижение нагрузки на сайт SharePoint Online, даже если к ним не обращаются так часто.
Повышение производительности для каждого файла зависит от многих факторов, включая близость клиента к ближайшей конечной точке CDN, временные условия в локальной сети и т. д. Многие статические файлы имеют небольшой размер, и их можно скачать из Office 365 менее чем за секунду. Однако веб-страница может содержать много внедренных файлов с накопительным временем загрузки в несколько секунд. Обслуживание этих файлов из CDN может значительно сократить общее время загрузки страницы. Пример см. в разделе Какие преимущества производительности обеспечивает CDN?
Определение места хранения ресурсов
CDN извлекает ваши активы из места, называемого источником. Источником может быть сайт SharePoint, библиотека документов или папка, доступная по URL-адресу. У вас есть большая гибкость при указании источников для организации. Например, можно указать несколько источников или один источник, куда нужно поместить все ресурсы CDN. Вы можете выбрать как общедоступные, так и частные источники для своей организации. Большинство организаций предпочитают реализовать сочетание этих двух вариантов.
Вы можете создать контейнер для источников, таких как папки или библиотеки документов, и добавить файлы, которые нужно сделать доступными из СЕТИ CDN. Это хороший подход для определенного набора ресурсов, которые должны быть доступны из СЕТИ CDN, и вы хотите ограничить набор ресурсов CDN только теми файлами в контейнере.
Вы также можете настроить существующее семейство веб-сайтов, библиотеку или папку в качестве источника, что делает все соответствующие ресурсы в контейнере доступными из СЕТИ CDN. Прежде чем добавлять существующий контейнер в качестве источника, важно убедиться, что вы знаете его содержимое и разрешения, чтобы непреднамеренно не предоставлять ресурсы анонимному доступу или несанкционированным пользователям.
Вы можете определить политики CDN , чтобы исключить содержимое в источниках из CDN. Политики CDN исключают ресурсы в общедоступном или частном источниках по таким атрибутам, как тип файла и классификация сайтов, и применяются ко всем источникам CdnType (частным или общедоступным), указанным в политике. Например, если добавить частный источник, состоящий из сайта, содержащего несколько дочерних сайтов, можно определить политику исключения сайтов, помеченных как конфиденциальные , чтобы содержимое сайтов с примененной классификацией не обслуживалось из СЕТИ CDN. Политика применяется к содержимому из всех частных источников, добавленных в CDN.
Помните, что чем больше число источников, тем больше влияние на время, затравленное службой CDN на обработку запросов. Рекомендуется максимально ограничить количество источников.
Выберите, должен ли каждый источник быть общедоступным или частным.
При определении источника необходимо указать, следует ли сделать его общедоступным или закрытым. Доступ к ресурсам CDN в общедоступных источниках является анонимным, а содержимое CDN в частных источниках защищено динамически создаваемыми маркерами для повышения безопасности. Независимо от того, какой вариант вы выберете, корпорация Майкрософт делает все возможное для вас, когда дело доходит до администрирования самого CDN. Кроме того, вы можете изменить свое мнение позже, после того как настроите CDN и определили свои источники.
Как общедоступные, так и частные варианты обеспечивают одинаковый прирост производительности, но каждый из них имеет уникальные атрибуты и преимущества.
Общедоступные источники в Office 365 CDN доступны анонимно, а размещенные ресурсы могут быть доступны любому пользователю, у которого есть URL-адрес ресурса. Так как доступ к содержимому в общедоступных источниках является анонимным, их следует использовать только для кэширования нечувствительного универсального содержимого, такого как файлы JavaScript, скрипты, значки и изображения.
Частные источники в Office 365 CDN предоставляют частный доступ к пользовательскому содержимому, такому как библиотеки документов SharePoint Online, сайты и собственные образы. Доступ к содержимому в частных источниках защищен динамически создаваемыми маркерами, поэтому к нему могут обращаться только пользователи с разрешениями на доступ к исходной библиотеке документов или расположению хранилища. Частные источники в Office 365 CDN можно использовать только для содержимого SharePoint Online, а доступ к ресурсам в частных источниках можно получить только путем перенаправления из клиента SharePoint Online.
Дополнительные сведения о том, как работает доступ CDN к ресурсам в частном источнике, см. в статье Использование ресурсов в частных источниках.
Атрибуты и преимущества размещения ресурсов в общедоступных источниках
Ресурсы, предоставляемые из общедоступного источника, доступны всем анонимно.
Важно!
Никогда не размещайте ресурсы, содержащие сведения о пользователях или считающиеся конфиденциальными для вашей организации, в общедоступном источнике.
При удалении ресурса из общедоступного источника ресурс может оставаться доступным в течение 30 дней из кэша; однако ссылки на ресурс в СЕТИ CDN будут недействительными в течение 15 минут.
При размещении таблиц стилей (CSS-файлов) в общедоступном источнике можно использовать в коде относительные пути и URI. Этот результат означает, что вы можете ссылаться на расположение фоновых изображений и других объектов относительно расположения ресурса, который его вызывает.
Хотя вы можете создать URL-адрес общедоступного источника, следует действовать с осторожностью, использовать свойство контекста страницы и следовать инструкциям для этого. Если доступ к сети CDN становится недоступным, URL-адрес не будет автоматически разрешаться в вашей организации в SharePoint Online и может привести к нерабочим ссылкам и другим ошибкам. URL-адрес также может быть изменен, поэтому не следует жестко кодировать его на текущее значение.
Типы файлов по умолчанию, которые включены для общедоступных источников:
.css,.eot, ,.ico.gif,.jpeg,.jpg,.js,.map,.png.svg,.ttf.woff, и.woff2. Можно указать дополнительные типы файлов.Вы можете настроить политику для исключения ресурсов на основе указанных классификаций сайтов. Например, можно исключить все ресурсы, помеченные как конфиденциальные или ограниченные, даже если они являются допустимым типом файлов и находятся в общедоступном источнике.
Атрибуты и преимущества размещения ресурсов в частных источниках
Частные источники можно использовать только для ресурсов SharePoint Online.
Пользователи могут получить доступ к ресурсам из частного источника, только если у них есть разрешения на доступ к контейнеру. Анонимный доступ к таким ресурсам запрещен.
Ресурсы в частных источниках должны ссылаться из клиента SharePoint Online. Прямой доступ к частным ресурсам CDN не работает.
Если удалить ресурс из частного источника, ресурс может оставаться доступным в течение часа из кэша. Но ссылки на ресурс в СЕТИ CDN недопустимы в течение 15 минут после удаления ресурса.
По умолчанию для частных источников включены типы файлов GIF, ICO, JPEG, JPG, JS и PNG. Можно указать дополнительные типы файлов.
Как и в случае с общедоступными источниками, можно настроить политику, чтобы исключить ресурсы, определенные указанными классификациями сайтов, даже если для включения всех ресурсов в папку или библиотеку документов используются подстановочные знаки.
Дополнительные сведения о том, почему следует использовать Office 365 CDN, общие понятия CDN и другие сети CDN Майкрософт, которые можно использовать с клиентом Office 365, см. в разделе Сети доставки содержимого.
Источники CDN по умолчанию
Если не указано иное, Office 365 настраивает некоторые источники по умолчанию при включении Office 365 CDN. Если вы изначально решили не подготавливать их, вы можете добавить эти источники после завершения настройки. Если вы не понимаете последствия пропуска настройки источников по умолчанию и не имеете для этого конкретных причин, вы должны разрешить их создание при включении СЕТИ CDN.
Частные источники CDN по умолчанию:
- */siteassets
Общедоступные источники CDN по умолчанию:
- */masterpage
- */библиотека стилей
- */clientsideassets
Примечание.
clientsideassets — это общедоступный источник по умолчанию, добавленный в службу CDN Office 365 в декабре 2017 г. Этот источник должен присутствовать, чтобы SharePoint Framework решения в СЕТИ CDN работали. Если вы включили Office 365 CDN до декабря 2017 года или пропустили настройку источников по умолчанию при включении CDN, вы можете вручную добавить этот источник. Дополнительные сведения см. в разделе Моя клиентская веб-часть или SharePoint Framework решение не работает.
Настройка и настройка сети CDN Office 365 с помощью командной консоли SharePoint Online
Процедуры, описанные в этом разделе, требуют использования командной консоли SharePoint Online для подключения к SharePoint Online. Инструкции см. в статье Connect to SharePoint Online PowerShell.
Выполните следующие действия, чтобы настроить сеть CDN для размещения ресурсов в SharePoint Online с помощью командной консоли SharePoint Online.
Выберите, чтобы развернуть
Включение организации в использование Office 365 CDN
Прежде чем вносить изменения в параметры CDN клиента, необходимо получить текущее состояние частной конфигурации CDN в клиенте Office 365. Подключитесь к клиенту с помощью командной консоли SharePoint Online:
Connect-SPOService -Url https://contoso-admin.sharepoint.com
Теперь используйте командлет Get-SPOTenantCdnEnabled , чтобы получить параметры состояния CDN из клиента:
Get-SPOTenantCdnEnabled -CdnType <Public | Private>
На экране отображается состояние CDN для указанного CdnType.
Используйте командлет Set-SPOTenantCdnEnabled, чтобы разрешить вашей организации использовать Office 365 CDN. Вы можете включить в организации одновременное использование общедоступных источников, частных источников или обоих источников. Вы также можете настроить CDN, чтобы пропустить настройку источников по умолчанию при ее включении. Эти источники всегда можно добавить позже, как описано в этой статье.
В Windows PowerShell для SharePoint Online:
Set-SPOTenantCdnEnabled -CdnType <Public | Private | Both> -Enable $true
Например, чтобы разрешить организации использовать как общедоступные, так и частные источники, введите следующую команду:
Set-SPOTenantCdnEnabled -CdnType Both -Enable $true
Чтобы разрешить организации использовать общедоступные и частные источники, но пропустить настройку источников по умолчанию, введите следующую команду:
Set-SPOTenantCdnEnabled -CdnType Both -Enable $true -NoDefaultOrigins
Сведения о источниках по умолчанию, подготовленных по умолчанию при включении Office 365 CDN, а также о возможных последствиях пропуска настройки источников по умолчанию см. в разделе Источники CDN по умолчанию.
Чтобы разрешить организации использовать общедоступные источники, введите следующую команду:
Set-SPOTenantCdnEnabled -CdnType Public -Enable $true
Чтобы разрешить организации использовать частные источники, введите следующую команду:
Set-SPOTenantCdnEnabled -CdnType Private -Enable $true
Дополнительные сведения об этом командлете см. в разделе Set-SPOTenantCdnEnabled.
Изменение списка типов файлов для включения в Office 365 CDN (необязательно)
Совет
При определении типов файлов с помощью командлета Set-SPOTenantCdnPolicy вы перезаписываете текущий список. Если вы хотите добавить в список дополнительные типы файлов, сначала используйте командлет, чтобы узнать, какие типы файлов уже разрешены, и включить их в список вместе с новыми.
Используйте командлет Set-SPOTenantCdnPolicy , чтобы определить типы статических файлов, которые могут размещаться общедоступными и частными источниками в СЕТИ CDN. По умолчанию разрешены общие типы ресурсов, например .css, .gif, .jpg и .js.
В Windows PowerShell для SharePoint Online:
Set-SPOTenantCdnPolicy -CdnType <Public | Private> -PolicyType IncludeFileExtensions -PolicyValue "<Comma-separated list of file types >"
Например, чтобы включить cdn для размещения .css и .png файлов, введите команду :
Set-SPOTenantCdnPolicy -CdnType Private -PolicyType IncludeFileExtensions -PolicyValue "CSS,PNG"
Чтобы узнать, какие типы файлов в настоящее время разрешены CDN, используйте командлет Get-SPOTenantCdnPolicies :
Get-SPOTenantCdnPolicies -CdnType <Public | Private>
Дополнительные сведения об этих командлетах см. в разделах Set-SPOTenantCdnPolicy и Get-SPOTenantCdnPolicies.
Изменение списка классификаций сайтов, которые нужно исключить из Office 365 CDN (необязательно)
Совет
При исключении классификаций сайтов с помощью командлета Set-SPOTenantCdnPolicy вы перезаписываете текущий список. Если вы хотите исключить дополнительные классификации сайтов, сначала используйте командлет , чтобы узнать, какие классификации уже исключены, а затем добавить их вместе с новыми.
Используйте командлет Set-SPOTenantCdnPolicy , чтобы исключить классификации сайтов, которые не нужно делать доступными через CDN. По умолчанию не исключаются никакие классификации сайтов.
В Windows PowerShell для SharePoint Online:
Set-SPOTenantCdnPolicy -CdnType <Public | Private> -PolicyType ExcludeRestrictedSiteClassifications -PolicyValue "<Comma-separated list of site classifications >"
Чтобы узнать, какие классификации сайтов в настоящее время ограничены, используйте командлет Get-SPOTenantCdnPolicies :
Get-SPOTenantCdnPolicies -CdnType <Public | Private>
Возвращаемые свойства: IncludeFileExtensions, ExcludeRestrictedSiteClassifications и ExcludeIfNoScriptDisabled.
Свойство IncludeFileExtensions содержит список расширений файлов, обслуживаемых из CDN.
Примечание.
Расширения файлов по умолчанию различаются между общедоступными и частными.
Свойство ExcludeRestrictedSiteClassifications содержит классификации сайтов, которые необходимо исключить из CDN. Например, можно исключить сайты, помеченные как конфиденциальные , чтобы содержимое сайтов с примененной классификацией не обслуживалось из CDN.
Свойство ExcludeIfNoScriptDisabled исключает содержимое из СЕТИ CDN на основе параметров атрибута NoScript на уровне сайта. По умолчанию атрибут NoScript имеет значение Включено для современных сайтов и Отключено для классических сайтов. Это зависит от параметров клиента.
Дополнительные сведения об этих командлетах см. в разделах Set-SPOTenantCdnPolicy и Get-SPOTenantCdnPolicies.
Добавление источника для ресурсов
Используйте командлет Add-SPOTenantCdnOrigin для определения источника. Вы можете определить несколько источников. Источник — это URL-адрес, указывающий на библиотеку или папку в SharePoint, содержащую ресурсы, которые требуется размещать в сети CDN.
Важно!
Никогда не размещайте ресурсы, содержащие сведения о пользователях или считающиеся конфиденциальными для вашей организации, в общедоступном источнике.
Add-SPOTenantCdnOrigin -CdnType <Public | Private> -OriginUrl <path>
Значение пути — это относительный путь к библиотеке или папке, содержащей ресурсы. Помимо относительных путей, можно использовать подстановочные знаки. Источники поддерживают подстановочные знаки, добавленные к URL-адресу. Это позволяет создавать источники, охватывающие несколько сайтов. Например, чтобы включить все ресурсы в папку masterpages для всех сайтов в качестве общедоступного источника в сети CDN, введите следующую команду:
Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
- Модификатор с подстановочными знаками */ можно использовать только в начале пути и соответствует всем сегментам URL-адресов в указанном URL-адресе.
- Путь может указывать на библиотеку документов, папку или сайт. Например, путь */site1 соответствует всем библиотекам документов на сайте.
Можно добавить источник с определенным относительным путем. Вы не можете добавить источник с помощью полного пути.
В этом примере добавляется частный источник библиотеки siteassets на определенном сайте:
Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl sites/site1/siteassets
В этом примере добавляется частный источник папки folder1 в библиотеке ресурсов сайта семейства веб-сайтов:
Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl sites/test/siteassets/folder1
Если в пути есть пробел, можно либо заключить путь в двойные кавычки, либо заменить пробел url-адресом в кодировке %20. В следующих примерах добавляется частный источник папки 1 в библиотеке ресурсов сайта семейства веб-сайтов:
Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl sites/test/siteassets/folder%201
Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl "sites/test/siteassets/folder 1"
Дополнительные сведения об этой команде и ее синтаксисе см. в разделе Add-SPOTenantCdnOrigin.
Примечание.
В частных источниках ресурсы, совместно используемые из источника, должны иметь опубликованную основную версию, прежде чем к ним можно будет получить доступ из CDN.
После выполнения команды система синхронизирует конфигурацию в центре обработки данных. Этот результат может занять до 15 минут.
Пример. Настройка общедоступного источника для страниц master и библиотеки стилей для SharePoint Online
Как правило, эти источники настраиваются по умолчанию при включении Office 365 CDN. Однако если вы хотите включить их вручную, выполните следующие действия.
Используйте командлет Add-SPOTenantCdnOrigin , чтобы определить библиотеку стилей в качестве общедоступного источника.
Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */style%20libraryИспользуйте командлет Add-SPOTenantCdnOrigin, чтобы определить страницы master в качестве общедоступного источника.
Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
Дополнительные сведения об этой команде и ее синтаксисе см. в разделе Add-SPOTenantCdnOrigin.
После выполнения команды система синхронизирует конфигурацию в центре обработки данных. Этот результат может занять до 15 минут.
Пример. Настройка частного источника для ресурсов сайта, страниц сайта и изображений публикации для SharePoint Online
Используйте командлет Add-SPOTenantCdnOrigin , чтобы определить папку ресурсов сайта в качестве частного источника.
Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */siteassetsИспользуйте командлет Add-SPOTenantCdnOrigin , чтобы определить папку страниц сайта в качестве частного источника.
Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */sitepagesИспользуйте командлет Add-SPOTenantCdnOrigin , чтобы определить папку публикации изображений в качестве частного источника.
Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */publishingimages
Дополнительные сведения об этой команде и ее синтаксисе см. в разделе Add-SPOTenantCdnOrigin.
После выполнения команды система синхронизирует конфигурацию в центре обработки данных. Этот результат может занять до 15 минут.
Пример. Настройка частного источника для семейства веб-сайтов для SharePoint Online
Используйте командлет Add-SPOTenantCdnOrigin , чтобы определить семейство веб-сайтов в качестве частного источника. Например:
Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl sites/site1/siteassets
Дополнительные сведения об этой команде и ее синтаксисе см. в разделе Add-SPOTenantCdnOrigin.
После выполнения команды система синхронизирует конфигурацию в центре обработки данных. Может появиться сообщение о ожидании конфигурации . Это сообщение ожидается, когда клиент SharePoint Online подключается к службе CDN. Этот результат может занять до 15 минут.
Управление Office 365 CDN
После настройки CDN можно внести изменения в конфигурацию при обновлении содержимого или при изменении потребностей, как описано в этом разделе.
Добавление, обновление и удаление ресурсов из Office 365 CDN
После завершения действий по настройке можно добавлять новые ресурсы, а также обновлять или удалять существующие ресурсы в любое время. Просто внесите изменения в ресурсы в папке или библиотеке SharePoint, которые вы определили как источник. При добавлении нового ресурса он сразу же будет доступен через CDN. Однако при обновлении ресурса потребуется до 15 минут, чтобы новая копия распространилась и стала доступной в CDN.
Если необходимо получить расположение источника, можно использовать командлет Get-SPOTenantCdnOrigins . Сведения об использовании этого командлета см. в разделе Get-SPOTenantCdnOrigins.
Удаление источника из Office 365 CDN
Вы можете удалить доступ к папке или библиотеке SharePoint, которые вы определили как источник, с помощью командлета Remove-SPOTenantCdnOrigin .
Remove-SPOTenantCdnOrigin -OriginUrl <path> -CdnType <Public | Private | Both>
Сведения об использовании этого командлета см. в разделе Remove-SPOTenantCdnOrigin.
Изменение источника в Office 365 CDN
Вы не сможете изменить источник после его создания. Вместо этого удалите источник и добавьте новый. Дополнительные сведения см. в разделах Удаление источника из Office 365 CDN и Добавление источника для ресурсов.
Отключение сети CDN Office 365
Используйте командлет Set-SPOTenantCdnEnabled , чтобы отключить сеть CDN для организации. Если для CDN включены общедоступные и частные источники, необходимо выполнить командлет дважды, как показано в следующих примерах.
Чтобы отключить использование открытых источников в СЕТИ CDN, введите следующую команду:
Set-SPOTenantCdnEnabled -CdnType Public -Enable $false
Чтобы отключить использование частных источников в СЕТИ CDN, введите следующую команду:
Set-SPOTenantCdnEnabled -CdnType Private -Enable $false
Дополнительные сведения об этом командлете см. в разделе Set-SPOTenantCdnEnabled.
Настройка и настройка Office 365 CDN с помощью PnP PowerShell
Процедуры, описанные в этом разделе, требуют использования PnP PowerShell для подключения к SharePoint Online. Инструкции см. в статье Начало работы с PnP PowerShell.
Выполните следующие действия, чтобы настроить сеть CDN для размещения ресурсов в SharePoint Online с помощью PnP PowerShell.
Выберите, чтобы развернуть
Включение организации в использование Office 365 CDN
Прежде чем вносить изменения в параметры CDN клиента, необходимо получить текущее состояние частной конфигурации CDN в клиенте Office 365. Подключитесь к клиенту с помощью PnP PowerShell:
Connect-PnPOnline -Url https://contoso-admin.sharepoint.com -UseWebLogin
Теперь используйте командлет Get-PnPTenantCdnEnabled , чтобы получить параметры состояния CDN из клиента:
Get-PnPTenantCdnEnabled -CdnType <Public | Private>
На экране отображается состояние CDN для указанного CdnType.
Используйте командлет Set-PnPTenantCdnEnabled, чтобы разрешить вашей организации использовать Office 365 CDN. Вы можете включить в организации одновременное использование общедоступных источников, частных источников или обоих источников. Вы также можете настроить CDN, чтобы пропустить настройку источников по умолчанию при ее включении. Эти источники всегда можно добавить позже, как описано в этой статье.
В PnP PowerShell:
Set-PnPTenantCdnEnabled -CdnType <Public | Private | Both> -Enable $true
Например, чтобы разрешить организации использовать как общедоступные, так и частные источники, введите следующую команду:
Set-PnPTenantCdnEnabled -CdnType Both -Enable $true
Чтобы разрешить организации использовать общедоступные и частные источники, но пропустить настройку источников по умолчанию, введите следующую команду:
Set-PnPTenantCdnEnabled -CdnType Both -Enable $true -NoDefaultOrigins
Сведения о источниках по умолчанию, подготовленных по умолчанию при включении Office 365 CDN, а также о возможных последствиях пропуска настройки источников по умолчанию см. в разделе Источники CDN по умолчанию.
Чтобы разрешить организации использовать общедоступные источники, введите следующую команду:
Set-PnPTenantCdnEnabled -CdnType Public -Enable $true
Чтобы разрешить организации использовать частные источники, введите следующую команду:
Set-PnPTenantCdnEnabled -CdnType Private -Enable $true
Дополнительные сведения об этом командлете см. в разделе Set-PnPTenantCdnEnabled.
Изменение списка типов файлов для включения в Office 365 CDN (необязательно)
Совет
При определении типов файлов с помощью командлета Set-PnPTenantCdnPolicy вы перезаписываете текущий список. Если вы хотите добавить в список дополнительные типы файлов, сначала используйте командлет, чтобы узнать, какие типы файлов уже разрешены, и включить их в список вместе с новыми.
Используйте командлет Set-PnPTenantCdnPolicy , чтобы определить типы статических файлов, которые могут размещаться общедоступными и частными источниками в CDN. По умолчанию разрешены общие типы ресурсов, например .css, .gif, .jpg и .js.
В PnP PowerShell:
Set-PnPTenantCdnPolicy -CdnType <Public | Private> -PolicyType IncludeFileExtensions -PolicyValue "<Comma-separated list of file types >"
Например, чтобы включить cdn для размещения .css и .png файлов, введите команду :
Set-PnPTenantCdnPolicy -CdnType Private -PolicyType IncludeFileExtensions -PolicyValue "CSS,PNG"
Чтобы узнать, какие типы файлов в настоящее время разрешены CDN, используйте командлет Get-PnPTenantCdnPolicies :
Get-PnPTenantCdnPolicies -CdnType <Public | Private>
Дополнительные сведения об этих командлетах см. в разделах Set-PnPTenantCdnPolicy и Get-PnPTenantCdnPolicies.
Изменение списка классификаций сайтов, которые нужно исключить из Office 365 CDN (необязательно)
Совет
При исключении классификаций сайтов с помощью командлета Set-PnPTenantCdnPolicy вы перезаписываете текущий список. Если вы хотите исключить дополнительные классификации сайтов, сначала используйте командлет , чтобы узнать, какие классификации уже исключены, а затем добавить их вместе с новыми.
Используйте командлет Set-PnPTenantCdnPolicy , чтобы исключить классификации сайтов, которые не нужно делать доступными через CDN. По умолчанию не исключаются никакие классификации сайтов.
В PnP PowerShell:
Set-PnPTenantCdnPolicy -CdnType <Public | Private> -PolicyType ExcludeRestrictedSiteClassifications -PolicyValue "<Comma-separated list of site classifications>"
Чтобы узнать, какие классификации сайтов в настоящее время ограничены, используйте командлет Get-PnPTenantCdnPolicies :
Get-PnPTenantCdnPolicies -CdnType <Public | Private>
Возвращаемые свойства: IncludeFileExtensions, ExcludeRestrictedSiteClassifications и ExcludeIfNoScriptDisabled.
Свойство IncludeFileExtensions содержит список расширений файлов, обслуживаемых из CDN.
Примечание.
Расширения файлов по умолчанию различаются между общедоступными и частными.
Свойство ExcludeRestrictedSiteClassifications содержит классификации сайтов, которые необходимо исключить из CDN. Например, можно исключить сайты, помеченные как конфиденциальные , чтобы содержимое сайтов с применяемой классификацией не обслуживалось из CDN.
Свойство ExcludeIfNoScriptDisabled исключает содержимое из СЕТИ CDN на основе параметров атрибута NoScript на уровне сайта. По умолчанию атрибут NoScript имеет значение Включено для современных сайтов и Отключено для классических сайтов. Это зависит от параметров клиента.
Дополнительные сведения об этих командлетах см. в разделах Set-PnPTenantCdnPolicy и Get-PnPTenantCdnPolicies.
Добавление источника для ресурсов
Используйте командлет Add-PnPTenantCdnOrigin для определения источника. Вы можете определить несколько источников. Источник — это URL-адрес, указывающий на библиотеку или папку в SharePoint, содержащую ресурсы, которые требуется размещать в сети CDN.
Важно!
Никогда не размещайте ресурсы, содержащие сведения о пользователях или считающиеся конфиденциальными для вашей организации, в общедоступном источнике.
Add-PnPTenantCdnOrigin -CdnType <Public | Private> -OriginUrl <path>
Значение пути — это относительный путь к библиотеке или папке, содержащей ресурсы. Помимо относительных путей, можно использовать подстановочные знаки. Источники поддерживают подстановочные знаки, добавленные к URL-адресу. Это позволяет создавать источники, охватывающие несколько сайтов. Например, чтобы включить все ресурсы в папку masterpages для всех сайтов в качестве общедоступного источника в сети CDN, введите следующую команду:
Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
- Модификатор с подстановочными знаками */ можно использовать только в начале пути и соответствует всем сегментам URL-адресов в указанном URL-адресе.
- Путь может указывать на библиотеку документов, папку или сайт. Например, путь */site1 соответствует всем библиотекам документов на сайте.
Можно добавить источник с определенным относительным путем. Вы не можете добавить источник с помощью полного пути.
В этом примере добавляется частный источник библиотеки ресурсов сайта на определенном сайте:
Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl sites/site1/siteassets
В этом примере добавляется частный источник папки folder1 в библиотеке ресурсов сайта семейства веб-сайтов:
Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl sites/test/siteassets/folder1
Если в пути есть пробел, можно либо заключить путь в двойные кавычки, либо заменить пробел url-адресом в кодировке %20. В следующих примерах добавляется частный источник папки 1 в библиотеке ресурсов сайта семейства веб-сайтов:
Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl sites/test/siteassets/folder%201
Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl "sites/test/siteassets/folder 1"
Дополнительные сведения об этой команде и ее синтаксисе см. в разделе Add-PnPTenantCdnOrigin.
Примечание.
В частных источниках ресурсы, к которым предоставлен общий доступ из источника, должны иметь основную версию, прежде чем они будут доступны из CDN.
После выполнения команды система синхронизирует конфигурацию в центре обработки данных. Этот результат может занять до 15 минут.
Пример. Настройка общедоступного источника для страниц master и библиотеки стилей для SharePoint Online
Как правило, эти источники настраиваются по умолчанию при включении Office 365 CDN. Однако если вы хотите включить их вручную, выполните следующие действия.
Используйте командлет Add-PnPTenantCdnOrigin , чтобы определить библиотеку стилей в качестве общедоступного источника.
Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */style%20libraryИспользуйте командлет Add-PnPTenantCdnOrigin, чтобы определить страницы master как общедоступные.
Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
Дополнительные сведения об этой команде и ее синтаксисе см. в разделе Add-PnPTenantCdnOrigin.
После выполнения команды система синхронизирует конфигурацию в центре обработки данных. Этот результат может занять до 15 минут.
Пример. Настройка частного источника для ресурсов сайта, страниц сайта и изображений публикации для SharePoint Online
Используйте командлет Add-PnPTenantCdnOrigin , чтобы определить папку ресурсов сайта в качестве частного источника.
Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */siteassetsИспользуйте командлет Add-PnPTenantCdnOrigin , чтобы определить папку страниц сайта в качестве частного источника.
Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */sitepagesИспользуйте командлет Add-PnPTenantCdnOrigin , чтобы определить папку публикации изображений в качестве частного источника.
Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */publishingimages
Дополнительные сведения об этой команде и ее синтаксисе см. в разделе Add-PnPTenantCdnOrigin.
После выполнения команды система синхронизирует конфигурацию в центре обработки данных. Этот результат может занять до 15 минут.
Пример. Настройка частного источника для семейства веб-сайтов для SharePoint Online
Используйте командлет Add-PnPTenantCdnOrigin , чтобы определить семейство веб-сайтов в качестве частного источника. Например:
Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl sites/site1/siteassets
Дополнительные сведения об этой команде и ее синтаксисе см. в разделе Add-PnPTenantCdnOrigin.
После выполнения команды система синхронизирует конфигурацию в центре обработки данных. Может появиться сообщение о ожидании конфигурации . Этот результат ожидается при подключении клиента SharePoint Online к службе CDN. Этот результат может занять до 15 минут.
Управление Office 365 CDN
После настройки CDN можно внести изменения в конфигурацию при обновлении содержимого или при изменении потребностей, как описано в этом разделе.
Добавление, обновление и удаление ресурсов из Office 365 CDN
После завершения действий по настройке можно добавлять новые ресурсы, а также обновлять или удалять существующие ресурсы в любое время. Просто внесите изменения в ресурсы в папке или библиотеке SharePoint, которые вы определили как источник. При добавлении нового ресурса он сразу же будет доступен через CDN. Однако при обновлении ресурса потребуется до 15 минут, чтобы новая копия распространилась и стала доступной в CDN.
Если необходимо получить расположение источника, можно использовать командлет Get-PnPTenantCdnOrigin . Сведения об использовании этого командлета см. в разделе Get-PnPTenantCdnOrigin.
Удаление источника из Office 365 CDN
Вы можете удалить доступ к папке или библиотеке SharePoint, которые вы определили как источник. Чтобы выполнить это действие, используйте командлет Remove-PnPTenantCdnOrigin .
Remove-PnPTenantCdnOrigin -OriginUrl <path> -CdnType <Public | Private | Both>
Сведения об использовании этого командлета см. в разделе Remove-PnPTenantCdnOrigin.
Изменение источника в Office 365 CDN
Вы не сможете изменить источник после его создания. Вместо этого удалите источник и добавьте новый. Дополнительные сведения см. в разделах Удаление источника из Office 365 CDN и Добавление источника для ресурсов.
Отключение сети CDN Office 365
Используйте командлет Set-PnPTenantCdnEnabled , чтобы отключить CDN для вашей организации. Если для CDN включены общедоступные и частные источники, необходимо выполнить командлет дважды, как показано в следующих примерах.
Чтобы отключить использование открытых источников в СЕТИ CDN, введите следующую команду:
Set-PnPTenantCdnEnabled -CdnType Public -Enable $false
Чтобы отключить использование частных источников в СЕТИ CDN, введите следующую команду:
Set-PnPTenantCdnEnabled -CdnType Private -Enable $false
Дополнительные сведения об этом командлете см. в разделе Set-PnPTenantCdnEnabled.
Настройка и настройка Office 365 CDN с помощью интерфейса командной строки для Microsoft 365
Процедуры, описанные в этом разделе, требуют интерфейса командной строки для Microsoft 365. , подключитесь к клиенту Office 365 с помощью команды входа.
Выполните следующие действия, чтобы настроить сеть CDN для размещения ресурсов в SharePoint Online с помощью интерфейса командной строки для Microsoft 365.
Выберите, чтобы развернуть
Включение Office 365 CDN
Вы можете управлять состоянием сети CDN Office 365 в клиенте с помощью команды spo cdn set.
Чтобы включить Office 365 общедоступной сети CDN в клиенте, выполните следующую команду:
m365 spo cdn set --type Public --enabled true
Чтобы включить Office 365 CDN SharePoint, выполните следующую команду:
m365 spo cdn set --type Private --enabled true
Просмотр текущего состояния сети CDN Office 365
Чтобы проверка, включен ли конкретный тип Office 365 CDN, используйте команду spo cdn get.
Чтобы проверка, включена ли общедоступная сеть CDN Office 365, выполните следующую команду:
m365 spo cdn get --type Public
Просмотр источников CDN Office 365
Чтобы просмотреть настроенные в настоящее время источники общедоступных CDN Office 365, выполните следующую команду:
m365 spo cdn origin list --type Public
Сведения о источниках, подготовленных по умолчанию при включении Office 365 CDN, см. в разделе Источники CDN по умолчанию.
Добавление источника CDN Office 365
Важно!
Никогда не размещайте ресурсы, которые считаются конфиденциальными для вашей организации, в библиотеке документов SharePoint, настроенной в качестве общедоступного источника.
Чтобы определить источник CDN, используйте команду spo cdn origin add. Вы можете определить несколько источников. Источником является URL-адрес, указывающий на библиотеку Или папку SharePoint, содержащую ресурсы, которые требуется разместить в CDN.
m365 spo cdn origin add --type [Public | Private] --origin <path>
Где path — относительный путь к папке, содержащей ресурсы. Помимо относительных путей, можно использовать подстановочные знаки.
Чтобы включить все ресурсы в коллекцию главных страниц всех сайтов в качестве общедоступного источника, выполните следующую команду:
m365 spo cdn origin add --type Public --origin */masterpage
Чтобы настроить частный источник для определенного семейства веб-сайтов, выполните следующую команду:
m365 spo cdn origin add --type Private --origin sites/site1/siteassets
Примечание.
После добавления источника CDN может понадобиться до 15 минут, чтобы получить файлы через службу CDN. Вы можете проверить, включен ли тот или иной источник, с помощью команды spo cdn origin list.
Удаление источника CDN Office 365
Чтобы удалить источник CDN для указанного типа CDN, используйте команду spo cdn origin remove.
Чтобы удалить общедоступный источник из конфигурации CDN, выполните следующую команду:
m365 spo cdn origin remove --type Public --origin */masterpage
Примечание.
Удаление источника CDN не влияет на файлы, хранящиеся в любой библиотеке документов, которая соответствует источнику. Если на эти ресурсы ссылаются с помощью URL-адреса SharePoint, SharePoint автоматически переключается обратно на исходный URL-адрес, указывающий на библиотеку документов. Если на ресурсы ссылается общедоступный URL-адрес CDN, удаление источника разрывает ссылку, и необходимо изменить их вручную.
Изменение источника CDN Office 365
Изменить имеющийся источник CDN невозможно. Вместо этого следует удалить определенный ранее источник CDN с помощью команды spo cdn origin remove и добавить новый с помощью команды spo cdn origin add.
Изменение типов файлов для включения в Office 365 CDN
По умолчанию в CDN включены следующие типы файлов: .css, , .eot, .ico.gif, .jpeg, .jpg, .js, .map, .png, .svg, .ttf, .woff, и .woff2. Если требуется включить в сеть CDN дополнительные типы файлов, вы можете изменить конфигурацию CDN с помощью команды spo cdn policy set.
Примечание.
При изменении списка типов файлов перезаписывается текущий список. Если требуется включить дополнительные типы файлов, сперва используйте команду spo cdn policy list, чтобы узнать, какие типы файлов настроены в текущий момент.
Чтобы добавить тип файла JSON в список типов файлов по умолчанию, включенный в общедоступную сеть CDN, выполните следующую команду:
m365 spo cdn policy set --type Public --policy IncludeFileExtensions --value "CSS,EOT,GIF,ICO,JPEG,JPG,JS,MAP,PNG,SVG,TTF,WOFF,JSON"
Изменение списка классификаций сайтов, которые требуется исключить из сети CDN Office 365
Используйте команду spo cdn policy set , чтобы исключить классификации сайтов, которые вы не хотите делать доступными через CDN. По умолчанию не исключаются никакие классификации сайтов.
Примечание.
При изменении списка исключаемых классификаций сайтов перезаписывается текущий список. Если требуется исключить дополнительные классификации сайтов, сперва используйте команду spo cdn policy list, чтобы узнать, какие классификации настроены в текущий момент.
Чтобы исключить сайты, классифицированные как HBI , из общедоступной сети CDN, выполните следующую команду:
m365 spo cdn policy set --type Public --policy ExcludeRestrictedSiteClassifications --value "HBI"
Отключение сети CDN Office 365
Чтобы отключить сеть CDN Office 365, используйте команду spo cdn set. Пример:
m365 spo cdn set --type Public --enabled false
Использование ресурсов CDN
Теперь, когда вы включили CDN и настроили источники и политики, вы можете начать использовать ресурсы CDN.
Этот раздел поможет вам понять, как использовать URL-адреса CDN на страницах и содержимом SharePoint, чтобы SharePoint перенаправляла запросы на ресурсы как в общедоступном, так и в частном источниках в CDN.
- Обновление ссылок на ресурсы CDN
- Использование ресурсов в общедоступных источниках
- Использование ресурсов в частных источниках
Сведения об использовании СЕТИ CDN для размещения клиентских веб-частей см. в статье Размещение клиентской веб-части из Office 365 CDN (Hello World часть 4).
Примечание.
Если добавить папку ClientSideAssets в частный список источников CDN, пользовательские веб-части, размещенные в CDN, не смогут выполнить отрисовку. Файлы, используемые веб-частями SPFX, могут использовать только общедоступную сеть CDN, а папка ClientSideAssets является источником по умолчанию для общедоступной сети CDN.
Обновление ссылок на ресурсы CDN
Чтобы использовать ресурсы, добавленные в источник, просто обновите ссылки на исходный файл с путем к файлу в источнике.
- Измените страницу или содержимое, содержащие ссылки на ресурсы, добавленные в источник. Вы также можете использовать один из нескольких методов для глобального поиска и замены ссылок на входном сайте или семействе веб-сайтов, если вы хотите обновить ссылку на данный ресурс везде, где он отображается.
- Для каждой ссылки на ресурс в источнике замените путь на путь к файлу в источнике CDN. Можно использовать относительные пути.
- Сохраните страницу или содержимое.
Например, рассмотрим изображение /site/SiteAssets/images/image.png, скопированное в папку библиотеки документов /site/CDN_origins/public/. Чтобы использовать ресурс CDN, замените исходный путь к расположению файла изображения путем к источнику, чтобы сделать новый URL-адрес /site/CDN_origins/public/image.png.
Если вы хотите использовать полный URL-адрес ресурса вместо относительного пути, создайте ссылку следующим образом:
https://<TenantHostName>.sharepoint.com/sites/site/CDN_origins/public/image.png
Примечание.
Как правило, не следует жестко кодировать URL-адреса непосредственно к ресурсам в сети CDN. Однако при необходимости можно вручную создать URL-адреса для ресурсов в общедоступном источнике. Дополнительные сведения см. в статье Жесткое кодирование URL-адресов CDN для общедоступных ресурсов.
Сведения о том, как проверить, обслуживаются ли ресурсы из сети CDN, см. в статье Разделы справки подтверждение того, что ресурсы обслуживаются cdn? в разделе Устранение неполадок с Office 365 CDN.
Использование ресурсов в общедоступных источниках
Функция публикации в SharePoint Online автоматически перезаписывает URL-адреса ресурсов, хранящихся в общедоступных источниках, в их эквиваленты CDN, чтобы ресурсы обслуживались из службы CDN, а не из SharePoint.
Если источник находится на сайте с включенной функцией публикации и ресурсы, которые вы хотите выгрузить в CDN, находятся в одной из следующих категорий, SharePoint автоматически перезаписывает URL-адреса для ресурсов в источнике, если ресурс не был исключен политикой CDN.
В следующем примере представлен обзор, в котором ссылки автоматически переписываются функцией публикации SharePoint.
- URL-адреса IMG/LINK/CSS в html-ответах классической страницы публикации.
- Сюда входят изображения, добавленные авторами в HTML-содержимое страницы.
- Url-адреса изображений веб-частей для слайдов библиотеки рисунков.
- Поля изображений в результатах REST API SPList (RenderListDataAsStream).
- Используйте новое свойство ImageFieldsToTryRewriteToCdnUrls для предоставления списка полей, разделенных запятыми.
- Поддерживает поля гиперссылки и поля PublishingImage.
- Представления изображений SharePoint.
На следующей схеме показан рабочий процесс, когда SharePoint получает запрос на страницу, содержащую ресурсы из общедоступного источника.
Совет
Если вы хотите отключить автоматическую перезапись для определенных URL-адресов на странице, можно проверка страницу и добавить параметр строки запроса ? NoAutoReWrites=true до конца каждой ссылки, которую требуется отключить.
Создание URL-адресов CDN для общедоступных ресурсов
Если функция публикации не включена для общедоступного источника или ресурс не является одним из типов ссылок, поддерживаемых функцией автоматического перезаписи службы CDN, можно вручную создать URL-адреса в расположении CDN ресурсов и использовать эти URL-адреса в содержимом.
Примечание.
Невозможно жестко закодировать или создать URL-адреса CDN для ресурсов в частном источнике, так как требуемый маркер доступа, формируемый последним разделом URL-адреса, создается во время запроса ресурса. Вы можете создать URL-адрес для общедоступного CDN, и URL-адрес не должен быть жестко закодирован, так как он может измениться.
Для общедоступных ресурсов CDN формат URL-адреса выглядит следующим образом:
https://publiccdn.sharepointonline.com/<TenantHostName>/sites/site/library/asset.png
Замените TenantHostName именем клиента. Например:
https://publiccdn.sharepointonline.com/contoso.sharepoint.com/sites/site/library/asset.png
Примечание.
Используйте свойство контекста страницы для создания префикса вместо жесткого кодирования https://publiccdn.sharepointonline.com, так как URL-адрес может быть изменен. Если вы используете шаблоны отображения с классической версией SharePoint Online, вы можете использовать свойство window._spPageContextInfo.publicCdnBaseUrl в шаблоне отображения для префикса URL-адреса. Если вы используете веб-части SPFx для современных и классических SharePoint, можно использовать свойство this.context.pageContext.legacyPageContext.publicCdnBaseUrl, которое также предоставляет префикс. Если префикс меняется, реализация обновляется вместе с ним.
В качестве примера для SPFx можно создать URL-адрес с помощью свойства this.context.pageContext.legacyPageContext.publicCdnBaseUrlhost - //relativeURL for the item - - - . Дополнительные сведения см. в видео Использование CDN в клиентском коде, которое является частью серии производительности сезона 1.
Использование ресурсов в частных источниках
Дополнительная настройка для использования ресурсов в частных источниках не требуется. SharePoint Online автоматически перезаписывает URL-адреса для ресурсов в частных источниках, поэтому запросы на эти ресурсы всегда обслуживаются из CDN. Вы не можете вручную создавать URL-адреса для ресурсов CDN в частных источниках, так как эти URL-адреса содержат маркеры, которые должны быть автоматически созданы SharePoint Online во время запроса ресурса.
Доступ к ресурсам в частных источниках защищен динамически создаваемыми маркерами на основе разрешений пользователя к источнику с оговорками, описанными в следующих разделах. Пользователи должны иметь по крайней мере доступ на чтение к источникам, чтобы CDN отображала содержимое.
На следующей схеме показан рабочий процесс, когда SharePoint получает запрос на страницу, содержащую ресурсы из частного источника.
Авторизация на основе маркеров в частных источниках
Доступ к ресурсам в частных источниках в Office 365 CDN предоставляется маркерами, созданными SharePoint Online. Пользователям, у которых уже есть разрешение на доступ к папке или библиотеке, назначенной источником, автоматически предоставляются маркеры, позволяющие пользователю получить доступ к файлу в зависимости от их уровня разрешений. Эти маркеры доступа действительны в течение 30–90 минут после их создания, чтобы предотвратить атаки на воспроизведение маркеров.
После создания маркера доступа SharePoint Online возвращает клиенту пользовательский URI, содержащий два параметра авторизации eat (маркер авторизации edge) и oat (маркер авторизации источника). Структура каждого маркера — "<время окончания срока действия в формате времени эпохи">__<"безопасная подпись".> Например:
https://privatecdn.sharepointonline.com/contoso.sharepoint.com/sites/site1/library1/folder1/image1.jpg?eat=1486154359_cc59042c5c55c90b26a2775323c7c8112718431228fe84d568a3795a63912840&oat=1486154359_7d73c2e3ba4b7b1f97242332900616db0d4ffb04312
Примечание.
Любой пользователь, владеющий маркером, может получить доступ к ресурсу в сети CDN. Однако URL-адреса, содержащие эти маркеры доступа, совместно используются только по протоколу HTTPS, поэтому, если url-адрес не будет явно предоставлен конечным пользователем до истечения срока действия маркера, ресурс не будет доступен для несанкционированных пользователей.
Разрешения на уровне элементов не поддерживаются для ресурсов в частных источниках
Важно отметить, что SharePoint Online не поддерживает разрешения на уровне элементов для ресурсов в частных источниках. Например, для файла, расположенного по адресу https://contoso.sharepoint.com/sites/site1/library1/folder1/image1.jpg, пользователи имеют эффективный доступ к файлу при следующих условиях:
| User | Разрешения | Эффективный доступ |
|---|---|---|
| Пользователь 1 | Имеет доступ к папке1 | Доступ к image1.jpg из СЕТИ CDN |
| Пользователь 2 | Не имеет доступа к folder1 | Не удается получить доступ к image1.jpg из CDN |
| Пользователь 3 | Не имеет доступа к папке folder1, но ему предоставляется явное разрешение на доступ к image1.jpg в SharePoint Online. | Может получить доступ к image1.jpg ресурсов непосредственно из SharePoint Online, но не из СЕТИ CDN |
| Пользователь 4 | Имеет доступ к папке Folder1, но явно запрещен доступ к image1.jpg в SharePoint Online | Не удается получить доступ к ресурсу из SharePoint Online, но может получить доступ к ресурсу из сети CDN, несмотря на отказ в доступе к файлу в SharePoint Online |
Устранение неполадок с Office 365 CDN
Разделы справки подтвердить, что cdn обслуживает ресурсы?
После добавления ссылок на ресурсы CDN на страницу можно убедиться, что ресурс обслуживается из СЕТИ CDN, перейдя на страницу, щелкнув правой кнопкой мыши изображение после его отображения и просмотрив URL-адрес изображения.
Вы также можете использовать средства разработчика браузера для просмотра URL-адреса каждого ресурса на странице или использовать стороннее средство трассировки сети.
Примечание.
Если вы используете сетевое средство, например Fiddler, для тестирования ресурсов за пределами отрисовки ресурса со страницы SharePoint, необходимо вручную добавить заголовок ссылки "Referer: https://yourdomain.sharepoint.com" в запрос GET, где URL-адрес является корневым URL-адресом вашего клиента SharePoint Online.
Вы не можете тестировать URL-адреса CDN непосредственно в веб-браузере, так как у вас должен быть ссылочный объект, поступающий из SharePoint Online. Однако если добавить URL-адрес ресурса CDN на страницу SharePoint, а затем открыть страницу в браузере, ресурс CDN будет отображен на странице.
Дополнительные сведения об использовании средств разработчика в браузере Microsoft Edge см. в статье Средства разработчика Microsoft Edge.
Чтобы watch короткое видео, размещенное на канале YouTube для разработчиков SharePoint, в котором показано, как проверить работу сети CDN, см. статью Проверка использования CDN и обеспечение оптимального сетевого подключения.
Почему ресурсы из нового источника недоступны?
Ресурсы в новых источниках не будут сразу доступны для использования, так как требуется время для распространения регистрации по сети CDN и отправки ресурсов из источника в хранилище CDN. Время, необходимое для того, чтобы ресурсы были доступны в СЕТИ CDN, зависит от количества ресурсов и размеров файлов.
Моя клиентская веб-часть или SharePoint Framework решение не работает
При включении Office 365 CDN для общедоступных источников служба CDN автоматически создает следующие источники по умолчанию:
- */MASTERPAGE
- */БИБЛИОТЕКА СТИЛЕЙ
- */CLIENTSIDEASSETS
Если источник */clientsideassets отсутствует, SharePoint Framework решения завершаются сбоем, и предупреждения или сообщения об ошибках не создаются. Этот источник может отсутствовать либо из-за включения CDN с параметром -NoDefaultOrigins, для $true, либо из-за того, что источник был удален вручную.
Вы можете проверка, чтобы узнать, какие источники присутствуют, с помощью следующей команды PowerShell:
Get-SPOTenantCdnOrigins -CdnType Public
Кроме того, вы можете проверка с помощью интерфейса командной строки для Microsoft 365:
m365 spo cdn origin list
Чтобы добавить источник в PowerShell, выполните следующие действия:
Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */CLIENTSIDEASSETS
Чтобы добавить источник с помощью cli для Microsoft 365, выполните следующие действия:
m365 spo cdn origin add --origin */CLIENTSIDEASSETS
Какие модули PowerShell и оболочки CLI необходимы для работы с Office 365 CDN?
Вы можете работать с Office 365 CDN с помощью модуля PowerShell командной консоли SharePoint Online или интерфейса командной строки для Microsoft 365.
См. также
Планирование сети и настройка производительности для Office 365
Серия видео о производительности SharePoint — Office 365 серия видео CDN