Digital Footprint (preview) RiskIQ Digital Footprint (предварительная версия)

RiskIQ Digital Footprint для Корпорации Майкрософт позволяет группам безопасности контролировать их поверхность атаки, уменьшая их риск и создавая лучшую защиту. Соединитель RiskIQ Digital Footprint для Майкрософт автоматически сделает ваш внешний инвентаризацию активов, включая метаданные ресурсов, доступные вашей команде для автоматизированных операций. Используйте эти данные для создания отчетов, активации оповещений или помощи в выявлении уязвимостей или воздействия на ресурсы.

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

Услуга 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)
Контакт
Имя Цифровой след в RiskIQ
URL https://www.riskiq.com/integrations/microsoft/
Адрес электронной почты support@riskiq.com
Метаданные соединителя
Publisher RiskIQ
Website https://www.riskiq.com/products/digital-footprint/
Политика конфиденциальности https://www.riskiq.com/privacy-policy/
Категории Безопасность; ИТ-операции

RiskIQ Digital Footprint предоставляет сведения о глобальном инвентаризации. Глобальные конечные точки инвентаризации позволяют запрашивать инвентаризацию ресурсов RiskIQ. Инвентаризация активов состоит из следующих типов активов: домен, узел, IP_Address, IP_Block, AS, Page, SSL_Cert, Contact. Каждый ресурс имеет уникальное имя, которое можно использовать для извлечения ресурса из инвентаризации.

Pre-requisites

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

Получение учетных данных

Зарегистрируйтесь для тестового ключа API в RiskIQ Security Intelligence Services или обратитесь к представителю учетной записи (support@riskiq.com), чтобы определить существующие ключи клиента.

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

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

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

По умолчанию

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

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

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

Имя Тип Description Обязательно
Токен securestring Токен для этого API True
Секрет securestring Секрет для этого API True

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

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

Действия

Добавление ресурсов в глобальную инвентаризацию

Добавьте один или несколько ресурсов и набор свойств.

Запрос на поиск по списку активов по типу

Массовое получение набора ресурсов по имени и типу.

Запрос на получение ресурсов из исторического набора данных, соответствующего критериям

Выполните поиск по данным журнала глобального инвентаризации для набора ресурсов, которые соответствуют критериям.

Запрос на получение ресурсов из недавнего набора данных, соответствующего критериям

Выполните поиск по недавнему набору данных глобального инвентаризации для набора ресурсов, которые соответствуют критериям.

Обновление ресурсов до глобального инвентаризации с помощью исторического поиска

Обновите одно или несколько свойств в наборе ресурсов. При обновлении через запрос будет использоваться исторический поиск, в противном случае он работает так же, как и /update.

Обновление ресурсов до глобальной инвентаризации

Обновите одно или несколько свойств в наборе ресурсов.

Отмена задачи для обновления глобальной инвентаризации

Отмена дальнейшей обработки асинхронной задачи глобального обновления инвентаризации.

Получение задачи по идентификатору

Получение состояния асинхронной задачи глобального обновления инвентаризации.

Получение количества подтвержденных ресурсов, добавленных или удаленных

Получение сводки, описывающей количество подтвержденных активов, которые были добавлены или удалены из инвентаризации в течение заданного периода времени.

Получение подключенных ресурсов по типу

Получите набор ресурсов, подключенных к запрашиваемому ресурсу.

Получение ресурса по идентификатору

Извлеките ресурс указанного идентификатора UUID из глобальной инвентаризации.

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

Выполните поиск по недавнему набору данных глобальной инвентаризации для ресурсов, которые соответствуют критериям.

Получение ресурсов по типу

Извлеките ресурс указанного типа и имени из глобальной инвентаризации.

Получение списка брендов

Получение списка брендов, определенных для рабочей области.

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

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

Получение списка организаций

Получение списка организаций, определенных для рабочей области.

Получение списка подтвержденных ресурсов, добавленных или удаленных по типу

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

Получение списка сохраненных поисков

Получите список сохраненных поисков для рабочей области.

Получение списка тегов

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

Добавление ресурсов в глобальную инвентаризацию

Добавьте один или несколько ресурсов и набор свойств.

Параметры

Имя Ключ Обязательно Тип Описание
object
Сбой при ошибке
failOnError boolean

Если значение true, запрос завершится ошибкой, если обнаружено недопустимое обновление. Если значение false, все недопустимые обновления будут пропущены, но другие будут продолжаться.

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

Добавление ответа глобального инвентаризации

response
object

Запрос на поиск по списку активов по типу

Массовое получение набора ресурсов по имени и типу.

Параметры

Имя Ключ Обязательно Тип Описание
object

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

Товары
BulkGetAssetResponse

Запрос на получение ресурсов из исторического набора данных, соответствующего критериям

Выполните поиск по данным журнала глобального инвентаризации для набора ресурсов, которые соответствуют критериям.

Параметры

Имя Ключ Обязательно Тип Описание
object
Глобальный
global boolean

При задании этого значения значение true будет выполняться поиск во всех глобальных инвентаризациях. Установка значения false будет выполнять поиск ресурсов в рабочей области, связанной с маркером проверки подлинности.

Страница
page integer

Индекс извлекаемой страницы. Индекс основан на нуле, поэтому первая страница — страница 0.

Size
size integer

Количество соответствующих ресурсов для возврата на страницу

Недавние
recent boolean

Если задано и "true", возвращаются только последние данные в ресурсе.

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

Ответ глобального поиска инвентаризации

response
object

Запрос на получение ресурсов из недавнего набора данных, соответствующего критериям

Выполните поиск по недавнему набору данных глобального инвентаризации для набора ресурсов, которые соответствуют критериям.

Параметры

Имя Ключ Обязательно Тип Описание
object
Глобальный
global boolean

При установке этого значения значение true будет выполнять поиск всех глобальных параметров инвентаризации с значением false, будет выполнять поиск ресурсов в рабочей области, связанной с маркером проверки подлинности.

Страница
page integer

Индекс извлекаемой страницы. Индекс равен нулю, поэтому первая страница — страница 0

Size
size integer

Количество соответствующих ресурсов для возврата на страницу

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

Ответ глобального поиска инвентаризации

response
object

Обновление ресурсов до глобального инвентаризации с помощью исторического поиска

Обновите одно или несколько свойств в наборе ресурсов. При обновлении через запрос будет использоваться исторический поиск, в противном случае он работает так же, как и /update.

Параметры

Имя Ключ Обязательно Тип Описание
object
Сбой при ошибке
FailOnError boolean

Если значение true, запрос завершится ошибкой, если обнаружено недопустимое обновление. Если значение false, все недопустимые обновления будут пропущены, но другие будут продолжаться.

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

Ответ глобального обновления инвентаризации

response
object

Обновление ресурсов до глобальной инвентаризации

Обновите одно или несколько свойств в наборе ресурсов.

Параметры

Имя Ключ Обязательно Тип Описание
object
Сбой при ошибке
failOnError boolean

Если значение true, запрос завершится ошибкой, если обнаружено недопустимое обновление. Если значение false, то любые недопустимые обновления будут пропущены, но другие будут продолжаться

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

Ответ глобального обновления инвентаризации

response
object

Отмена задачи для обновления глобальной инвентаризации

Отмена дальнейшей обработки асинхронной задачи глобального обновления инвентаризации.

Параметры

Имя Ключ Обязательно Тип Описание
object
Идентификатор задачи
id True string

Идентификатор асинхронной задачи для отмены

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

Тело
TaskResponse

Получение задачи по идентификатору

Получение состояния асинхронной задачи глобального обновления инвентаризации.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор задачи
id True string

Идентификатор асинхронной задачи для получения.

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

Тело
TaskResponse

Получение количества подтвержденных ресурсов, добавленных или удаленных

Получение сводки, описывающей количество подтвержденных активов, которые были добавлены или удалены из инвентаризации в течение заданного периода времени.

Параметры

Имя Ключ Обязательно Тип Описание
Date
date string

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

Диапазон
range integer

Период времени, с течением которого были определены изменения. Поддерживаемые диапазоны : 1, 7 и 30 дней.

Бренд
brand string

Суммарные счетчики будут включать только активы, имеющие этот бренд.

Организация
organization string

Суммарные счетчики будут включать только ресурсы, имеющие эту организацию.

Тег
tag string

Суммарные счетчики включают только ресурсы с этим тегом.

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

Получение подключенных ресурсов по типу

Получите набор ресурсов, подключенных к запрашиваемому ресурсу.

Параметры

Имя Ключ Обязательно Тип Описание
Тип
type True string

Тип ресурса для поиска подключенных ресурсов. Допустимые типы: ("Домен", "Узел", "IP_Address", "IP_Block", "AS", "Страница", "SSL_Cert", "Name_Server", "Mail_Server", "Контакт"

Имя
name True string

Имя ресурса для поиска подключенных ресурсов

Глобальный
global boolean

При задании этого значения значение true будет выполняться поиск во всех глобальных инвентаризациях. Если задать значение false, он будет искать ресурсы в рабочей области, связанной с маркером проверки подлинности.

Страница
page integer

Индекс извлекаемой страницы. Индекс основан на нуле, поэтому первая страница — страница 0.

Size
size integer

Ответ содержит страницу ресурсов для каждого связанного типа ресурса. Размер определяет количество связанных активов каждого типа, возвращаемых.

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

Глобальный ресурс инвентаризации

response
object

Получение ресурса по идентификатору

Извлеките ресурс указанного идентификатора UUID из глобальной инвентаризации.

Параметры

Имя Ключ Обязательно Тип Описание
UUID (Универсальный уникальный идентификатор)
uuid True string

Идентификатор UUID извлекаемого ресурса.

Глобальный
global boolean

При задании этого значения значение true будет выполняться поиск во всех глобальных инвентаризациях. Если задать значение false, он будет искать ресурсы в рабочей области, связанной с маркером проверки подлинности.

Недавние
recent boolean

Если задано и "true", возвращаются только последние данные в ресурсе.

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

Глобальный ресурс инвентаризации

response
object

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

Выполните поиск по недавнему набору данных глобальной инвентаризации для ресурсов, которые соответствуют критериям.

Параметры

Имя Ключ Обязательно Тип Описание
Сохраненный идентификатор поиска
savedSearchID integer

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

Сохраненное имя поиска
savedSearchName string

Имя сохраненного поиска, которое требуется выполнить.

Глобальный
global boolean

При задании этого значения значение true будет выполняться поиск во всех глобальных инвентаризациях. Если задать значение false, он будет искать ресурсы в рабочей области, связанной с маркером проверки подлинности.

Страница
page integer

Индекс извлекаемой страницы. Индекс основан на нуле, поэтому первая страница — страница 0.

Size
size integer

Количество соответствующих ресурсов для возврата на страницу

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

Ответ глобального поиска инвентаризации

response
object

Получение ресурсов по типу

Извлеките ресурс указанного типа и имени из глобальной инвентаризации.

Параметры

Имя Ключ Обязательно Тип Описание
Тип
type True string

Тип извлекаемого ресурса. Допустимые типы: (домен, узел, IP_Address, IP_Block, AS, страница, SSL_Cert, Name_Server, Mail_Server, контакт)

Имя
name True string

Имя извлекаемого ресурса

Глобальный
global boolean

При задании этого значения значение true будет выполняться поиск во всех глобальных инвентаризациях. Если задать значение false, он будет искать ресурсы в рабочей области, связанной с маркером проверки подлинности.

Size
size integer

Глобальные ресурсы инвентаризации могут содержать страницы связанных данных, например атрибуты, файлы cookie и пары узлов. Размер определяет количество возвращаемых элементов.

Недавние
recent boolean

Если задано и "true", возвращаются только последние данные в ресурсе.

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

Глобальный ресурс инвентаризации

response
object

Получение списка брендов

Получение списка брендов, определенных для рабочей области.

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

Товары
brands

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

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

Параметры

Имя Ключ Обязательно Тип Описание
Период
period integer

Только что открытый период порта в днях. Допустимые параметры: 7, 14 и 30. Если период не указан, то вновь открытые порты из всего периода времени будут возвращены.

Ports
ports string

Список портов с разделителями-запятыми, используемый для ограничения результатов, которые включают порт в список.

Исключенные порты
excludedPorts string

Разделенный запятыми список портов, используемых для ограничения результатов, которые не включают порт в список

После
after integer

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

Stream
stream boolean

Используется для указания того, использует ли запрос функцию потоковой передачи конечной точки.

Size
size integer

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

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

Товары
ApeHits

Получение списка организаций

Получение списка организаций, определенных для рабочей области.

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

Товары
organizations

Получение списка подтвержденных ресурсов, добавленных или удаленных по типу

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

Параметры

Имя Ключ Обязательно Тип Описание
Тип
type string

Тип ресурса, который требуется получить, или тип сведений о ресурсах, которые требуется извлечь. Допустимые типы ресурсов: (домен, узел, IP_Address, IP_Block, AS, Page, SSL_Cert, Name_Server, Mail_Server, Contact). Допустимые типы сведений о ресурсах: (Self_Hosted_Resource, ThirdParty_Hosted_Resource)

Date
date string

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

Диапазон
range integer

Период времени, с течением которого были определены изменения. Поддерживаемые диапазоны : 1, 7 и 30 дней.

Мера
measure string

Тип изменения. Допустимые параметры : ADDED или REMOVED

Бренд
brand string

Будут возвращены только активы, имеющие этот бренд.

Организация
organization string

Будут возвращены только ресурсы, имеющие эту организацию.

Тег
tag string

Будут возвращены только ресурсы, имеющие этот тег.

Страница
page integer

Индекс извлекаемой страницы. Индекс основан на нуле, поэтому первая страница — страница 0.

Size
size integer

Количество соответствующих ресурсов для возврата на страницу

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

Получение списка сохраненных поисков

Получите список сохраненных поисков для рабочей области.

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

Товары
savedSearches

Получение списка тегов

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

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

Товары
tags

Определения

savedSearches

Имя Путь Тип Описание
Товары
savedSearch

сохраненный поиск

Имя Путь Тип Описание
Сохраненный идентификатор поиска
savedSearchID integer
Глобальный поиск
globalSearch boolean
Сохраненное имя поиска
savedSearchName string
Поиск рабочей области
workspaceSearch boolean

tags

Имя Путь Тип Описание
Товары
tag

tag

Имя Путь Тип Описание
Создано в
createdAt integer
Обновлено в
updatedAt integer
Состояние
status string
Идентификатор тега рабочей области
workspaceTagID integer
Тип тега рабочей области
workspaceTagType string
Цвет
color string
Идентификатор рабочей области
workspaceID integer
Имя
name string
Идентификатор
id integer

Брендов

Имя Путь Тип Описание
Товары
brand

клеймо

Имя Путь Тип Описание
Создано в
createdAt integer
Обновлено в
updatedAt integer
Состояние
status string
Идентификатор торговой марки рабочей области
workspaceBrandID integer
Идентификатор рабочей области
workspaceID integer
Имя
name string
Идентификатор
id integer

organizations

Имя Путь Тип Описание
Товары
organization

организация

Имя Путь Тип Описание
Создано в
createdAt integer
Обновлено в
updatedAt integer
Состояние
status string
Идентификатор организации рабочей области
workspaceOrganizationID integer
Идентификатор рабочей области
workspaceID integer
Имя
name string
Идентификатор
id integer

GlobalInventoryDeltasSummaryResponse

Имя Путь Тип Описание
Дата выполнения
runDate string
Дельта
deltas array of deltaSummary

deltaSummary

Имя Путь Тип Описание
Тип
type string
aggregations
aggregations array of aggregation

агрегация

Имя Путь Тип Описание
Removed
removed integer
Добавлено
added integer
Изменено
changed integer
Численность
count integer
Диапазон
range integer
Расхождение
difference integer

ApeHits

Имя Путь Тип Описание
Товары
ApeHit

ApeHit

Имя Путь Тип Описание
Идентификатор рабочей области
workspaceId integer
ИД политики
policyId string
Создано в
createdAt integer
Исходный материал
source string
asset
asset GlobalInventoryAsset

Глобальный ресурс инвентаризации

Действия
actions array of object
Идентификатор действия
actions.actionId integer
Имя
actions.name string
Действие
actions.action string
Параметры действия
actions.actionParameters string
metadata
metadata array of object
Key
metadata.key string
Ценность
metadata.value string
StoredAt
storedAt integer

GlobalInventoryAsset

Глобальный ресурс инвентаризации

Имя Путь Тип Описание
object

Глобальный ресурс инвентаризации

TaskResponse

Имя Путь Тип Описание
Класс задач
taskClass string
Идентификатор пользователя
userID integer
Начало работы
startedAt integer
Завершено в
completedAt integer
Государство
state string
Phase
phase string
Причина
reason string
Имя задачи
taskName string
Идентификатор рабочей области
key.workspaceID integer
UUID (Универсальный уникальный идентификатор)
key.uuid string
Типы целевых активов
data.targetAssetTypes array of
assets
data.assets array of AssetIdentifier
RequestType
data.requestType string
Оцененные
data.estimated integer
ApiToken
data.apiToken string
Application
data.application string
RequestLog
data.requestLag integer
Progress
data.progress integer
Updated
data.updated integer
Общее количество обновлений
data.totalUpdates integer
countersByType
data.countersByType object
Обработанные обновления
data.processedUpdates integer
Свойства
data.properties array of object
items
data.properties object
Поддерживаемые действия
supportedActions array of
Голосование
polling boolean

AssetIdentifier

Имя Путь Тип Описание
Имя
name string
Тип
type string

BulkGetAssetResponse

Имя Путь Тип Описание
Товары

GlobalInventoryDeltasResponse

Имя Путь Тип Описание
Всего элементов
totalElements integer
Всего страниц
totalPages integer
Фамилия
last boolean
Количество элементов
numberOfElements integer
First
first boolean
Size
size integer
Number
number integer
содержимое
content array of object
Имя
content.name string
Дата выполнения
content.runDate string
Мера
content.measure string
Создано в
content.createdAt integer
Автоматическое подтверждение
content.autoconfirmed boolean
Предприятие
content.enterprise boolean
Государство
content.state string
Исходный материал
content.source boolean
Ключевой камень
content.keystone boolean
Обновлено в
content.updatedAt integer
Подстановочная карточка
content.wildcard boolean
Тип
content.type string
Description
content.description string

объект

Это тип object.