POST/api/auth/sso/exchange
SSO لاگ ان (SAML/OIDC) کا آخری مرحلہ: ری ڈائریکٹ سے ایک بار استعمال ہونے والے کوڈ کو ایکسیس ٹوکن اور ریفریش ٹوکن سے بدلتا ہے۔
آئیڈینٹیٹی پرووائیڈر پر لاگ ان کے بعد، Zentor App براؤزر کو کوئری پیرامیٹر `sso_code` میں ایک بار استعمال ہونے والے کوڈ کے ساتھ واپس بھیجتی ہے۔ یہ کوڈ `code` فیلڈ میں بھیجیں۔ جواب میں معمول کے لاگ ان کی طرح `token` اور `refreshToken` شامل ہے۔ ہر کوڈ صرف ایک بار اور صرف مختصر وقت کے لیے درست ہے۔ پہلے سے استعمال شدہ، میعاد ختم یا غلط کوڈ 400 `SSO_EXCHANGE_INVALID` کا سبب بنتا ہے؛ صارف پھر SSO لاگ ان دوبارہ شروع کرتا ہے۔ اس لیے یہ کال idempotent نہیں ہے۔
جائزہ
کال: POST /api/auth/sso/exchange۔ یہ اینڈپوائنٹ Zentor App کی API کے گروپ “توثیق” سے تعلق رکھتا ہے۔ یہ عوامی طور پر قابلِ رسائی ہے اور اس کے لیے کسی تصدیق (authentication) کی ضرورت نہیں۔ یہ کال idempotent نہیں ہے: ہر کامیاب کال عمل کو دوبارہ متحرک کرتی ہے۔ لازمی پیرامیٹرز: code (باڈی)۔ دستاویزی ایرر کیسز: 400 SSO_EXCHANGE_INVALID۔ نیچے دیا گیا نمونہ جواب JSON فارمیٹ میں کامیاب جواب کی ساخت دکھاتا ہے۔
تصدیقِ شناخت اور تحفظ
تصدیقِ شناخت ضروری نہیں
Idempotent (دہرانے پر یکساں اثر): نہیں
پیرامیٹرز
code(body, string، ضروری)— SSO ری ڈائریکٹ سے ایک بار استعمال ہونے والا کوڈمثالی Request
{"code":"<SSO کال بیک ری ڈائریکٹ سے حاصل کردہ یک بارہ کوڈ>"}مثالی Response
{"ok":true,"token":"<JWT>","refreshToken":"<Refresh-Token>"}خرابی کے کوڈز
400 SSO_EXCHANGE_INVALID — کوڈ غلط، پہلے سے استعمال شدہ یا میعاد ختم ہے۔تصدیق شدہ طرزِ عمل
غلط کوڈ 400 `SSO_EXCHANGE_INVALID` واپس کرتا ہے۔ کامیابی کا کیس کنفیگرڈ آئیڈینٹیٹی پرووائیڈر پر مکمل لاگ ان کو فرض کرتا ہے۔
توثیق
POST /api/auth/loginای میل ایڈریس یا یوزرنیم اور پاس ورڈ کے ساتھ صارف کو لاگ ان کرتا ہے اور ایک ایکسیس ٹوکن (JWT) اور ایک ریفریش ٹوکن جاری کرتا ہے۔POST /api/auth/refreshایک درست ریفریش ٹوکن کو ایکسیس ٹوکن اور ریفریش ٹوکن کے نئے جوڑے سے بدلتا ہے۔POST /api/auth/forgot-passwordپاس ورڈ ری سیٹ شروع کرتا ہے: اگر دی گئی ای میل ایڈریس سے کوئی اکاؤنٹ موجود ہو تو اسے ری سیٹ لنک کے ساتھ ایک ای میل ملتی ہے۔POST /api/auth/reset-passwordپاس ورڈ ری سیٹ ای میل سے ری سیٹ ٹوکن کے ساتھ ایک نیا پاس ورڈ سیٹ کرتا ہے۔