ما تحصل عليه
- تسجيل دخول إلى Manager والواجهة البرمجية عبر مزوّد الهوية لديك
- الأدوار:
eddi-adminوeddi-editorوeddi-userوeddi-viewerوeddi-approverلقرارات الموافقة - نطاق
eddiالجاهز (realm) الذي يستورده المثبّت إلى Keycloak - استدعاءات تُنفَّذ بصفة المستخدم المسجَّل، فيذكر مسار التدقيق شخصاً حقيقياً
كيف يعمل في EDDI
- شغّل المثبّت بالخيار
--with-auth. يبدأ Keycloak ويستورد نطاقeddiعند أول إقلاع. - اضبط كلمة مرور للمستخدم
eddiفي لوحة إدارة Keycloak. النطاق المرفق لا يحمل كلمة مرور. - سجّل الدخول إلى Manager. امنح الأشخاص الأدوار التي يحتاجونها وأضف المعتمِدين إلى
eddi-approver. - مع مزوّد هوية قائم، اضبط متغيرات
QUARKUS_OIDC_*(تفعيل المستأجر وعنوان خادم المصادقة ومعرّف العميل وسرّ العميل). - في استدعاء HTTP، استخدم
${caller:token}لاستدعاء واجهة برمجية برمز المستخدم المسجَّل نفسه بدل بيانات اعتماد مشتركة واحدة.
الإعدادات
مأخوذة من وثائق EDDI. القيم النائبة مثل your-agent-id عليك استبدالها بقيمك.
bash install.sh --with-authdocker 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. قد تتغير أسماء الحقول والقيم الافتراضية بين الإصدارات، فتأكد منها في وثائق إصدارك.