اتصال برنامههای چندمشتری
برخی نرمافزارها، مانند برنامههای حسابداری، مشتریان زیادی دارند و هر مشتری باید پیامک را از حساب پایاوای خودش بفرستد. برای این سناریو، پایاوا مفهوم ClientApp را ارائه میدهد: نرمافزار شما یک کلاینت واحد است و هر مشتری نهایی یک سشن و توکنهای مخصوص به خود را دارد.
مدل کلی
| مفهوم | نقش |
|---|---|
| ClientApp | هویت نرمافزار شما. پشتیبانی پایاوا برای آن یک کلید میسازد و شما آن را در هدر X-Client-App میفرستید |
| سشن | شناسهی اتصال یک مشتری مشخص روی یک نصب مشخص از نرمافزار. در هدر X-Session-Key فرستاده میشود |
| توکنها | هر مشتری Access Token و Refresh Token مخصوص خودش را دارد |
این مدل سه مزیت دارد:
- توکن هر مشتری از مشتری دیگر جداست و لغو یا خطا در یکی بر دیگری اثر ندارد.
- کلید ClientApp فقط در اختیار نرمافزار شماست و مشتریان نیازی به دیدن آن ندارند.
- ارتباط شما با پشتیبانی یکبار انجام میشود، نه برای هر مشتری.
گامهای پیادهسازی
- دریافت کلید ClientApp. از پشتیبانی پایاوا برای نرمافزار خود کلاینت و کلید
X-Client-Appبگیرید. این کلید را مانند رمز عبور نگه دارید و در بخش کاربری برنامه (مرورگر یا برنامهی موبایل مشتری) قرار ندهید. - ساخت کلید سشن. هنگام اتصال هر مشتری، یک مقدار یکتا و تصادفی، مثلاً GUID، تولید و برای همان مشتری ذخیره کنید. این مقدار در همهی مراحل بعدی همان مشتری ثابت میماند.
- شروع ورود. با شمارهی موبایل مشتری، verify را صدا بزنید. یک پیامک تأیید برای شمارهی مشتری فرستاده میشود و
referenceIdبرمیگردد. شماره باید برای یک حساب موجود در پایاوا باشد. - تکمیل ورود. کد پیامکشده را همراه
referenceIdبه register بفرستید تا توکنها را دریافت کنید. - ذخیرهی اطلاعات هر مشتری. برای هر مشتری،
accessToken،refreshToken، تاریخ انقضا (expireAtUtc) و کلید سشن را در محل امن ذخیره کنید. - استفاده و نوسازی. درخواستها را با توکن همان مشتری بفرستید و پیش از انقضا یا با دریافت
401توکن را نوسازی کنید.
نکات مهم
- کلید سشن مشتری را تغییر ندهید. نوسازی توکن فقط با همان
X-Session-Keyکه هنگام ورود ثبت شده انجام میشود. اگر مقدار متفاوتی بفرستید، پاسخ خطا با پیام «خطا در اعتبار سنجی» برمیگردد. - هر مشتری یک شمارهی مستقل دارد. پیامک تأیید به شمارهی خود مشتری میرسد و ورود با شمارهی دیگران ممکن نیست.
- از افشای کلید ClientApp جلوگیری کنید. اگر کلید لو رفت، به پشتیبانی اطلاع دهید.
- ارسال پیامک با X-Client-App. برای کلاینتهایی که الزامکنندهی کلید برنامه هستند، همان هدر
X-Client-Appرا در درخواستهای ارسال پیامک هم بفرستید.
پشتیبانی
سازندهی نرمافزار، پشتیبانی فنی مشتریان نهایی را خودش برعهده دارد و برای مسائل مربوط به ClientApp یا اتصال با تیم پشتیبانی پایاوا در ارتباط است.