مرجع API · تسجيل المفتاح

إرسال مفتاح عام

POST/v1/enrollments/{invitationId}/keys

يرسل النصف العام من مفتاح P-256 جديد، ويتلقى التحدّي لإثبات أنك تملك النصف الخاص.

الصلاحيةلا شيء

المصادقةرمز التسجيل

حدود الموظفين التي يُحتسب ضمنهالا شيء

حزمة SDK لـ ‎.NETenrollment.SubmitKeyAsync(request)

احفظ المفتاح الخاص قبل هذا الاستدعاء: الدعوة الواحدة تأخذ مفتاحًا واحدًا بالضبط.

المعاملات

الاسم	الموضع	النوع	ملاحظات
`invitationId`إلزامي	`path`	UUID	معرّف UUID بأحرف صغيرة مع الشرطات.

مُصرَّح به عبر Authorization: Enrollment <token>؛ غير موقَّع.

الترويسات: Accept-Language (اختياري). تضبطها حزم SDK كلها نيابةً عنك.

المحتوى: EnrollmentKeyRequest، بصيغة JSON.

الحقل	النوع	ملاحظات
`publicJwk`إلزامي	PublicJwk	النصف العام فقط من مفتاح P-256 جديد. العنصر الخاص يُرفض.
`notBefore`إلزامي	string (date-time)	يُستخدم طول النافذة فقط (حتى `expiresAt`) — ويبقى بين يوم واحد وسنتين افتراضيًا — ويبدأ حين يفعّل موظفو أنيس المفتاح.
`expiresAt`إلزامي	string (date-time)	نهاية مدة الصلاحية التي تطلبها. انظر `notBefore`.
`cidrs`	list of string	الشبكات التي ستستدعي منها، مقترحةً ليؤكّدها موظفو أنيس.

الحالة	المعنى	المحتوى
200	نجاح.	EnrollmentKeyResult
401	مرفوض: لم تتم المصادقة.	مشكلة
404	مرفوض: غير موجود، أو ليس لك.	مشكلة
409	مرفوض: يتعارض مع الحالة الحالية.	مشكلة
422	مرفوض: الاستدعاء يخالف قاعدة.	مشكلة
429	مرفوض: بلغتَ حدًا.	مشكلة
503	لا قرار: خدمة مطلوبة غير متاحة.	مشكلة

كل ردّ موقَّع من أنيس؛ وتتحقق منه حزم SDK قبل أن يصلك.

كل رفض مشكلةٌ موقَّعة. ابنِ منطقك على رمزها code؛ وكلٌّ منها يرتبط بصفحة تشرح معناه وما عليك فعله.

الحقل	النوع	ملاحظات
`publicJwk`إلزامي	PublicJwk	النصف العام فقط من مفتاح P-256 جديد. العنصر الخاص يُرفض.
`notBefore`إلزامي	string (date-time)	يُستخدم طول النافذة فقط (حتى `expiresAt`) — ويبقى بين يوم واحد وسنتين افتراضيًا — ويبدأ حين يفعّل موظفو أنيس المفتاح.
`expiresAt`إلزامي	string (date-time)	نهاية مدة الصلاحية التي تطلبها. انظر `notBefore`.
`cidrs`	list of string	الشبكات التي ستستدعي منها، مقترحةً ليؤكّدها موظفو أنيس.

الحقل	النوع	ملاحظات
`kty`إلزامي	string	دائمًا `EC`. القيم: `EC`
`crv`إلزامي	string	دائمًا `P-256`. القيم: `P-256`
`x`إلزامي	string	الإحداثي x للمفتاح: 32 بايت بالضبط، بترميز base64url دون حشو.
`y`إلزامي	string	الإحداثي y للمفتاح: 32 بايت بالضبط، بترميز base64url دون حشو.
`kid`	string	في مفاتيح التوقيع لدى أنيس: المفتاح الذي يذكره توقيع الرد. تعامل معه كاسم مبهم. لا يُرسل حين ترسل مفتاحك أنت.
`use`	string	الاستخدام المقصود، حين يُنشر.
`alg`	string	الخوارزمية، حين تُنشر.

الحقل	النوع	ملاحظات
`keyId`موجود دائمًا	UUID	معرّف مفتاحك: وهو `keyid` الذي سيحمله كل توقيع بعد أن يصبح المفتاح فعّالًا.
`thumbprint`موجود دائمًا	string	بصمة المفتاح. أعطها لموظفي أنيس عبر القناة المتّفق عليها؛ فهم يؤكّدون المفتاح بها.
`challenge`موجود دائمًا	string	التحدّي الذي يجيب عنه إثباتك. لا يُرجَع إلا هنا: احتفظ به حتى يُقبل الإثبات.
`challengeGeneration`	integer	رقم هذا التحدّي؛ وإعادة بدء التسجيل تصدر التحدّي التالي.