Download the PHP package mixu/sso-auth without Composer

Mixu SSO Auth Package

Sistem SSO (Single Sign-On) authentication lengkap untuk Laravel dengan fitur security monitoring, session binding, dan activity tracking.

📋 Fitur Utama

• ✅ OAuth2 Integration - Mudah integrase dengan Mixu Auth Server atau OAuth2 provider lainnya
• ✅ Session Security - IP binding dan User-Agent validation untuk mencegah session hijacking
• ✅ Activity Tracking - Audit trail lengkap untuk setiap user activity
• ✅ Security Monitoring - Brute force detection, anomaly detection, security event logging
• ✅ Role-Based Access - Kontrol akses berbasis role dari SSO Server
• ✅ Area-Based Access - Kontrol akses berbasis access area dari SSO Server
• ✅ Global Logout Webhook - Logout otomatis di semua aplikasi saat logout di SSO Server
• ✅ Laravel 12+ Support - Compatible dengan Laravel 12 dan PHP 8.2+

🚀 Instalasi

1. Install via Composer

2. Publish Configuration & Migrations

3. Setup Environment Variables

Tambahkan di file .env:

4. Run Migrations

⚙️ Konfigurasi

Service Provider Otomatis

Package akan secara otomatis terdaftar melalui package auto-discovery. Jika tidak, tambahkan di config/app.php:

Catatan penting: sejak Laravel 11 paket tidak lagi mengandalkan file Console/Kernel.php. Jadwal (schedule) didefinisikan di provider atau routes/console.php aplikasi. lihat bagian berikut untuk detail.

Register Middleware

Daftarkan middleware di bootstrap/app.php atau app/Http/Kernel.php milik aplikasi (package tidak memerlukan file kernel sendiri):

📖 Cara Penggunaan

1. Setup Routes

Routes sudah otomatis terdaftar:

• GET /login - Redirect ke SSO login
• GET /auth/callback - Callback setelah login dari SSO
• POST /logout - Logout user
• POST /auth/sso/logout-callback - Webhook untuk global logout

2. Protect Routes dengan Middleware

3. Role & Area-Based Access Control

4. Menggunakan Service di Controller

📆 Menjadwalkan Rebuild Statistik

Perintah security:stats menghitung ulang statistik keamanan. Paket akan mendaftarkannya otomatis melalui service provider, sehingga tidak perlu kode di Kernel.php.

Pastikan aplikasi memanggil scheduler setiap menit (cron):

Jika ingin mengontrol sendiri jadwal, tambahkan snippet berikut di routes/console.php aplikasi:

use Mixu\SSOAuth\Services\SecurityMonitoringService;

class DashboardController extends Controller { public function __construct( private SSOAuthService $sso, private SecurityMonitoringService $security ) {}

public function index()
{
    // Get user dan token dari session
    $user = auth()->user(); // atau request()->session()->get('sso_user')

    // Check token masih valid
    if (!$this->sso->isTokenValid($user['access_token'])) {
        return redirect()->route('auth.login');
    }

    // Get security stats
    $stats = $this->security->getSecurityStats(30);

    return view('dashboard', compact('stats'));
}

} env AUTH_BASE_URL=https://auth.example.com AUTH_CLIENT_ID=your-id AUTH_CLIENT_SECRET=your-secret AUTH_REDIRECT_URI=http://yourapp.test/auth/callback

### Token Exchange Failed

**Error:** "Tukar authorization code ke access token gagal"

**Solution:** Periksa:
1. `AUTH_BASE_URL` benar
2. `AUTH_CLIENT_ID` dan `AUTH_CLIENT_SECRET` benar
3. `AUTH_REDIRECT_URI` sama dengan di SSO Server
4. Network connectivity ke SSO Server

### Session IP Mismatch

**Error:** "Your session was accessed from a different location"

**Solution:** User mengakses dari IP berbeda. Normal jika:
- Mobile user pindah dari wifi ke cellular
- User di behind proxy/VPN yang berubah

Jika perlu melonggarkan, disable middleware `validate.session.ip`.

## 📝 License

MIT License. See LICENSE file for details.

## 🤝 Contributing

Contributions welcome! Silakan buat issue atau pull request.

## 📧 Support

Email: [email protected]
Website: https://mixu.io