HTTP REST API

統合バージョン:　8.0

Chronicle SOAR で HTTP REST API 統合を構成する

Chronicle SOAR で統合を構成する方法の詳細については、統合を構成するをご覧ください。

アクション

データを取得する

説明

HTTP を送信してリクエストを取得します。

パラメータ

パラメータ	種類	デフォルト値	必須	説明
URL	文字列	なし	○	リクエストの送信先 URL。
ユーザー名	文字列	なし	いいえ	なし
パスワード	文字列	なし	いいえ	なし
SSL 認証	チェックボックス	オフ	いいえ	宛先サーバーの SSL 証明書を検証するかどうか。
ヘッダー JSON	文字列	なし	いいえ	リクエストとともに送信される HTTP ヘッダーの JSON オブジェクト。
HTTP エラーコードを無視	チェックボックス	オフ	いいえ	有効になっている場合、アクションは 4xx または 5xx HTTP エラーコードを無視し、エラーを返しません。

ユースケース

なし

実行

このアクションは URL エンティティに対して実行されます。

アクションの結果

エンティティ拡充

なし

分析情報

なし

スクリプトの結果

スクリプト結果名	値のオプション	例
response_data	なし	なし

JSON の結果

{
  "redirects": [
    "http://blank.org/"
  ],
  "response_code": 200,
  "data": "<html>\n\n<head>\n<title>\nblank\n</title>\n</head>\n\n<body bgcolor=#ffffff text=#2222ff link=#ff0000 vlink=#880000 alink=#00ff00>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<center>\n<a style=\"text-decoration:none\" href=\"blank.html\">.</a>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n</center>\n</body>\n</html>\n"
}

URL データを取得する

説明

URL エンティティに HTTP GET リクエストを送信します。

パラメータ

パラメータ	種類	デフォルト値	必須	説明
ユーザー名	文字列	なし	いいえ	基本認証用のユーザー名。省略可。
パスワード	文字列	なし	いいえ	基本認証用のパスワード。省略可。
SSL 認証	チェックボックス	なし	いいえ	宛先サーバーの SSL 証明書を検証するかどうか。

ユースケース

なし

実行

このアクションは URL エンティティに対して実行されます。

アクションの結果

エンティティ拡充

なし

分析情報

なし

スクリプトの結果

スクリプト結果名	値のオプション	例
is_success	True/False	is_success:False

JSON の結果

[
    {
        "EntityResult": {
            "redirects": ["http://blank.org/"],
            "data": "<html>\\n\\n<head>\\n<title>\\nblank\\n</title>\\n</head>\\n\\n<body bgcolor=#ffffff text=#2222ff link=#ff0000 vlink=#880000 alink=#00ff00>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<center>\\n<a style=\\\"text-decoration:none\\\" href=\\\"blank.html\\\">.</a>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n</center>\\n</body>\\n</html>\\n"
        },
        "Entity": "http://blank.org/"
    }
]

Ping

説明

接続をテストする。

パラメータ

なし

ユースケース

なし

実行

このアクションはすべてのエンティティに対して実行されます。

アクションの結果

エンティティ拡充

なし

分析情報

なし

スクリプトの結果

スクリプト結果名	値のオプション	例
is_succeed	True/False	is_succeed:False

JSON の結果

N/A

送信データ

説明

HTTP リクエストと POST リクエストを送信します。

パラメータ

パラメータ	種類	デフォルト値	説明
URL	文字列	なし	○	リクエストの送信先 URL。
データ	文字列	なし	○	リクエストと一緒に送信するデータ。
ユーザー名	文字列	なし	いいえ	なし
パスワード	文字列	なし	いいえ	なし
SSL 認証	チェックボックス	なし	オフ	宛先サーバーの SSL 証明書を検証するかどうか。
ヘッダー JSON	文字列	なし	いいえ	リクエストとともに送信される HTTP ヘッダーの JSON オブジェクト。
コンテンツタイプ	文字列	なし	いいえ	Content-Typeapplication または JSON に設定する場合、入力データは JSON 文字列である必要があります。

ユースケース

なし

実行

このアクションはすべてのエンティティに対して実行されます。

アクションの結果

エンティティ拡充

なし

分析情報

なし

スクリプトの結果

スクリプト結果名	値のオプション	例
response_data	なし	なし

JSON の結果

{
  "redirects": [
    "http://blank.org/"
  ],
  "data": "<html>\n\n<head>\n<title>\nblank\n</title>\n</head>\n\n<body bgcolor=#ffffff text=#2222ff link=#ff0000 vlink=#880000 alink=#00ff00>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<center>\n<a style=\"text-decoration:none\" href=\"blank.html\">.</a>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n</center>\n</body>\n</html>\n"
}