Skip to content

Commit

Permalink
add README
Browse files Browse the repository at this point in the history
  • Loading branch information
richardstephens committed Feb 26, 2023
1 parent 4444c6c commit d60aff6
Showing 1 changed file with 22 additions and 0 deletions.
22 changes: 22 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
Authenticating Reverse Proxy
============================

This is a simple reverse proxy that can be used to expose a
service using HTTP Basic authentication and GitHub Personal Access Tokens as an auth backend.

Other auth methods may be supported in the future.

The org token parameter is optional, but without it, only users who have their org membership publicly visible will be
able to login.

Usage:

```shell
docker run -it -e TARGET=http://example.com \
-e AUTH_METHOD=GH_BASIC \
-e GH_ORG=your-org \
-e GH_ORG_TOKEN=ghp_XXXXX \
-e BIND=0.0.0.0:8080 \
-p 8080:8080 \
ghcr.io/richardstephens/authenticating-reverse-proxy:latest
```

0 comments on commit d60aff6

Please sign in to comment.