INTEGRITY Документация

Gateway DNS

В описаниях ниже перечислены поля, доступные для gateway_dns.

AccountID

Тип: string

ID аккаунта Cloudflare.

ApplicationID

Тип: int

Идентификатор приложения, к которому относится домен (например, 1, 2). Если ApplicationID не найден, устанавливается значение 0.

ApplicationName

Тип: string

Название приложения, к которому относится домен (например, 'Cloudflare Dashboard').

AppliedMaxTTL

Тип: int

Максимальное ограничение TTL, применяемое к записям ответа, в секундах. Устанавливается в 0, если ограничение не применялось.

AuthoritativeNameServerIPs

Тип: array[string]

IP-адреса авторитетных серверов имён, предоставивших ответы, если таковые имеются (например, ['203.0.113.1', '203.0.113.2']).

CNAMECategoryIDs

Тип: array[int]

Идентификатор или идентификаторы категории, к которой относятся промежуточные CNAME-домены (например, [7,12,28,122,129,163]).

CNAMECategoryNames

Тип: array[string]

Название или названия категорий, к которым относятся промежуточные домены cname (например, ['Photography', 'Weather']).

CNAME-записи

Тип: array[string]

Разрешённые промежуточные cname-домены (например, ['alias.example.com']).

CNAMEsReversed

Тип: array[string]

Разрешённые промежуточные cname-домены в обратном порядке (например, ['com.example.alias']).

ColoCode

Тип: string

Название дата-центра, который получил DNS-запрос (например, «SJC», «MIA», «IAD»).

ColoID

Тип: int

Идентификатор дата-центра, принявшего DNS-запрос (например, 46, 72, 397).

CustomResolveDurationMs

Тип: int

Время, которое потребовалось пользовательскому резолверу для ответа.

CustomResolverAddress

Тип: string

Комбинация IP-адреса и порта, использованная для выполнения запроса к пользовательскому DNS-резолверу, если применимо.

CustomResolverPolicyID (устарело)

Тип: string

UUID пользовательской политики резолвера, если найдено совпадение. Заменено полем ResolverPolicyID.

CustomResolverPolicyName (устарело)

Тип: string

Название пользовательской политики резолвера, если найдено совпадение. Заменено полем ResolverPolicyName.

CustomResolverResponse

Тип: string

Статус ответа пользовательского резолвера.

Datetime

Тип: int or string

Дата и время отправки соответствующего DNS-запроса (например, '2021-07-27T00:01:07Z').

DeviceID

Тип: string

UUID устройства, с которого был отправлен HTTP-запрос (например, 'dad71818-0429-11ec-a0dc-000000000000').

DeviceName

Тип: string

Название устройства, с которого поступил HTTP-запрос (например, «Laptop MB810»).

DoHSubdomain

Тип: string

Целевой поддомен DoH, на который был отправлен DNS-запрос.

DoTSubdomain

Тип: string

Целевой поддомен DoT, на который был отправлен DNS-запрос.

DstIP

Тип: string

IP-адрес назначения, на который был отправлен DNS-запрос (например, '104.16.132.2290').

DstPort

Тип: int

Порт назначения, используемый в периферийной сети. Порт меняется в зависимости от протокола, который использует DNS-запрос (например, 0).

EDEErrors

Тип: array[int]

Список возвращённых кодов Extended DNS Error Codes (например, [2, 3]).

Электронная почта

Тип: string

Адрес электронной почты, используемый для аутентификации клиента (например, '[email protected]').

InitialCategoryIDs

Тип: array[int]

Идентификатор или идентификаторы категории, к которой относятся запрошенные домены (например, [7,12,28,122,129,163]).

InitialCategoryNames

Тип: array[string]

Название или названия категорий, к которым относятся запрошенные домены (например, ['Photography', 'Weather']).

InitialResolvedIPs

Тип: array[string]

IP-адреса, используемые для сопоставления существующей политики соответствия FQDN между Gateway DNS и Gateway proxy.

InternalDNSDurationMs

Тип: int

Время, которое потребовалось внутреннему DNS для ответа.

InternalDNSFallbackStrategy

Тип: string

Резервная стратегия, применённая к внутреннему DNS-ответу. Пусто, если резервная стратегия не применялась.

InternalDNSRCode

Тип: int

Код возврата, отправленный внутренней службой DNS.

InternalDNSViewID

Тип: string

Идентификатор внутреннего представления DNS, отправленный во внутреннюю службу DNS.

InternalDNSZoneID

Тип: string

Идентификатор зоны DNS, возвращённый внутренней службой DNS.

IsResponseCached

Тип: bool

Поступает ли ответ из кеша или нет.

Расположение

Тип: string

Название местоположения, откуда приходит DNS-запрос. Местоположение создаётся клиентом (например, 'Office NYC').

LocationID

Тип: string

UUID местоположения, откуда приходит DNS-запрос. Местоположение создаётся клиентом (например, '7bdc7a9c-81d3-4816-8e56-000000000000').

MatchedCategoryIDs

Тип: array[int]

Идентификатор или идентификаторы категории, с которой домен был сопоставлен согласно политике (например, [7,12,28,122,129,163]).

MatchedCategoryNames

Тип: array[string]

Название или названия категорий, с которыми домен был сопоставлен согласно политике (например, ['Photography', 'Weather']).

MatchedIndicatorFeedIDs

Тип: array[int]

Идентификатор или идентификаторы indicator feed(s), с которым домен был сопоставлен согласно политике (например, [7,12]).

MatchedIndicatorFeedNames

Тип: array[string]

Название или названия indicator feed(s), с которыми домен был сопоставлен согласно политике (например, ['Vendor Malware Feed', 'Vendor CoC Feed']).

Политика (устаревшее)

Тип: string

Название политики, которая была применена, если таковая была (например, '7bdc7a9c-81d3-4816-8e56-de1acad3dec5').

PolicyID

Тип: string

Идентификатор применённой политики или правила (если есть).

PolicyName

Тип: string

Название политики, которая была применена, если таковая была.

Протокол

Тип: string

Протокол, который клиент использовал для DNS-запроса (например, «udp»).

QueryApplicationIDs

Тип: array[int]

Идентификатор или идентификаторы приложений, к которым относится запрошенный домен (например, [1, 51])

QueryApplicationNames

Тип: array[string]

Название или названия приложений, к которым относится запрошенный домен (например, ['Cloudflare Dashboard'])

QueryCategoryIDs

Тип: array[int]

Объединение всех категорий; начальные категории + категории разрешённых IP-адресов + промежуточные категории CNAME

QueryCategoryNames

Тип: array[string]

Объединение всех названий категорий; начальные категории + категории разрешённых IP-адресов + промежуточные категории CNAME

QueryID

Тип: string

Глобально уникальный идентификатор запроса.

QueryIndicatorFeedIDs

Тип: array[int]

Идентификатор или идентификаторы indicator feed(s), к которому относится домен (например, [7,12,28]).

QueryIndicatorFeedNames

Тип: array[string]

Название или названия indicator feed(s), к которым относится домен (например, ['Vendor Malware Feed', 'Vendor CoC Feed', 'Vendor Phishing Feed']).

QueryName

Тип: string

Имя запроса (например, «example.com»). Для запросов к корневым серверам Cloudflare покажет в журналах «.».

QueryNameReversed

Тип: string

Имя запроса в обратном порядке (например, 'com.example'). Для запросов к корневому серверу Cloudflare показывает в журналах '.'.

QuerySize

Тип: int

Размер DNS-запроса в байтах (например, 151).

QueryType

Тип: int

Тип DNS-запроса (например, 1, 28, 15 или 16).

QueryTypeName

Тип: string

Тип DNS-запроса (например, 'A', 'AAAA', 'MX' или 'TXT').

RCode

Тип: int

Код возврата, отправленный DNS-резолвером.

RData (устаревшее)

Тип: array[object]

Объекты rdata (например, [{"type":"5","data":"dns-packet-placeholder..."}]).

RedirectTargetURI

Тип: string

Пользовательский URI, на который был перенаправлен пользователь, если есть.

RegistrationID

Тип: string

UUID регистрации устройства, с которого поступил этот HTTP-запрос (например, 'dad71818-0429-11ec-a0dc-000000000000').

RequestContextCategoryIDs

Тип: array[int]

Идентификатор или идентификаторы категории, отправленной на шлюз в EDNS-запросе для фильтрации (например, [7,12,28,122,129,163]).

RequestContextCategoryNames

Тип: array[string]

Название или названия категории, отправленной на шлюз в EDNS-запросе для фильтрации (например, ['Photography', 'Weather']).

ResolvedIPCategoryIDs

Тип: array[int]

Идентификатор или идентификаторы категории, к которой относятся IP-адреса в ответе (например, [7,12,28,122,129,163]).

ResolvedIPCategoryNames

Тип: array[string]

Название или названия категорий, к которым относятся IP-адреса в ответе (например, ['Photography', 'Weather']).

ResolvedIPContinentCodes

Тип: array[string]

Код континента для каждого разрешённого IP-адреса, если есть (например, ['NA', 'EU']).

ResolvedIPCountryCodes

Тип: array[string]

Код страны для каждого разрешённого IP-адреса, если есть (например, ['US', 'PT']).

ResolvedIPs

Тип: array[string]

IP-адреса, полученные в ответе, если они есть (например, ['203.0.113.1', '203.0.113.2']).

ResolverDecision

Тип: string

Результат DNS-запроса (например, 'overrideForSafeSearch').

ResolverPolicyID

Тип: string

UUID политики резолвера, если было найдено совпадение.

ResolverPolicyName

Тип: string

Название политики резолвера, если было найдено совпадение.

ResourceRecords

Тип: array[object]

Объекты rdata (например, [{"type":"5","data":"dns-packet-placeholder..."}]).

ResourceRecordsJSON

Тип: string

Строка, представляющая массив JSON с возвращёнными ресурсными записями (например, '[{"name": "example.com", "type": "CNAME", "class": "IN", "ttl": 3600, "rdata": "cname.example.com."}]').

ResponseTimeMs

Тип: int

Общее время ответа на DNS-запрос в миллисекундах.

SrcIP

Тип: string

IP-адрес источника, отправившего DNS-запрос (например, '104.16.132.229').

SrcIPContinentCode

Тип: string

Код континента IP-адреса источника, с которого был отправлен DNS-запрос (например, 'NA').

SrcIPCountryCode

Тип: string

Код страны IP-адреса источника, с которого был отправлен DNS-запрос (например, 'US').

SrcPort

Тип: int

Порт, который клиент использовал при отправке DNS-запроса (например, 0).

TenantID

Тип: string

Идентификатор тенанта DNS-запроса, если он существует.

TimeZone

Тип: string

Часовой пояс, использованный для расчёта текущего времени, если для соответствующего правила было задано расписание с этим часовым поясом.

TimeZoneInferredMethod

Тип: string

Метод выбора часового пояса для расписания (по правилу / по IP-адресу пользователя / по локальному времени).

UpstreamRecordTTLs

Тип: array[int]

TTL каждой записи в upstream-ответе, в секундах. Соответствует один к одному ресурсным записям (например, [3600, 300]).

UserID

Тип: string

Идентификатор пользователя, с которого поступил HTTP-запрос (например, '00000000-0000-0000-0000-000000000000').