HyAS Insights (предварительная версия)

Интеграция HYAS Insights с Microsoft Azure Sentinel обеспечивает прямой, высокий объем доступа к данным HYAS Insights. Он позволяет следователям и аналитикам понимать и защищаться от кибер-злоумышленников и их инфраструктуры.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга	Class	Регионы
Copilot Studio	Премия	Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD)
Логические приложения	Стандарт	Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD)
Power Apps	Премия	Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD)
Power Automate	Премия	Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD)

Контакт
Имя	HYAS Infosec
URL	https://www.hyas.com/contact
Адрес электронной почты	support@hyas.com

Метаданные соединителя
Publisher	HYAS Infosec
Website	https://www.hyas.com
Политика конфиденциальности	https://www.hyas.com/privacy-statement/
Категории	Безопасность; Сайт

Соединитель HYAS Insights

Pre-requisites

Для продолжения вам потребуется следующее:

План Microsoft Power Apps или Power Automate с пользовательским компонентом соединителя
подписка Azure
Ключ API аналитики HYAS

Поддерживаемые операции

Подробные сведения обо всех поддерживаемых операциях, входных и выходных данных доступны здесь.

Поддержка и документация:

Для всех запросов в службу поддержки и общих запросов вы можете связаться support@hyas.com с нами или посетить его.

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:


По умолчанию	Параметры для создания подключения.	Все регионы	Недоступен для совместного использования

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя	Тип	Description	Обязательно
Ключ API аналитики HYAS	securestring	Ключ API HYAS Insights для этого API	True

Ограничения регулирования

Имя	Вызовы	Период обновления
Вызовы API для каждого подключения	100	60 секунд

Действия

Получение динамической информации DNS	Возвращает динамические сведения DNS.
Получение пассивной хэш-информации	Возвращает пассивные хэш-данные.
Получение сведений о SSL-сертификате	Возвращает сведения о SSL-сертификате.
Получение сведений о Whois	Возвращает сведения о Whois.
Получение сведений о вредоносных программах	Возвращает сведения о вредоносных программах.
Получение сведений о географическом размещении мобильных устройств	Возвращает список сведений о географическом размещении мобильных устройств.
Получение сведений о индикаторах с открытым кодом	Возвращает список индикаторов угроз или intel из открытых источников.
Получение сведений о образцах записей вредоносных программ	Возвращает примеры вредоносных программ.
Получение сведений о приемнике	Возвращает сведения о приемнике.
Получение сведений о текущих объектах Whois	Возвращает текущую информацию whois для домена.
Получение сведений об атрибуции C2	Возвращает сведения об атрибуции C2.
Получение сведений об пассивном DNS	Возвращает пассивные сведения DNS.

Получение динамической информации DNS

Идентификатор операции:: DynamicDNS

Возвращает динамические сведения DNS.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Тип индикатора	indicator_type	True	string	Фильтр, используемый для запроса конечной точки dynamicdns, поддерживаемые значения: IP, домен и электронная почта.
Значение индикатора	indicator_value	True	string	Укажите допустимое значение IP-адреса или домена или электронной почты.

Возвращаемое значение

Товары: dynamicdns

Получение пассивной хэш-информации

Идентификатор операции:: PassiveHash

Возвращает пассивные хэш-данные.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Тип индикатора	indicator_type	True	string	Фильтр, используемый для запроса конечной точки пассивной косой черты, поддерживаются значения ipv4 и домена.
Значение индикатора	indicator_value	True	string	Укажите допустимое значение ipv4 или домена.

Возвращаемое значение

Товары: passivehash

Получение сведений о SSL-сертификате

Идентификатор операции:: SSLCertificate

Возвращает сведения о SSL-сертификате.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Тип индикатора	indicator_type	True	string	Фильтр, используемый для запроса конечной точки ssl_certificate, поддерживаются значения sha1 hash, ip и domain.
Значение индикатора	indicator_value	True	string	Укажите допустимое значение хэша sha1 или IP-адреса или домена.

Возвращаемое значение

Тело: sslcertificate

Получение сведений о Whois

Идентификатор операции:: Whois

Возвращает сведения о Whois.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Тип индикатора	indicator_type	True	string	Фильтр, используемый для запроса конечной точки whois, поддерживаемые значения: домен, электронная почта и телефон.
Значение индикатора	indicator_value	True	string	Укажите допустимое значение домена или электронной почты или телефона.

Возвращаемое значение

Товары: whois

Получение сведений о вредоносных программах

Идентификатор операции:: SampleInformation

Возвращает сведения о вредоносных программах.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Тип индикатора	indicator_type	True	string	Фильтр, используемый для запроса конечной точки выборки или инкромации, поддерживаются хэш-значения.
Значение индикатора	indicator_value	True	string	Укажите допустимое хэш-значение.

Возвращаемое значение

Тело: sample_information

Получение сведений о географическом размещении мобильных устройств

Идентификатор операции:: MobileGeolocation

Возвращает список сведений о географическом размещении мобильных устройств.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Тип индикатора	indicator_type	True	string	Фильтр, используемый для запроса конечной точки device_geo, поддерживаются значения ipv4 и ipv6.
Значение индикатора	indicator_value	True	string	Укажите допустимое значение ipv4 или ipv6.

Возвращаемое значение

Товары: device_geo

Получение сведений о индикаторах с открытым кодом

Идентификатор операции:: OpenSourceIndicators

Возвращает список индикаторов угроз или intel из открытых источников.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Тип индикатора	indicator_type	True	string	Фильтр, используемый для запроса конечной точки os_indicators, поддерживаемые значения: ipv4, ipv6, домен, sha1, sha256 и md5.
Значение индикатора	indicator_value	True	string	Укажите допустимое значение ipv4 или ipv6 или sha1 или sha256 или md5.

Возвращаемое значение

Товары: os_indicators

Получение сведений о образцах записей вредоносных программ

Идентификатор операции:: Sample

Возвращает примеры вредоносных программ.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Тип индикатора	indicator_type	True	string	Фильтр, используемый для запроса образца конечной точки, поддерживаемые значения: md5, домен и ipv4.
Значение индикатора	indicator_value	True	string	Укажите допустимое значение md5 или домена или ipv4.

Возвращаемое значение

Товары: sample

Получение сведений о приемнике

Идентификатор операции:: Sinkhole

Возвращает сведения о приемнике.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Тип индикатора	indicator_type	True	string	Фильтр, используемый для запроса конечной точки приемника, поддерживаются значения ipv4.
Значение индикатора	indicator_value	True	string	Укажите допустимое значение ipv4.

Возвращаемое значение

Товары: sinkhole

Получение сведений о текущих объектах Whois

Идентификатор операции:: CurrentWhois

Возвращает текущую информацию whois для домена.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Домен	domain	True	string	Укажите допустимый домен.

Возвращаемое значение

Тело: whois_current

Получение сведений об атрибуции C2

Идентификатор операции:: C2Attribution

Возвращает сведения об атрибуции C2.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Тип индикатора	indicator_type	True	string	Фильтр, используемый для запроса конечной точки c2attribution, поддерживаемые значения: домен, IP, электронная почта и sha256.
Значение индикатора	indicator_value	True	string	Укажите допустимое значение домена или адреса электронной почты или sha256.

Возвращаемое значение

Товары: c2attribution

Получение сведений об пассивном DNS

Идентификатор операции:: PassiveDNS

Возвращает пассивные сведения DNS.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Тип индикатора	indicator_type	True	string	Фильтр, используемый для запроса конечной точки пассивного трафика, поддерживаемые значения— ipv4, домен.
Значение индикатора	indicator_value	True	string	Укажите допустимое значение ipv4 или домена.

Возвращаемое значение

Товары: passivedns

Определения

device_geo

Имя	Путь	Тип	Описание
datetime	datetime	string	Строка даты и времени в формате RFC 3339.
device_user_agent	device_user_agent	string	Строка агента пользователя для устройства.
geo_country_alpha_2	geo_country_alpha_2	string	Код ISO 3316 alpha-2 для страны, связанной с сообщаемой lat/long.
geo_horizontal_accuracy	geo_horizontal_accuracy	float	Горизонтальная точность GPS.
ipv4	ipv4	string	Ipv4-адрес, назначенный устройству. Устройство может иметь ipv4 и ipv6.
ipv6	ipv6	string	Ipv6-адрес, назначенный устройству. Устройство может иметь ipv4 и ipv6.
широта	latitude	float	Единицы — это градусы на сфероиде WGS 84.
долгота	longitude	float	Единицы — это градусы на сфероиде WGS 84.
wifi_bssid	wifi_bssid	string	BSSID (MAC-адрес) маршрутизатора Wi-Fi, через который устройство обменивается данными.

воронка

Имя	Путь	Тип	Описание
count	count	number	Число воронок.
country_name	country_name	string	Страна ip.
data_port	data_port	number	Порт данных.
datetime	datetime	string	Первая замеченная дата воронки.
ipv4	ipv4	string	Ipv4 приемника.
last_seen	last_seen	string	Последняя видимая дата воронки.
organization_name	organization_name	string	Организация isp для ip-адреса.
sink_source	sink_source	string	Ipv4 источника приемника.

пассивные нсы

Имя	Путь	Тип	Описание
cert_name	cert_name	string	Имя поставщика сертификатов.
count	count	number	Пассивное число DNS.
domain	domain	string	Домен запрашиваемой пассивной информации DNS.
first_seen	first_seen	string	При первом просмотре этого домена.
city_name	ip.geo.city_name	string	Город ip-организации.
country_iso_code	ip.geo.country_iso_code	string	Код ISO страны для ip-организации.
country_name	ip.geo.country_name	string	Имя страны ip-организации.
location_latitude	ip.geo.location_latitude	string	Широта ip-организации.
location_longitude	ip.geo.location_longitude	string	Долгота ip-организации.
почтовый индекс	ip.geo.postal_code	string	Почтовый индекс ip-организации.
протокол IP	ip.ip	string	IP-адрес организации.
autonomous_system_number	ip.isp.autonomous_system_number	string	ASN ip-адреса.
autonomous_system_organization	ip.isp.autonomous_system_organization	string	ASO ip-адреса.
ip_address	ip.isp.ip_address	string	IP-адрес.
isp	ip.isp.isp	string	Поставщик услуг Интернета.
организация	ip.isp.organization	string	Организация ISP.
ipv4	ipv4	string	Ipv4-адрес пассивной записи DNS.
ipv6	ipv6	string	Ipv6-адрес пассивной записи DNS.
last_seen	last_seen	string	Последний раз, когда этот домен был замечен.
Источников	sources	array of string	Список поставщиков pDNS, из которых поступили данные.

dynamicdns

Имя	Путь	Тип	Описание
a_record	a_record	string	Запись A для домена.
account	account	string	Имя владельца учетной записи.
создано	created	string	Дата создания домена.
created_ip	created_ip	string	Ip-адрес владельца учетной записи.
domain	domain	string	Домен, связанный с динамическими сведениями DNS.
domain_creator_ip	domain_creator_ip	string	Ip-адрес создателя домена.
электронная почта	email	string	Адрес электронной почты, подключенный к домену.

пассивный хэш

Имя	Путь	Тип	Описание
domain	domain	string	Домен запрашиваемой пассивной хэш-информации.
md5_count	md5_count	number	Пассивное число DNS.

sslcertificate

Имя	Путь	Тип	Описание
related_count	related_count	number	Количество IP-адресов, подключенных к этому сертификату.
ssl_certs	ssl_certs	array of object	Объект ssl_certs.
протокол IP	ssl_certs.ip	string	IP-адрес, связанный с сертификатом.
cert_key	ssl_certs.ssl_cert.cert_key	string	Ключ сертификата (sha1).
expire_date	ssl_certs.ssl_cert.expire_date	string	Дата окончания срока действия сертификата.
issue_date	ssl_certs.ssl_cert.issue_date	string	Дата выдачи сертификата.
issuer_commonName	ssl_certs.ssl_cert.issuer_commonName	string	Общее имя, из которое был выдан сертификат.
issuer_countryName	ssl_certs.ssl_cert.issuer_countryName	string	Страна ISO сертификат был выдан из.
issuer_localityName	ssl_certs.ssl_cert.issuer_localityName	string	Город, где компания-издатель находится юридически.
issuer_organizationName	ssl_certs.ssl_cert.issuer_organizationName	string	Имя организации, выдавающее сертификат.
issuer_organizationalUnitName	ssl_certs.ssl_cert.issuer_organizationalUnitName	string	Имя подразделения организации, выдавающее сертификат.
issuer_stateOrProvinceName	ssl_certs.ssl_cert.issuer_stateOrProvinceName	string	Государство или провинция издателя.
md5	ssl_certs.ssl_cert.md5	string	Сертификат MD5.
serial_number	ssl_certs.ssl_cert.serial_number	string	Серийный номер сертификата.
sha1	ssl_certs.ssl_cert.sha1	string	Сертификат sha1.
sha_256	ssl_certs.ssl_cert.sha_256	string	Сертификат sha256.
sig_algo	ssl_certs.ssl_cert.sig_algo	string	Алгоритм подписи сертификата.
подпись	ssl_certs.ssl_cert.signature	string	Сигнатура разделена на несколько строк.
ssl_version	ssl_certs.ssl_cert.ssl_version		Версия SSL.
subject_commonName	ssl_certs.ssl_cert.subject_commonName	string	Имя субъекта, которому был выдан сертификат.
subject_countryName	ssl_certs.ssl_cert.subject_countryName	string	Страна, в который был выдан сертификат.
subject_localityName	ssl_certs.ssl_cert.subject_localityName	string	Город, где субъектная компания находится юридически.
subject_organizationName	ssl_certs.ssl_cert.subject_organizationName	string	Имя организации, получившей сертификат.
subject_organizationalUnitName	ssl_certs.ssl_cert.subject_organizationalUnitName	string	Имя подразделения организации, полученное сертификатом.
subject_stateOrProvinceName	ssl_certs.ssl_cert.subject_stateOrProvinceName	string	Название штата или провинции, в которой находится субъектная компания.
отметка времени	ssl_certs.ssl_cert.timestamp	string	Дата и время сертификата.

whois

Имя	Путь	Тип	Описание
address	address	array of string	Сведения об адресе.
city	city	array of string	Сведения о городе.
country	country	array of string	Сведения о стране.
domain	domain	string	Домен реестра.
domain_2tld	domain_2tld	string	Домен второго уровня реестра.
domain_created_datetime	domain_created_datetime	string	Дата и время создания записи whois.
domain_expires_datetime	domain_expires_datetime	string	Дата и время истечения срока действия записи whois.
domain_updated_datetime	domain_updated_datetime	string	Дата и время последнего обновления записи whois.
электронная почта	email	array of string	Сведения электронной почты.
idn_name	idn_name	string	Международное доменное имя.
nameserver	nameserver	array of string	Сведения о сервере имен.
phone	phone	array of object	Массив объекта, контакт реестра телефонного номера в формате e164 вместе с геоинформативными данными.
phone	phone.phone	string	Контакт реестра телефонного номера в формате e164.
носитель	phone.phone_info.carrier	string	Оператор номера телефона.
country	phone.phone_info.country	string	Страна номера телефона.
гео	phone.phone_info.geo	string	Номер телефона может быть городом или провинцией или регионом или страной.
privacy_punch	privacy_punch	boolean	Значение true, если эта запись содержит дополнительные сведения, обходя защиту конфиденциальности.
архивариус	registrar	string	Регистратор доменов.
whois_hash	whois_hash	string	Хэш-информация.
whois_id	whois_id	string	Сведения об идентификаторе whois.

c2attribution

Имя	Путь	Тип	Описание
actor_ipv4	actor_ipv4	string	Субъект ipv4.
c2_domain	c2_domain	string	Домен c2.
c2_ip	c2_ip	string	Ipv4 c2.
c2_url	c2_url	string	URL-адрес панели C2.
datetime	datetime	string	C2 Attribution datetime.
электронная почта	email	string	Сообщение электронной почты субъекта.
email_domain	email_domain	string	Домен электронной почты.
referrer_domain	referrer_domain	string	Домен ссылщика.
referrer_ipv4	referrer_ipv4	string	Ipv4-адрес ссылки.
referrer_url	referrer_url	string	URL-адрес ссылки.
sha256	sha256	string	Хэш вредоносных программ sha256.

sample_information

Имя	Путь	Тип	Описание
avscan_score	avscan_score	string	Оценка проверки AV.
md5	md5	string	Хэш MD5.
scan_results	scan_results	array of object
av_name	scan_results.av_name	string	Имя AV.
def_time	scan_results.def_time	string	Дата и время av.
threat_found	scan_results.threat_found	string	Источник.
scan_time	scan_time	string	Дата и время сканирования.
sha1	sha1	string	Хэш sha1.
sha256	sha256	string	Хэш sha256.
sha512	sha512	string	Хэш sha512.

образец

Имя	Путь	Тип	Описание
datetime	datetime	string	Дата обработки образца.
domain	domain	string	Домен примера.
ipv4	ipv4	string	Ipv4 примера.
ipv6	ipv6	string	Ipv6 примера.
md5	md5	string	Md5 примера.
sha1	sha1	string	Sha1 примера.
sha256	sha256	string	Sha256 примера.

os_indicators

Имя	Путь	Тип	Описание
context	context	string	Дополнительные сведения об источнике.
данные	data	object	Большой двоичный объект JSON с необработанными данными.
datetime	datetime	string	Строка даты и времени в формате RFC 3339.
domain	domain	string	Домен.
domain_2tld	domain_2tld	string	Domain_2tld.
first_seen	first_seen	string	Строка даты и времени в формате RFC 3339.
ipv4	ipv4	string	Ipv4-адрес. Может быть cidr.
ipv6	ipv6	string	Ipv6-адрес. Может быть cidr.
last_seen	last_seen	string	Строка даты и времени в формате RFC 3339.
md5	md5	string	Значение md5.
sha1	sha1	string	Значение sha1.
sha256	sha256	string	Значение sha256.
source_name	source_name	string	Source_name.
source_url	source_url	string	Source_url.
УРИ	uri	string	Исходное значение URI.

whois_current

Имя	Путь	Тип	Описание
items	items	array of object	Объект items.
abuse_emails	items.abuse_emails	array of string	Сведения о злоупотреблении электронной почтой.
address	items.address	array of string	Сведения об адресе.
city	items.city	array of string	Город реестра.
country	items.country	array of string	Страна реестра.
данные	items.data	string	Сведения о данных.
datetime	items.datetime	string	Сведения о дате и времени.
domain	items.domain	string	Домен реестра.
domain_2tld	items.domain_2tld	string	Домен второго уровня реестра.
domain_created_datetime	items.domain_created_datetime	string	Дата и время создания записи Whois.
domain_expires_datetime	items.domain_expires_datetime	string	Дата и время истечения срока действия записи Whois.
domain_updated_datetime	items.domain_updated_datetime	string	Дата и время последнего обновления записи Whois.
электронная почта	items.email	array of string	Сведения электронной почты.
idn_name	items.idn_name	string	Сведения о международном домене.
meta_data	items.meta_data	string	Сведения о метаданных.
имя	items.name	array of string	Имя контакта (контакт с реестром, административный контакт, технический контакт или контакт с злоупотреблением).)
nameserver	items.nameserver	array of string	Домен сервера имен.
организация	items.organization	array of string	Сведения о организации.
phone	items.phone	array of	Номер телефона реестра в формате e164.
архивариус	items.registrar	string	Регистратор доменов.
государство	items.state	array of	Состояние регистрации домена.
whois_hash	items.whois_hash	string	Хэш-информация.
whois_id	items.whois_id	string	Сведения об идентификаторе whois.
whois_nameserver	items.whois_nameserver	array of object	Объект whois_nameserver.
domain	items.whois_nameserver.domain	string	Сведения о домене сервера имен.
domain_2tld	items.whois_nameserver.domain_2tld	string	Сведения domain_2tld сервера имен.
whois_related_nameserver_id	items.whois_nameserver.whois_related_nameserver_id	string	Сведения об идентификаторе сервера имен.
whois_pii	items.whois_pii	array of object	Объект whois_pii.
address	items.whois_pii.address	string	Сведения об адресе личного удостоверения.
city	items.whois_pii.city	string	Сведения о городе личных удостоверений.
данные	items.whois_pii.data	string	Сведения о персональных удостоверениях.
электронная почта	items.whois_pii.email	string	Сведения электронной почты личных удостоверений.
geo_country_alpha_2	items.whois_pii.geo_country_alpha_2	string	Сведения о стране личных удостоверений.
имя	items.whois_pii.name	string	Сведения об имени личного удостоверения.
организация	items.whois_pii.organization	string	Сведения о организации личных удостоверений.
phone_e164	items.whois_pii.phone_e164	string	Личная идентификация Phone_e164 сведения.
государство	items.whois_pii.state	string	Сведения о состоянии личных удостоверений.
whois_related_pii_id	items.whois_pii.whois_related_pii_id	string	Сведения об идентификаторе личного удостоверения.
whois_related_type	items.whois_pii.whois_related_type	string	Связанные с личными удостоверениями сведения.
source	source	string	Исходные сведения.
total_count	total_count	number	Общее количество сведений.