mirror of
https://github.com/fosrl/badger.git
synced 2026-02-08 05:56:46 +00:00
write readme and add license
This commit is contained in:
36
README.md
36
README.md
@@ -1,3 +1,35 @@
|
||||
# badger
|
||||
# Badger Plugin for Traefik with Pangolin Integration
|
||||
|
||||
Middleware auth bouncer for Pangolin
|
||||
Badger is a middleware plugin designed to work with the Traefik reverse proxy in conjunction with [Pangolin](https://github.com/fosrl/pangolin), a multi-tenant tunneled reverse proxy server and management interface with identity and access management. Badger acts as an authentication bouncer, ensuring only authenticated and authorized requests are allowed through the proxy.
|
||||
|
||||
This plugin is **required** to be configured alongside [Pangolin](https://github.com/fosrl/pangolin) to enforce secure authentication and session management.
|
||||
|
||||
## Installation
|
||||
|
||||
Learn how to set up [Pangolin](https://github.com/fosrl/pangolin) and Badger in the [Pangolin Documentation](https://github.com/fosrl/pangolin).
|
||||
|
||||
---
|
||||
|
||||
## Configuration
|
||||
|
||||
Badger requires the following configuration parameters to be specified in your [Traefik configuration file](https://doc.traefik.io/traefik/getting-started/configuration-overview/). These coincide with the separate [Pangolin](https://github.com/fosrl/pangolin) configuration file.
|
||||
|
||||
### Configuration Options
|
||||
|
||||
```yaml
|
||||
apiBaseUrl: "http://localhost:3001/api/v1"
|
||||
userSessionCookieName: "session"
|
||||
resourceSessionCookieName: "resource_session"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## License
|
||||
|
||||
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
|
||||
|
||||
---
|
||||
|
||||
## Contact
|
||||
|
||||
Please contact us at [support@fossorial.io](mailto:support@fossorial.io).
|
||||
|
||||
Reference in New Issue
Block a user