В этом документе представлены рекомендации по настройке политики безопасности контента (CSP) веб-сайта для API JavaScript Карт. Поскольку пользователи используют самые разные типы и версии браузеров, разработчикам рекомендуется использовать этот пример в качестве справочного материала и корректировать настройки до тех пор, пока нарушения CSP не прекратятся.
Узнайте больше о Политике безопасности контента .
Строгий CSP
Мы рекомендуем использовать строгую CSP вместо CSP с разрешённым списком, чтобы снизить вероятность атак на систему безопасности. Maps JavaScript API поддерживает использование строгой CSP на основе одноразовых значений. Веб-сайты должны заполнять элементы script и style одноразовыми значениями. Maps JavaScript API находит первый такой элемент и применяет его одноразовые значения к элементам стиля или скрипта, вставленным скриптом 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 JavaScript API, чтобы быть в курсе последних изменений, и при необходимости добавить любой новый домен службы в разрешённый список.
Веб-сайты, загружающие API JavaScript Карт из устаревшего домена API Google (например, 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:;