Experimental Single-Sign-On (SSO) server with multiple factor authentication for OAuth2 and OpenID Connect authentication
Glewlwyd 2.7.2 is available. Feel free to install it, test it, use it (with precautions!), and send feedback if you feel like it!
- OpenID Connect/OAuth2
- OAuth2: Legacy plugin, it's recommended to use the OpenID Connect/OAuth2 for new installations
- Password
- One-time password (TOTP/HOTP)
- WebAuthn (Yubikey, Android and Apple fingerprint or face id, etc.)
- One-time password sent via e-mail
- TLS Certificate
- External OAuth2/OIDC providers
- HTTP Backend service providing Basic Authentication
New users can register a new account with the possibility to confirm their e-mail address or not. During the registration process, the new user may be expected to register their passwords, as well as other authentication factors:
- One-time password (TOTP/HOTP)
- WebAuthn (Yubikey, Android devices)
- TLS Certificate
- External OAuth2/OIDC providers
Existing users can update their e-mail by sending a confirmation link to the new e-mail.
Existing users can reset their credentials if their password or authentication schemes are lost or unavailable. Credentials can be reset by different factors:
- A link sent to the user's e-mail
- A one-time use recovery code
See the register/update e-mail/reset credentials documentation for more information on the registration, update e-mail or reset credentials features.
Based on a plugin architecture to make it easier to add or update storage backends, authentication schemes or process.
Adding new authentication schemes or backend storage for users and clients is possible via the plugin architecture.
The backend API server is fully written in C and uses a small amount of resources.
Its plugin architecture makes it easy to add new modules or plugins, or modify existing ones with less risks to have unmaintainable code.
Glewlwyd is mostly developped by myself on my free time, with gracious help from users.
Nevertheless, it hasn't been audited or fully tested by external developpers.
Glewlwyd can take a central place in a system where applications and environments need authentication and authorization, be aware of the risks: bugs, non discovered vulnerabilities, etc.
I recommend not to use Glewlwyd in production, more likely to test OAuth2/OpenID behavior, MFA connections, or IdP in general. You can also explore its functionalities and help yourself with its source code for other implementations.
If you intend to use it in production, it's highly recommended to follow the documentation and enable only the features you will use.
The full installation documentation is available in the Install documentation.
A docker image is available for tests on localhost. To test the image, run the following command:
$ docker run --rm -it -p 4593:4593 babelouest/glewlwyd:latestAnd open the address http://localhost:4593/ on your browser.
- User:
admin - Password:
password
This Docker image can be used for tests or for real use by changing the configuration files. More information in the install documentation.
The Getting started documentation will help administrators configure Glewlwyd's modules and authentication schemes.
The user documentation will help Glewlwyd's users manage their profile and log in to Glewlwyd.
The full core REST API documentation is available in the API documentation
You can update the existing plugins or add new ones depending on your needs, check out the documentation available for each type of plugin:
- User backend modules
- User middleware backend modules
- Client backend modules
- Authentication schemes modules
- Plugins (Register, OAuth2 or OIDC plugins)
Go to the Screenshots folder to get a visual idea of Glewlwyd.
You can open an issue, a pull request or send me an e-mail. Any help is much appreciated!
You can visit the IRC channel #glewlwyd on the Libera.Chat network.