مفاتيح API والنطاقات
في Guardrail Ledger نوع واحد من المفاتيح هو رمز الإدخال. وليس له نطاقات قابلة للضبط.
| المفتاح | الاستخدام | من يمكنه إدارته |
|---|---|---|
| رمز الإدخال | إرسال SARIF إلى /api/v1/ingest/sarif من مسار بناء. لا يمكنه قراءة النتائج ولا تغيير الإعدادات. | مالكو مساحة العمل ومسؤولوها |
التعامل مع الرموز
- أنشئ رمزًا في صفحة المسار. يظهر مرة واحدة ولا يُحتفظ إلا بتجزئته.
- خزّنه كمتغير سري. لا تضعه أبدًا في ملف داخل مستودع أو في لقطة شاشة.
- استخدم رمزًا واحدًا لكل مسار بناء، حتى تتمكن من إلغاء رمز دون المساس بالرموز الأخرى.
- يؤدي إلغاء الرمز إلى إيقاف الإدخال به فورًا. ألغِه عبر واجهة API باستخدام
DELETE /api/v1/tokens/<id>، مع تسجيل الدخول بصفة مالك أو مسؤول، ونوع محتوى JSON، وجسم JSON فارغ.
يُكتب كل إنشاء وإلغاء في سجل التدقيق مع اسم من قام به.