Inspired from the Norse mythology, Heimdallr, modernly anglicized as Heimdall is the gatekeeper of Bifröst, the rainbow road connecting Midgard, realm of the humans, to Asgard, the realm of Gods.
In CodeIgniter 4, Heimdall serves as the gatekeeper between the client and the Resource server. Heimdall gives you an out of the box OAuth 2.0 authorization protocol implementation to your Web Service. Heimdall also comes with some handy extensions such as Open ID Connect support to gives you a simple identity layer on top of the OAuth 2.0 protocol and a Proof Key for Code Exchange support.
Heimdall implements the standards compliant implementation of an OAuth 2.0 authorization server written in PHP which makes working with OAuth 2.0 trivial. You can easily configure an OAuth 2.0 server to protect your API with access tokens, or allow clients to request new access tokens and refresh them.
This library was created in order to simplify the need of OAuth 2.0 implementation in your CodeIgniter 4 framework, based on the OAuth 2.0 Server library by thephpleague.
See the latest version of Heimdall here.
In order to install Heimdall, you have to use Composer.
In your root directory of your CodeIgniter 4 project, fire up a terminal and run:
composer require ezralazuardy/heimdall
Then Heimdall is ready to be configured and run in your server.
In order to start configuring & implementing Heimdall in your CodeIgniter 4 project, please refer to the documentation.
Read the Heimdall documentation here.
All contributions are welcomed. Please make a pull request so that I can review your changes.
Before start making contributions to Heimdall, please read the contribution guidelines and code of conduct.
Read the current Heimdall's security policy here.
Heimdall is at it's early stage. If you experiencing an error or bug, please report by creating a new issues.