Skip to main content
يستبدل التدوير مفتاح الاستيعاب الخاص بالمشروع. ولا يغيّر المشروع أو بيانات القياس عن بُعد المخزّنة فيه. أدر المفاتيح باستخدام مصادقة الحساب. يستطيع مفتاح الاستيعاب إرسال بيانات القياس عن بُعد فقط، ولا يستطيع إدارة المفاتيح. قبل أن تبدأ، ثبّت CLI وسجّل الدخول. اضبط 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. تعامل مع ملف المفتاح وفق سياسة الأسرار لديك.

تعافَ بأمان

إذا استمر فشل التدوير، فأبلغ عن مشكلة. شارك البيانات الوصفية للمفاتيح فقط. لا تضمّن بيانات الاعتماد أو الترويسات أو بيانات القياس عن بُعد الخام أو بيانات العملاء أو المسارات المحلية أو الشيفرة المصدرية.