Справочник по API Defender для Интернета вещей
В этом разделе описаны общедоступные API, поддерживаемые Microsoft Defender для Интернета вещей. Использование API Defender для Интернета вещей регулируется лицензиями и условиями использования API Microsoft.
Используйте API Defender для Интернета вещей, чтобы получить доступ к данным, обнаруженным датчиками и выполнять действия с данными.
Подключения API защищены по протоколу SSL.
Создание маркера доступа к API
Для многих API Defender для Интернета вещей требуется маркер доступа. Маркеры доступа не требуются для API проверки подлинности.
Чтобы создать маркер, выполните приведенные действия.
В окне Параметры системы выберите элемент Интеграции>Маркеры доступа.
Щелкните Создать маркер.
В поле Описание укажите, для чего нужен новый маркер, и щелкните Создать.
Отобразится новый маркер доступа. Скопируйте его, поскольку больше он не появится.
Выберите Готово.
Созданные вами маркеры появятся в диалоговом окне Маркеры доступа. В столбце Использовано указывается время, когда был получен последний внешний вызов с этим маркером.
Если в столбце Использовано отображается значение Н/Д, значит соединение между датчиком и подключенным сервером не работает.
После создания маркера добавьте в запрос заголовок HTTP с именем Authorization и присвойте ему значение только что созданного маркера.
Справочник по версии API датчика
| Версия | Поддерживаемые API |
|---|---|
| Нет версии | Проверка подлинности и управление паролями: - set_password (изменение пароля) - set_password_by_admin (обновление пароля пользователя по администратору) - проверка (проверка учетных данных пользователя) |
| Новые возможности в версии 1 | Инвентаризация: - подключения (получение сведений о подключении устройства) - cves (получение сведений о CVEs) - устройства (получение сведений об устройстве) Оповещения: - оповещения (получение сведений об оповещении) - события (получение событий временной шкалы) Уязвимости: - операционные (получение операционных уязвимостей) - устройства (получение сведений об уязвимостях устройства) - устранение рисков (получение шагов по устранению рисков) - безопасность (получение уязвимостей безопасности) |
| Новые возможности в версии 2 | Оповещения: — обновления оповещений (получение сведений об оповещении) |
Примечание.
API интеграции предназначены для непрерывного выполнения и создания постоянно работающего потока данных, например для запроса новых данных за последние пять минут. API интеграции возвращают данные с меткой времени.
Чтобы просто запрашивать данные, используйте обычные API-интерфейсы, отличные от интеграции, для конкретного датчика для запроса устройств только с этого датчика.
Эпоха
Во всех значениях метки времени Defender для Интернета вещей время эпохи равно 1/1/1970.
Дальнейшие действия
Дополнительные сведения см. в разделе: