Výnimky

Každá chyba dedí z RoundlyConsulting\Passkeys\Exceptions\PasskeyException (RuntimeException). Zachyťte základ pre jednotnú odpoveď, alebo konkrétneho potomka pre jemnejšie riadenie:

use RoundlyConsulting\Passkeys\Exceptions\PasskeyException;

try {
    $passkey = Passkeys::authenticate($response);
} catch (PasskeyException $e) {
    // Return a uniform failure to the client; log $e server-side.
    return response()->json(['message' => 'Sign-in failed.'], 422);
}

Chyby ceremónie

Konfigurácia, dekódovanie a atestácia

Lokalizované hlásenia

Hlásenia sa prekladajú cez menný priestor passkeys::errors.*, ktorý je pribalený v angličtine a slovenčine a riadi sa jazykom aplikácie — publikujte passkeys-translations, ak ich chcete upraviť alebo doplniť ďalší jazyk. Hlásenie je celé v jazyku aplikácie: aj vlastné doplňujúce časti balíka — aký tvar musí mať nastavenie, prečo je atestačný výrok poškodený, ktorú požiadavku na certifikát nespĺňa — sú prekladové kľúče, kým doslovné tokeny ako x5c, CA:FALSE, OID či kľúče nastavení zostávajú nezmenené. Celočíselné a enum nastavenia overuje package-toolkit-for-laravel, ktorého hlásenia sú len v angličtine.

Text z nižšej vrstvy — dekodéra CBOR/COSE alebo parsera certifikátov — sa preložiť nedá, preto sa do hlásenia nikdy nedostane. Vývojárom zostáva k dispozícii:

• $e->getPrevious() — výnimka nižšej vrstvy (napríklad CryptoException) za MalformedCbor, InvalidCoseKey, InvalidAuthenticatorData::because(), UnsupportedAlgorithm::because() a za InvalidAttestation::malformedStatement() pri chybe parsera.
• $e->context() — ['reason' => '…'] pri štyroch továrňach, ktoré nesú dôvod, inak []. Obsluha výnimiek Laravelu ho do záznamu v logu pridá automaticky.