Simple and Lightweight Auth System for CodeIgniter
benedmunds Merge pull request #1261 from Indigo744/fix_reuse_connection
Reuse default DB connection when no group name
Latest commit 4a007e6 Aug 16, 2018

Ion Auth 2

The future of authentication

by Ben Edmunds

Redux Auth 2 had a lot of potential. It's lightweight, simple, and clean, but had a ton of bugs and was missing some key features. So we refactored the code and added new features.

This version drops any backwards compatibility and makes things even more awesome than you could expect.


If you use this to further your career, or put money in your pocket, and would like to support the project please consider a moral license.


Documentation is located at


There are 2 ways to install this package.

  1. Move files from this package to the corresponding folder structure:
CI                          # → Root Directory
└── application/
    ├── config/
    │   └── ion_auth.php
    ├── controllers/
    │   └── Auth.php
    ├── libraries
    │   ├── Bcrypt.php
    │   └── Ion_auth.php
    ├── models
    │   └── Ion_auth_model.php
    └── views/
        └── auth/           # → Various view files

  1. Move files from this package to the corresponding third_party structure:
CI                          # → Root Directory
└── application/
    ├── controllers/
    │   └── Auth.php
    ├── third_party/
    │   └── ion_auth/
    │       ├── config/
    │       │   └── ion_auth.php
    │       ├── libraries
    │       │    ├── Bcrypt.php
    │       │    └── Ion_auth.php
    │       └── models
    │            └── Ion_auth_model.php
    └── views/
        └── auth/           # → Various view files

Then in your controller, example Auth.php add the package path and load the library like normal


Or autoload by adding the following to application/config/autoload.php

$autoload['packages'] = array(APPPATH.'third_party/ion_auth');

CodeIgniter Version 2 Compatibility

CodeIgniter v2 requires the class file names to be lowercase. In order to support this follow the standard installation procedures and then either rename the following files or create symlinks

models/Ion_auth_model.php         =>   models/ion_auth_model.php
controllers/Auth.php              =>   controllers/auth.php

Relational DB Setup

Then just run the appropriate SQL file (if you're using migrations you can get the migrations from JD here:


In the package you will find example usage code in the controllers and views folders. The example code isn't the most beautiful code you'll ever see but it'll show you how to use the library and it's nice and generic so it doesn't require a MY_controller or anything else.

Default Login

Username: Password: password


It is highly recommended that you use encrypted database sessions for security!


It is recommended that you add your identity column as a unique index.


Time Based One-Time Password (TOTP) - There is a Time Based One-Time Password (TOTP) implementation compatible with Google Authenticator available. Feature branch maintained by biscofil and is available at

For Help

Feel free to send me an email if you have any problems.

Thanks, -Ben Edmunds @benedmunds