https://github.com/rutaka-n/httpkeeper
simple reverse proxy server with JWT auth
https://github.com/rutaka-n/httpkeeper
http jwt-auth reverse-proxy
Last synced: about 1 year ago
JSON representation
simple reverse proxy server with JWT auth
- Host: GitHub
- URL: https://github.com/rutaka-n/httpkeeper
- Owner: rutaka-n
- License: mit
- Created: 2023-07-22T15:49:58.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-04-01T11:57:19.000Z (about 2 years ago)
- Last Synced: 2025-01-27T06:32:17.931Z (about 1 year ago)
- Topics: http, jwt-auth, reverse-proxy
- Language: Go
- Homepage:
- Size: 192 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# HTTP Keeper
The HTTP Keeper is a simple http reverse proxy server that proxy http-requests to an upstream server.
It allows to:
- set basic auth user:password for upstream
- use access-tokens to authenticate clients requests
- set the rate limit for upstream
- set invalidated tokens
## Installation
Download the archive from release page, extract the executable file, and add into your path.
## Configuration
You can find the example of configuration file in `share/config.json`
**Note:** Please change the `server.secret`.
## Usage
### Generate Secret
```
$ httpkeeper secret N
```
Where `N` is a length of the secret.
After generating, you need to set the value to the config file.
### Generate Token
```
$ httpkeeper token -config path/to/config.json -client CLIENT_NAME -expiresAt "2023-12-31 23:59:59"
```
The command generate JWT-token that you can copy to configuration of the client. Client should set the value in HTTP Authorization header:
```
Authorization: Bearer
```
### Run proxy
```
$ httpkeeper proxy -config path/to/config.json [-addr addr:port] [-log path/to/httpkeeper.log]
```
## TODO
* set/check list of services in the token
* TLS
* control script
* install.sh
* Load balancing
* healthchecks