اتصال صندوق به سرویس ابری
ساخت شعبه و کلید دستگاه در داشبورد ابری، وارد کردن کلید در دسکتاپ، امضای HMAC و چرخش کلید.
پاسخ کوتاه
مالک در داشبورد ابری از «تنظیمات پلتفرم ← شعبهها و دستگاهها ← افزودن شعبه» شعبه و کلید دستگاه میسازد، سپس همان کلید را با نشانی سرور در دسکتاپ، «تنظیمات ← داده و پشتیبان ← سرور ابری»، وارد و «ذخیره و آزمایش اتصال» را میزند.
گام ۱ — ساخت شعبه و کلید در داشبورد ابری
- ۱با حساب «مالک» وارد داشبورد ابری شوید و «تنظیمات پلتفرم» را باز کنید (از صفحهٔ انتخاب شعبه یا منوی کاربر).
- ۲زبانهٔ «شعبهها و دستگاهها» را باز کنید و «افزودن شعبه» را بزنید.
- ۳در گام «مشخصات شعبه» نام شعبه (مثلاً «شعبه مرکزی») را بنویسید؛ شهر اختیاری است. «ادامه» را بزنید.
- ۴در گام «دستگاه POS» یک برچسب برای این صندوق بدهید (پیشفرض POS-1) و «ایجاد شعبه و کلید» را بزنید.
- ۵در گام «کلید دستگاه» کلید (با پیشوند bzdk_) فقط همین یکبار نمایش داده میشود؛ آن را کپی کنید و جای امن نگه دارید.
گام ۲ — وارد کردن کلید در دسکتاپ
- ۱در نرمافزار دسکتاپ به «تنظیمات» بروید و گروه «داده و پشتیبان» را باز کنید؛ کادر «سرور ابری» آنجاست.
- ۲کلید «فعال/خاموش» بالای کادر را روی «فعال» بگذارید.
- ۳در «آدرس سرور» نشانی کامل سرور ابری (مثلاً https://cloud.example.ir) و در «کلید دستگاه» کلید کپیشده را بچسبانید.
- ۴روی «ذخیره و آزمایش اتصال» بزنید. برنامه ابتدا ذخیره میکند (پیام «ذخیره شد — اتصال فعال است») و بعد سه مرحله را آزمایش میکند؛ نیازی به بستن برنامه نیست.
مالک سرور را روی cloud.rezaei-food.ir نصب کرده و شعبهٔ «مرکزی» را ساخته است.
- در ویزارد ابری
- نام شعبه: شعبه مرکزی · شهر: تهران · برچسب دستگاه: صندوق ۱
- کلید نمایشدادهشده
- bzdk_ab12cd34_… (۴۸ نویسه؛ فقط یکبار دیده میشود)
- در دسکتاپ — آدرس سرور
- https://cloud.rezaei-food.ir
- در دسکتاپ — کلید دستگاه
- همان کلید (کادر رمزگذاریشده است و نویسهها پنهان دیده میشوند)
- نتیجه
- سه مرحلهٔ «دسترسی به سرور»، «احراز هویت کلید دستگاه» و «ارسال رویداد» ✓ میشوند و بالای کادر «متصل به سرور ابری» دیده میشود
- در داشبورد ابری
- بعد از حداکثر یک دقیقه وضعیت شعبه «آنلاین» میشود
متن راهنمای انتهای ویزارد ابری به تنظیم یک متغیر محیطی اشاره میکند؛ در دسکتاپ فعلی لازم نیست، کلید را مستقیم در همان کادر «سرور ابری» وارد کنید. جزئیات کادر در پیکربندی اتصال در نرمافزار صندوق آمده است.
امضای درخواستها و امنیت
- ▸هر درخواست صندوق به ابر با HMAC-SHA256 و کلید دستگاه امضا میشود؛ خود کلید در درخواستها فاش نمیشود و سرور فقط امضای معتبر را میپذیرد.
- ▸زمان درخواست باید حداکثر ۵ دقیقه با ساعت سرور فاصله داشته باشد تا درخواستهای تکراری رد شوند.
- ▸ساعت و منطقهٔ زمانی رایانهٔ صندوق را درست نگه دارید. مثلاً اگر ساعت سرور ۱۴:۰۰ و ساعت رایانه ۱۴:۰۷ باشد (۷ دقیقه اختلاف)، درخواست رد میشود؛ با ۱۴:۰۴ پذیرفته میشود.
- ▸دادههای هر کسبوکار روی سرور ابری از کسبوکار دیگر جداست.
چند صندوق در یک شعبه
اگر شعبه صندوق دومی با نصب جداگانهٔ دسکتاپ دارد، در ردیف همان شعبه (دکمهٔ ◂ کنار نام) فهرست دستگاهها را باز کنید و «+ کلید اضافی» را بزنید؛ یک برچسب (مثلاً POS-2) بدهید تا برای آن دستگاه کلید مستقل صادر شود.
چرخش و ابطال کلید
- ۱اگر کلید لو رفت یا مشکوک شدید، در «شعبهها و دستگاهها» فهرست دستگاههای شعبه را باز و روی همان دستگاه «چرخش» را بزنید و تأیید کنید.
- ۲کلید جدید نمایش داده میشود و کلید قبلی همان لحظه باطل میگردد. تا وارد کردن کلید جدید، صندوق نمیتواند ارسال کند ولی رویدادها در صف محلی میمانند و از دست نمیروند.
- ۳کلید جدید را در «سرور ابری» دسکتاپ جایگزین و «ذخیره و آزمایش اتصال» را بزنید.
- ۴برای کنار گذاشتن دائمی یک دستگاه (مثلاً صندوق دزدیدهشده)، «ابطال» را بزنید؛ این کلید برای همیشه باطل میشود.
اگر … شد
- ▸مرحلهٔ «احراز هویت کلید دستگاه» ✕ خورد: کلید اشتباه، ناقص یا باطلشده است؛ ساعت رایانه را هم با اینترنت همگام کنید.
- ▸مرحلهٔ «دسترسی به سرور» ✕ خورد: نشانی را (با https://) و اینترنت یا فایروال را بررسی کنید.
- ▸پیام «آدرس سرور و کلید دستگاه هر دو الزامی هستند»: یکی از دو کادر خالی است.
- ▸فهرست کامل را در عیبیابی همگامسازی ابری ببینید.
پرسشهای متداول
؟کلید دستگاه را گم کردهام؛ دوباره نمایش داده میشود؟
خیر، کلید فقط هنگام صدور یکبار نمایش داده میشود. در داشبورد ابری روی همان دستگاه «چرخش» بزنید تا کلید تازهای صادر شود و آن را در تنظیمات دسکتاپ وارد کنید.
؟چه کسی میتواند شعبه و کلید دستگاه بسازد؟
فقط کاربر با نقش «مالک». صفحهٔ «تنظیمات پلتفرم» برای سایر نقشها باز نمیشود.
؟چرا آزمایش اتصال در مرحلهٔ احراز هویت خطا میدهد؟
معمولاً یا کلید اشتباه یا باطلشده وارد شده، یا ساعت رایانهٔ صندوق بیش از ۵ دقیقه با ساعت سرور اختلاف دارد. کلید را بدون فاصلهٔ اضافی دوباره وارد کنید و ساعت ویندوز را همگام کنید.
؟برای هر صندوق کلید جدا لازم است؟
بله. هر نصب دسکتاپ کلید مخصوص خودش را دارد؛ برای صندوق دوم یک شعبه از «+ کلید اضافی» در همان ردیف شعبه استفاده کنید.