Golang API Client for GRR Rapid Response

What?

This package contains Go bindings for the GRR Rapid Response API. It provides a way to talk to the GRR AdminUI server and is intended for automation and integration tasks.

It currently targets the stable 3.1.0.2 release of GRR. This is the version for which the GRR project has provided an Ubuntu/Xenial package. There is also a package of the 3.1.0.2 version in Debian/unstable which can be used on Debian 9.x ("stretch") systems.

Why?

During the March 8 2017 Meetup, it was announced that someone inside Google had been working on a Golang API client and that it would be published "soon". While a Python client has been added to the api_client/python directory, no "official" Go client has been published as of late May 2017. Until the GRR team at Google decides to publish their code, I hope that this will be useful.

Hacking / Work in progress

Data structures have been generated from the Protobuf definitions that are shipped with GRR 3.1.0.2.

This package does not yet cover all functions and API endpoints. There are templates for three basic patterns, see generate.go, generate/gen-functions.sh for details:

• simple GET: fixed path, no parameters, receive Protobuf Message
• simple POST: fixed path, provide Protobuf Message, receive simple answer
• GET/POST: fixed path, provide Protobuf Message, receive Protobuf Message

For everything else (e.g. GET /api/clients/<client>), a small adapter function has to be written, see GetClient() for an example.

License

Apache 2.0, see LICENSE file in the source distribution.

Author

Hilko Bengen [email protected]