Files
PS_Launcher/server/api/routes/ValidateLicense.php
j.foucher 7a29dbb049 v0.4: licensing — server validation, DPAPI cache, Ed25519 signed responses
UX bonus: clicking "Reprendre" on an interrupted download skips the
release-notes confirmation dialog (the user already approved when they
first clicked Installer).

Server side
-----------
- migrations/001_init.sql: licenses, license_machines, rate_limit,
  audit_log on InnoDB/utf8mb4. Foreign keys, unique on license_key, slot
  uniqueness per (license_id, machine_id).
- api/lib/Db.php: thin PDO singleton (exception mode, prepared, no emul).
- api/lib/Crypto.php: Ed25519 sign/verify via libsodium (sodium_crypto_*),
  HMAC-SHA-256 helper for v0.6, canonicalJson() that strips `signature`
  before serializing — must match exactly the encoding done client-side
  before verify.
- api/routes/ValidateLicense.php: POST /license/validate. Looks up the
  key, walks the machine slot logic (insert or update last_seen),
  enforces max_machines, returns a payload signed Ed25519 + status of
  valid/expired/revoked/machine_limit_exceeded/invalid. Audit logs every
  outcome. Rate-limit 10/min/IP via the rate_limit table.
- tools/generate-keypair.php: prints a fresh sodium keypair so the
  operator drops the hex into config.php and the public_key_hex into the
  launcher resource.
- tools/issue-license.php: PRSRV-XXXX-XXXX-XXXX-XXXX generator (32-char
  unambiguous alphabet), inserts the license, prints the key once.
- tools/sign-manifest.php: now also signs the manifest itself with
  Ed25519 after computing the per-zip sha256s.
- config.example.php: schema rewritten with sections db / hmac / ed25519
  / jwt / rate-limit. config.php remains gitignored.

Client side
-----------
- Models/License.cs: LicenseValidationRequest + LicenseValidationResponse
  with CanDownload(VersionManifest) — entitlement_until vs version's
  minLicenseDate. The status valid|expired|revoked|machine_limit_exceeded
  flow is preserved end-to-end.
- Core/Licensing/LicenseService.cs:
  * machineId = SHA-256 of HKLM/Software/Microsoft/Cryptography/MachineGuid
    + UserName (stable, no PII leak)
  * online ValidateAsync calls /license/validate with launcher version
  * embedded server-pubkey.txt drives Ed25519 verification of the
    response (skipped gracefully if pubkey not yet provisioned)
  * SaveCached / GetCached use DPAPI CurrentUser scope on the license
    key; the cleartext key never touches disk
  * GetCached has a 7-day offline grace window after the last successful
    validation, so going offline doesn't lock the user out
- Core/Resources/server-pubkey.txt: EmbeddedResource. Default content is
  a comment, which the service treats as "no pubkey configured" and
  bypasses verification. Operator pastes the real hex post-deploy and
  rebuilds.
- Core/PSLauncher.Core.csproj: Polly, NSec.Cryptography (Ed25519),
  System.Security.Cryptography.ProtectedData (DPAPI).
- App/Views/OnboardingDialog.xaml(.cs): first-launch / "🔑 Activer"
  modal. Calls LicenseService, displays status messages with red
  foreground on errors and green-tinted secondary text otherwise.
- ViewModels/VersionRowViewModel.cs: new LicenseAllowsDownload property.
  Install button label switches to "🔒 License insuffisante" when the
  user's entitlement_until precedes the version's minLicenseDate;
  CanInstall is false in that case so the click is a no-op too.
- ViewModels/MainViewModel.cs: loads the cached license at startup (no
  network call), surfaces it as LicenseSummary in the top bar, exposes
  ActivateLicenseCommand to (re)open the onboarding dialog. RebuildList
  applies the per-version license filter so older installed versions
  remain launchable but newer-than-license ones can't be downloaded.
- Views/MainWindow.xaml: top bar gains a "🔑 Activer / changer" button
  next to the license summary.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-01 10:12:37 +02:00

136 lines
5.6 KiB
PHP

<?php
declare(strict_types=1);
namespace PSLauncher\Routes;
use PSLauncher\Crypto;
use PSLauncher\Db;
use PSLauncher\Response;
final class ValidateLicense
{
public static function handle(array $config): void
{
// Rate limit basique par IP
$ip = $_SERVER['REMOTE_ADDR'] ?? '0.0.0.0';
self::enforceRateLimit($config, $ip);
$body = json_decode(file_get_contents('php://input') ?: '[]', true) ?? [];
$licenseKey = trim((string)($body['licenseKey'] ?? ''));
$machineId = trim((string)($body['machineId'] ?? ''));
$machineLabel = trim((string)($body['machineLabel'] ?? ''));
$launcherVer = trim((string)($body['launcherVersion'] ?? ''));
if ($licenseKey === '' || $machineId === '') {
Response::error('invalid_request', 'licenseKey et machineId sont requis', 400);
}
$db = Db::get($config);
$now = (new \DateTimeImmutable('now'))->format('Y-m-d H:i:s');
$stmt = $db->prepare(
'SELECT id, license_key, owner_name, issued_at, download_entitlement_until,
max_machines, revoked_at
FROM licenses WHERE license_key = ? LIMIT 1'
);
$stmt->execute([$licenseKey]);
$lic = $stmt->fetch();
if (!$lic) {
self::audit($db, null, $ip, 'validate_invalid', ['key_prefix' => substr($licenseKey, 0, 6)]);
Response::error('invalid', 'Clé de license invalide', 401);
}
if ($lic['revoked_at'] !== null) {
self::audit($db, (int)$lic['id'], $ip, 'validate_revoked', []);
Response::error('revoked', 'License révoquée', 403);
}
// Slot machine
$slotStmt = $db->prepare(
'SELECT id FROM license_machines WHERE license_id = ? AND machine_id = ? LIMIT 1'
);
$slotStmt->execute([$lic['id'], $machineId]);
$existingSlot = $slotStmt->fetch();
if ($existingSlot) {
$db->prepare('UPDATE license_machines SET last_seen = ? WHERE id = ?')
->execute([$now, $existingSlot['id']]);
} else {
$countStmt = $db->prepare('SELECT COUNT(*) AS c FROM license_machines WHERE license_id = ?');
$countStmt->execute([$lic['id']]);
$count = (int)($countStmt->fetch()['c'] ?? 0);
if ($count >= (int)$lic['max_machines']) {
self::audit($db, (int)$lic['id'], $ip, 'machine_limit', ['count' => $count]);
Response::error('machine_limit_exceeded',
"Cette license autorise {$lic['max_machines']} machine(s) ; toutes les places sont prises.",
403, ['ownerName' => $lic['owner_name']]);
}
$db->prepare(
'INSERT INTO license_machines (license_id, machine_id, machine_label, first_seen, last_seen)
VALUES (?, ?, ?, ?, ?)'
)->execute([$lic['id'], $machineId, $machineLabel ?: null, $now, $now]);
}
// Construit la réponse, signe-la, renvoie
$entUntil = (new \DateTimeImmutable($lic['download_entitlement_until']))->format(\DateTimeInterface::ATOM);
$serverTime = (new \DateTimeImmutable('now'))->format(\DateTimeInterface::ATOM);
$expired = strtotime($lic['download_entitlement_until']) < time();
$payload = [
'status' => $expired ? 'expired' : 'valid',
'licenseId' => 'lic_' . $lic['id'],
'ownerName' => $lic['owner_name'],
'issuedAt' => (new \DateTimeImmutable($lic['issued_at']))->format(\DateTimeInterface::ATOM),
'downloadEntitlementUntil' => $entUntil,
'maxMachines' => (int)$lic['max_machines'],
'serverTime' => $serverTime,
];
// Signature Ed25519 du payload canonical
$sk = $config['ed25519']['private_key_hex'] ?? '';
if ($sk !== '') {
$payload['signature'] = Crypto::signEd25519(Crypto::canonicalJson($payload), $sk);
}
self::audit($db, (int)$lic['id'], $ip, $expired ? 'validate_expired' : 'validate_ok', [
'launcher_version' => $launcherVer,
]);
Response::json($payload, $expired ? 200 : 200);
}
private static function enforceRateLimit(array $config, string $ip): void
{
$max = (int)($config['validate_max_per_minute_per_ip'] ?? 10);
if ($max <= 0) return;
$db = Db::get($config);
$now = new \DateTimeImmutable('now');
$window = $now->modify('-1 minute')->format('Y-m-d H:i:s');
$stmt = $db->prepare('SELECT counter, window_start FROM rate_limit WHERE ip = ?');
$stmt->execute([$ip]);
$row = $stmt->fetch();
if ($row === false || $row['window_start'] < $window) {
$db->prepare('REPLACE INTO rate_limit (ip, window_start, counter) VALUES (?, ?, 1)')
->execute([$ip, $now->format('Y-m-d H:i:s')]);
return;
}
if ((int)$row['counter'] >= $max) {
Response::error('rate_limited', 'Trop de tentatives. Réessaie dans 1 minute.', 429);
}
$db->prepare('UPDATE rate_limit SET counter = counter + 1 WHERE ip = ?')->execute([$ip]);
}
private static function audit(\PDO $db, ?int $licenseId, string $ip, string $event, array $detail): void
{
try {
$db->prepare(
'INSERT INTO audit_log (ts, license_id, ip, event, detail) VALUES (NOW(), ?, ?, ?, ?)'
)->execute([$licenseId, $ip, $event, json_encode($detail, JSON_UNESCAPED_UNICODE)]);
} catch (\Throwable) { /* best-effort */ }
}
}