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:

Cara Kerja

Package ini secara otomatis:

1. Mendaftarkan Service Provider - SsoClientServiceProvider akan dimuat otomatis melalui auto-discovery
2. Merge Konfigurasi - File konfigurasi config/sso-client.php akan di-merge dengan aplikasi Anda
3. 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.