أنشئ مفاتيح API للوصول البرمجي إلى Entity Enricher. استخدم مفاتيح وصول المؤسسة للتكامل بين الخدمات وخطوط أنابيب CI/CD وسير العمل الآلي.
يدعم Entity Enricher نوعين من مفاتيح API، يناسب كل منهما حالات استخدام مختلفة:
مفاتيح مستقلة لها دورها الخاص، غير مرتبطة بأي حساب مستخدم. الخيار الأمثل للتكامل بين الخدمات.
مفاتيح مرتبطة بحساب مستخدم محدد. ترث دور منشئها وتتأثر بتغييرات حساب المستخدم.
ent_a1b2c3d4e5f6g7h8تستخدم المفاتيح البادئة ent_ متبوعةً ببايتات عشوائية. ويُعرض المفتاح الكامل مرة واحدة فقط عند الإنشاء — إذ لا يمكن استرجاعه لاحقاً.
مفاتيح الوصول (لاستدعاء API الخاص بـ Entity Enricher) تُخزَّن كتجزئات SHA256 في قاعدة البيانات، لذا حتى مع الوصول إلى قاعدة البيانات، لا يمكن استعادة المفتاح الأصلي. تُخزَّن أول 12 حرفًا فقط (البادئة) كنص عادي لأغراض التعريف.
مفاتيح المزوّد (مفاتيح API الخاصة بالـ LLM مثل Anthropic وOpenAI) مشفَّرة أثناء التخزين باستخدام تشفير Fernet المتماثل (AES-128-CBC + HMAC). يجب أن تكون قابلة لفك التشفير أثناء التشغيل للمصادقة مع مزوّدي الـ LLM. تُخزَّن الأحرف الأربعة الأخيرة فقط كنص عادي.
أنشئ المفاتيح من صفحة مفاتيح API في التطبيق، أو برمجيًا عبر REST API:
| الحقل | الوصف |
|---|---|
| الاسم | اسم وصفي للتعريف (مثل "CI/CD Pipeline"، "n8n Integration") |
| الدور | مستوى الإذن: مالك، أو محرّر، أو مُشغّل. يحدّد ما يمكن للمفتاح الوصول إليه. |
| النطاقات | قراءة أو كتابة أو كلاهما. يتحكم في ما إذا كان بإمكان المفتاح تعديل البيانات أم قراءتها فقط. |
| انتهاء الصلاحية | تاريخ انتهاء اختياري. تظل المفاتيح بدون تاريخ انتهاء صالحة حتى إلغائها. |
أرسل مفتاح API الخاص بك في ترويسة X-API-Key مع كل طلب:
curl -H "X-API-Key: ent_your_key_here" \
https://your-instance.example.com/api/enrichment/options| الطريقة | الترويسة | حالة الاستخدام |
|---|---|---|
| مفتاح API | X-API-Key: ent_... | من خدمة إلى خدمة، CI/CD، الأتمتة |
| رمز Bearer | Authorization: Bearer <jwt> | عملاء الويب، الجلسات التفاعلية |
| OAuth 2.1 | Authorization: Bearer <access_token> | الموصّلات وعملاء الذكاء الاصطناعي — تفويض قابل للإلغاء لكل تطبيق، لا مفتاح مشترك |
يحدد دور مفتاح API نقاط النهاية التي يمكنه الوصول إليها:
| فئة نقطة النهاية | الحد الأدنى للدور |
|---|---|
| الإثراء (فردي، دُفعة) | مُشغِّل |
| السجلات (عرض، تفاصيل، حذف) | مُشغِّل |
| المخطط (قراءة) | مُشغِّل |
| المخطط (إنشاء، تحرير، حذف) | المحرّر |
| الدمج | مُشغِّل |
| معلومات المزوّد | مُشغِّل |
| تحليلات التكلفة | مُشغِّل |
| إدارة مفاتيح API | المالك |
| إدارة المستخدمين | المالك |
توفر صفحة مفاتيح API عرضًا كاملاً لجميع مفاتيح المؤسسة مع إحصاءات الاستخدام:
تضم صفحة مفاتيح API خمس علامات تبويب تخدم أغراضًا مختلفة:
مفاتيح API لمزوّد LLM الخاص بمؤسستك (Anthropic، OpenAI، إلخ) للفوترة المستقلة. يدعم مفاتيح متعددة لكل مزوّد مع تدوير LRU تلقائي. راجع النماذج والأسعار لنظام BYOK.
تُشفَّر مفاتيح المزوّد أثناء التخزين باستخدام تشفير Fernet المتماثل (AES-128-CBC مع مصادقة HMAC). ولا تُفكّ تشفيرها إلا أثناء التشغيل عند إجراء نداءات API الخاصة بـ LLM. ولا تُخزَّن سوى آخر 4 أحرف بنصّ صريح لأغراض العرض.
مفاتيح مزوّدي LLM على مستوى النظام يديرها المسؤولون. تُستخدم كبديل احتياطي عند عدم توفّر مفتاح خاص بالمؤسسة. تدعم عدة مفاتيح لكل مزوّد مع تناوب LRU: المفتاح المفعَّل الأقدم استخدامًا يأتي دوره تاليًا، ولا يخرج مفتاح من التناوب إلا عندما يعطّله أحد المسؤولين يدويًا.
مفاتيح للوصول إلى API الخاص بـ Entity Enricher. تستخدمها الأنظمة الخارجية لاستدعاء نقاط نهاية الإثراء والمخطط والسجلات وغيرها برمجياً. راجع مرجع API للاطلاع على توثيق نقاط النهاية.
التطبيقات التي منحتها إذنًا عبر OAuth 2.1 — دليل موصّلات claude.ai، وClaude Desktop، واتصالات Make وn8n. كل صف هو تفويض قابل للإلغاء لا سرٌّ مشترك: إلغاؤه هنا يُبطل رموز ذلك التطبيق دون المساس ببقية تكاملاتك. كما يمكن للمالكين تسجيل عميل OAuth لمثيل n8n مستضاف ذاتيًا.
بيانات اعتماد نفق Ollama ذاتي الخدمة، الذي يتيح للمنصة الوصول إلى Ollama محلي دون فتح أي منفذ. راجع دليل نفق Ollama.