corentin_wakdo/tests/Unit/Auth/PinVerifierTest.php
Imugiii 5a4897921e
Some checks failed
CI / php-lint (push) Successful in 19s
CI / secret-scan (pull_request) Successful in 8s
CI / secret-scan (push) Successful in 10s
CI / static-tests (push) Successful in 30s
CI / php-lint (pull_request) Successful in 19s
CI / auto-merge (push) Has been skipped
CI / static-tests (pull_request) Successful in 30s
CI / auto-merge (pull_request) Failing after 4s
feat(admin): throttle du PIN d'action sensible par acteur (RG-T22)
Ferme le finding HIGH de la revue Produits (#17) : le PIN d'action sensible
etait verifie sans limitation de tentatives. Conception via panel multi-agents
(3 lentilles + synthese + passe adversariale, holds=true) puis revue de
l'implementation (holds=true).

Dimension du throttle = UTILISATEUR AGISSANT (identite de session, RG-T02), pas
l'email cible (contournable par rotation) ni l'IP (collateral sur poste partage).
Table dediee pin_throttle (entite 22) STRICTEMENT SEPAREE des compteurs de login
(user.failed_login_attempts / login_throttle) : un echec de PIN n'incremente aucun
compteur de connexion (pas d'escalade DoS vers le login).

- db/migrations/0002_pin_throttle.sql : table cle sur actor_user_id (UNIQUE, FK
  -> user ON DELETE CASCADE), separee du login. Appliquee a la base dev.
- ThrottlePolicy : dimension 'pin' (bornes propres PIN_THROTTLE_*, 30s..300s, plus
  permissives que le login : controle de dissuasion, residuel Faible).
- PinThrottle (nouveau) : isLocked / recordFailure (upsert atomique + backoff, une
  transaction, miroir d'AuthService) / reset (UPDATE simple). N'ecrit jamais
  user/login_throttle/audit_log.
- PinVerifier::payTimingDecoy : parite de timing du chemin verrouille.
- ProductController update/destroy : gate AVANT verification (leurre + 422
  generique, pas de pin.failed sous verrou actif = borne anti-flood de l'audit) ;
  recordFailure sur PIN faux ; reset sur succes, cle sur l'acteur de SESSION.
- Docs Merise 21 -> 22 entites : RG-T22 (mlt), entite 22 pin_throttle
  (mcd/mld/dictionary), couverture MCT 22/22 (mct).
- .env.example + docker-compose : PIN_THROTTLE_THRESHOLD/BASE/MAX/WINDOW.
- Journal RNCP : docs/journal/2026-06-15--p3-throttle-pin-rg-t22.md.

Tests : 188 verts (525 assertions), PHPStan L6 propre.
2026-06-15 22:03:07 +00:00

153 lines
5.2 KiB
PHP

<?php
declare(strict_types=1);
namespace App\Tests\Unit\Auth;
use PHPUnit\Framework\TestCase;
use App\Auth\PasswordHasher;
use App\Auth\PinVerifier;
use App\Core\Config;
use App\Tests\Support\FakeDatabase;
/**
* Verification du PIN d'action sensible (RG-T13) avec un FakeDatabase et un vrai
* PasswordHasher a cout reduit.
*/
final class PinVerifierTest extends TestCase
{
/** @var list<string> */
private array $touchedKeys = [];
private FakeDatabase $db;
private PasswordHasher $hasher;
protected function setUp(): void
{
$this->setEnv('STAFF_PIN_MIN_LENGTH', '4');
$this->setEnv('STAFF_PIN_MAX_LENGTH', '12');
$this->setEnv('ARGON2_MEMORY_COST', '1024');
$this->setEnv('ARGON2_TIME_COST', '1');
$this->setEnv('ARGON2_THREADS', '1');
$this->db = new FakeDatabase();
$this->hasher = new PasswordHasher(new Config());
}
protected function tearDown(): void
{
foreach ($this->touchedKeys as $key) {
putenv($key);
}
$this->touchedKeys = [];
}
private function setEnv(string $key, string $value): void
{
$this->touchedKeys[] = $key;
putenv($key . '=' . $value);
}
private function verifier(): PinVerifier
{
return new PinVerifier($this->db, new Config(), $this->hasher);
}
public function testVerifyTrueWhenPinMatches(): void
{
$this->db->pinUserRow = ['pin_hash' => $this->hasher->hash('4729')];
self::assertTrue($this->verifier()->verify(7, '4729'));
// Garde RG-T13 : la lecture filtre bien is_active = 1 (retirer le predicat
// ferait echouer ce cas via le routage durci du FakeDatabase).
self::assertStringContainsString('is_active = 1', $this->db->reads[0]['sql']);
}
public function testVerifyFalseWhenPinWrong(): void
{
$this->db->pinUserRow = ['pin_hash' => $this->hasher->hash('4729')];
self::assertFalse($this->verifier()->verify(7, '0000'));
}
public function testVerifyFalseWhenPinHashNull(): void
{
// PIN non defini sur le compte.
$this->db->pinUserRow = ['pin_hash' => null];
self::assertFalse($this->verifier()->verify(7, '4729'));
}
public function testVerifyFalseWhenUserAbsentOrInactive(): void
{
// La requete filtre is_active = 1 : un compte inactif/absent ne renvoie rien.
$this->db->pinUserRow = null;
self::assertFalse($this->verifier()->verify(7, '4729'));
}
public function testVerifyFalseWhenPinEmpty(): void
{
$this->db->pinUserRow = ['pin_hash' => $this->hasher->hash('4729')];
self::assertFalse($this->verifier()->verify(7, ''));
}
public function testResolveActingUserReturnsIdentityWhenPinMatches(): void
{
$this->db->actingUserRow = ['id' => 7, 'role_id' => 4, 'pin_hash' => $this->hasher->hash('4729')];
self::assertSame(['id' => 7, 'role_id' => 4], $this->verifier()->resolveActingUser('staff@wakdo.local', '4729'));
// Garde RG-T13 : la resolution filtre is_active = 1 (retirer le predicat
// ferait echouer ce cas, comme pour verify()).
self::assertStringContainsString('is_active = 1', $this->db->reads[0]['sql']);
}
public function testResolveActingUserNullWhenPinWrong(): void
{
$this->db->actingUserRow = ['id' => 7, 'role_id' => 4, 'pin_hash' => $this->hasher->hash('4729')];
self::assertNull($this->verifier()->resolveActingUser('staff@wakdo.local', '0000'));
}
public function testResolveActingUserNullWhenEmailUnknown(): void
{
$this->db->actingUserRow = null;
self::assertNull($this->verifier()->resolveActingUser('ghost@wakdo.local', '4729'));
}
public function testResolveActingUserNullWhenInputEmpty(): void
{
self::assertNull($this->verifier()->resolveActingUser('', '4729'));
self::assertNull($this->verifier()->resolveActingUser('staff@wakdo.local', ''));
}
public function testPayTimingDecoyHashesWithoutTouchingDatabase(): void
{
// Chemin "acteur verrouille" (RG-T22) : on paie le cout argon2id sans aucune
// lecture/ecriture DB, pour egaliser le timing avec le chemin mauvais-PIN
// sans introduire d'oracle (aucune requete = rien a observer).
$this->verifier()->payTimingDecoy('4729');
self::assertSame([], $this->db->reads);
self::assertSame([], $this->db->writes);
}
public function testMeetsLengthPolicy(): void
{
$verifier = $this->verifier();
// Sous le minimum / au minimum / dans les bornes.
self::assertFalse($verifier->meetsLengthPolicy('123'));
self::assertTrue($verifier->meetsLengthPolicy('1234'));
self::assertTrue($verifier->meetsLengthPolicy('123456'));
// Au max (12) accepte, au-dela refuse (RG-T18 borne haute).
self::assertTrue($verifier->meetsLengthPolicy('123456789012'));
self::assertFalse($verifier->meetsLengthPolicy('1234567890123'));
// Charset : chiffres uniquement ; vide refuse.
self::assertFalse($verifier->meetsLengthPolicy('abcd'));
self::assertFalse($verifier->meetsLengthPolicy('12ab'));
self::assertFalse($verifier->meetsLengthPolicy(''));
}
}