Gineadóir agus Fíoraitheoir JWT

Conas JWT sínithe a chruthú

1. Roghnaigh an t-Algartam: HS256/384/512 (rún comhroinnte), RS256/384/512 nó PS256/384/512 (RSA), ES256/384/512 (ECDSA ar P-256, P-384 nó P-521), nó EdDSA (Ed25519, nuair a thacaíonn do bhrabhsálaí leis).
2. Cuir an Ceanntásc (JSON) agus an Ábhar (éilimh JSON) in eagar. Leanann an réimse alg an algartam roghnaithe i gcónaí, agus is é JWT an luach réamhshocraithe ar typ.
3. Úsáid cnaipí na n-éileamh ama chun dátaí a chur leis: iat = anois, nbf = anois, nó roghnaigh moill ar nós “i gceann 1 uair” agus cliceáil Socraigh exp. Is NumericDates iad na luachanna: soicindí ón 1 Eanáir 1970 UTC.
4. Cuir isteach an Rún (algartaim HS, mar théacs nó Base64/Base64url faoi Formáid an rúin) nó an Eochair phríobháideach (PEM nó JWK). Níl eochair agat fós? Cliceáil Gin eochair thástála.
5. Cliceáil Sínigh an comhartha, ansin Cóipeáil an toradh nó cliceáil Fíoraigh an comhartha seo chun é a sheiceáil láithreach.

Conas JWT a fhíorú

1. Greamaigh an comhartha faoi Comhartha le fíorú.
2. Roghnaigh an Algartam ionchasach. Má fhágann tú ar “Ó cheanntásc an chomhartha (ná none riamh)” é, glactar le pé rud a deir an ceanntásc, ach amháin none; má roghnaíonn tú algartam ar leith, diúltaíonn an uirlis d’aon chomhartha a síníodh ar bhealach eile, mar ba cheart d’fhíor-fhreastalaí a dhéanamh.
3. Cuir isteach an rún, nó an Eochair phoiblí (PEM nó JWK): bloc PEM PUBLIC KEY, RSA PUBLIC KEY nó CERTIFICATE, JWK, nó Tacar JWK (úsáidtear an eochair a mheaitseálann kid an cheanntásc).
4. Más mian leat, socraigh Fad ama breise cloig (soicindí) chun bheith bog ar mhionmhíreanna cloig, ansin cliceáil Fíoraigh an comhartha.

Deir an toradh an bhfuil an síniú bailí, agus seiceálann sé ansin exp (am éaga) agus nbf (ní bhailí roimh) i gcomparáid le ham reatha do ríomhaire. Má tá síniú ceart ar chomhartha ach tá an t-am éaga san am atá caite, tuairiscítear mar chomhartha as feidhm é, ní mar chomhartha bailí.

Eochracha agus formáidí

Le haghaidh síniú, glacann an uirlis le bloic PRIVATE KEY PKCS#8, bloic RSA PRIVATE KEY PKCS#1 agus EC PRIVATE KEY SEC1 (iompaithe go PKCS#8 go hinmheánach), agus JWKanna príobháideacha. Ní mór eochracha atá cosanta ag focal faire a easpórtáil gan focal faire ar dtús. Cruthaíonn Gin eochair thástála rún randamach de mhéid an haise d’algartaim HS, péire eochracha RSA 2048-giotán d’RS agus PS, an cuar comhfhreagrach d’ES, nó péire Ed25519. Faigheann tú na heochracha mar PEM agus JWK, agus líontar isteach ar an dá thaobh iad ionas go n-oibríonn timthriall iomlán láithreach.

Leanann na sínithe RFC 7515 agus RFC 7518: úsáideann RSA-PSS salann chomh fada leis an hais, agus is é an comhcheangal amh r||s na sínithe ECDSA. Atáirgeann an cur i bhfeidhm sampla HS256 de RFC 7515, Aguisín A.1.

Nótaí slándála

• Ritheann gach rud i do bhrabhsálaí le API Web Crypto. Ní sheoltar na comharthaí ná na heochracha chuig áit ar bith, ach b’fhearr fós eochracha tástála a úsáid seachas rúin tháirgthe.
• Ní shínítear alg: none riamh agus ní ghlactar leis riamh.
• Ba cheart go mbeadh rúin HMAC chomh fada leis an hais ar a laghad (32 bheart do HS256). Cuireann rún níos giorra rabhadh ar bun.
• Cruthaíonn síniú sláine agus bunús, ní go bhfuil na héilimh oiriúnach: ní mór d’fhreastalaithe iss, aud agus na scóip a sheiceáil freisin.