الانتقال إلى المحتوى الرئيسي
POST
استبدال الإثبات
ينشئ إشهادًا جديدًا يحل محل إشهاد موجود. يتم وضع علامة على الإشهاد الأصلي على أنه SUPERSEDED مع إشارة إلى الإصدار الجديد. يتم توقيع الإشهاد الجديد بالمفتاح المحدد، وتسجيله في سجل الشفافية، وإعادته جنبًا إلى جنب مع الإشهاد الأصلي المحدث. يظل كلا الإشهادين قابلين للتحقق، مما ينشئ سلسلة قابلة للتدقيق من إصدارات الاعتماد. يمكن استبدال إشهادات VALID فقط — إشهادات REVOKED أو الإشهادات التي تم SUPERSEDED بالفعل تُرجع 409 Conflict.

كيف يعمل

1

استدعاء supersede بمعرف التصديق الأصلي

قدم UUID للشهادة المراد استبدالها كمعامل مسار، بالإضافة إلى الحمولة الجديدة ومفتاح التوقيع.
2

الإثبات الأصلي تم وضع علامة "مستبدل"

تتغير حالة التصديق الأصلي إلى SUPERSEDED مع طابع زمني ومرجع إلى معرف التصديق الجديد.
3

تم إنشاء شهادة جديدة بحالة صالحة

يتم سك شهادة جديدة مع الحمولة المحدثة، موقعة بالمفتاح المحدد، ومسجلة في سجل الشفافية.
4

كلاهما تم إرجاعه في الاستجابة

يتضمن الرد كلاً من كائنات التصديق القديمة (التي تم إبطالها) والجديدة (الصالحة) تحت مفتاحي old و new.

حالات الاستخدام الشائعة

الاستجابات

عمليات الاستبدال متطابقة عند استخدام نفس Idempotency-Key. إعادة محاولة طلب فاشل بنفس المفتاح آمنة ولن تنشئ إثباتات مكررة.
يبقى التصديق الأصلي في سجل الشفافية ويمكن التحقق منه. تتغير حالته إلى SUPERSEDED ولكن يتم الحفاظ على الإثبات التشفيري. يمكن للمتحققين تتبع سلسلة الإحلال الكاملة باتباع حقل superseded_by_attestation_id.

التفويضات

X-API-Key
string
header
مطلوب

مفتاح API للمصادقة من جهاز إلى جهاز

الترويسات

Idempotency-Key
string
مطلوب

معلمات المسار

id
string<uuid>
مطلوب

الجسم

application/json
alg
string
مطلوب
kid
string
مطلوب
payload_b64url
string
مطلوب

الاستجابة

201 - application/json

تم إنشاء إثبات جديد

id
string<uuid>
issuer_id
string<uuid>
kid
string
status
enum<string>
الخيارات المتاحة:
VALID,
REVOKED,
SUPERSEDED
payload
object
signature
string
log_index
integer
created_at
string<date-time>