← Client-side security / client-side-security / rules

Нарушения правил безопасности контента

Нарушение правила происходит, когда браузер загружает ресурс, не охваченный ни одним из ваших правила безопасности контента. При использовании правил логирования ресурс загружается в обычном режиме, но регистрируется. При использовании правил разрешения браузер блокирует ресурс.

Через некоторое время после настройки правил безопасности контента на панели управления Cloudflare начнут отображаться все нарушения этих правил. Эта информация доступна для правил с любым действие (Allow и Log).

Информация о нарушениях правил также доступна через GraphQL API и Logpush.

Чтобы просмотреть сведения о нарушении правил:

1. На панели управления Cloudflare перейдите к разделу Правила безопасности страницу.

   Перейдите в Правила безопасности ↗

2. (Необязательно) Отфильтруйте по Правила безопасности содержимого.

Отображаемая информация включает следующее:

• Мини-график рядом с названием правила, показывающий количество нарушений за последние семь дней.
• Для правил безопасности контента с зафиксированными нарушениями доступен раскрывающийся блок сведений по каждому правилу: в нём указаны основные ресурсы, фигурирующие в событиях нарушений, и спарклайн для каждого такого ресурса.

Используйте Cloudflare GraphQL API чтобы получить информацию о нарушениях правил через следующий набор данных:

• pageShieldReportsAdaptiveGroups

Вы можете запрашивать в наборе данных нарушения правил, произошедшие за последние 30 дней.

Используйте интроспекция чтобы изучить доступные поля схемы GraphQL. Дополнительные сведения см. в Изучите схему GraphQL.

Введение в запросы GraphQL см. Основы запросов.

query PageShieldReports(
	$zoneTag: string
	$datetimeStart: Time
	$datetimeEnd: Time
) {
	viewer {
		zones(filter: { zoneTag: $zoneTag }) {
			pageShieldReportsAdaptiveGroups(
				limit: 100
				orderBy: [datetime_ASC]
				filter: { datetime_geq: $datetimeStart, datetime_leq: $datetimeEnd }
			) {
				avg {
					sampleInterval
				}
				count
				dimensions {
					policyID
					datetime
					datetimeMinute
					datetimeFiveMinutes
					datetimeFifteenMinutes
					datetimeHalfOfHour
					datetimeHour
					url
					urlHost
					host
					resourceType
					pageURL
					action
				}
			}
		}
	}
}

echo '{ "query":
  "query PageShieldReports($zoneTag: string, $datetimeStart: string, $datetimeEnd: string) {
    viewer {
      zones(filter: {zoneTag: $zoneTag}) {
        pageShieldReportsAdaptiveGroups(limit: 100,  orderBy: [datetime_ASC], filter: {datetime_geq:$datetimeStart, datetime_leq:$datetimeEnd}) {
          avg {
            sampleInterval
          }
          count
          dimensions {
            policyID
            datetime
            datetimeMinute
            datetimeFiveMinutes
            datetimeFifteenMinutes
            datetimeHalfOfHour
            datetimeHour
            url
            urlHost
            host
            resourceType
            pageURL
            action
          }
        }
      }
    }
  }",
  "variables": {
    "zoneTag": "<CLOUDFLARE_ZONE_ID>",
    "datetimeStart": "2023-04-17T11:00:00Z",
    "datetimeEnd": "2023-04-24T12:00:00Z"
  }
}' | tr -d '\n' | curl --silent \
https://api.cloudflare.com/client/v4/graphql \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
--header "Content-Type: application/json" \
--data @-

Cloudflare Logpush поддерживает отправку журналов в сервисы хранения, SIEM-системы, и провайдеров управления журналами.

Информация о нарушениях правил доступна в page_shield_events датасет.

Дополнительные сведения о настройке заданий Logpush см. Logpush документация.