Struttura u Funzjoni ta' JSON Web Token (JWT)
JSON Web Token (JWT) huwa standard miftuħ (RFC 7519) użat biex jittrasmetti informazzjoni b'mod sigur bejn żewġ partijiet bħala oġġett JSON. Din l-informazzjoni tista' tiġi vverifikata u fdata għaliex hija ffirmata b'mod diġitali. JWT tipikament jikkonsisti f'format kompatt magħmul minn tliet partijiet separati b'punti (.): il-header, il-payload, u l-firma.
Kull parti hija kkodifikata bl-użu ta' Base64URL, li huwa varjant ta' Base64 iddisinjat biex ikun sigur għall-użu fl-URLs billi jissostitwixxi karattri bħal + u / b'karattri oħra, u billi jneħħi l-padding =. Id-Dekodifikatur tal-JWT jippermetti li ddaħħal din is-sekwenza ta' karattri biex immedjatament tara l-kontenut oriġinali tagħha.
Il-Header tal-JWT
Il-header tipikament jikkonsisti f'żewġ partijiet: l-algoritmu tal-iffirmar li qed jintuża (bħal HS256 jew RS256) u t-tip ta' token, li normalment huwa "JWT". Dawn huma rrappreżentati mill-pretensjonijiet (claims) standard li ġejjin:
alg: L-algoritmu użat għall-iffirmar.typ: It-tip tat-token.
Il-Payload tal-JWT
Il-payload fih il-pretensjonijiet (claims), li huma dikjarazzjonijiet dwar entità (tipikament l-utent) u dejta addizzjonali. Hemm tliet tipi ta' claims: reġistrati, pubbliċi, u privati. Il-claims reġistrati huma sett ta' pretensjonijiet predefiniti li mhumiex obbligatorji iżda huma rrakkomandati biex jipprovdu metadata utli:
iat(Issued At): Il-ħin meta t-token ġie ġġenerat.exp(Expiration Time): Il-ħin meta t-token jieqaf milli jkun validu.
Kif Jaħdem id-Dekodifikatur tal-JWT
Meta ddaħħal string fit-test field tal-għodda, is-sistema tanalizza l-input abbażi ta' regoli speċifiċi ta' validazzjoni. L-għodda tidentifika n-numru ta' karattri fl-input u turi l-valur ħdejn il-label Karattri.
Regoli ta' Validazzjoni u Messaġġi ta' Żball
Biex l-għodda tkun tista' tipproċessa t-token, l-input irid isegwi l-istruttura standard tal-JWT. Jekk l-input ma jissodisfax il-kriterji, l-għodda taħbi l-oqsma ddekodifikati u turi wieħed mill-messaġġi ta' żball li ġejjin:
- Format mhux validu: Jekk l-input ma fihx tliet partijiet separati b'punti, l-għodda turi l-messaġġ: "Mhux JWT validu — mistennija tliet partijiet separati b'punti."
- Tul eċċessiv: Jekk l-input huwa twil wisq biex jitqies bħala token ġenwin, jidher il-messaġġ: "Dak huwa twil wisq biex ikun JWT reali."
- Żball fil-Base64URL tal-Header: Jekk il-header ma jistax jiġi ddekodifikat minħabba kodifikazzjoni ħażina, jidher il-messaġġ: "Ma setax jiġi ddekodifikat il-header — Base64URL invalidu."
- Żball fil-Base64URL tal-Payload: Jekk il-payload għandu kodifikazzjoni ħażina, jidher il-messaġġ: "Ma setax jiġi ddekodifikat il-payload — Base64URL invalidu."
- JSON tal-Header invalidu: Jekk il-header jiġi ddekodifikat iżda ma jkunx f'format JSON validu, jidher il-messaġġ: "Il-header mhuwiex JSON validu."
- JSON tal-Payload invalidu: Jekk il-payload iddekodifikat ma jkunx f'format JSON validu, jidher il-messaġġ: "Il-payload mhuwiex JSON validu."
Meta l-input ikun vojt, l-għodda tibqa' fi stat ta' "Lest. Pejstja JWT biex tiddekodifikah." Jekk tagħfas il-buttuna Ikklerja, l-input jitneħħa, jidher il-messaġġ "Ikklerjat.", u l-focus tal-cursor jirritorna immedjatament fuq il-qasam tal-input.
Id-Differenza bejn Dekodifikazzjoni u Verifika
Huwa kruċjali li tifhem id-differenza fundamentali bejn id-dekodifikazzjoni ta' JWT u l-verifika tiegħu.
| Karatteristika | Dekodifikazzjoni | Verifika |
|---|---|---|
| Għan | Tibdel il-format Base64URL lura għal test JSON li jista' jinqara. | Tikkonferma li t-token ma ġiex mibdul u li huwa fdat. |
| Rekwiżiti | Jeħtieġ biss is-string tat-token innifsu. | Jeħtieġ is-sigriet tal-iffirmar (signing secret) jew il-public key. |
| Sigurtà | Ma tipprovdi l-ebda garanzija li d-dejta hija awtentika. | Tiggarantixxi l-integrità u l-awtentiċità tad-dejta. |
Din l-għodda hija dekodifikatur biss. Hija ma tivverifikax il-firma tal-JWT u ma titlob qatt is-sigriet tal-iffirmar jew il-public key tiegħek. Għalhekk, l-analiżi tal-istatus tal-iskadenza ssir biss fuq il-bażi tal-pretensjoni exp li tinsab fil-payload, mingħajr ma tiġi vverifikata l-awtentiċità tal-firma nnifisha.
Proċessar Lokali u Privatezza tad-Dejta
Meta tuża din l-għodda, is-sigurtà tad-dejta tiegħek hija protetta permezz ta' proċessar lokali. It-token tiegħek jiġi ddekodifikat fil-browser tiegħek. Xejn ma jittella' fuq BroBroGo.
Peress li l-ebda informazzjoni ma tintbagħat fuq servers esterni, tista' tanalizza l-istruttura tat-tokens tiegħek b'mod kunfidenzjali direttament fil-browser tiegħek.
Mistoqsijiet Frekwenti (FAQ)
Huwa sigur li nippejstja l-JWT tiegħi hawn?
Iva. Id-dekodifikazzjoni ssir kompletament fil-browser tiegħek — it-token tiegħek qatt ma jintbagħat lil BroBroGo.
Din l-għodda tivverifika l-firma?
Le. Din l-għodda tiddekodifika biss il-header u l-payload biex tkun tista' taqrahom. Il-verifika ta' firma teħtieġ is-sigriet tal-iffirmar jew il-public key, li din l-għodda qatt ma titlob.
Kif inkun naf jekk it-token tiegħi skadiex?
Id-dekodifikatur jaqra l-claim exp u juri badge tal-istatus — validu, skadut, għadu mhux validu, jew l-ebda skadenza — ħdejn it-token iddekodifikat.
X'jiġri jekk it-token tiegħi ma jkollux claim ta' skadenza?
Jekk it-token ma jkollux claim exp fil-payload tiegħu, l-għodda turi l-istatus bħala "L-ebda skadenza".