README

Package Laravel untuk integrasi Single Sign-On (SSO) dengan aplikasi SSO-SIMRS RSUD Kraton. Package ini memudahkan aplikasi Laravel untuk melakukan autentikasi terpadu melalui server SSO.

Fitur

✅ Autentikasi melalui server SSO
✅ Manajemen callback URL otomatis
✅ Konfigurasi yang mudah disesuaikan
✅ Support untuk PHP 7.3+ dan Laravel framework
✅ Dilengkapi dengan service provider otomatis

Persyaratan

PHP 7.3 atau lebih tinggi (7.3, 8.0, 8.1, 8.2, 8.3)
Laravel framework
Composer

Instalasi

1. Instalasi Package via Composer

Jalankan perintah berikut di direktori project Laravel Anda:

composer require rsud-kraton/sso-client

2. Publish Konfigurasi (Opsional)

Jika Anda ingin meng-customize konfigurasi SSO, publish file konfigurasi ke direktori config:

php artisan vendor:publish --tag=sso-client-config

Perintah ini akan membuat file config/sso-client.php di project Anda.

3. Konfigurasi Environment

Tambahkan variabel environment berikut pada file .env:

# SSO Server Configuration
SSO_SERVER_URL=http://sso-simrs.test ## SSO server yang telah di sepakti team
SSO_CLIENT_ID=client-app
SSO_CALLBACK_URL=http://localhost:8000/sso/callback
SSO_REDIRECT_URL=/dashboard

Penjelasan konfigurasi:

Variabel	Deskripsi
`SSO_SERVER_URL`	URL server SSO-SIMRS tanpa trailing slash
`SSO_CLIENT_ID`	ID Klien yang sudah terdaftar di server SSO
`SSO_CALLBACK_URL`	URL callback untuk redirect setelah login SSO
`SSO_REDIRECT_URL`	Route yang dituju setelah login berhasil

Cara Kerja

Package ini secara otomatis:

Mendaftarkan Service Provider - SsoClientServiceProvider akan dimuat otomatis melalui auto-discovery
Merge Konfigurasi - File konfigurasi config/sso-client.php akan di-merge dengan aplikasi Anda
Register Routes - Route /sso/login dan /sso/callback secara otomatis didaftarkan

Penggunaan

Login via SSO

Untuk mengarahkan user ke halaman login SSO, gunakan route:

<a href="/sso/login">Login dengan SSO</a>

atau di controller:

return redirect('/sso/login');

Callback Handling

Route /sso/callback akan otomatis menangani:

Verifikasi response dari server SSO
Set session user
Redirect ke halaman yang dikonfigurasi di SSO_REDIRECT_URL

Struktur Package

laravel-sso-client/
├── src/
│   ├── Controllers/
│   │   └── SsoClientController.php
│   ├── Providers/
│   │   └── SsoClientServiceProvider.php
│   └── routes/
│       └── web.php
├── config/
│   └── sso-client.php
└── composer.json

Troubleshooting

Konfigurasi tidak terload

Pastikan Anda sudah menjalankan:

composer dump-autoload

Callback URL tidak cocok

Periksa bahwa SSO_CALLBACK_URL di environment sesuai dengan URL yang terdaftar di server SSO.

Error "Client not registered"

Pastikan SSO_CLIENT_ID sudah didaftarkan di server SSO-SIMRS.

License

MIT License - lihat file LICENSE untuk detailnya.

Author

virusphp - packercyber@gmail.com

Untuk bantuan lebih lanjut atau pelaporan bug, silakan buat issue di repository ini.

rsudkraton / sso-client

Maintainers

Package info

Statistics

Security