Рекомендации по Content Security Policy

В этом документе содержатся рекомендации по настройке политики безопасности контента (CSP) веб-сайта для API JavaScript Карт. Поскольку конечные пользователи используют широкий спектр типов и версий браузеров, разработчикам рекомендуется использовать этот пример в качестве справочного материала, выполняя тонкую настройку до тех пор, пока не прекратятся дальнейшие нарушения CSP.

Узнайте больше о Политике безопасности контента .

Строгий CSP

Мы рекомендуем использовать строгий CSP вместо CSP с разрешенным списком, чтобы снизить вероятность атак на безопасность. Maps JavaScript API поддерживает использование строгого CSP на основе nonce. Веб-сайты должны заполнять элементы script и style значением nonce. Внутри Maps JavaScript API найдет первый такой элемент и применит его значение nonce к элементам стиля или скрипта, вставленным скриптом API соответственно.

Пример

В следующем примере показан образец CSP, а также HTML-страница, на которой он встроен:

Образец политики безопасности контента

script-src 'nonce-{script value}' 'strict-dynamic' https: 'unsafe-eval' blob:;
img-src 'self' https://*.googleapis.com https://*.gstatic.com *.google.com *.googleusercontent.com data:;
frame-src *.google.com;
connect-src 'self' https://*.googleapis.com *.google.com https://*.gstatic.com data: blob:;
font-src https://fonts.gstatic.com;
style-src 'nonce-{style value}' https://fonts.googleapis.com;
worker-src blob:;

Пример HTML-страницы

<!DOCTYPE html>
<html>
  <head>
    <link rel="stylesheet" href="style.css" nonce="{style value}">
    <style nonce="{style value}">...</style>
    ...
  </head>
  <body>
    <div id="map"></div>
    <script src="https://maps.googleapis.com/maps/api/js?key=&callback=initMap" async nonce="{script value}"></script>
    <script nonce="{script value}"> function initMap() { ... } </script>
  </body>
</html>

Белый список CSP

Если вы настроили белый список CSP, ознакомьтесь со списком доменов Google Maps . Мы рекомендуем ознакомиться с этим документом и примечаниями к выпуску Maps JavaScript API, чтобы оставаться в курсе событий, и при необходимости включить в белый список любой новый домен службы.

Веб-сайты, загружающие Maps JavaScript API из устаревшего домена Google API (например, maps.google.com ) или домена, специфичного для региона (например, maps.google.fr ), также должны включать эти доменные имена в свои настройки CSP script-src , как показано в следующем примере:

script-src 'self' 'unsafe-inline' 'unsafe-eval' https://*.googleapis.com https://*.gstatic.com *.google.com https://*.ggpht.com *.googleusercontent.com blob:;
img-src 'self' https://*.googleapis.com https://*.gstatic.com *.google.com  *.googleusercontent.com data:;
frame-src *.google.com;
connect-src 'self' https://*.googleapis.com *.google.com https://*.gstatic.com  data: blob:;
font-src https://fonts.gstatic.com;
style-src 'self' 'unsafe-inline' https://fonts.googleapis.com;
worker-src blob:;