LOGBREW_PROJECT_ID على UUID المشروع. واضبط LOGBREW_API_URL على
https://api.logbrew.co. تستخدم الأمثلة Bash وcurl بالإصدار 7.76.0 أو أحدث
وjq.
في التدوير المخطط له، أنشئ المفتاح البديل وانشره واختبره قبل أن تبطل المفتاح
القديم. حدّد في سياسة الأمان لديك عدد مرات التدوير. إذا كان للمفتاح تاريخ
انتهاء، فاستبدله قبل ذلك التاريخ.
1
أنشئ المفتاح البديل
يقبل لا تتابع إلا بعد نجاح الأمر. اضبط
POST /api/projects/{project_id}/ingest-keys قيمة label غير فارغة
بطول 120 حرفًا على الأكثر. قيمة kind هي cli أو sdk أو browser أو
server أو artifact. لا يستطيع مفتاح artifact إرسال بيانات القياس عن
بُعد. ويجب أن تكون قيمة expires_at الاختيارية وقتًا مستقبليًا بتنسيق
RFC3339.استخدم قيمة kind نفسها التي يستخدمها المفتاح القديم. يستخدم CLI القيمة
sdk عندما تحذف --kind، والقيمة CLI-created SDK key عندما تحذف
--label. لا يوجد في CLI خيار لتاريخ الانتهاء. لضبط expires_at، استخدم
API.يحفظ CLI الرمز المميز ذا الاستخدام الواحد في ملف جديد لا يصل إليه إلا مالكه،
خارج نظام التحكم في المصدر. ويطبع البيانات الوصفية، لا الرمز المميز:NEW_KEY_ID على قيمة ingest_key.id
المُعادة.إذا كانت النتيجة غير مؤكدة، فشغّل الأمر نفسه تمامًا مرة أخرى. يعيد CLI
استخدام مفتاح إعادة المحاولة المعلّق لديه. لا تستخدم --abandon-retry في
إعادة المحاولة هذه.يتلقى عميل API المباشر الرمز المميز مرة واحدة في الاستجابة. لإعادة
المحاولة، أرسل الترويسة Idempotency-Key نفسها مع النص نفسه. خلال 24 ساعة،
تعيد إعادة المحاولة هذه المفتاح نفسه. لا تطبع الرمز المميز أبدًا، ولا تضعه
في commit، ولا تشاركه.2
انشر المفتاح الجديد مع بقاء القديم نشطًا
ضع الرمز المميز الجديد في إعداد النشر المحمي. انشر التطبيق. أبقِ المفتاح
القديم نشطًا. أبقِ الرمزين المميزين كليهما خارج الشيفرة المصدرية ومخرجات
البناء والسجلات.
3
أرسل حدثًا اصطناعيًا واحدًا
حمّل الرمز المميز الجديد في متغير الصدفة لا تتابع إلا عندما تعيد القراءة هذا السجل بقيمة
new_ingest_key. لا تطبعه. أرسل
سجلًا اصطناعيًا واحدًا بالمفتاح الجديد، ثم اقرأه:occurred_at نفسها. سجل
فحص تدوير أقدم لا يثبت أن المفتاح الجديد يعمل. تأكد أيضًا من أن التطبيق
المنشور يرسل بيانات القياس عن بُعد. إذا فشل أمر، فتوقف واقرأ الاستجابة.
أبقِ المفتاح القديم نشطًا ما لم يكن مكشوفًا.4
اعرض البيانات الوصفية للمفاتيح دون أسرار
اضبط الاستجابة مصفوفة من البيانات الوصفية للمفاتيح دون رموز مميزة. الحالة هي
LOGBREW_ACCOUNT_BEARER من مصادقة حسابك. اعثر على معرّف المفتاح
القديم. تأكد من أن حالة NEW_KEY_ID هي active:active أو expired أو revoked. يصبح المفتاح expired عندما يمر
وقت expires_at الخاص به.5
أبطل المفتاح القديم فقط
اضبط الطلب
OLD_KEY_ID من القائمة. لا يبطل الأمر المفتاح القديم إلا عندما يختلف
المعرّفان:DELETE متساوي القوى (idempotent). يعيد البيانات الوصفية للمفتاح مع
status: "revoked" وضبط revoked_at. يمكنك تكراره بأمان بعد استجابة غير
مؤكدة.شغّل unset new_ingest_key. تعامل مع ملف المفتاح وفق سياسة الأسرار لديك.تعافَ بأمان
إذا استمر فشل التدوير، فأبلغ عن مشكلة. شارك
البيانات الوصفية للمفاتيح فقط. لا تضمّن بيانات الاعتماد أو الترويسات أو بيانات
القياس عن بُعد الخام أو بيانات العملاء أو المسارات المحلية أو الشيفرة المصدرية.
