Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/portier/portier-broker
Portier Broker reference implementation, written in Rust
https://github.com/portier/portier-broker
auth openidconnect portier rust
Last synced: 4 days ago
JSON representation
Portier Broker reference implementation, written in Rust
- Host: GitHub
- URL: https://github.com/portier/portier-broker
- Owner: portier
- License: apache-2.0
- Created: 2016-05-18T20:10:35.000Z (over 8 years ago)
- Default Branch: main
- Last Pushed: 2024-05-16T05:05:27.000Z (6 months ago)
- Last Synced: 2024-05-17T06:49:41.757Z (6 months ago)
- Topics: auth, openidconnect, portier, rust
- Language: Rust
- Homepage: http://portier.github.io/
- Size: 2.23 MB
- Stars: 549
- Watchers: 17
- Forks: 17
- Open Issues: 26
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
Awesome Lists containing this project
- awesome-repositories - portier/portier-broker - Portier Broker reference implementation, written in Rust (Rust)
- awesome-starred - portier/portier-broker - Portier Broker reference implementation, written in Rust (rust)
README
# Portier Broker
This is the Portier Broker reference implementation.
- [Portier Broker on GitHub](https://github.com/portier/portier-broker)
- [Portier main website](https://portier.github.io/)
- [Portier specification](https://github.com/portier/portier.github.io/blob/main/Specs.md)## How to run your own broker
[![HerokuDeploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/portier/portier-broker/tree/main)
Portier is specified such that everyone can run their own broker instance. You
can point your Relying Parties at your own broker, so that you do not have to
depend on the broker run by the Portier project.Binaries for the broker can be found on the [GitHub releases] page. Docker
images are also available on [Docker Hub]. Alternatively, you can [build the
broker] yourself.[docker hub]: https://hub.docker.com/r/portier/broker
[github releases]: https://github.com/portier/portier-broker/releases
[build the broker]: ./docs/build.mdThe broker can be configured using a configuration file or through environment
variables. Both are documented in the [example configuration file].[example configuration file]: ./config.toml.dist
Once you've prepared the configuration, simply run the broker executable:
```bash
# From binaries:
./portier-broker[.exe] ./config.toml# Using Docker:
docker run -v /srv/portier-broker:/data:ro portier/broker /data/config.toml
```Some additional notes:
- If using environment variables only, don't specify a configuration file on
the command line.- [Systemd units] are also included with the Linux binaries.
- The broker only talks plain HTTP, and not HTTPS. Using HTTPS is strongly
recommended, but you'll need to add a reverse proxy in front of the broker to
do this. ([Apache] or [Nginx] can do this for you.)[systemd units]: ./docs/systemd/
[apache]: https://httpd.apache.org
[nginx]: http://nginx.org