burgerauth/README.md

19 lines
1.0 KiB
Markdown
Raw Normal View History

2024-06-26 00:02:25 +01:00
# Burgerauth
2024-06-26 00:05:10 +01:00
Burgerauth is a free-and-open-source OAuth2/OIDC (or as I've taken to calling it, OAuth2 + OIDC) server.
2024-06-26 00:02:25 +01:00
## Ok, that's great, how do I host my own instance?
2024-06-26 00:02:47 +01:00
First, replace the domains in the source code and templates with your own (a domain is required, not just an IP). Second, copy config.ini.example to config.ini then tweak to your liking. Third, run `go build`, and fourth, run `./burgerauth`. Read ERRORS.md to see how to handle server errors.
2024-06-26 00:02:25 +01:00
## What if I am a developer?
The OAuth2 protocol should be fairly standard. Burgerauth comes with OpenID Connect discovery, and you should use that to find out the URL endpoints for the instance you are targeting, and you shouldn't really touch anything else. Burgerauth provides only authorization and not resource-delegation, and so doesn't issue refresh tokens.
## How long did this take to make?
2024-06-26 00:05:10 +01:00
Yes.
## What do you mean "OAuth2 + OIDC"?
OIDC is not a protocol in of itself, but rather an extension on top of a fully working OAuth2 system, made useful by the OAuth2 protocol and JWK token protocol.