README

Library PHP untuk memudahkan aplikasi menggunakan fasilitas login SSO UNISA.

Instalasi di Laravel

Install Composer di Laptop/PC anda
Install library composer dengan menjalankan perintah berikut di terminal projejct anda:
```
 composer install
```
Install library unisa/SSO dengan menjalankan perintah berikut di terminal project anda:
```
 composer require unisa/sso
```

Penggunaan

1. Menghilangkan Namespace

Agar kode anda terlihat rapi dan membuat kode anda tidak buruk, anda dapat menghilangkan namespace dengan menambahkan perintah di header controller anda:

use SSO\SSO;

Setelah itu untuk pemanggilan hanya menggunakan perintah seperti ini:

SSO::$command();

2. Otentikasi

SSO::authenticate();

Pemanggilan ini akan me-redirect browser ke login SSO. Jika otentikasi berhasil maka fungsi ini akan mengembalikan nilai true dan meneruskan nya ke aplikasi yang membutuhkan otentikasi tersebut.

3. Mendapatkan detail user

SSO::getUser();

Fungsi ini akan mengembalikan object stdClass yang memiliki detail dari user yang berhasil diotentikasi. Potongan kode nya sebagai berikut:

$user = SSO::getUser();
echo $user->email                   // menampilkan email dari user
echo $user->first_name             // menampilkan nama lengkap dari user

3. Memeriksa otentikasi

SSO::check();

Fungsi ini digunakan untuk mengecek apakah user pernah berhasil diotentikasi atau belum.

4. Logout

SSO::logout();

Pemanggilan ini akan mengakhiri otentikasi user.

SSO::logout(url('http://unisayogya.ac.id'));

Pemanggilan ini akan mengakhiri otentikasi user dan me-redirect ke halaman dashboard unisa.

Kedua fungsi diatas digunakan untuk menerapkan Single Logout.

Koneksi dengan Aplikasi

Login

public function signing_process() {
    if(SSO::authenticate()) //mengecek apakah user telah login atau belum
    {
        if(SSO::check()) {
            $check = User::where('username', SSO::getUser()->username)->first(); //mengecek apakah pengguna SSO memiliki username yang sama dengan database aplikasi
            if(!is_null($check)) {
                Auth::loginUsingId($check->id_pengguna); //mengotentikasi pengguna aplikasi
                session()->flash('success', 'You are logged in!');
                return redirect()->route('index');
            } else {
                alert()->error('Data pengguna tidak ditemukan, silahkan hubungi administrator.')->html(true);
                return redirect()->route('auth.login'); //mengarahkan ke halaman login jika pengguna gagal diotentikasi oleh aplikasi
            }
        }
    } else {
        return redirect()->route('auth.logout'); //me-*redirect* user jika otentikasi SSO gagal, diarahkan untuk mengakhiri sesi login (jika ada)
    }
}

Fungsi ini digunakan untuk mengecek otentikasi SSO pada aplikasi

Logout

public function logout() {
    if(Auth::check()) { //mengecek otentikasi pada aplikasi
        SSO::cookieClear(); //If destroy cookie laravel
        SSO::ciCookieClear(); //If destroy cookie codeigniter4
        Session::flush(); //Destroy Session
        Auth::logout(); //Destroy Auth
        alert()->success('Berhasil logout'); //Alert
        return redirect('auth/login')->with('pesan', 'berhasil logout'); //Redirect to login page
    } else {
        return redirect('auth/login'); //menampilkan halaman login
    }
}

Fungsi ini digunakan untuk mengakhiri sesi otentikasi pada SSO dan Aplikasi

Middleware

if( SSO::check() || Auth::check() ) {
    return $next($request);
} else {
    return redirect()->route('auth.logout');
}

Fungsi ini digunakan untuk mengecek otentikasi pada SSO atau bawaan laravel

Penggunaan di Codeigniter 4 menggunakan Composer

Untuk penggunaan di Codeigniter 4 terdapat perubahan di folder vendor/apereo/phpcas. Ekstrak file phpcas.zip dalam folder vendor/unisa/sso kemudiaan salin dan letakkan ke dalam folder vendor/apereo/phpcas.

Thanks to

PHP CAS
RistekCSUI/SSO

unisa / sso

Maintainers

Details