الانتقال إلى المحتوى الرئيسي
POST
تسجيل مفتاح
ينشئ مفتاحًا مُدارًا أو يسجل مادة مفتاح عام للمصدر المحدد بواسطة معلمة المسار id.

التوقيع المدار

استخدم provider: "KMS" وalg المطلوب. يدعم التوليد المدار Ed25519, ES256, ES384, RS256, RS512, PS256 and PS512. راجع algorithm support and encoding. استخدم kid الذي تم إنشاؤه والذي تم إرجاعه في الاستجابة؛ لا يتم الاحتفاظ بمعرف مفتاح مطلوب عشوائي في هذا الوضع.
يعتمد توفر الخوارزمية على المزود المنشور. اسم الخوارزمية وحده لا يثبت الامتثال لمعيار صناعي أو حكومي.

تسجيل المفتاح العام

يتطلب وضع الاستيراد kid و alg و public_key_b64url. algorithm و public_key ليسا بديلين. قم بترميز بايتات المفتاح العام DER SubjectPublicKeyInfo كـ base64url غير مبطن. تسجيل مفتاح عام لا يوفر مفتاحه الخاص، وهو غير كافٍ بحد ذاته لسك العملات من جانب الخادم. لا ترسل أبدًا مادة المفتاح الخاص في هذا الطلب. يتضمن الرد issuer_id، kid، alg، public_key_b64url، provider، وcreated_at. تأكد من توفر التوقيع قبل السك.

التفويضات

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

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

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

id
string<uuid>
مطلوب

الجسم

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

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

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

يجب أن يتطابق مع المفتاح العام. يدعم التوليد المدار الخوارزميات السبع المذكورة أعلاه؛ الافتراضي هو Ed25519.

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

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

الاستجابة

تم تسجيل المفتاح

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>