Keycloak / OIDC

Keycloak या किसी अन्य OIDC प्रोवाइडर के ज़रिए EDDI के सामने OpenID Connect प्रमाणीकरण लगाएँ, एडमिन, एडिटर, यूज़र, व्यूअर और अनुमोदकों के लिए भूमिकाओं के साथ।

आपको क्या मिलता है

आपके आइडेंटिटी प्रोवाइडर के ज़रिए Manager और API में लॉगिन
भूमिकाएँ: eddi-admin, eddi-editor, eddi-user, eddi-viewer और अनुमोदन निर्णयों के लिए eddi-approver
तैयार eddi रेल्म, जिसे इंस्टॉलर Keycloak में इंपोर्ट करता है
साइन-इन उपयोगकर्ता के रूप में होने वाले कॉल, ताकि ऑडिट ट्रेल में असली व्यक्ति का नाम आए

EDDI में यह कैसे काम करता है

इंस्टॉलर को --with-auth के साथ चलाएँ। यह Keycloak शुरू करता है और पहले बूट पर eddi रेल्म इंपोर्ट करता है।
Keycloak एडमिन कंसोल में eddi यूज़र के लिए पासवर्ड सेट करें। साथ आए रेल्म में कोई पासवर्ड नहीं है।
Manager में साइन इन करें। लोगों को ज़रूरी भूमिकाएँ दें और अनुमोदकों को eddi-approver में जोड़ें।
मौजूदा आइडेंटिटी प्रोवाइडर के लिए QUARKUS_OIDC_* वेरिएबल सेट करें (टेनेंट enabled, auth server URL, क्लाइंट आईडी, क्लाइंट सीक्रेट)।
HTTP कॉल में ${caller:token} का उपयोग करें, ताकि एक साझा क्रेडेंशियल की जगह साइन-इन उपयोगकर्ता के अपने टोकन से API कॉल हो।

कॉन्फ़िगरेशन

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 बंद होने पर शुरू होने से इनकार करता है जब तक आप स्पष्ट रूप से ऑप्ट-आउट न करें, इसलिए खुला मैनेजमेंट API एक निर्णय है, दुर्घटना नहीं।
अनुमोदन एंडपॉइंट के लिए eddi-approver भूमिका चाहिए, या मालिक होना या eddi-admin होना।
${caller:token} के साथ ऑडिट ट्रेल असली यूज़र को दर्ज करता है। एक साझा स्थिर क्रेडेंशियल हर कार्रवाई को एक ही प्रिंसिपल में समेट देता।

जानने योग्य बातें

प्रमाणीकरण वैकल्पिक है और डिफ़ॉल्ट रूप से बंद। इंस्टॉलर Keycloak ही प्रोविज़न करता है। अन्य OIDC प्रोवाइडर वही सेटिंग इस्तेमाल करते हैं, और कुछ ब्योरे (जैसे A2A के लिए घोषित टोकन एंडपॉइंट) जब तक आप सेट न करें, Keycloak पाथ मान लेते हैं।
साथ आया रेल्म इंपोर्ट एक बार का है। JSON में बाद के बदलाव चल रहे Keycloak तक नहीं पहुँचते।

शुरू करें दस्तावेज़ ↗

सुविधाएँ

एंटरप्राइज़

मैनेज्ड क्लाउड और एंटरप्राइज़ सपोर्ट

संसाधन