Home

Awesome

<div> <img alt="Build" src="https://github.com/ezralazuardy/heimdall/actions/workflows/build.yml/badge.svg" /> <img alt="Codacy Security Scan" src="https://github.com/ezralazuardy/heimdall/actions/workflows/codacy-analysis.yml/badge.svg" /> <img alt="Releases" src="https://img.shields.io/github/v/release/ezralazuardy/heimdall" /> <img alt="Minimum PHP version" src="https://img.shields.io/packagist/php-v/ezralazuardy/heimdall" /> <img alt="Issues" src="https://img.shields.io/github/issues/ezralazuardy/heimdall?color=red" /> <img alt="Code Quality" src="https://img.shields.io/codacy/grade/ff30d1e1cc494b1ca03462cd90f2e1f1" /> <img alt="Maintainability" src="https://img.shields.io/codeclimate/maintainability/ezralazuardy/heimdall" /> </div>

🤺 heimdall

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 resource server. Heimdall gives you an out of the box OAuth 2 authorization protocol implementation to your CodeIgniter's 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 protocol and a Proof Key for Code Exchange support.

Heimdall implements the standards compliant implementation of an OAuth 2 authorization server written in PHP which makes working with OAuth 2 trivial. You can easily configure an OAuth 2 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 implementation in your CodeIgniter 4 framework, based on the OAuth 2.0 Server library by thephpleague.

Latest version

See the latest version of Heimdall here.

<br/>

✍️ Installation

In order to install Heimdall, you have to use Composer.

In the root directory of your CodeIgniter 4 project, fire up a terminal and run:

composer require ezralazuardy/heimdall

Heimdall is now ready to be configured and run in your server.

<br/>

🚀️ Getting Started

In order to start configuring & implementing Heimdall in your CodeIgniter 4 project, please refer to the documentation.

<br/>

📖️ Documentation

Read the Heimdall documentation on https://heimdall.lazuardy.tech.

<br/>

👷️ Contributing

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.

<br/>

🛡️ Security Policy

Read the current Heimdall's security policy here.

<br/>

🗒️ Side Note

Heimdall is at it's early stage. If you experiencing an error or bug, please report by creating a new issues.

<br/>

📜 License

<a href="https://app.fossa.com/projects/git%2Bgithub.com%2Fezralazuardy%2Fheimdall?ref=badge_large" alt="FOSSA Status"><img src="https://app.fossa.com/api/projects/git%2Bgithub.com%2Fezralazuardy%2Fheimdall.svg?type=large"/></a>