الانتقال إلى المحتوى الرئيسي
POST
تدوير مفتاح المصدر
ينشئ مفتاحًا بديلاً لمفتاح نشط وينتهي صلاحية المفتاح القديم تلقائيًا للإصدار الجديد. يبقى البديل في نفس المصدر والبيئة. استخدم kid الذي تم إرجاعه صراحةً في طلبات السك اللاحقة؛ لا يتم تحويل المتصلين بصمت إلى مفتاح آخر.

إنشاء بديل

يدعم التوليد المدار Ed25519 و ES256 و ES384 و RS256 و RS512 و PS256 و PS512. لاستيراد المفتاح العام، قم بتوفير kid و alg و public_key_b64url مع SubjectPublicKeyInfo المشفرة بـ DER كـ base64url غير مبطن. المواد العامة المستوردة وحدها لا يمكنها سك سجلات جديدة. راجع خوارزميات التوقيع.

السجلات الموجودة

يستخدم التحقق الطابع الزمني للإصدار المسجل. يمكن للسجلات الصادرة قبل تاريخ انتهاء صلاحية المفتاح القديم أن تجتاز التحقق من التوقيع بحمولتها الأصلية. يتم رفض المفتاح المخترق أو الملغى حتى للسجلات القديمة. لا يمكن استبدال الطوابع الزمنية الموثوقة المفقودة بتاريخ يوفره المتصل. يعيد النجاح HTTP 201 مع المفتاح البديل و rotated_from. لا يمكن تدوير المفتاح المتقاعد مرة أخرى. تستمر فحوصات انتهاء الصلاحية والإلغاء والتوقيع في التطبيق بشكل مستقل.

التفويضات

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

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

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

kid
string
مطلوب

الجسم

application/json
provider
enum<string>
مطلوب

ينشئ KMS مفتاح توقيع مخصصًا. يسجل DEV مواد التحقق العامة فقط.

الخيارات المتاحة:
KMS
alg
enum<string>

خوارزمية التوقيع المطابقة للمفتاح.

الخيارات المتاحة:
Ed25519,
ES256,
ES384,
ES512,
RS256,
RS384,
RS512,
PS256,
PS384,
PS512
kid
string
public_key_b64url
string

SubjectPublicKeyInfo بتنسيق DER base64url غير محشو؛ مطلوب للاستيراد، لا ترسل أبدًا مادة المفتاح الخاص.

الاستجابة

201 - application/json

تم تدوير المفتاح

kid
string

معرف المفتاح

issuer_id
string<uuid>
algorithm
enum<string>

خوارزمية التوقيع لتوليد المفتاح

الخيارات المتاحة:
Ed25519,
ES256,
ES384,
ES512,
RS256,
RS384,
RS512,
PS256,
PS384,
PS512
public_key
string

المفتاح العام المشفر بـ Base64

status
enum<string>
الخيارات المتاحة:
ACTIVE,
DISABLED,
EXPIRED
not_before
string<date-time>
expires_at
string<date-time>