an HTTP proxy that automatically signs Windows Azure storage requests
Wazproxy is an HTTP proxy written in Node.js that automatically signs requests to Windows Azure blob storage for a given account. This is useful for developers who want to try out the Windows Azure REST API without having to deal with authentication. By running wazproxy and proxying web requests through it, you can use simple tools like
curl or even a web browser to interact with Windows Azure storage.
Wazproxy is also useful for adapting existing apps to work with Windows Azure storage. For example, if you have an application that can consume a generic OData feed but doesn't support Windows Azure storage authentication, you can start wazproxy, change your proxy settings, and use the application as-is.
npm install wazproxy -g
Usage: wazproxy.js [options] Options: -h, --help output usage information -V, --version output the version number -a, --account [account] storage account name -k, --key [key] storage account key -p, --port [port] port (defaults to 8080)
The following will list all the tables in the given account:
wazproxy -a <account> -k <key> set http_proxy=127.0.0.1:8080 curl <account>.table.core.windows.net/tables
On Linux or OS X, use
export instead of
The following will create a container (private, by default), upload a text blob into it, retrieve the blob, and finally delete the container.
curl <account>.blob.core.windows.net/testcontainer?restype=container -X PUT -d "" curl <account>.blob.core.windows.net/testcontainer/testblob -X PUT -d "hello world" -H "content-type:text/plain" -H "x-ms-blob-type:BlockBlob" curl <account>.blob.core.windows.net/testcontainer/testblob # output: "hello world" curl <account>.blob.core.windows.net/testcontainer?restype=container -X DELETE
The following will peek at a queue message:
For the full details of the Windows Azure storage API, see the "Windows Azure Storage Services REST API Reference" on MSDN.
Wazproxy only proxies HTTP requests (not HTTPS). Any request that's not addressed to
<account>.(blob|table|queue).core.windows.net is simply passed through unmodified, so you can proxy all traffic through wazproxy (including, for example, traffic from other browser tabs).
Wazproxy does not support the storage emulator, but pull requests are welcome.