Convertor PEM ↔ JWK
Intrare (PEM sau JWK / JWKS)
Ieșire
Detalii tehnice
Cum funcționează convertorul PEM în JWK
Ce face convertorul PEM ↔ JWK
Acest instrument convertește chei criptografice între PEM (text Base64 DER, folosit de OpenSSL, nginx și majoritatea serverelor) și JWK / JWKS (JSON Web Key, RFC 7517, folosit de JWT, OAuth 2.0 și OpenID Connect). Lipește o cheie publică PEM (SPKI), o cheie privată (PKCS#8), un certificat X.509, o cheie RSA PKCS#1 sau o cheie EC SEC1 și primești un JWK; lipește un JWK sau un document JWKS și primești un PEM. Direcția este detectată automat. Calculează și amprenta SHA-256 RFC 7638, modul standard de a obține un kid stabil. Toată procesarea se face local în browser.
Cazuri de utilizare frecvente
Utilizări tipice sunt publicarea unei chei publice la un endpoint /.well-known/jwks.json, configurarea unui furnizor de identitate sau a unui API gateway care așteaptă JWKS, transformarea unui certificat în JWK pentru verificarea semnăturilor JWT, generarea unui kid care corespunde cu cel calculat de alte biblioteci și convertirea unui JWK primit de la un furnizor într-un PEM pe care OpenSSL sau un server web îl poate citi. Este util și la depanarea validării token-urilor RS256, ES256 sau EdDSA.
Tipuri de chei și formate acceptate
Tipurile de chei acceptate sunt RSA (RS256, PS256, RSA-OAEP), chei de curbă eliptică pe P-256, P-384 și P-521 (ES256, ES384, ES512) și chei OKP: Ed25519 (EdDSA) și X25519 (ECDH-ES). Etichetele PEM acceptate sunt PUBLIC KEY, PRIVATE KEY, CERTIFICATE, RSA PUBLIC KEY, RSA PRIVATE KEY și EC PRIVATE KEY. Algoritmul este dedus din cheie și poate fi suprascris; membrii opționali use, alg și kid și un înveliș JWKS pot fi adăugați la ieșire.
Capcane și limite
Un JWK care conține membrul d (sau p, q, dp, dq, qi pentru RSA) este o cheie privată și nu trebuie publicat niciodată; folosește opțiunea doar cheia publică înainte de a pune o cheie într-un endpoint JWKS. Fișierele PEM criptate nu sunt acceptate, așa că decriptează-le mai întâi cu openssl. Amprenta kid se calculează doar din membrii publici, deci un JWK public și unul privat al aceleiași chei au același kid. Certificatele se convertesc doar în cheia publică: lanțul, subiectul și perioada de valabilitate nu sunt transferate în JWK.