# Kapow!

If you can script it, you can HTTP it.

![Kapow! Logo](https://raw.githubusercontent.com/BBVA/kapow/master/docs/source/_static/logo-200px.png)

[![Test status](https://circleci.com/gh/BBVA/kapow/tree/master.svg?style=svg)](https://circleci.com/gh/BBVA/kapow/tree/master)
[![Go Report](https://goreportcard.com/badge/github.com/bbva/kapow)](https://goreportcard.com/report/github.com/bbva/kapow)

|Section         | Info                                           |
|----------------|------------------------------------------------|
|Project site    | https://github.com/BBVA/kapow                  |
|Issues          | https://github.com/BBVA/kapow/issues/          |
|Documentation   | https://kapow.readthedocs.io                   |
|Author          | BBVA Innovation Labs                           |
|Latest Version  | v0.3.0                                         |

----


## What's Kapow!

Say we have a nice cozy **shell command** that solves our problem. Kapow! lets
us easily **turn that into an HTTP API**.


### Let's see this with an example

We want to expose **log entries** for files not found on our **Apache Web
Server**, as an HTTP API.  With Kapow! we just need to write this file:

```bash
[apache-host]$ cat search-apache-errors.pow
kapow route add /apache-errors - <<-'EOF'
    cat /var/log/apache2/access.log | grep 'File does not exist' | kapow set /response/body
EOF
```

and then, run it using Kapow!

```bash
[apache-host]$ kapow server --bind 0.0.0.0:8080 search-apache-errors.pow
```

finally, we can read from the just-defined endpoint:

```bash
[another-host]$ curl http://apache-host:8080/apache-errors
[Fri Feb 01 22:07:57.154391 2019] [core:info] [pid 7:tid 140284200093440] [client 172.17.0.1:50756] AH00128: File does not exist: /usr/var/www/mysite/favicon.ico
[Fri Feb 01 22:07:57.808291 2019] [core:info] [pid 8:tid 140284216878848] [client 172.17.0.1:50758] AH00128: File does not exist: /usr/var/www/mysite/favicon.ico
[Fri Feb 01 22:07:57.878149 2019] [core:info] [pid 8:tid 140284208486144] [client 172.17.0.1:50758] AH00128: File does not exist: /usr/var/www/mysite/favicon.ico
...
```

### Why Kapow! shines in these cases

- We can share information **without having to grant SSH access** to anybody.
- We can share information easily **over HTTP**.
- We can **limit** what is executed.


## Documentation

You can find the complete documentation and examples
[here](https://kapow.readthedocs.io).


## Authors

Kapow! is being developed by BBVA-Labs Security team members, sorted by name length:

- César Gallego
- Hector Hurtado
- pancho horrillo
- Daniel Hernández
- Roberto Abdelkader Martínez Pérez

Kapow! is Open Source Software and available under the [Apache 2
license](https://raw.githubusercontent.com/BBVA/kapow/master/LICENSE).


## Contributions

Contributions are of course welcome. See
[CONTRIBUTING](https://raw.githubusercontent.com/BBVA/kapow/blob/master/CONTRIBUTING.rst)
or skim existing tickets to see where you could help out.