Skip to content
🚀 EDDI 6.5.0

19 مزود LLM، وقواعد معرفة تزحف إلى موقعك وتقرأ ملفاتك، ومحادثات تنتقل إلى إصدارات الوكيل المتوافقةما الجديد

السحابة المُدارة ابدأ الآن
كل التكاملات
الهوية والأمانOIDC

Keycloak / OIDC

ضع مصادقة OpenID Connect أمام EDDI عبر Keycloak أو أي مزوّد OIDC آخر، مع أدوار للمديرين والمحررين والمستخدمين والمشاهدين والمعتمِدين.

ما تحصل عليه

  • تسجيل دخول إلى Manager والواجهة البرمجية عبر مزوّد الهوية لديك
  • الأدوار: eddi-admin وeddi-editor وeddi-user وeddi-viewer وeddi-approver لقرارات الموافقة
  • نطاق eddi الجاهز (realm) الذي يستورده المثبّت إلى Keycloak
  • استدعاءات تُنفَّذ بصفة المستخدم المسجَّل، فيذكر مسار التدقيق شخصاً حقيقياً

كيف يعمل في EDDI

  1. شغّل المثبّت بالخيار --with-auth. يبدأ Keycloak ويستورد نطاق eddi عند أول إقلاع.
  2. اضبط كلمة مرور للمستخدم eddi في لوحة إدارة Keycloak. النطاق المرفق لا يحمل كلمة مرور.
  3. سجّل الدخول إلى Manager. امنح الأشخاص الأدوار التي يحتاجونها وأضف المعتمِدين إلى eddi-approver.
  4. مع مزوّد هوية قائم، اضبط متغيرات QUARKUS_OIDC_* (تفعيل المستأجر وعنوان خادم المصادقة ومعرّف العميل وسرّ العميل).
  5. في استدعاء HTTP، استخدم ${caller:token} لاستدعاء واجهة برمجية برمز المستخدم المسجَّل نفسه بدل بيانات اعتماد مشتركة واحدة.

الإعدادات

مأخوذة من وثائق EDDI. القيم النائبة مثل your-agent-id عليك استبدالها بقيمك.

Install with Keycloakخيار في المثبّت يضيف Keycloak.
bash install.sh --with-auth
Point EDDI at your identity providerمتغيرات البيئة لمزوّد OIDC خارجي، من وثائق EDDI.
docker run -d \
  -p 7070:7070 \
  -e MONGODB_CONNECTIONSTRING='mongodb://mongo:27017/eddi?retryWrites=true&w=majority' \
  -e QUARKUS_OIDC_TENANT_ENABLED=true \
  -e QUARKUS_OIDC_AUTH_SERVER_URL='https://keycloak.example.com/realms/eddi' \
  -e QUARKUS_OIDC_CLIENT_ID=eddi \
  -e QUARKUS_OIDC_CREDENTIALS_SECRET="$OIDC_CLIENT_SECRET" \
  labsai/eddi:6.4.0

الحوكمة

  • في وضع الإقلاع الإنتاجي يرفض EDDI العمل مع تعطيل OIDC ما لم تختر ذلك صراحة، فيكون ترك واجهة الإدارة مفتوحة قراراً لا حادثاً.
  • تتطلب نقاط الموافقة الدور eddi-approver، أو أن يكون المستخدم المالك أو eddi-admin.
  • مع ${caller:token} يسجّل مسار التدقيق المستخدم الحقيقي. أما بيانات اعتماد ثابتة مشتركة فتجمع كل الإجراءات في هوية واحدة.

من المفيد أن تعرف

  • المصادقة اختيارية ومطفأة افتراضياً. Keycloak هو ما يجهّزه المثبّت. تستخدم مزوّدات OIDC الأخرى الإعدادات نفسها، وبعض التفاصيل (مثل نقطة الرمز المعلَنة لـ A2A) تفترض مسارات Keycloak ما لم تضبطها.
  • استيراد النطاق المرفق يحدث مرة واحدة. التعديلات اللاحقة على ملف JSON لا تصل إلى Keycloak قيد التشغيل.

تكاملات ذات صلة

الإعدادات والسلوك في هذه الصفحة مبنيان على وثائق EDDI، وقد روجعا بتاريخ 2026-10-14. قد تتغير أسماء الحقول والقيم الافتراضية بين الإصدارات، فتأكد منها في وثائق إصدارك.