PUT suppliers/{supplier}/indicators（マルチテナンシーモード）

新しいインジケーターを脅威インジケーターに追加し、指定されたテナント内の既存のインジケーターを更新します。

REST API で追加された脅威インジケーターと、InternalTI および FalsePositive 脅威インジケーターのみが、このリクエストで更新できます。

パス

/api/%API_VERSION%/{TenantName}/suppliers/{supplier}/indicators

メソッド

PUT

リクエストヘッダー

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

リクエストヘッダー

名前	値	説明
`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`）です。

リクエストのパラメータ

このリクエストには、次のパラメータがあります：

リクエストのパラメータ

名前	パラメータタイプ	説明
`supplier`	パス	脅威インジケーターの名前。

リクエストボディ

このリクエストボディには、インジケーターオブジェクトの JSON 配列が含まれます。

[

{

"indicator":"%INDICATOR_VALUE_1%",

"context":

{

"%FIELD_NAME_1%":"%FIELD_VALUE_1%",

...

"%FIELD_NAME_N%":"%FIELD_VALUE_N%"

"tags":

[

"%TAG_NAME_1%",

...

"%TAG_NAME_N%"

]

...

{

"indicator":"%INDICATOR_VALUE_N%",

"context":

{

"%FIELD_NAME_1%":"%FIELD_VALUE_1%",

...

"%FIELD_NAME_N%":"%FIELD_VALUE_N%"

}

]

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

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

プロパティ	値	必須	説明
`indicator`	String	Yes	インジケーターの値。次のインジケータータイプを指定できます： MD5 Hash SHA1 Hash SHA256 Hash IP アドレス URL
`context`	インジケーターコンテキストオブジェクト	No（説明を参照）	インジケーターコンテキスト。このプロパティには、インジケーターコンテキストオブジェクトが含まれる必要があります。 FalsePositive 脅威インジケーターにインジケーターを追加する場合、context プロパティを指定しないでください。
`tags`	インジケータータグオブジェクト	No	REST API 1.1 以降で使用可能です。インジケーターに割り当てられたタグのリスト。このリストには、Kaspersky CyberTrace データベース内に既に存在するタグのみを含める必要があります。データベースに新しいタグを追加するには、POST tags リクエストを使用します。インジケータータグオブジェクトが欠落している場合、データベース内のインジケータータグに関する情報は変更されません。インジケータータグオブジェクトが空である場合、データベース内のインジケーターからすべてのタグが削除されます。タグ自体は削除されません。タグ名を追加または変更する場合、文字が大文字に変換されます。
`mark_detections`	Boolean	いいえ	REST API 1.2 以降で使用可能です。インジケーター関連の検知を誤検知としてマークするフラグ。このパラメーターは、リクエストパスで指定された脅威インジケーターの値が`FalsePositive`である場合にのみ適用されます。

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

インジケーターコンテキストオブジェクトのプロパティ

プロパティ	値	必須	説明
`%FIELD_NAME%`	`%FIELD_VALUE%`	Yes	インジケーターの 1 つ以上の背景情報フィールド。プロパティの名前は、インジケーターの背景情報フィールドの名前に対応している必要があります。プロパティの値は、インジケーターの背景情報フィールドの値に対応している必要があります。

プロパティ

値

必須

説明

%FIELD_NAME%

%FIELD_VALUE%

Yes

インジケーターの 1 つ以上の背景情報フィールド。

プロパティの名前は、インジケーターの背景情報フィールドの名前に対応している必要があります。

プロパティの値は、インジケーターの背景情報フィールドの値に対応している必要があります。

リクエスト例

PUT suppliers/{supplier}/indicators リクエストの例は、次の通りです。

PUT https://192.168.2.57/api/1.3/ExampleTenant/suppliers/ExampleSupplier/indicators

Accept: application/json

Content-Type: application/json

Authorization: Basic dXNlcjpwYXNzd29yZA==

Content-Length: 150

[

{"indicator":"tux.example.com","context":{"ip":"192.0.2.42","name":"ExampleIndicator", "threat_level":1},"tags":["OSINT", "EXAMPLE"]},

{"indicator":"malicious.example.com"}

]

mark_detections パラメータを FalsePositive 脅威インジケーターに適用した PUT suppliers/{supplier}/indicators リクエストの例は、次の通りです。

PUT https://192.168.2.57/api/1.3/ExampleTenant/suppliers/FalsePositive/indicators

Accept: application/json

Content-Type: application/json

Authorization: Basic dXNlcjpwYXNzd29yZA==

Content-Length: 150

[

{

"indicator":"DC212B238A5A7C0A9DF7BF298546A154",

"tags":

[

"FP"

"mark_detections": false

...

]

レスポンスヘッダー

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

レスポンスヘッダー

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

レスポンスボディ

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

[

{

"status": "All indicators were successfully added to the database"

}

]

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

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

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

レスポンス例

PUT suppliers/{supplier}/indicators リクエストのレスポンス例は、次の通りです。

НТТР/1.3 201 ОК

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

Content-Type: application/json

Content-Length: 46

[{"status": "All indicators successfully added to the database"}]

一部成功のレスポンス

このレスポンスは、一部のインジケーターが正常に処理されなかった時に生成されます。

レスポンスボディには、一部成功オブジェクトと操作のステータス、およびインジケーターエラーオブジェクトの配列が含まれます。

[

{

"status": "An error occurred while adding some of the indicators to the database",

"error_indicators":[

{

"indicator": "%INDICATOR_VALUE_1%",

"reason": "%REASON%"

...

{

"indicator": "%INDICATOR_VALUE_N%",

"reason": "%REASON%"

}

]

}

]

次のテーブルで一部成功オブジェクトのプロパティについて説明します。

一部成功オブジェクトのプロパティ

プロパティ	値	説明
`status`	String	操作のステータス。
`error_indicators`	インジケーターエラーオブジェクト	処理されなかったインジケーターに関する情報の配列。

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

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

プロパティ	値	説明
`indicator`	String	処理されなかったインジケーター。
`reason`	String	エラーの原因。このプロパティは、レスポンス内に存在しない可能性があります。

プロパティ

値

説明

indicator

String

処理されなかったインジケーター。

reason

String

エラーの原因。

このプロパティは、レスポンス内に存在しない可能性があります。

一部成功のレスポンス例

PUT suppliers/{supplier}/indicators リクエストの一部成功のレスポンス例は、次の通りです。

НТТР/1.3 202 Partial success

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

Content-Type: application/json

Content-Length: 265

[{"status": "An error occurred while adding some of the indicators to the database","error_indicators":[{"indicator":"bad\.example.com", "reason": "Invalid indicator format"},{"indicator":"bad2.example.com bad3.example.com", "reason": "Invalid indicator format"}]}]

エラーレスポンス

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

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

[

{

"status": "An error occurred while adding indicators to the database",

}

]

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

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

プロパティ	値	説明
`status`	String	エラーの説明。

エラーレスポンスの例

PUT suppliers/{supplier} エラーのレスポンス例は、次の通りです。

HTTP/1.3 500 Internal Server Error

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

Content-Type: application/json

Content-Length: 73

[{"status": "An error occurred while adding indicators to the database"}]

ページのトップに戻る