HTTP REST API

Integration version: 10.0

Configure HTTP REST API integration in Google Security Operations

For detailed instructions on how to configure an integration in Google SecOps, 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"
}

Need more help? Get answers from Community members and Google SecOps professionals.