POST/api/sso/:tenantSlug/saml/acs

اسرشن کنزیومر سروس (ACS): شناختی فراہم کنندہ کا دستخط شدہ SAML جواب فارم POST کے ذریعے وصول کرتا ہے۔

یہ اینڈ پوائنٹ صرف شناختی فراہم کنندہ کال کرتا ہے؛ اسے اس کی ترتیبات میں ACS URL کے طور پر درج ہونا چاہیے (`saml/metadata` دیکھیں)۔ شناختی فراہم کنندہ دستخط شدہ اور base64-انکوڈ شدہ جواب فارم فیلڈ `SAMLResponse` میں بھیجتا ہے۔ کامیابی کی صورت میں Zentor App براؤزر کو کوئری پیرامیٹر `sso_code` میں ایک بار کے کوڈ کے ساتھ ری ڈائریکٹ کرتا ہے؛ یہ کوڈ `POST /api/auth/sso/exchange` کے ذریعے ایکسیس ٹوکن سے بدلا جاتا ہے۔ اگر جواب غلط ہو یا متعلقہ لاگ ان کا عمل غائب ہو تو سرور کوئری پیرامیٹر `sso_error` کے ساتھ لاگ ان صفحے کی طرف ری ڈائریکٹ کرتا ہے، مثلاً `sso_error=SSO_STATE_MISSING`۔

جائزہ

کال: POST /api/sso/:tenantSlug/saml/acs۔ یہ اینڈپوائنٹ Zentor App کی API کے گروپ “ڈیمو چیٹ بوٹ اور SSO” سے تعلق رکھتا ہے۔ یہ عوامی طور پر قابلِ رسائی ہے اور اس کے لیے کسی تصدیق (authentication) کی ضرورت نہیں۔ یہ کال idempotent نہیں ہے: ہر کامیاب کال عمل کو دوبارہ متحرک کرتی ہے۔ لازمی پیرامیٹرز: tenantSlug (پاتھ), SAMLResponse (باڈی)۔ دستاویزی ایرر کیسز: 302 SSO_STATE_MISSING۔

تصدیقِ شناخت اور تحفظ

تصدیقِ شناخت ضروری نہیں

Idempotent (دہرانے پر یکساں اثر): نہیں

پیرامیٹرز

tenantSlug(path, string، ضروری)— اکاؤنٹ کی شناخت (Slug) جس کے لیے SSO سیٹ ہے
SAMLResponse(body, string، ضروری)— شناختی فراہم کنندہ کا دستخط شدہ SAML جواب (XML, base64-انکوڈ شدہ) فارم فیلڈ کے طور پر

مثالی Response

302 ری ڈائریکٹ https://zentor-app.de/login?sso_error=SSO_STATE_MISSING کی طرف (درست SAML جواب کے بغیر مثال)

خرابی کے کوڈز

302 SSO_STATE_MISSING — لاگ ان صفحے کی طرف `sso_error` کے ساتھ ری ڈائریکٹ، اگر SAML جواب غلط ہو یا متعلقہ لاگ ان کا عمل غائب ہو۔

تصدیق شدہ طرزِ عمل

غلط `SAMLResponse` لاگ ان صفحے کی طرف `sso_error` کے ساتھ ری ڈائریکٹ (302) کا باعث بنتا ہے۔

ڈیمو چیٹ بوٹ اور SSO

POST /api/global-chatbot/demozentor-app.de/demo پر عوامی ڈیمو چیٹ بوٹ کو پیغام بھیجتا ہے اور اس کا جواب واپس کرتا ہے۔ ڈیمو کو بغیر رجسٹریشن کے براؤزر میں آزمایا جا سکتا ہے۔GET /api/global-chatbot/demo/historyایک ڈیمو گفتگو کی سابقہ پیغامات کی تاریخ لوڈ کرتا ہے، تاکہ ڈیمو دوبارہ کھولنے پر یہ محفوظ رہے۔POST /api/global-chatbot/demo/pollایک ڈیمو گفتگو کے نئے پیغامات حاصل کرتا ہے، مثلاً جب Zentor کا کوئی رکن گفتگو سنبھال لے۔ ڈیمو صفحہ اس اینڈ پوائنٹ کو وقفوں سے کال کرتا ہے۔POST /api/global-chatbot/demo/ratingایک ڈیمو گفتگو کی درجہ بندی (مفید یا غیر مفید) اختیاری تبصرے کے ساتھ محفوظ کرتا ہے۔POST /api/global-chatbot/demo/trackZentor کے وزیٹر اعداد و شمار کے لیے ڈیمو صفحے کے گمنام استعمال کے واقعات ریکارڈ کرتا ہے۔POST /api/global-chatbot/demo/voice-transcribeڈیمو صفحے پر صوتی ریکارڈنگ کو متن میں تبدیل کرتا ہے (صوتی ان پٹ)، بشرطیکہ ڈیمو کی صوتی سہولت فعال ہو۔POST /api/global-chatbot/demo/voice-speakمتن کو بولی زبان میں تبدیل کرتا ہے (ڈیمو صفحے پر صوتی آؤٹ پٹ)، بشرطیکہ ڈیمو کی صوتی سہولت فعال ہو۔GET /api/sso/:tenantSlug/statusچیک کرتا ہے کہ کیا کسی اکاؤنٹ کے لیے سنگل سائن آن (SAML یا OIDC) سیٹ کیا گیا ہے۔ لاگ ان صفحہ نتیجہ استعمال کر کے SSO لاگ ان پیش کرتا ہے۔GET /api/sso/:tenantSlug/oidc/startOpenID Connect کے ذریعے لاگ ان شروع کرتا ہے اور براؤزر کو ترتیب شدہ شناختی فراہم کنندہ کی طرف بھیجتا ہے۔GET /api/sso/:tenantSlug/oidc/callbackOIDC لاگ ان کے بعد شناختی فراہم کنندہ کی ری ڈائریکٹ وصول کرتا ہے اور براؤزر کو Zentor App کی طرف واپس بھیجتا ہے۔GET /api/sso/:tenantSlug/saml/startSAML کے ذریعے لاگ ان شروع کرتا ہے اور براؤزر کو ترتیب شدہ شناختی فراہم کنندہ کی طرف بھیجتا ہے۔GET /api/sso/:tenantSlug/saml/metadataآپ کے شناختی فراہم کنندہ میں درآمد کرنے کے لیے Zentor App کا SAML میٹا ڈیٹا (XML) فراہم کرتا ہے۔

متعلقہ مضامین

← ڈیمو چیٹ بوٹ اور SSO