ورود یکپارچه چیست
ورود یکپارچه (Single Sign-On یا SSO) یعنی یک بار وارد میشوید و همهی برنامههای یک مجموعه شما را میشناسند. هر برنامه گذرواژه یا کد ورود جداگانه ندارد؛ همه به یک سرور هویت مورد اعتماد تکیه میکنند.
نتیجه برای شما: یک حساب، یک جا برای امنیت (سطح، دومرحلهای، کدهای بازیابی) و یک دکمه برای خروج از همهجا.
OpenID Connect و OAuth 2.0
OAuth 2.0 استاندارد «اجازه دادن» است: برنامهای اجازه میگیرد از طرف شما به یک سرویس دسترسی داشته باشد، بیآنکه رمز شما را ببیند.
OpenID Connect لایهای روی OAuth 2.0 است که «شناختن» را استاندارد میکند: به برنامه میگوید شما چه کسی هستید، کی و با چه روشی وارد شدهاید. دسرو ربات یک سرور کامل OpenID Connect است.
سه نقش اصلی
- کاربر: شما، با مرورگر یا برنامهی موبایل.
- برنامهی کلاینت: هر برنامهی 23RO که میخواهد شما را بشناسد.
- سرور هویت: دسرو ربات، تنها جایی که شمارهی همراه و کدها بررسی میشوند.
ورود قدمبهقدم (کد مجوز با PKCE)
-
۱
برنامه شما را میفرستد
روی «ورود» میزنید؛ برنامه شما را با یک «درخواست مجوز» به دسرو ربات میفرستد. همراه آن یک رمز یکبارمصرف (PKCE) میسازد که فقط خودش میداند.
-
۲
سرور هویت شما را میشناسد
دسرو ربات شمارهی همراه و کد پیامکی را بررسی میکند. اگر تازه وارد شده باشید، این قدم بدون پرسش رد میشود؛ این همان ورود یکپارچه است.
-
۳
کد کوتاهعمر برمیگردد
مرورگر با یک «کد مجوز» یکبارمصرف به برنامه برمیگردد. این کد بهتنهایی ارزشی ندارد.
-
۴
برنامه کد را با توکن عوض میکند
سرور برنامه، مستقیم و بیرون از مرورگر، کد و رمز PKCE را به دسرو ربات میدهد و توکنها را میگیرد.
-
۵
برنامه توکن را خودش بررسی میکند
امضای توکن با کلید عمومی منتشرشده بررسی میشود؛ لازم نیست برنامه برای هر درخواست از دسرو ربات بپرسد.
سه توکن
| توکن | کار | عمر در دسرو ربات |
|---|---|---|
| توکن شناسه (ID Token) | به برنامه میگوید شما چه کسی هستید و چطور وارد شدید | کوتاه؛ فقط هنگام ورود |
| توکن دسترسی (Access Token) | با آن، برنامه به API خودش یا سرویسهای دیگر دسترسی میگیرد | چند دقیقه |
| توکن تمدید (Refresh Token) | بیآنکه دوباره وارد شوید، توکن دسترسی تازه میگیرد؛ با هر تمدید وضعیت حساب دوباره بررسی میشود | تا ۳۰ روز، چرخشی |
چرا امن است
- برنامهها هرگز کد پیامکی یا کد Authenticator شما را نمیبینند؛ فقط سرور هویت.
- توکنها امضا شدهاند و جعل نمیشوند؛ توکن دسترسی کوتاهعمر است.
- PKCE نمیگذارد کسی که کد مجوز را در راه برباید، از آن استفاده کند.
- اگر حساب غیرفعال شود یا نقشی گرفته شود، در اولین تمدید و با پیام خروج فوری اثر میکند.
سطح احراز هویت (acr)
دسرو ربات در ادعای acr میگوید ورود شما چقدر قوی است: از urn:23ro:loa:1 تا urn:23ro:loa:4. برنامهای که به اطمینان بیشتری نیاز دارد، سطح بالاتر میخواهد و شما فقط همان قدم اضافه را برمیدارید. سطحها در راهنمای کاربر
خروج
خروج از یک برنامه فقط همان برنامه را میبندد. خروج از دسرو ربات (یا «خروج از همهی دستگاهها» در حساب من) با پیام استاندارد «خروج پسزمینه» (Back-Channel Logout) به همهی برنامهها خبر میدهد تا نشست شما را ببندند.
واژهها
| واژه | انگلیسی | معنا |
|---|---|---|
| سرور هویت | Identity Provider (IdP) | سامانهای که کاربر را میشناسد و توکن صادر میکند؛ اینجا دسرو ربات. |
| برنامهی کلاینت | Client / Relying Party | برنامهای که به سرور هویت اعتماد میکند تا کاربر را بشناسد. |
| ادعا | Claim | یک تکه اطلاعات درون توکن، مثل شناسهی کاربر (sub)، نقشها (roles) یا سطح (acr). |
| دامنه | Scope | آنچه برنامه درخواست میکند، مثل openid، profile یا roles. |
| سند کشف | Discovery Document | فایل استاندارد با همهی نشانیها و کلیدهای سرور هویت. |
| PKCE | Proof Key for Code Exchange | رمز یکبارمصرفی که نمیگذارد کد دزدیدهشده به توکن تبدیل شود. |
توسعهدهندهاید؟ اتصال برنامه به دسرو ربات