golgote / HTTP_Request2_Hawk

Hawk authenticated HTTP requests with HTTP_Request2

HTTP_Request2_Hawk

Hawk authenticated requests with the HTTP_Request2 package from PEAR.

This class is built as an Observer for HTTP_Request2 that modifies the requests on the connect event by adding the Authorization header.

On the receivedHeaders event, the Observer also authentifies the Server-Authorization header in the response and makes the result available in the Observer itself for later use.

Hawk is an HTTP authentication scheme using a message authentication code (MAC) algorithm to provide partial HTTP request cryptographic verification.

Usage example

require_once 'HTTP/Request2/Observer/Hawk.php';

// Create the request object
$request = new HTTP_Request2('http://example.com/api/test');

// Initialize and attach the Hawk observer
$hawk = new HTTP_Request2_Observer_Hawk('id', 'key', 'sha1');
$request->attach($hawk);

// Perform the request with Hawk Server-Authorization header
$request->send();

// Check if server response is authentified
if ($hawk->isAuthentic()) {
    echo "Server response is authentified";
}