فحص JWKS محلي

عارض JWKS وفاحص مفاتيح JWK

الصق مجموعة مفاتيح JSON Web Key Set أو مفتاح JWK واحدًا لترى لكل مفتاح قيمة kid ونوعه وخوارزميته وحجمه وبصمة RFC 7638. تنبّهك الأداة إلى المكوّنات الخاصة وقيم kid المفقودة أو المكررة ومفاتيح RSA الضعيفة، ثم تصدّر المفاتيح العامة بصيغة PEM داخل متصفحك.

كيف تعمل الأداة تقنياً

مجموعة مفاتيح JSON Web Key Set وفق RFC 7517 هي كائن JSON يحتوي مصفوفة "keys" تنشر المفاتيح العامة التي يستخدمها مزوّد الهوية لتوقيع رموزه، وغالبًا على المسار /.well-known/jwks.json. يصف كل JWK مفتاحًا واحدًا بحقول مثل kty (النوع) وkid (المعرّف) وalg وuse، إضافة إلى معاملات المفتاح: n وe في RSA، وcrv وx وy في EC، وx في OKP.

حين يستقبل واجهتك البرمجية رمز JWT فإنها تقرأ kid من ترويسته وتبحث عن المفتاح المطابق في المجموعة وتتحقق من التوقيع به. وهذا ما يجعل تدوير المفاتيح سهلًا: يضيف المزوّد مفتاحًا جديدًا بقيمة kid جديدة ويوقّع به، ويُبقي المفتاح القديم منشورًا حتى تنتهي صلاحية الرموز السابقة.

يحلّل هذا العارض ملف JSON الذي تلصقه ويعرض كل مفتاح ويحسب بصمة RFC 7638 ويبيّن الحجم الفعلي لمعامل RSA أو المنحنى في EC. وينبّه إلى المكوّنات الخاصة ومفاتيح oct المتماثلة وقيم kid المفقودة أو المكررة ومفاتيح RSA الضعيفة وعدم اتساق alg أو use. ولا يجلب أي رابط: تلصق المحتوى بنفسك ويبقى كل شيء داخل متصفحك.

شرح عملي خطوة بخطوة مع مثال حقيقي

افحص مجموعة المفاتيح قبل نشرها أو الوثوق بها:

1. الصق JWKS

الصق مجموعة كاملة أو مفتاح JWK واحدًا أو مصفوفة مفاتيح. يعرض زر المثال الصيغة المطلوبة. يُقبل حتى 100 مفتاح.

2. اقرأ بطاقة كل مفتاح

راجع kid وkty وalg وuse، ثم حجم RSA بالبت أو منحنى EC. وتمنح البصمة كل مفتاح معرّفًا ثابتًا يمكن مقارنته بين الأنظمة.

3. عالج التنبيهات

تعني الأخطاء الحمراء وجود مكوّن خاص أو مفتاح متماثل في المجموعة. وتشمل التحذيرات البرتقالية kid مفقودًا أو مكررًا وRSA ضعيفًا وخوارزميات غير متسقة.

4. صدّر المفاتيح العامة

انسخ مفتاح RSA أو EC عامًا بصيغة SPKI PEM للمكتبات التي لا تقرأ JWK. لا تُصدَّر المفاتيح الخاصة أبدًا.

مثال عملي: بصمة RFC 7638 القسم 3.1

صيغة JSON القياسية للمفتاح العام RSA (e وkty وn):{"e":"AQAB","kty":"RSA","n":"0vx7agoebGcQSuuPiLJXZptN9nndrQmbXEps2aiAFbWhM78LhWx4cbbfAAtVT86zwu1RK7aPFFxuhDR1L6tSoc_BJECPebWKRXjBZCiFV4n3oknjhMstn64tZ_2W-5JsGY4Hc5n9yBXArwl93lqt7_RN5w6Cf0h4QyQ5v-65YGjQR0_FDW2QvzqY368QQMicAtaSqzs8KJZgnYb9c7d0zgdAZHzu6qMQvRL5hajrn1n91CbOpbISD08qNLyrdkt-bFTWhAI4vMQFh6WeZu0fM4lFd2NcRwr3XPksINHaQ-G_xBniIqbw0Ls1jF44-csFCur-kEgU8awapJzKnqDKgw"}
بصمة SHA-256 (Base64URL):NzbLsXh8uDCcd-6MNwXF4W_7noWXFZAfHkxZsRGC9Xs

مفتاح 2048 بت في المواصفة ينتج هذه القيمة بالضبط وطولها 43 حرفًا. تُرتَّب الحقول أبجديًا دون مسافات، فتصل أي منصة صحيحة إلى البصمة نفسها.

الأخطاء الشائعة وتنبيهات الأمان

نشر JWK خاص

الحقول d وp وq خاصة. إن ظهرت في jwks.json أمكن لأي شخص تزوير الرموز. انشر المعاملات العامة فقط.

تكرار kid أو إغفاله

من دون kid فريد يضطر المتحقق إلى تجربة كل المفاتيح ويصبح التدوير تخمينًا. امنح كل مفتاح kid مميزًا، والأفضل أن يكون بصمته.

وضع مفتاح متماثل في مجموعة عامة

يحمل النوع oct سرًّا مشتركًا في الحقل k. يجب ألا يتضمنه JWKS عام أبدًا؛ شارك أسرار HMAC عبر قناة خاصة.

الوثوق بقيمة alg في الرمز

حدّد الخوارزمية المتوقعة لكل مفتاح. ترك القرار لترويسة الرمز يفتح الباب لهجوم الخلط بين الخوارزميات، مثل فحص HS256 بمفتاح RSA عام.

أنواع مفاتيح JWK وحقول بصمتها

ktyحقول البصمةالخوارزميات الشائعةآمن في JWKS عام
RSAe, kty, nRS256, PS256نعم، الأجزاء العامة فقط
ECcrv, kty, x, yES256, ES384, ES512نعم، الأجزاء العامة فقط
OKPcrv, kty, xEdDSAنعم، الأجزاء العامة فقط
octk, ktyHS256, HS384, HS512أبدًا

أمثلة برمجية (Node.js و Python و Java)

تحقق من الرموز مقابل JWKS في الخلفية:

Node.js (TypeScript)
import { createRemoteJWKSet, jwtVerify, calculateJwkThumbprint } from 'jose';
import type { JWK } from 'jose';

const JWKS = createRemoteJWKSet(new URL('https://auth.example.com/.well-known/jwks.json'));

export async function verify(token: string) {
  const { payload, protectedHeader } = await jwtVerify(token, JWKS, {
    issuer: 'https://auth.example.com',
    audience: 'my-api',
    algorithms: ['RS256'],
  });
  return { payload, kid: protectedHeader.kid };
}

export const thumbprint = (jwk: JWK) => calculateJwkThumbprint(jwk, 'sha256');
Python
import jwt  # PyJWT with the cryptography package
from jwt import PyJWKClient

client = PyJWKClient("https://auth.example.com/.well-known/jwks.json")

def verify(token: str) -> dict:
    signing_key = client.get_signing_key_from_jwt(token)
    return jwt.decode(
        token,
        signing_key.key,
        algorithms=["RS256"],
        audience="my-api",
        issuer="https://auth.example.com",
    )
Java
import com.nimbusds.jose.jwk.JWK;
import com.nimbusds.jose.jwk.JWKSet;
import com.nimbusds.jose.util.Base64URL;
import java.net.URL;

public class JwksInspect {
  public static void main(String[] args) throws Exception {
    JWKSet set = JWKSet.load(new URL("https://auth.example.com/.well-known/jwks.json"));
    for (JWK jwk : set.getKeys()) {
      Base64URL thumbprint = jwk.computeThumbprint();
      System.out.println(jwk.getKeyID() + " " + jwk.getKeyType() + " " + thumbprint);
    }
  }
}

الأسئلة الشائعة

ما الفرق بين JWK وJWKS؟

JWK هو مفتاح واحد مكتوب بصيغة JSON، أما JWKS فكائن يحتوي مصفوفة keys فيها مفتاح JWK أو أكثر، وفق RFC 7517.

ما بصمة JWK ولماذا تُستخدم؟

يعرّفها RFC 7638 بأنها تجزئة SHA-256 للحقول المطلوبة بصيغة JSON قياسية ثم ترميز Base64URL. وهي معرّف ثابت يصلح قيمةً لـ kid.

لماذا ينبّه العارض إلى الحقول الخاصة؟

المعاملات d وp وq وdp وdq وqi خاصة. وإذا كشفها JWKS منشور فبإمكان أي شخص توقيع رموز تقبلها واجهتك البرمجية.

هل تجلب الأداة ملف jwks.json من رابط؟

لا. تقرأ المحتوى الملصق فقط، فلا تتصل بخادمك وتتجنب مخاطر CORS والطلبات من جهة الخادم. افتح الرابط في تبويب وانسخ JSON.

ما الحجم المناسب لمفتاح RSA في JWKS؟

2048 بت على الأقل. يقيس العارض الطول الفعلي للمعامل من n وينبّه إذا قلّ عن ذلك، لأن المفاتيح الأقصر تُعدّ ضعيفة.

كيف أدوّر مفاتيح JWKS؟

أضف المفتاح الجديد بقيمة kid جديدة وابدأ التوقيع به، وأبقِ القديم منشورًا حتى تنتهي صلاحية كل الرموز التي وقّعها، ثم احذفه.

عن الكاتب

تطوّر Avada Labs أدوات مجانية للمطورين، من بينها هذا الموقع، بخبرة تمتد لست سنوات في تطوير الويب والأدوات البرمجية. المشاريع والشيفرة المصدرية متاحة على GitHub.

عارض JWKS وبصمة JWK – فحص مجموعات المفاتيح