دسرو ربات

سامانه

توسعه‌دهندگان

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

دسرو ربات یک سرور استاندارد OpenID Connect است؛ هر کتابخانه‌ی معتبر OpenID Connect در هر زبانی به آن وصل می‌شود. برنامه‌ی وب، موبایل، دسکتاپ، API و سرویس پس‌زمینه، و حتی سامانه‌های شرکت‌ها و سکوهای دیگر هم می‌توانند ورود کاربرانشان را به دسرو ربات بسپارند.

قابلیت‌ها

کد مجوز با PKCE

جریان اصلی ورود کاربر برای وب، موبایل و برنامه‌ی تک‌صفحه‌ای؛ PKCE برای همه اجباری است.

توکن تمدید

توکن دسترسی کوتاه‌عمر است؛ با هر تمدید، وضعیت کاربر، نقش‌ها و سطح دوباره بررسی می‌شود.

اعتبارنامه‌ی کلاینت

برای فراخوانی سرویس‌به‌سرویس بدون کاربر (client credentials).

خروج پس‌زمینه

با خروج کاربر، سامانه توکن خروج امضاشده را به نشانی ثبت‌شده‌ی برنامه می‌فرستد (Back-Channel Logout).

سطح و ارتقا

سطح احراز هویت در ادعای acr می‌آید (urn:23ro:loa:1 تا 4)؛ برنامه می‌تواند سطح بالاتر بخواهد.

نقش و عضویت

نقش‌های هر برنامه در توکن می‌آید و مدیر برنامه در پنل مدیریتی آن‌ها را می‌دهد یا می‌گیرد. در برنامه‌هایی که نقش پایه لازم دارند، سرور هویت کاربر غیرعضو را پیش از صدور توکن به صفحه‌ی عضویت می‌برد.

شروع کار

  1. برنامه‌ی خود را نزد مدیر سامانه ثبت کنید: نام، نشانی‌های بازگشت، نشانی خروج پس‌زمینه، مدل دسترسی و سطح لازم.
  2. شناسه‌ی کلاینت (و برای برنامه‌ی سمت سرور، راز کلاینت) را در تنظیمات امن برنامه بگذارید، نه در کد.
  3. کتابخانه‌ی OpenID Connect زبان خود را با سند کشف زیر پیکربندی کنید.
  4. کاربران را با ادعای sub بشناسید، نه با شماره‌ی همراه.

سند کشف OpenID Connect

همه‌ی نشانی‌ها، کلیدهای امضا و قابلیت‌ها در این سند است:

https://sso.23ro.ir/.well-known/openid-configuration

باز کردن سند کشف

نمونه‌ها و راهنمای کامل

راهنمای کامل اتصال برای هر نوع سرویس (وب سمت سرور، برنامه‌ی تک‌صفحه‌ای با BFF، موبایل، دسکتاپ، API، سرویس‌به‌سرویس، سکوهای بیرونی) با نمونه‌ی کد در «راهنمای توسعه‌دهندگان» داخل سامانه است و برای دارندگان نقش مدیر کل یا توسعه‌دهنده باز است. برنامه‌های نمونه‌ی آزموده در ASP.NET Core، Angular، React، Flask و PHP هم در مخزن پروژه است.

راهنمای توسعه‌دهندگان OpenID Connect چیست؟

برنامه یا سکوی تازه‌ای دارید؟ از مدیر سامانه بخواهید آن را ثبت کند یا تیکت بزنید.