پرش به مطلب اصلی

اتصال برنامه‌های چندمشتری

برخی نرم‌افزارها، مانند برنامه‌های حسابداری، مشتریان زیادی دارند و هر مشتری باید پیامک را از حساب پایاوای خودش بفرستد. برای این سناریو، پایاوا مفهوم ClientApp را ارائه می‌دهد: نرم‌افزار شما یک کلاینت واحد است و هر مشتری نهایی یک سشن و توکن‌های مخصوص به خود را دارد.

مدل کلی​

مفهومنقش
ClientAppهویت نرم‌افزار شما. پشتیبانی پایاوا برای آن یک کلید می‌سازد و شما آن را در هدر X-Client-App می‌فرستید
سشنشناسه‌ی اتصال یک مشتری مشخص روی یک نصب مشخص از نرم‌افزار. در هدر X-Session-Key فرستاده می‌شود
توکن‌هاهر مشتری Access Token و Refresh Token مخصوص خودش را دارد

این مدل سه مزیت دارد:

  • توکن هر مشتری از مشتری دیگر جداست و لغو یا خطا در یکی بر دیگری اثر ندارد.
  • کلید ClientApp فقط در اختیار نرم‌افزار شماست و مشتریان نیازی به دیدن آن ندارند.
  • ارتباط شما با پشتیبانی یک‌بار انجام می‌شود، نه برای هر مشتری.

گام‌های پیاده‌سازی​

  1. دریافت کلید ClientApp. از پشتیبانی پایاوا برای نرم‌افزار خود کلاینت و کلید X-Client-App بگیرید. این کلید را مانند رمز عبور نگه دارید و در بخش کاربری برنامه (مرورگر یا برنامه‌ی موبایل مشتری) قرار ندهید.
  2. ساخت کلید سشن. هنگام اتصال هر مشتری، یک مقدار یکتا و تصادفی، مثلاً GUID، تولید و برای همان مشتری ذخیره کنید. این مقدار در همه‌ی مراحل بعدی همان مشتری ثابت می‌ماند.
  3. شروع ورود. با شماره‌ی موبایل مشتری، verify را صدا بزنید. یک پیامک تأیید برای شماره‌ی مشتری فرستاده می‌شود و referenceId برمی‌گردد. شماره باید برای یک حساب موجود در پایاوا باشد.
  4. تکمیل ورود. کد پیامک‌شده را همراه referenceId به register بفرستید تا توکن‌ها را دریافت کنید.
  5. ذخیره‌ی اطلاعات هر مشتری. برای هر مشتری، accessToken، refreshToken، تاریخ انقضا (expireAtUtc) و کلید سشن را در محل امن ذخیره کنید.
  6. استفاده و نوسازی. درخواست‌ها را با توکن همان مشتری بفرستید و پیش از انقضا یا با دریافت 401 توکن را نوسازی کنید.

نکات مهم​

  • کلید سشن مشتری را تغییر ندهید. نوسازی توکن فقط با همان X-Session-Key که هنگام ورود ثبت شده انجام می‌شود. اگر مقدار متفاوتی بفرستید، پاسخ خطا با پیام «خطا در اعتبار سنجی» برمی‌گردد.
  • هر مشتری یک شماره‌ی مستقل دارد. پیامک تأیید به شماره‌ی خود مشتری می‌رسد و ورود با شماره‌ی دیگران ممکن نیست.
  • از افشای کلید ClientApp جلوگیری کنید. اگر کلید لو رفت، به پشتیبانی اطلاع دهید.
  • ارسال پیامک با X-Client-App. برای کلاینت‌هایی که الزام‌کننده‌ی کلید برنامه هستند، همان هدر X-Client-App را در درخواست‌های ارسال پیامک هم بفرستید.

پشتیبانی​

سازنده‌ی نرم‌افزار، پشتیبانی فنی مشتریان نهایی را خودش برعهده دارد و برای مسائل مربوط به ClientApp یا اتصال با تیم پشتیبانی پایاوا در ارتباط است.