В этом документе содержатся рекомендации по настройке политики безопасности контента (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:;