--- title: "Refresh Tokens for Laravel — dokumentácia | Roundly" description: "Vývojárska dokumentácia Refresh Tokens for Laravel: hašované rotujúce refresh tokeny, detekcia zneužitia, relácie zariadení, vlastníci a udalosti." url: https://roundly-consulting.com/sk/open-source/navody/refresh-tokens-for-laravel language: sk --- [Všetky balíky](https://roundly-consulting.com/sk/open-source.md) Open source # Refresh Tokens for Laravel Inštalácia `composer require roundly-consulting/refresh-tokens-for-laravel` Vyžaduje: PHP ^8.4 · Laravel ^12.0|^13.0 [GitHub](https://github.com/roundly-consulting/refresh-tokens-for-laravel) [Packagist](https://packagist.org/packages/roundly-consulting/refresh-tokens-for-laravel) [Prispieť (otvorí sa v novej karte)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Patreon](https://www.patreon.com/cw/roundly) ## Prehľad Nepriehľadné rotujúce refresh tokeny a relácie zariadení pre Laravel. Tokeny sa ukladajú len ako SHA-256 odtlačky, rotujú sa jediným atomickým dopytom typu compare-and-swap, takže zo súbežných obnovení uspeje práve jedno, a opätovné predloženie už použitého tokenu automaticky odvolá celú jeho rodinu. Akýkoľvek Authenticatable model — používatelia, API klienti, administrátori — drží relácie v jednej polymorfnej tabuľke so stabilným ID relácie, údajmi o zariadení a odhlásením „všade“ jedným volaním. Licencia MIT, bez runtime závislostí tretích strán — len Laravel a vlastné balíky Roundly pre kryptografiu, enumy a toolkit. ### Čo získate #### Hašované v databáze Ukladá sa len SHA-256 odtlačok pod unikátnym indexom; plaintext dostanete raz. Voliteľne s HMAC pepperom. #### Atomická rotácia Jeden dopyt typu compare-and-swap: zo súbežných obnovení uspeje práve jedno — bez transakcie a bez zámku riadku. #### Detekcia opätovného použitia Opätovne predložený rotovaný token odvolá celú rodinu, zneplatní jej prístupové tokeny a spustí udalosť. Vždy zapnuté. #### Relácie zariadení Stabilné ID relácie pre každé prihlásenie, údaje o zariadení a polohe a odvolanie jednej, ostatných či všetkých relácií. #### Polymorfní vlastníci Používatelia, API klienti, administrátori — akýkoľvek Authenticatable model v jednej tabuľke, s obnovou obmedzenou na typ účtu. #### Posuvná aj absolútna životnosť Posuvné TTL pri každej rotácii plus pevný absolútny strop relácie, oboje nastaviteľné pre konkrétne prihlásenie. #### Fasáda, DI alebo akcie Jedna fasáda RefreshTokens nad injektovateľným manažérom a jednoúčelovými akciami, plus zaznamenávajúci fake, v ktorom každé volanie naozaj beží. ### Dokumentácia #### [Inštalácia](https://roundly-consulting.com/sk/open-source/navody/refresh-tokens-for-laravel/instalacia.md) Inštalácia cez Composer, publikovanie a spustenie migrácie a pridanie traitu HasRefreshTokens na každý model vlastníka. #### [Konfigurácia](https://roundly-consulting.com/sk/open-source/navody/refresh-tokens-for-laravel/konfiguracia.md) Každý kľúč, predvolená hodnota a env premenná — tabuľka, typ kľúča, životnosti, dĺžka tokenu, hašovanie, tolerancia rotácie a čistenie. #### [Vlastníci a typy kľúčov](https://roundly-consulting.com/sk/open-source/navody/refresh-tokens-for-laravel/vlastnici.md) Polymorfní vlastníci: používatelia, API klienti a administrátori v jednej tabuľke, oddelení morph triedou a kľúčom, s kľúčmi bigint, UUID či ULID. #### [Fasáda RefreshTokens](https://roundly-consulting.com/sk/open-source/navody/refresh-tokens-for-laravel/fasada.md) Celá fasáda RefreshTokens na jednom mieste — vydanie, uplatnenie, rotácia, odvolanie a čistenie plus objekty sessions() a session(). #### [DI a akcie](https://roundly-consulting.com/sk/open-source/navody/refresh-tokens-for-laravel/bez-fasady.md) Namiesto fasády injektujte RefreshTokensManager alebo spustite akciu za ktoroukoľvek metódou — vždy beží ten istý kód. #### [Vydávanie tokenov](https://roundly-consulting.com/sk/open-source/navody/refresh-tokens-for-laravel/vydavanie-tokenov.md) Vydajte refresh token prepojený s prístupovým tokenom cez IssueContext alebo fluentný builder; plaintext dostanete práve raz. #### [Uplatnenie a rotácia](https://roundly-consulting.com/sk/open-source/navody/refresh-tokens-for-laravel/rotacia.md) Atomicky uplatnite token s ochranou proti dvojitému použitiu, rotujte ho jedným volaním, obmedzte obnovu na typ vlastníka a ošetrite zlyhania. #### [Detekcia opätovného použitia](https://roundly-consulting.com/sk/open-source/navody/refresh-tokens-for-laravel/detekcia-opatovneho-pouzitia.md) Opätovne predložený rotovaný token odvolá celú rodinu, zneplatní jej prístupové tokeny a spustí RefreshTokenReuseDetected — vždy zapnuté. #### [Odvolanie a odhlásenie](https://roundly-consulting.com/sk/open-source/navody/refresh-tokens-for-laravel/odvolanie.md) Odhláste jeden token alebo všetky relácie, zaznamenajte dôvod cez RevocationReason a pri zmene hesla odvolajte všetko. #### [Relácie](https://roundly-consulting.com/sk/open-source/navody/refresh-tokens-for-laravel/relacie.md) Vypisujte, vyhľadávajte a odvolávajte relácie zariadení podľa stabilného ID rodiny — základ obrazovky „vaše zariadenia“. #### [Údaje o zariadení a polohe](https://roundly-consulting.com/sk/open-source/navody/refresh-tokens-for-laravel/obohatenie-relacii.md) Pripojte k relácii prehliadač, OS, typ zariadenia a polohu, ktoré spracovala aplikácia, cez enrich() — typicky z asynchrónneho jobu. #### [Odvolanie prístupových tokenov](https://roundly-consulting.com/sk/open-source/navody/refresh-tokens-for-laravel/odvolanie-pristupovych-tokenov.md) Zaregistrujte AccessTokenRevoker, aby každá odvolaná relácia či rodina zneplatnila aj svoj prístupový token, napr. cez denylist JWT jti. #### [Udalosti](https://roundly-consulting.com/sk/open-source/navody/refresh-tokens-for-laravel/udalosti.md) Štyri typované udalosti — vydanie, uplatnenie, odvolanie a detekcia zneužitia — len s ID a skalármi, nikdy s modelom či plaintextom. #### [Bezpečnosť a hašovanie](https://roundly-consulting.com/sk/open-source/navody/refresh-tokens-for-laravel/bezpecnost.md) SHA-256 odtlačky v databáze, voliteľný HMAC pepper, validovaná konfigurácia, bezpečná serializácia a hranice zodpovednosti aplikácie. #### [Model tokenu](https://roundly-consulting.com/sk/open-source/navody/refresh-tokens-for-laravel/model-tokenu.md) Scopes, pomocné metódy, casty a skryté atribúty modelu RefreshToken a náhrada vlastnou podtriedou. #### [Databázová schéma](https://roundly-consulting.com/sk/open-source/navody/refresh-tokens-for-laravel/databazova-schema.md) Stĺpce tabuľky refresh\_tokens a RefreshTokenBlueprint na zopakovanie či prevzatie schémy vo vlastnej migrácii. #### [Artisan príkazy](https://roundly-consulting.com/sk/open-source/navody/refresh-tokens-for-laravel/prikazy.md) Čistite mŕtve tokeny podľa vlastného plánu cez refresh-tokens:prune alebo pomenovaný model:prune a konfiguráciu skontrolujte cez about. #### [Výnimky](https://roundly-consulting.com/sk/open-source/navody/refresh-tokens-for-laravel/vynimky.md) Všetky typované výnimky balíka, kedy sa vyhadzujú a základná trieda, ktorou zachytíte všetky naraz. #### [Testovanie](https://roundly-consulting.com/sk/open-source/navody/refresh-tokens-for-laravel/testovanie.md) RefreshTokens::fake() zaznamená každé vydanie, uplatnenie, rotáciu, odvolanie, obohatenie aj čistenie; zvyšok pokryje FakeAccessTokenRevoker a factory. #### [Požiadavky](https://roundly-consulting.com/sk/open-source/navody/refresh-tokens-for-laravel/poziadavky.md) PHP 8.4+ a Laravel 12 alebo 13, bez runtime závislostí tretích strán. Sprievodné balíky Roundly sa nainštalujú automaticky. ## Prejavte lásku k open source Tento balík je zadarmo pod licenciou MIT. Ak vám šetrí čas, jednorazový príspevok alebo členstvo na Patreone nám pomôže ho ďalej udržiavať, testovať a dokumentovať. [Ďalšie spôsoby podpory vrátane kryptomien](https://roundly-consulting.com/sk/podporte-nas.md) Odoslaním daru súhlasíte s našimi [podmienkami prijímania darov](https://roundly-consulting.com/sk/podmienky-darov.md). [Podporte našu open-source prácu (otvorí sa v novej karte)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Pridajte sa k nám na Patreone (otvorí sa v novej karte)](https://www.patreon.com/cw/roundly) ## Chcete to zabudovať do svojho produktu? Naše balíky integrujeme do zákazkových Laravel a AI riešení. Napíšte nám, na čom pracujete, a ozveme sa do 48 hodín. [Ponuka do 48 hodín](https://roundly-consulting.com/sk/kontakt.md) [Prezrieť všetky balíky](https://roundly-consulting.com/sk/open-source.md)