⚡ Quick Start

Prerequisiti

Username/password forniti da Salabam
SSL certificate attivo sul vostro dominio
Supporto PHP 7.4+ o linguaggio equivalente per JWT

Setup in 5 minuti

1. Ottenere credenziali SSO

Username: your-company
Password: [fornita separatamente]

2. Endpoint SSO principale

POST https://ws.salabam.com/ws/v1/sso/your-company

3. Test di connessione

curl -X POST "https://ws.salabam.com/ws/v1/sso/your-company" \
     -H "Content-Type: application/json" \
     -d '{"username":"test-user","email":"test@company.com"}'

4. Verifica risposta

{
  "success": true,
  "redirect_url": "https://portal.salabam.com/sso-login?token=..."
}

Esempio Minimo Funzionante

<?php
use Firebase\JWT\JWT;

$username = 'your-company';
$secret = 'your-secret-key';

// Prepara payload JWT
$payload = [
    'iss' => 'https://yourdomain.com',
    'aud' => 'https://ws.salabam.com',
    'iat' => time(),
    'exp' => time() + (4 * 3600),
    'data' => [
        'orderAuthUrl' => 'https://yourdomain.com/api/authorize',
        'employee' => [
            'id' => 'EMP001',
            'name' => 'Mario',
            'surname' => 'Rossi',
            'email' => 'mario.rossi@company.com',
            'fiscalCode' => 'RSSMRA85M01H501X',
            'availability' => 500.00
        ]
    ]
];

// Genera JWT
$jwt = JWT::encode($payload, $secret, 'HS256');

// Chiamata SSO
$ch = curl_init("https://ws.salabam.com/ws/v1/sso/{$username}");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'message' => 'token request',
    'jwt' => $jwt
]));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$data = json_decode($response, true);

// Redirect utente
header("Location: " . $data['data']['redirectTo']);

Prossimi Passi

✅ Implementa endpoint di autorizzazione ordine
✅ Testa in ambiente staging
✅ Configura beneficiari se necessario
✅ Attiva servizi desiderati
✅ Vai in produzione!