أمثلة اختبار التوقيع

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

ما الذي هنا

يسرد الملف /vectors/index.json كل مثال بعنوانه وملفه، وللردود: هل يجب قبوله أم رفضه. ويذكر الفهرس نفسه الأجزاء الموقّعة في كل نوع من الاستدعاءات.

اختبار توقيع الاستدعاءات

يحمل كل مثال استدعاء: الاستدعاء (request)، ووقتَي التوقيع (signature.created وsignature.expires)، ومفتاح الاختبار (key)، وما يجب أن يخرج (expected).

1. ابنِ نصّ التوقيع من request.method وrequest.authority وrequest.path وrequest.canonicalQuery (الاستعلام دون علامة ?) وrequest.anisDate وrequest.nonce وrequest.idempotencyKey والمحتوى في request.bodyBase64، مع key.keyId معرّفًا للمفتاح.
2. قارن Content-Digest لديك بـ expected.contentDigest، وSignature-Input بـ expected.signatureInput، ونصّ التوقيع بـ expected.signatureBaseUtf8 — بايتًا ببايت.
3. وقّع نصّك بالمفتاح الخاص للاختبار (key.privateKeyPkcs8Base64) وتأكد أن key.publicJwk يتحقق منه. توقيع ECDSA يختلف في كل مرة، فقارن نصّ التوقيع لا بايتات التوقيع.

يعطي المثال RQ-03 اسم الخادم كما قد يكتبه المستدعي (request.authorityAsGiven) وكما يجب أن يُوقَّع (request.authority، بأحرف صغيرة). والمثال RQ-06 كشفٌ: بلا محتوى إطلاقًا، فبصمته بصمة صفر بايت.

اختبار التحقق من الردود

يحمل كل مثال ردّ: الردّ (response.status وresponse.headers وresponse.bodyBase64)، وSignature-Input الخاص بالاستدعاء الذي يجيب عنه (request.signatureInput)، ومفاتيح أنيس المنشورة في تلك اللحظة (signingKeys)، والوقت الذي تعتمده ساعةً لك (verifyAt، بثواني Unix — استخدمه لا الساعة الحقيقية).

يجب أن يصل فاحصك إلى expected.outcome: ‏accept أو reject. وعند الرفض يذكر expected.reason السبب؛ قد تختلف أسماء الأخطاء لديك، فطابق النتيجة واستعن بالسبب لفهم أي اختلاف. وsignatureBaseForDebugging هو النصّ الذي وقّعته أنيس.

تأتي معظم الردود في عائلات: ردّ يجب قبوله (RS-001-…) ونسخ معدَّلة منه (RS-001-…-M01 فما بعد) يجب رفض كلٍّ منها — بايت واحد تغيّر في المحتوى، أو بصمة أُعيدت كتابتها، أو توقيع بصيغة DER، أو جزء موقَّع ناقص، أو وقت خارج النافذة. وأخرى تختبر المفاتيح المنشورة: الردّ الموقَّع بالمفتاح التالي أو بالمفتاح المتقاعد يجب قبوله، ووثيقة المفاتيح التي تحمل عنصرًا خاصًا يجب رفضها كلها.

اختبار إثبات الحيازة

يعطي كل مثال تسجيل ما أرجعه إرسال المفتاح (keySubmissionResult) ومفتاح الاختبار (key).

1. ابنِ رسالة الإثبات من keySubmissionResult وقارنها بـ expected.proofMessageUtf8 — وبصمة التحدّي بـ expected.challengeHashHex.
2. وقّعها بمفتاح الاختبار؛ exampleSignature توقيع صحيح واحد، وkey.publicJwk يتحقق من الاثنين.
3. expected.proofRequest هو المحتوى الذي ترسله.

بعد اجتياز الأمثلة

استدعِ فحص توقيعك بمفتاحك الحقيقي. إنه يُجري كل فحص تُجريه أنيس على الاستدعاء الموقَّع، ويخبرك بما رأته أنيس، ولا يغيّر شيئًا.