HTTP REST API

Integration version: 10.0

Configure HTTP REST API integration in Google Security Operations SOAR

For detailed instructions on how to configure an integration in Google Security Operations SOAR, see Configure integrations.

Actions

Get Data

Description

Send an HTTP and get a request.

Parameters

Parameters Type Default Value Is Mandatory Description
URL String N/A Yes The URL to send the request to.
Username String N/A No N/A
Password String N/A No N/A
SSL Verification Checkbox Unchecked No Whether to verify the SSL certificate of the destination server.
Headers JSON String N/A No A JSON object of the HTTP headers to be sent with the request.
Ignore HTTP Error Codes Checkbox Unchecked No If enabled, the action should ignore 4xx or 5xx HTTP error codes and not return error.

Use cases

N/A

Run On

This action runs on the URL entity.

Action Results

Entity Enrichment

N/A

Insights

N/A

Script Result
Script Result Name Value Options Example
response_data N/A N/A
JSON Result
{
  "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"
}

Get URL Data

Description

Send HTTP GET requests to URL entities.

Parameters

Parameters Type Default Value Is Mandatory Description
Username String N/A No Username for basic authentication. Optional.
Password String N/A No Password for basic authentication. Optional.
SSL Verification Checkbox N/A No Whether to verify the SSL certificate of the destination server.

Use cases

N/A

Run On

This action runs on the URL entity.

Action Results

Entity Enrichment

N/A

Insights

N/A

Script Result
Script Result Name Value Options Example
is_success True/False is_success:False
JSON Result
[
    {
        "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

Description

Test Connectivity.

Parameters

N/A

Use cases

N/A

Run On

This action runs on all entities.

Action Results

Entity Enrichment

N/A

Insights

N/A

Script Result
Script Result Name Value Options Example
is_succeed True/False is_succeed:False
JSON Result
N/A

Post Data

Description

Send HTTP and post requests.

Parameters

Parameter Type Default Value Description
URL String N/A Yes The URL to send the request to.
Data String N/A Yes The data to send with the request.
Username String N/A No N/A
Password String N/A No N/A
SSL Verification Checkbox N/A Unchecked Whether to verify the SSL certificate of the destination server.
Headers JSON String N/A No A JSON object of the HTTP headers to be sent with the request.
Content Type String N/A No Content type. If set to application or JSON, the input data must be JSON string.

Use cases

N/A

Run On

This action runs on all entities.

Action Results

Entity Enrichment

N/A

Insights

N/A

Script Result
Script Result Name Value Options Example
response_data N/A N/A
JSON Result
{
  "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"
}