POST 脅威インジケーター

サポート

法人向けアプリケーション

Kaspersky CyberTrace

REST API リファレンス

リクエスト

POST 脅威インジケーター

2024年4月11日

ID 198625

新しい脅威インジケーターを追加します。

追加した脅威インジケーターは REST API 脅威インジケーターであり、REST API メソッドを使用して管理できます。新しい脅威インジケーターは既定で有効化されます。

パス

/api/%API_VERSION%/suppliers

メソッド

POST

リクエストヘッダー

このリクエストには、次のヘッダーがあります。

リクエストヘッダー

名前	値	説明
`Authorization`	`string (base 64)`	認証文字列。
`Accept`	`application/json`	レスポンスのコンテンツタイプ。
`Content-Type`	`application/json`	リクエストのコンテンツタイプ。 `utf-8` charset タイプを指定することもできます。例：`Content-Type: application/json; charset=utf-8`
`Content-Length`	`integer`	リクエストボディのサイズ（バイト）。このリクエストボディの最大サイズは、128 MB（`134217728`）です。

リクエストボディ

このリクエストボディには、JSON 配列と脅威インジケーターオブジェクトが含まれます。1 つの脅威インジケーターオブジェクトのみを指定する必要があります。

[

{

"name":"%SUPPLIER_NAME%",

"confidence": %SUPPLIER_CONFIDENCE%,

"retention": %SUPPLIER_RETENTION%,

"vendor": "%SUPPLIER_VENDOR%"

}

]

次の表で脅威インジケーターオブジェクトのプロパティについて説明します。

脅威インジケーターオブジェクトのプロパティ

プロパティ	値	必須	説明
`name`	`文字列`	Yes	脅威インジケーターの名前。脅威インジケーターの名前には、ラテン文字、数字、ハイフン（`-`）、アンダースコア（`_`）のみを含める必要があります。脅威インジケーター名には、スペース記号（`「」`）を使用できません。脅威インジケーター名として FalsePositive および InternalTI は使用しないでください。これらは、Kaspersky CyberTrace の組み込み脅威インジケーター名として予約されているためです。
`confidence`	`integer`	Yes	この脅威インジケーターのインジケーターの信頼性レベル。このパラメータの値の範囲は、`0` ～ `100` です。
`retention`	`integer`	Yes	インジケーターの保持時間（分）。このパラメータにより、この脅威インジケーターのインジケーターがマッチングで使用されなくなるまでのタイムアウトが決定されます。このタイムアウトは、インジケーターの最後の更新時から計算されます。
`vendor`	`文字列`	No	脅威インジケーターのベンダー名。

リクエスト例

POST suppliers リクエストの例は、次の通りです。

POST https://192.0.2.57/api/1.1/suppliers

Accept: application/json

Content-Type: application/json

Authorization: Basic dXNlcjpwYXNzd29yZA==

Content-Length: 91

[

{"name":"ExampleSupplier", "confidence": 90, "retention": 5000, "vendor": "ExampleVendor"}

]

レスポンスヘッダー

このレスポンスには、次のヘッダーがあります。

レスポンスヘッダー

名前	値	説明
Content-Type	`application/json`	レスポンスのコンテンツタイプ。
Content-Length	`integer`	レスポンスボディのサイズ（バイト）。

レスポンスボディ

レスポンスボディには、JSON オブジェクトと操作のステータスが含まれます。

[

{

"status": "Supplier successfully created"

}

]

次の表でステータスオブジェクトのプロパティについて説明します。

ステータスオブジェクトのプロパティ

プロパティ	値	説明
`status`	`文字列`	操作のステータス。

レスポンス例

POST suppliers リクエストのレスポンス例は、次の通りです。

НТТР/1.1 201 ОК

Date:Mon, 23 Dec 2019 09:56:10 UTC

Content-Type: application/json

Content-Length: 41

"status": "Supplier successfully created"

エラーレスポンス

エラーレスポンスには、レスポンスのステータスに関する情報が含まれます。

エラーレスポンスには、JSON オブジェクトとエラーの説明が含まれます。

[

{

"status": "An error occurred while creating some suppliers",

"reason": "%REASON%"

}

]

次の表でエラーオブジェクトのプロパティについて説明します。

エラーオブジェクトのプロパティ

プロパティ	値	説明
`status`	`文字列`	エラーの説明。
`reason`	`文字列`	エラーの原因。

エラーレスポンスの例

POST suppliers エラーのレスポンス例は、次の通りです。

HTTP/1.1 400 Bad Request

Date:Mon, 23 Dec 2019 09:56:10 UTC

Content-Type: application/json

Content-Length: 92

[{"status": "An error occurred while creating some suppliers", "reason": "Incorrect supplier name"}]

この記事はお役に立ちましたか？

改善できる点がありましたらお聞かせください。

フィードバックをいただき、ありがとうございました。改善に向けて取り組んでまいります。