base/utils/active-http.bro

ActiveHTTP

A module for performing active HTTP requests and getting the reply at runtime.

Namespace:ActiveHTTP
Imports:base/utils/exec.bro
Source File:/scripts/base/utils/active-http.bro

Summary

Runtime Options

ActiveHTTP::default_max_time: interval &redef The default timeout for HTTP requests.
ActiveHTTP::default_method: string &redef The default HTTP method/verb to use for requests.

Functions

ActiveHTTP::request: function Perform an HTTP request according to the ActiveHTTP::Request record.

Detailed Interface

Runtime Options

ActiveHTTP::default_max_time
Type:interval
Attributes:&redef
Default:1.0 min

The default timeout for HTTP requests.

ActiveHTTP::default_method
Type:string
Attributes:&redef
Default:"GET"

The default HTTP method/verb to use for requests.

Types

ActiveHTTP::Request
Type:

record

url: string

The URL being requested.

method: string &default = ActiveHTTP::default_method &optional

The HTTP method/verb to use for the request.

client_data: string &optional

Data to send to the server in the client body. Keep in mind that you will probably need to set the method field to “POST” or “PUT”.

max_time: interval &default = ActiveHTTP::default_max_time &optional

Timeout for the request.

addl_curl_args: string &optional

Additional curl command line arguments. Be very careful with this option since shell injection could take place if careful handling of untrusted data is not applied.

ActiveHTTP::Response
Type:

record

code: count

Numeric response code from the server.

msg: string

String response message from the server.

body: string &optional

Full body of the response.

headers: table [string] of string &optional

All headers returned by the server.

Functions

ActiveHTTP::request
Type:function (req: ActiveHTTP::Request) : ActiveHTTP::Response

Perform an HTTP request according to the ActiveHTTP::Request record. This is an asynchronous function and must be called within a “when” statement.

Req:A record instance representing all options for an HTTP request.
Returns:A record with the full response message.

Previous Page

base/init-default.bro

Copyright 2016, The Bro Project. Last updated on January 10, 2019. Created using Sphinx 1.7.5.