مفاتيح API

تتحكم مفاتيح API بمن وما يمكنه الوصول إلى خادم Failproof AI Observability، بحيث يمكن لأداة جمع البيانات إرسال الأحداث دون الحصول على صلاحيات القراءة أو الإدارة. يحمل كل مفتاح واحداً أو أكثر من الصلاحيات، وكل صلاحية تتحكم في مسارات خادم محددة؛ فأنت تمنح فقط ما تحتاجه المهمة. تنشئ معظم عمليات النشر ثلاثة أنواع من المفاتيح فقط.

المفاتيح الثلاثة التي تحتاجها معظم عمليات النشر

المفتاح	الصلاحيات	من يستخدمه
مفتاح جامع البيانات	`events:add`	`agenteye-collector` على كل جهاز وكيل، لإرسال الأحداث.
مفتاح قراءة لوحة التحكم	`events:read`, `keys:read`	عامل تشغيل أو تكامل يقرأ فقط يستعلم عن البيانات دون تغييرها.
مفتاح إدارة التمهيد	جميع الصلاحيات	عامل التشغيل الذي يبدأ المثيل أولاً (ولوحة التحكم). يتم تغذيته من متغير البيئة `ADMIN_KEY`. راجع مفتاح إدارة التمهيد.

ابدأ هنا. استخدم قائمة الصلاحيات الكاملة أدناه فقط عندما تحتاج إلى مفتاح مخصص أقل نطاقاً. راجع أيضاً تخطيط المفتاح الموصى به وإنشاء المفاتيح.

الصلاحيات

يفرض الخادم قائمة ثابتة من الصلاحيات؛ تتحكم كل واحدة في مسارات HTTP محددة. يحمل مفتاح الإدارة جميعها؛ يحمل المفتاح ذو النطاق المحدد المجموعة الفرعية التي تمنحها عند الإنشاء. يتم رفض سلاسل الصلاحيات غير المعروفة عند إنشاء مفتاح.

ملاحظة: صلاحيتان صحيحتان مخصصتان للعاملين البشريين/لوحة التحكم فقط ولا يمكن منحهما لمفتاح API: orgs:admin (إدارة المثيل، وهي حصرية للعاملين) وkeys:update. يتم رفض الطلب إلى POST /keys أو PATCH /keys/:id الذي يحاول منح أي منهما برمز HTTP 422. راجع صف keys:update أدناه لمعرفة السبب في أن مفتاح الحامل قد ينشئ مفاتيح لكن لا يمكنه تعديلها.

بث الأحداث والاستعلام عنها

الصلاحية	مسارات HTTP	ما تسمح به
`events:add`	`POST /events`	بث دفعات من الأحداث من جامع البيانات. الصلاحية الوحيدة التي يحتاجها جامع البيانات.
`events:read`	`GET /events`, `GET /events/latency_aggregate`, `GET /events/environments`, `GET /events/models`, `GET /sessions/:session_id/export`	الاستعلام عن الأحداث، وإدراج البيئات المعروفة، وإدراج معرفات النموذج المرئية في البيانات (تستخدمها عرض النماذج ومرشحات النموذج)، وحساب إجمالي الكمون الذي يقوي خريطة الحرارة / نطاق النسب المئوية، وتصدير جلسة عمل كـ JSONL. تكون نقاط نهاية facet شريط التصفية المشترك `GET /events/environments` و`GET /events/agent_ids` قابلة للوصول باستخدام `events:read` أو `evaluations:read`، بحيث تعيد صفحة الجلسات (المحدودة `evaluations:read`) استخدام نفس facet لكل منظمة. `GET /events/models` ليست واحدة منها: تتطلب `events:read`، لذا فإن المبدأ الذي يحتفظ بـ `evaluations:read` فقط يحصل على 403 منها.

الجلسات والتقييمات

الصلاحية	مسارات HTTP	ما تسمح به
`evaluations:read`	`GET /sessions`, `GET /evaluations`, `GET /evaluations/aggregate`, `GET /evaluations/environments`, `GET /evaluation-jobs`	إدراج الجلسات، وقراءة نتائج التقييم، وصحة التقييم المجمعة التي تستخدمها لوحات التحكم، وحالة قائمة انتظار عمل التقييم.
`evaluations:trigger`	`POST /sessions/:session_id/re-evaluate`	إعادة تقييم يدوية لجلسة منتهية.

لوحات التحكم

الصلاحية	مسارات HTTP	ما تسمح به
`dashboards:read`	`GET /dashboards`, `GET /dashboards/:id`, `GET /dashboards/:id/tiles`	إدراج لوحات التحكم، وتحميل واحدة، وقراءة بلاطاتها.
`dashboards:write`	`POST /dashboards`, `PUT /dashboards/:id`, `POST /dashboards/:id/tiles`, `PUT /dashboards/:id/tiles/:tile_id`, `DELETE /dashboards/:id/tiles/:tile_id`, `PUT /dashboards/:id/tiles/layout`	إنشاء وتعديل لوحات التحكم، وإضافة / تعديل / إزالة البلاطات، وإعادة ترتيب شبكة البلاطات.
`dashboards:delete`	`DELETE /dashboards/:id`	حذف لوحة تحكم بالكامل (حذف على مستوى البلاطة موجود تحت `dashboards:write`).

الاستعلامات المحفوظة (محرر SQL)

الصلاحية	مسارات HTTP	ما تسمح به
`queries:read`	`GET /queries`, `GET /queries/:id`, `GET /queries/schema`	إدراج الاستعلامات المحفوظة، وتحميل واحد، وفحص المخطط المقروء فقط الذي يستهدفه محرر الاستعلام.
`queries:write`	`POST /queries`, `PUT /queries/:id`	إنشاء وتعديل الاستعلامات المحفوظة. لا يزال SQL يتم توجيهه من خلال نفس الدور المقروء فقط والتحقق من SQL المحمي كما هو الحال في استدعاء `queries:run`.
`queries:delete`	`DELETE /queries/:id`	حذف استعلام محفوظ.
`queries:run`	`POST /queries/run`	تنفيذ استعلامات SQL محفوظة أو مرتجلة ضد الدور المقروء فقط الذي يستخدمه محرر الاستعلام.

مساعد ذكي

الصلاحية	مسارات HTTP	ما تسمح به
`agent:use`	`GET /agent/conversations`, `POST /agent/conversations`, `GET /agent/conversations/:id`, `PATCH /agent/conversations/:id`, `DELETE /agent/conversations/:id`, `PUT /agent/conversations/:id/messages`	التحدث إلى المساعد الذكي وإدارة محادثاتك الخاصة (الخاصة). مطلوب على المستخدم لرؤية لوحة المساعد؛ مفتاح المساعد نفسه هو `dashboard-assistant` ويتم تغذيته بشكل منفصل (انظر أدناه).

الصلاحية	مسارات HTTP	ما تسمح به
`keys:create`	`POST /keys`	إنشاء مفتاح API جديد محدد النطاق. لا يمنح **تعديل صلاحيات مفتاح موجود (هذا هو `keys:update`).
`keys:read`	`GET /keys`	إدراج المفاتيح الموجودة. لا يتم إرجاع الأسرار من قبل هذا الجانب.
`keys:update`	`PATCH /keys/:id`	تعديل صلاحيات مفتاح موجود. صلاحية حصرية للعاملين البشريين/لوحة التحكم؛ لا يمكن تعيينها لمفتاح API (قد يقوم مفتاح الحامل بإنشاء مفاتيح لكن لا يمكنه تعديلها).
`keys:disable`	`POST /keys/:id/disable`	إلغاء مفتاح. لا يمكن تعطيل المفاتيح المحمية (`admin`, `dashboard-assistant`); قم بتدويرها عبر متغير البيئة + إعادة تشغيل.
`keys:regenerate`	`POST /keys/:id/regenerate`	تدوير سر المفتاح. لا يمكن إعادة إنشاء المفاتيح المحمية من خلال هذا الجانب.

مستخدمو لوحة التحكم

الصلاحية	مسارات HTTP	ما تسمح به
`users:create`	`POST /users`, `GET /users/defaults`	دعوة مستخدم لوحة تحكم جديد (إصدار رمز بريد + رمز لمرة واحدة (OTP) تسجيل دخول) وقراءة مجموعة الصلاحيات الافتراضية المكونة بلوحة التحكم المستخدمة لتمرير نموذج الدعوة.
`users:read`	`GET /users`, `GET /users/:id`	إدراج المستخدمين وتحميل سجل مستخدم واحد.
`users:update`	`PUT /users/:id`	تعديل صلاحيات المستخدم. تُرسل التحديثات رسالة بريد تغيير الصلاحيات للمستخدم المتأثر وتصبح سارية عند طلبهم التالي؛ لا يلزم إعادة تسجيل الدخول.
`users:delete`	`DELETE /users/:id`, `POST /users/:id/enable`	تعطيل مستخدم (إلغاء جلساته على الفور) وإعادة تفعيل مستخدم تم تعطيله سابقاً.

تدعم هذه الصلاحيات صفحة لوحة التحكم المستخدمون، حيث يتم عرض النطاقات الممنوحة لكل عضو كرقائق:

صفحة المستخدمون: بطاقة لكل مستخدم لوحة تحكم مع بريده الإلكتروني والصلاحيات الممنوحة والتحكم في التعديل/التعطيل

الإعدادات التشغيلية

الصلاحية	مسارات HTTP	ما تسمح به
`settings:read`	`GET /settings`, `GET /settings/schema`, `GET /settings/model-context-windows`, `GET /settings/model-context-windows/resolve`	عرض الإعدادات التشغيلية المدارة بلوحة التحكم وبيانات التعريف الخاصة بها؛ إدراج تجاوزات نافذة السياق حسب النموذج؛ وحل النافذة الفعالة للنموذج.
`settings:write`	`PUT /settings/:key`, `PUT /settings/model-context-windows`, `DELETE /settings/model-context-windows`	تعديل الإعدادات التشغيلية وإضافة أو تغيير أو إزالة تجاوزات نافذة السياق حسب النموذج. تؤثر التغييرات على الأحداث الجديدة دون إعادة تشغيل الخادم.

صفحة الإعدادات: إعدادات تشغيلية مدارة بلوحة التحكم مثل عمليات تسجيل الدخول المسموحة وأعمار الجلسات / OTP، قابلة للتعديل دون إعادة تشغيل

التنبيهات والحوادث

الصلاحية	مسارات HTTP	ما تسمح به
`alerts:read`	`GET /alerts`, `GET /alerts/:id`	عرض تعريفات التنبيهات المكونة.
`alerts:write`	`POST /alerts`, `PUT /alerts/:id`, `DELETE /alerts/:id`, `POST /alerts/:id/test`	إنشاء وتعديل وحذف وتشغيل تنبيهات تجريبية.
`incidents:read`	`GET /alerts/incidents`, `GET /alerts/incidents/:iid`, `GET /alerts/incidents/:iid/comments`, `GET /alerts/incidents/:iid/subscribers`	عرض الحوادث وأثر الفحص الخاص بها.
`incidents:write`	`POST /alerts/:id/incidents`	فتح حادثة يدوية ضد تنبيه موجود.
`incidents:ack`	`POST /alerts/incidents/:iid/ack`, `POST /alerts/incidents/:iid/assign`, `POST /alerts/incidents/:iid/resolve`, `POST /alerts/incidents/:iid/comments`, `POST /alerts/incidents/:iid/subscribe`, `POST /alerts/incidents/:iid/unsubscribe`	الإقرار بالحوادث وتعيينها وحلها والتعليق عليها.

التدقيقات

الصلاحية	مسارات HTTP	ما تسمح به
`audits:read`	`GET /audits`, `GET /audits/:id`, `GET /audits/:id/runs`, `GET /audits/findings`, `GET /audits/findings/:fid`	عرض تعريفات التدقيق وسجل التشغيل والنتائج.
`audits:write`	`POST /audits`, `PUT /audits/:id`, `DELETE /audits/:id`, `POST /audits/:id/run`, `POST /audits/findings/:fid/status`	إنشاء وتعديل وحذف وتشغيل التدقيقات؛ فحص النتائج (إقرار / كتم صوت / رفض / حل / إعادة فتح / تعيين).

ملاحظة: لإعطاء مفتاح سطح التدقيق، امنح audits:* بشكل صريح. راجع ملاحظات الترقية والتوافق للخلف لمعرفة كيف تمت ترقية المستفيدين الموجودين عند شحن التدقيقات.

نقطة نهاية منتقي المستقبل GET /alerts/recipients (التي تسرد رسائل بريد الأعضاء التي يمكن لمحرر التنبيهات إخطارهم) قابلة للوصول من قبل صاحب إما alerts:read أو alerts:write، لذا يمكن لمحررات التنبيهات ملء المنتقي دون منح users:read.

مشاهد لوحة التحكم يحتاج كل من dashboards:read (لتحميل العروض المحفوظة) وevaluations:read (يتم حساب مقاييس الصحة من بيانات التقييم). امنح dashboards:write للسماح للمستخدم بإنشاء أو تعديل لوحات التحكم، وdashboards:delete لإزالتها.

/health و/auth/* (طلب OTP، التحقق من OTP، فحص الجلسة، تسجيل الخروج) غير معاثة بالتصميم؛ إنها تدفق تسجيل الدخول واختبار الحيوية. GET /access-granters يتطلب مفتاحاً صحيحاً لكن لا توجد صلاحية محددة، بحيث يمكن لأي مستخدم مسجل دخول أن يرى الإداريين الذين يجب الاتصال بهم بخصوص تغييرات الوصول.

مجموعات الصلاحيات

تتيح لك مجموعات الصلاحيات تطبيق دور محدد اسم بدلاً من انتقاء رموز فردية يدوياً في كل مرة. بدلاً من تحديد عشرات الصلاحيات واحدة تلو الأخرى لكل مستخدم جديد لوحة تحكم أو مفتاح API، تختار مجموعة، ويحمل كل شخص معين لها منحة متسقة وقابلة للمراجعة. يؤدي تعديل مجموعة مخصصة إلى إعادة تطبيق المنحة الجديدة على كل مستخدم معين لها بالفعل، بحيث يكون تغيير الدور تعديلاً واحداً بدلاً من مسح عبر كل عضو. يتم تغذية كل منظمة بثلاث مجموعات مدمجة:

المجموعة	الصلاحيات	المقصود ل
`read-only`	`events:read`, `keys:read`, `users:read`, `evaluations:read`, `dashboards:read`, `queries:read`, `settings:read`, `alerts:read`, `audits:read`, `incidents:read`	وصول العرض فقط عبر كل سطح تشغيلي.
`standard`	كل شيء في `read-only`، بالإضافة إلى `evaluations:trigger`, `queries:run`, `incidents:ack`, `agent:use`	قراءة فقط بالإضافة إلى إجراءات في الوقت المناسب اليومية: تشغيل الاستعلامات وإعادة تقييم الجلسات والإقرار بالحوادث واستخدام المساعد الذكي.
`admin`	كل صلاحية قابلة للتعيين	التحكم الكامل بالمنظمة.

المجموعات المدمجة الثلاث غير قابلة للتغيير؛ أسماؤها تعني دائماً نفس الشيء، لذا فإن read-only وstandard وadmin آمنة للرجوع إليها في السياسة والتمهيد. يمكن لعامل التشغيل إنشاء مجموعات مخصصة إضافية لنمذجة أدوار محددة لمنظمتك (على سبيل المثال، دور “مؤلف لوحة التحكم” أو دور “جامع البيانات فقط”). يتم عرض المجموعات في لوحة التحكم وإدارتها عبر API في GET /permission-sets (الإدراج، المحدود بـ users:read) وPOST /permission-sets / PUT /permission-sets/:name / DELETE /permission-sets/:name (إنشاء وتعديل وحذف مجموعة مخصصة، المحدودة بـ settings:write). يتم رفض حذف أو تعديل مجموعة مدمجة. عضوية المجموعة هي ما يدعم ميزتين أخريين:

DEFAULT_USER_PERMISSIONS (المنحة المحددة مسبقاً عندما يفتح المسؤول + مستخدم جديد) تقتصر على مجموعة standard.
الحد --set على agenteye-orgctl (إدارة أعضاء المشغل) يبدأ عضواً من مجموعة محددة، والتي يمكنك بعد ذلك ضبطها بدقة باستخدام --add / --remove.

ملاحظة: عندما تتضمن مجموعة صلاحية غير قابلة لتعيين المفاتيح (على سبيل المثال مجموعة مخصصة تحمل keys:update)، يسقط تغذية مفتاح من تلك المجموعة الرموز غير القابلة للتعيين؛ سيتم رفض الخادم المفتاح برمز HTTP 422. مستخدمو لوحة التحكم ليسوا خاضعين لهذا القيد.

مفتاح إدارة التمهيد

مفتاح الإدارة هو بيانات اعتماد جذر واحدة تسمح لعامل التشغيل بإحضار الوصول من لا شيء: باستخدامه يمكنك صك كل مفتاح محدود النطاق آخر، ودعوة أول مستخدمي لوحة تحكم، وتكوين المثيل قبل وجود أي مفتاح آخر. إنه المفتاح الوحيد الذي لا تقوم بإنشاؤه من خلال مفاتيح API؛ يتم توفيره من البيئة بحيث يكون الخادم قابلاً للوصول عند بدء التشغيل الأول. اضبط متغير البيئة ADMIN_KEY على الخادم. في كل بدء تشغيل، يقوم الخادم بـ upsert هذه القيمة كمفتاح إدارة مع جميع الصلاحيات. للتدوير: غيّر ADMIN_KEY إلى سر جديد وأعد تشغيل الخادم.

نطاق المنظمة

يتم إنشاء المنظمات وإدارتها خارج النطاق من قبل عامل التشغيل، وليس من خلال API المفاتيح هذا. دورة حياة المنظمة والعضو (إنشاء / إعادة تسمية / حذف / تنظيف منظمة؛ إضافة / تحديث / إزالة عضو) يتم بـ agenteye-orgctl CLI؛ لا توجد واجهة HTTP API أو زر لوحة تحكم لذلك. ما لم يتغير: يتم سك مفاتيح API لكل منظمة في لوحة التحكم (أو عبر API المفاتيح هذا) من قبل أعضاء المنظمة. في نشر متعدد المنظمات، يملك كل مفتاح ينشئه عضو المنظمة (من خلال API المفاتيح هذا أو صفحة لوحة التحكم المفاتيح) منظمة واحدة ولا يمكنه أبداً قراءة أو كتابة بيانات تلك المنظمة فقط؛ يتم وضع الختم على المنظمة على المفتاح عند الإنشاء وتطبيقه على كل طلب. الاستثناء الوحيد هو المفاتيح الاستهلاكية الاثنان: مفتاح admin (المحدثة من ADMIN_KEY) ومفتاح dashboard-assistant (المحدثة من AGENT_API_KEY) هما نطاق المثيل (لا يحملان أي منظمة). تتحقق لوحة التحكم مع مفتاح admin بحيث يمكنها توكيل الطلبات لكل منظمة نيابة عن الأعضاء المسجلين. لا تحتاج عمليات النشر للتأجير الواحد إلى التفكير في هذا؛ جميع المفاتيح تابعة للمنظمة المدمجة default.

إنشاء المفاتيح

استخدم مفتاح الإدارة (أو أي مفتاح به صلاحية keys:create) لإنشاء مفاتيح محدودة النطاق إضافية.

مفتاح جامع البيانات (البث فقط)

curl -s -X POST http://your-server/keys \
  -H "Authorization: Bearer $ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "prod-collector",
    "key": "your-collector-secret",
    "permissions": ["events:add"]
  }'

مفتاح لوحة التحكم (قراءة فقط)

curl -s -X POST http://your-server/keys \
  -H "Authorization: Bearer $ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "dashboard",
    "key": "your-dashboard-secret",
    "permissions": ["events:read", "keys:read"]
  }'

عند إنشاء مفتاح عبر HTTP API، تقدم قيمة key بنفسك؛ اختر سراً قوياً وخزّنه بأمان. (لوحة التحكم تعمل بالطريقة الأخرى: فهي تنتج سراً قوياً لك وتعرضه مرة واحدة عند الإنشاء؛ انظر إدارة المفاتيح في لوحة التحكم.) يؤكد الرد أنه تم إنشاء المفتاح:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "prod-collector",
  "permissions": ["events:add"],
  "created_at": "2026-04-01T12:00:00Z"
}

إدراج المفاتيح

curl -s http://your-server/keys \
  -H "Authorization: Bearer $ADMIN_KEY"

لا يتم إرجاع أسرار المفاتيح في استجابات الإدراج، فقط المعرفات والأسماء والصلاحيات.

تعطيل مفتاح

يؤدي التعطيل إلى إلغاء الوصول على الفور دون حذف سجل المفتاح.

curl -s -X POST http://your-server/keys/<id>/disable \
  -H "Authorization: Bearer $ADMIN_KEY"

إعادة إنشاء مفتاح

ينتج سراً جديداً لمفتاح موجود. يتم إلغاء السر القديم على الفور.

curl -s -X POST http://your-server/keys/<id>/regenerate \
  -H "Authorization: Bearer $ADMIN_KEY"

تتضمن الاستجابة السر الجديد بنص عادي، معروض مرة واحدة فقط.

إدارة المفاتيح في لوحة التحكم

توفر صفحة المفاتيح في لوحة التحكم واجهة مستخدم لجميع العمليات المذكورة أعلاه. تحتاج مفتاح به صلاحية keys:read لعرض القائمة، وkeys:create / keys:update / keys:disable / keys:regenerate لإجراءات الإنشاء / التعديل / التعطيل / إعادة الإنشاء على التوالي. يختلف تعديل صلاحيات المفتاح (keys:update) عن إنشاء واحد (keys:create)، بحيث يمكنك منح عامل تشغيل القدرة على سك مفاتيح دون القدرة على إعادة تحديد نطاق الموجودة، أو العكس. يغطي مفتاح الإدارة كل هذه. عند إنشاء مفتاح من لوحة التحكم لا تقدم السر؛ تنتج لوحة التحكم سراً قوياً لك وتعرضه مرة واحدة عند الإنشاء. انسخه فوراً وخزّنه بأمان؛ لا يتم عرضه أبداً مرة أخرى، تماماً كما هو الحال مع إعادة الإنشاء. لا يزال بإمكانك انتقاء صلاحيات المفتاح مباشرة، أو تغذيتها من مجموعة صلاحيات (انظر أدناه).

صفحة مفاتيح API: بطاقة لكل مفتاح توضح اسمه والصلاحيات الممنوحة ووقت الإنشاء، مع إجراءات إعادة الإنشاء والتعطيل؛ يتم وضع علامة على المفاتيح المحمية مثل admin

تخطيط المفتاح الموصى به

المفتاح	الصلاحيات	يستخدمه
`admin` (التمهيد عبر متغير بيئة `ADMIN_KEY`)	الكل	العمليات / الإعداد، ولوحة التحكم (المصادقة باستخدام `ADMIN_KEY`، توكيل طلبات المستخدم مع فحوصات الصلاحية)
مفتاح جامع البيانات لكل مضيف	`events:add`	جامع البيانات على كل جهاز وكيل
`dashboard-assistant` (التمهيد عبر متغير بيئة `AGENT_API_KEY`)	`events:read`, `evaluations:read`, `dashboards:read`, `dashboards:write`, `queries:read`, `queries:write`, `queries:run`	المساعد الذكي، المحدثة تلقائياً، محمي؛ لا يمكن تعديله من خلال API
مفتاح قياس مساعد (اختياري)	`events:add`	قياس ذاتي للمساعد الذكي، إن تم تفعيله

ملاحظة: يتم تغذية مفتاح المساعد تلقائياً من قبل الخادم من متغير بيئة AGENT_API_KEY (نفس السر الذي يقدمه الوكيل باسم AGENTEYE_API_KEY); لا يوجد خطوة سك مفاتيح يدويّة ولا مفتاح إدارة متورط. تم إصلاح صلاحياته في كود المصدر بحيث لا يمكن توسيع النطاق من خلال سوء التكوين: قراءة عبر الأحداث / التقييمات / لوحات التحكم، بالإضافة إلى dashboards-write و queries-read / write / run لتدفق الإنشاء من قبل استخدام “اطلب من AI كتابة استعلام”. لا يزال كل SQL يمر عبر نفس الدور المقروء فقط والمسار SQL المحمي كما هو الحال مع الاستعلام المكتوب من قبل المستخدم، لذا فإن هذا يوسع سطح الإنشاء، وليس سطح البيانات؛ تبقى العمليات المدمّرة (queries:delete, dashboards:delete) عن قصد بعيداً عن مفتاح المساعد. مثل مفتاح admin، فهو محمي: لا يمكن تعطيله أو إعادة إنشاؤه من خلال API المفاتيح، فقط تدويره بتغيير AGENT_API_KEY وإعادة تشغيل. مستخدمو لوحة التحكم بالإضافة إلى يحتاجون إلى صلاحية agent:use لرؤية واستخدام المساعد. إذا قمت بتفعيل قياس ذاتي، امنح المساعد مفتاحاً منفصلاً events:add فقط.

ملاحظات الترقية والتوافق للخلف

أنت بحاجة فقط إلى هذه إذا كنت ترقي مثيلاً موجوداً؛ يمكن لعمليات النشر الجديدة تخطيها.

عند شحن التدقيقات، تمت توسيع المستفيدين الموجودين على طول نفس أشكال الأدوار مثل التنبيهات: اكتسب كل مستخدم ومجموعة صلاحيات تحمل alerts:read على audits:read، واكتسب كل صاحب alerts:write على audits:write. لم يتم توسيع مفاتيح API الموجودة. امنح audits:* لمفتاح بشكل صريح إذا كان يحتاج إلى سطح التدقيق.

يتم تحليل مانحات الرموز الموروثة لـ alerts:ack كـ incidents:ack بحيث يحتفظ في الوقت المناسب بالوصول دون إعادة صك. لم يعد الرمز قابلاً للتعيين من محرر مستخدمي لوحة التحكم؛ تقدم المصفوفة incidents:ack بدلاً من ذلك.

الخطوات التالية

Python SDK: كيفية مصادقة كود الوكيل عند إرسال الأحداث.
الأمان: كيف يعمل تسجيل الدخول والتحكم في الوصول وعزل البيانات لكل منظمة.

Overview

Features

SDK and CLI

Administration