# 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](https://docs.cloud.google.com/chronicle/docs/soar/respond/integrations-setup/configure-integrations).

## Actions


For more information about actions, see [Respond to pending actions from your workdesk](https://docs.cloud.google.com/chronicle/docs/soar/overview-and-introduction/your-workdesk/respond-to-pending-actions-from-workdesk) and [Run a
manual action in your case](https://docs.cloud.google.com/chronicle/docs/soar/investigate/working-with-cases/what-actions-can-you-take-on-a-case#run-manual-action).

### 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.](https://security.googlecloudcommunity.com/)