دسرو ربات

سامانه

استاندارد

OpenID Connect چیست؟

استاندارد جهانی که دسرو ربات با آن شما را به همه‌ی برنامه‌های 23RO معرفی می‌کند؛ همان استانداردی که «ورود با گوگل» و «ورود با مایکروسافت» با آن کار می‌کنند.

ورود یکپارچه چیست

ورود یکپارچه (Single Sign-On یا SSO) یعنی یک بار وارد می‌شوید و همه‌ی برنامه‌های یک مجموعه شما را می‌شناسند. هر برنامه گذرواژه یا کد ورود جداگانه ندارد؛ همه به یک سرور هویت مورد اعتماد تکیه می‌کنند.

نتیجه برای شما: یک حساب، یک جا برای امنیت (سطح، دومرحله‌ای، کدهای بازیابی) و یک دکمه برای خروج از همه‌جا.

OpenID Connect و OAuth 2.0

OAuth 2.0 استاندارد «اجازه دادن» است: برنامه‌ای اجازه می‌گیرد از طرف شما به یک سرویس دسترسی داشته باشد، بی‌آنکه رمز شما را ببیند.

OpenID Connect لایه‌ای روی OAuth 2.0 است که «شناختن» را استاندارد می‌کند: به برنامه می‌گوید شما چه کسی هستید، کی و با چه روشی وارد شده‌اید. دسرو ربات یک سرور کامل OpenID Connect است.

سه نقش اصلی

  • کاربر: شما، با مرورگر یا برنامه‌ی موبایل.
  • برنامه‌ی کلاینت: هر برنامه‌ی 23RO که می‌خواهد شما را بشناسد.
  • سرور هویت: دسرو ربات، تنها جایی که شماره‌ی همراه و کدها بررسی می‌شوند.

ورود قدم‌به‌قدم (کد مجوز با PKCE)

  1. ۱

    برنامه شما را می‌فرستد

    روی «ورود» می‌زنید؛ برنامه شما را با یک «درخواست مجوز» به دسرو ربات می‌فرستد. همراه آن یک رمز یک‌بارمصرف (PKCE) می‌سازد که فقط خودش می‌داند.

  2. ۲

    سرور هویت شما را می‌شناسد

    دسرو ربات شماره‌ی همراه و کد پیامکی را بررسی می‌کند. اگر تازه وارد شده باشید، این قدم بدون پرسش رد می‌شود؛ این همان ورود یکپارچه است.

  3. ۳

    کد کوتاه‌عمر برمی‌گردد

    مرورگر با یک «کد مجوز» یک‌بارمصرف به برنامه برمی‌گردد. این کد به‌تنهایی ارزشی ندارد.

  4. ۴

    برنامه کد را با توکن عوض می‌کند

    سرور برنامه، مستقیم و بیرون از مرورگر، کد و رمز PKCE را به دسرو ربات می‌دهد و توکن‌ها را می‌گیرد.

  5. ۵

    برنامه توکن را خودش بررسی می‌کند

    امضای توکن با کلید عمومی منتشرشده بررسی می‌شود؛ لازم نیست برنامه برای هر درخواست از دسرو ربات بپرسد.

سه توکن

توکنکارعمر در دسرو ربات
توکن شناسه (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فایل استاندارد با همه‌ی نشانی‌ها و کلیدهای سرور هویت.
PKCEProof Key for Code Exchangeرمز یک‌بارمصرفی که نمی‌گذارد کد دزدیده‌شده به توکن تبدیل شود.

توسعه‌دهنده‌اید؟ اتصال برنامه به دسرو ربات