Overovanie podpisov a dôvera

Každé kryptografické primitívum pochádza z crypto-for-laravel; každé rozhodnutie o dôvere zostáva v tomto balíku. Purchases sám nevolá žiadnu funkciu openssl_*:

Výnimky kryptografie sa na hranici každého poskytovateľa prekladajú na VerificationException, takže jeden catch pokryje všetky obchody. Pripnuté odtlačky Apple dokazujú len to, že notifikáciu podpísal Apple — ten týmto reťazcom podpisuje notifikácie všetkých aplikácií —, preto purchases každú navyše viaže na vašu aplikáciu: bundle id, prostredie a v produkcii Apple ID (pozrite Apple App Store).

Platnosť certifikátov Apple

Notifikácia App Store sa odmietne, keď je ktorýkoľvek certifikát v jej reťazci x5c — koncový, sprostredkujúci alebo koreňový — mimo svojho okna notBefore..notAfter. Tolerancia posunu hodín, uplatnená na oboch koncoch okna, vyrovná hodiny servera, ktoré mierne predbiehajú alebo meškajú:

// config/purchases.php
'settings' => [
    'apple' => [
        // Seconds, 0–3600. Default 60. Anything outside that range is a
        // misconfiguration and throws InvalidConfigurationException — a
        // fat-fingered value can never silently switch the check off.
        'certificate_clock_skew' => env('PURCHASES_APPLE_CERTIFICATE_CLOCK_SKEW', 60),
    ],
],

Odmietnutie má vlastnú správu s názvom certifikátu a okamihom, keď platnosť vypršala, takže expirovaný reťazec si nikdy nepomýlite so zlým podpisom:

RoundlyConsulting\Purchases\Exceptions\VerificationException:
Apple certificate [Apple Worldwide Developer Relations Certification Authority] expired at
2026-01-01T00:00:00+00:00; the notification's certificate chain is outside its validity period.

Opätovné overenie archivovaných notifikácií

Opätovné overenie archivovanej notifikácie Apple podpísanej medzičasom vymeneným, dnes už expirovaným certifikátom zlyhá — a to je správne, pretože expirovaný certifikát nič nedokazuje. certificate_clock_skew zvyšujte len kvôli posunu hodín; nie je to obdobie odkladu a jeho strop je jedna hodina. purchases:replay sa to netýka: výsledky obnovuje z auditných snapshotov, ktoré boli overené pri doručení.