أنشئ مفاتيح 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. تُخزَّن الأحرف الأربعة الأخيرة فقط كنص عادي.
ent_ وبصمة تجزئة، لذا فإن أي مفتاح لم يُنسخ هنا يُستبدل ولا يُسترجع أبدًا.أنشئ المفاتيح من صفحة مفاتيح 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.