リクエスト
GET /v1/host-vulns
| クエリ |
タイプ |
内容 |
keyword |
string |
指定された文字列が含まれる脆弱性を検索します。対象フィールドは、ソフトウェア名、バージョン、ホスト名です。 |
triageLevel |
string |
トリアージレベル。指定しない場合は全てのトリアージレベルが対象になります。複数指定する場合はカンマ区切りで列挙します。( immediate , delayed , minor , none ) |
status |
string |
ステータス。指定しない場合は全てのステータスが対象になります。複数指定する場合はカンマ区切りで列挙します。( open : 未対応, in_progress : 対応中, wont_fix_closed : 修正しない, not_vuln_closed : 誤検知, closed : 完了) |
yamoryTags |
string |
タグ。複数指定する場合はカンマ区切りで列挙します。 |
openTimestamp |
datetime |
検出日時。指定日時以降に検出された脆弱性を検索します。指定可能な書式は YYYY-MM-DD , YYYY-MM-DDThh:mm:ssZ です。いずれも UTC として解釈されます。 |
page |
integer |
ページ。検索結果のインデックスを指定します。(0-) |
size |
integer |
ページサイズ。1ページ中に含まれるレコード数です。最大10000件まで指定できます。 |
リクエスト例
curl -XGET https://yamoryapi.yamory.io/v1/host-vulns?keyword=develop.host.name&triageLevel=immediate&status=open&yamoryTags=example&openTimestamp=2021-03-14T09:00:00Z&page=0&size=100 \
-H 'Accept: application/json' \
-H 'AUTHORIZATION: token xxxxxxxxxxxxxxxxx'
レスポンス
[{
"id" : "string",
"assetType" : "string",
"triageLevel" : "string",
"teamName" : "string",
"status" : "string",
"vulnTypes" : "string",
"hostTitle" : "string",
"hostName" : "string",
"hostIps" : "array",
"hostTags" : "array",
"family" : "string",
"osFamilyAndVer" : "string",
"packageNameAndVer" : "string",
"openSystem" : "boolean",
"hasPoc" : "boolean",
"solution" : "string",
"fixedVersion" : "string",
"ovalTitle" : "string",
"advisorySeverity" : "string",
"definitionId" : "string",
"scanTimestamp" : "string",
"openTimestamp" : "string",
"yamoryVuln" : "string",
}]
| ステータスコード |
内容 |
200 |
リクエストが正常に処理されたことを示します。取得件数が0件の場合もこのステータスコードが返却されます。 |
400 |
不正なリクエストです。リクエストヘッダまたはリクエストボディに問題がある場合に返却されます。 |
401 |
認証エラーです。 Authorization ヘッダが指定されていないか、指定された情報での認証が失敗した場合に返却されます。 |
403 |
認証エラーです。許可されていないIPアドレスからリクエストした場合に返却されます。 |
404 |
URLで指定したリソースが存在しない場合に返却されます。 |
500 |
サーバー内部でエラーが発生した場合に返却されます。 |