راهنمای جامع راه‌اندازی وب اتومیتور

نسخه سند: 1.13 · آخرین‌به‌روزرسانی: 2026-10-05
این راهنما برای مدیران فناوری اطلاعات و مسئول استقرار سازمان تهیه شده است.

فهرست

1. معرفی و لایسنس
2. محیط‌های پشتیبانی‌شده برای هاست وب
3. پیش‌نیازها
4. دریافت و محتوای بسته نصب
5. پیکربندی دیتابیس
6. اولین اجرا و ساخت خودکار دیتابیس
7. استقرار روی سرور
8. لایسنس
9. دوره آزمایشی ۳ روزه
10. حالت محدود پس از انقضا
11. برندینگ سازمان
12. به‌روزرسانی نرم‌افزار
13. آپدیت آفلاین (سرور بدون اینترنت)
14. انتقال از دیتابیس قدیمی
15. کار با پنل و افزونه
16. عیب‌یابی

1. معرفی و لایسنس

وب اتومیتور یک سامانه اتوماسیون فرآیندهای وب است که روی SQL Server اجرا می‌شود و با افزونه مرورگر Chrome کار می‌کند.

لایسنس: روی هر نصب (SaaS، on-prem، محیط dev) اعمال می‌شود — ابتدا دوره آزمایشی، سپس لایسنس امضاشده از vendor. تغییر وب اتومیتور:DeploymentMode در appsettings.json لایسنس را خاموش نمی‌کند.

برای هر استقرار جدا (چند دامنه، چند سرور، dev) وب اتومیتور:AppInstanceKey یکتا تعریف کنید.

2. محیط‌های پشتیبانی‌شده برای هاست وب

وب اتومیتور یک برنامه ASP.NET Core 9 است و روی سیستم‌عامل‌های مختلف قابل اجراست. دیتابیس باید SQL Server باشد (روی همان سرور یا سرور جدا — Windows، Linux یا سرویس ابری).

جدول محیط‌های هاست

نکات مهم

• سیستم‌عامل سرور وب مستقل از سیستم‌عامل SQL Server است — مثلاً برنامه روی Linux و دیتابیس روی Windows کاملاً ممکن است.
• افزونه Chrome روی رایانه کاربر نصب می‌شود؛ کاربران Windows، macOS یا Linux می‌توانند از وب اتومیتور استفاده کنند.
• بسته نصب پیش‌فرض ممکن است برای Windows (وب اتومیتور.Web.exe) یا Linux (وب اتومیتور.Web.dll) باشد — هنگام دریافت بسته، پلتفرم مقصد را به پشتیبانی اعلام کنید.
• برای HTTPS در production از گواهی معتبر (Let's Encrypt، گواهی سازمان، Azure/AWS) استفاده کنید.

3. پیش‌نیازها

سرور وب

Windows:

• Windows Server 2019 یا جدیدتر
• .NET 9 ASP.NET Core Runtime — برای IIS از Hosting Bundle استفاده کنید

Linux:

• توزیع پشتیبانی‌شده (Ubuntu 22.04 LTS، RHEL 8+، Debian 12+ و مشابه)
• .NET 9 ASP.NET Core Runtime برای Linux
• nginx (یا Apache) به‌عنوان reverse proxy — توصیه می‌شود

دیتابیس (الزامی — SQL Server)

• SQL Server 2019+، SQL Express، SQL Server on Linux، یا Azure SQL
• حساب اتصال باید اجازه ساخت دیتابیس را داشته باشد (در اولین اجرا)
• سرور SQL می‌تواند روی ماشین دیگری باشد

کلاینت کاربران

• مرورگر Chrome یا Edge (Chromium)
• افزونه وب اتومیتور Global (+ Smart Recorder اختیاری) — یک بار Load unpacked
• اگر گواهی سرور از CA داخلی صادر شده: گواهی ریشه در مخزن Trusted Root هر کلاینت (بخش ۷.۷). بدون این گام، پنل باز می‌شود ولی افزونه نمی‌تواند به سرور وصل شود و پنل می‌گوید افزونه نصب نیست.

شبکه

• HTTPS با گواهی معتبر (توصیه می‌شود)
• برای بررسی به‌روزرسانی: دسترسی به اینترنت یا URL سفارشی که در لایسنس یا تنظیمات تعریف شده

4. دریافت و محتوای بسته نصب

بسته نصب Enterprise معمولاً به‌صورت فایل فشرده (morobot-server.zip) در اختیار سازمان قرار می‌گیرد.

پس از استخراج، ساختار کلی به این شکل است:

Windows:

morobot-server/
├── وب اتومیتور.Web.exe          ← برنامه اصلی
├── appsettings.json
├── docs/setup-guide.md
├── wwwroot/
└── ...

Linux:

morobot-server/
├── وب اتومیتور.Web.dll          ← برنامه اصلی
├── appsettings.json
├── docs/setup-guide.md
├── wwwroot/
└── ...

مرحله بعد: پوشه را روی سرور مقصد کپی کنید (مثلاً C:\Apps\وب اتومیتور در Windows یا /opt/morobot در Linux).

5. پیکربندی دیتابیس

وب اتومیتور از SQL Server به‌عنوان موتور دیتابیس استفاده می‌کند. سرور، نام دیتابیس، کاربر و رمز همگی در زمان نصب از طریق appsettings.json (یا متغیر محیطی ConnectionStrings__Default) مشخص می‌شوند — نیازی به تنظیم جدا در کد نیست.

PostgreSQL / MySQL: در نسخه فعلی پشتیبانی نمی‌شود. فقط SQL Server (Windows، Linux یا Azure SQL).

5.0 چهار فایل تنظیمات و ترتیب بارگذاری

تنظیمات از چهار فایل خوانده می‌شود. هر لایه روی لایهٔ قبلی override می‌کند:

متغیرهای محیطی بین لایهٔ ۲ و ۳ قرار می‌گیرند و بر هر چهار فایل مقدم‌اند، پس ConnectionStrings__Default همیشه برنده است.

لایه ۴ برای چیست؟ در سرور مشتری، connection string و رمزها در appsettings.Production.json می‌مانند. بستهٔ به‌روزرسانی آفلاین نیاز دارد بتواند یک مقدار را به‌زور اعمال کند (مثلاً آدرس جدید فید به‌روزرسانی) بدون اینکه اپراتور آن فایل را دستی عوض کند. چون این لایه آخرین است، بر همه‌چیز مقدم می‌شود.

5.1 تنظیم اتصال در appsettings.json

قبل از اولین اجرا، بخش ConnectionStrings:Default را مطابق SQL Server سازمان ویرایش کنید:

"ConnectionStrings": {
  "Default": "Server=SQLHOST\\INSTANCE;Database=وب اتومیتورDb;User Id=morobot;Password=***;TrustServerCertificate=True;MultipleActiveResultSets=true"
}

برای سرور واقعی، این را در appsettings.Production.json بگذارید تا در هر publish پاک نشود.

5.2 دسترسی دیتابیس — خودکار حل می‌شود

وب اتومیتور در اولین اجرا خودش دیتابیس را می‌سازد، ولی برای این کار هویتِ پروسهٔ در حال اجرا باید در SQL Server دسترسی داشته باشد. این نکتهٔ کلیدی است که معمولاً نادیده گرفته می‌شود:

Trusted_Connection=True یعنی «با هویت ویندوزیِ پروسه احراز هویت کن». پشت IIS، این هویت Application Pool Identity است (IIS APPPOOL\<نام pool>)، و برای Windows Service معمولاً machine account (DOMAIN\HOST$). هیچ‌کدام هویت کاربری که با آن وارد ویندوز شده‌اید نیست.

لازم نیست این را حدس بزنید یا دستی بررسی کنید. اگر دسترسی کافی نباشد، برنامه بالا می‌آید و یک صفحهٔ راهنما نشان می‌دهد که دقیقاً می‌گوید چه چیزی کم است و کدام دستور SQL آن را حل می‌کند:

http://localhost:<port>/setup/database

این صفحه فقط از روی خود سرور (localhost) باز می‌شود: درخواستی که از بیرون از سرور برسد — یا آدرسش localhost نباشد — فقط پاسخ 503 ساده می‌گیرد و هیچ جزئیاتی از دیتابیس نمی‌بیند. اگر سایت با هدر میزبان (host header) bind شده باشد، از روی خود سرور یک Binding موقت http://localhost اضافه کنید (یا از IIS Manager → Bindings همان کار را انجام دهید) تا این صفحه در دسترس باشد. سه چیز را نشان می‌دهد:

و سپس دستور آماده برای کپی که با نام واقعی pool و دیتابیس شما ساخته شده. سه حالت ممکن است:

الف) login وجود ندارد (18456):

IF SUSER_ID(N'IIS APPPOOL\Automator') IS NULL
    CREATE LOGIN [IIS APPPOOL\Automator] FROM WINDOWS;
IF IS_SRVROLEMEMBER(N'dbcreator', N'IIS APPPOOL\Automator') = 0
    ALTER SERVER ROLE [dbcreator] ADD MEMBER [IIS APPPOOL\Automator];

ب) دیتابیس وجود ندارد (4060):

IF DB_ID(N'وب اتومیتورDb') IS NULL
    CREATE DATABASE [وب اتومیتورDb];

ج) user داخل دیتابیس نیست (4060 با دیتابیس موجود):

USE [وب اتومیتورDb];
IF USER_ID(N'IIS APPPOOL\Automator') IS NULL
    CREATE USER [IIS APPPOOL\Automator] FOR LOGIN [IIS APPPOOL\Automator];
ALTER ROLE [db_owner] ADD MEMBER [IIS APPPOOL\Automator];

پس از اجرای دستور، دکمهٔ «دوباره امتحان کن» را بزنید. نیازی به ری‌استارت سرویس نیست — برنامه همان لحظه تست می‌کند و اگر موفق شد، به‌طور عادی ادامه می‌دهد.

چرا رمز گرفته نمی‌شود؟ چون احراز هویت ویندوزی است. رمز را خود ویندوز مدیریت می‌کند و برنامه هرگز آن را نمی‌بیند. تنها چیزی که کم است، ثبت یک login برای یک هویت موجود است — که یک اقدام مدیریتی یک‌باره روی سرور دیتابیس است، نه رمزی که برنامه بخواهد ذخیره کند.

5.3 اتصال دیتابیس داخل لایسنس (Enterprise)

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

• تنظیمات اتصال در سامانه ذخیره می‌شود
• برای اعمال تغییر، یک بار سرویس را راه‌اندازی مجدد کنید
• در پنل مدیریت فقط نام سرور نمایش داده می‌شود (رمز عبور نمایش داده نمی‌شود)

6. اولین اجرا و ساخت خودکار دیتابیس

در اولین اجرا، وب اتومیتور به‌صورت خودکار این کارها را انجام می‌دهد:

1. اگر دیتابیس روی SQL Server وجود نداشته باشد → ایجاد دیتابیس
2. ساخت و به‌روزرسانی جداول مورد نیاز
3. تنظیمات اولیه و حساب مدیر (در صورت تعریف در بسته نصب)

اگر دسترسی کافی نباشد، برنامه متوقف نمی‌شود. بالا می‌آید و صفحهٔ /setup/database را نشان می‌دهد که هویت واقعی پروسه و دستور SQL لازم را می‌گوید (بخش ۵.۲). پس از اجرای دستور، دکمهٔ «دوباره امتحان کن» بدون ری‌استارت ادامه می‌دهد.

راه‌اندازی برنامه

Windows:

cd C:\Apps\وب اتومیتور
.\وب اتومیتور.Web.exe

Linux:

cd /opt/morobot
dotnet وب اتومیتور.Web.dll

برای تعیین آدرس و پورت:

Windows:

$env:ASPNETCORE_URLS = "http://0.0.0.0:5000"
.\وب اتومیتور.Web.exe

Linux:

export ASPNETCORE_URLS="http://127.0.0.1:5000"
dotnet وب اتومیتور.Web.dll

در production معمولاً برنامه پشت reverse proxy (IIS یا nginx) با HTTPS اجرا می‌شود — بخش ۷.

آدرس‌های مهم

7. استقرار روی سرور

7.1 Windows — IIS (پیشنهادی برای سازمان‌های Windows)

1. نصب ASP.NET Core Hosting Bundle 9
2. ایجاد Application Pool با گزینه No Managed Code
3. ایجاد Site — مسیر فیزیکی = پوشه نصب وب اتومیتور
4. تنظیم Binding با HTTPS
5. فایل web.config همراه بسته نصب است

پیش از اولین اجرا، بخش ۵.۲ را ببینید. تحت IIS، Trusted_Connection=True به هویت Application Pool معنا می‌شود (مثلاً IIS APPPOOL\Automator)، نه کاربری که با آن وارد ویندوز شده‌اید. اگر این login ساخته نشده باشد، برنامه با یک صفحهٔ راهنما بالا می‌آید و نام دقیق pool و دستور SQL لازم را نشان می‌دهد — کافی است یک‌بار اجرا کنید و «دوباره امتحان کن» را بزنید.

7.2 Windows — اجرای مستقیم

مناسب برای محیط آزمایشی یا سرورهای کوچک. برنامه را با وب اتومیتور.Web.exe اجرا کنید. برای اجرای دائم می‌توانید از Windows Service (مثلاً با NSSM) استفاده کنید.

7.3 Linux — nginx + systemd (پیشنهادی)

۱. سرویس systemd (فایل /etc/systemd/system/morobot.service):

[Unit]
Description=وب اتومیتور Web
After=network.target

[Service]
WorkingDirectory=/opt/morobot
ExecStart=/usr/bin/dotnet /opt/morobot/وب اتومیتور.Web.dll
Restart=always
RestartSec=10
Environment=ASPNETCORE_URLS=http://127.0.0.1:5000
User=www-data

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable morobot
sudo systemctl start morobot

۲. nginx (نمونه /etc/nginx/sites-available/morobot):

server {
    listen 443 ssl;
    server_name morobot.example.com;

    ssl_certificate     /etc/ssl/certs/morobot.crt;
    ssl_certificate_key /etc/ssl/private/morobot.key;

    location / {
        proxy_pass         http://127.0.0.1:5000;
        proxy_http_version 1.1;
        proxy_set_header   Upgrade $http_upgrade;
        proxy_set_header   Connection keep-alive;
        proxy_set_header   Host $host;
        proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header   X-Forwarded-Proto $scheme;
        proxy_cache_bypass $http_upgrade;
    }
}

۳. SignalR: اگر از قابلیت‌های real-time استفاده می‌کنید، در nginx هدرهای Upgrade و Connection باید فعال باشند (در نمونه بالا هست).

7.4 Docker / Kubernetes

• تصویر پایه: mcr.microsoft.com/dotnet/aspnet:9.0
• متغیر ConnectionStrings__Default را در environment تنظیم کنید
• SQL Server باید از داخل کانتینر در دسترس باشد
• برای HTTPS از ingress یا load balancer استفاده کنید

7.5 Azure App Service

• Runtime stack: .NET 9
• Connection string را در Configuration → Connection strings تنظیم کنید
• برای Linux plan همان بسته وب اتومیتور.Web.dll را deploy کنید

7.6 پشت Reverse Proxy (عمومی)

برنامه پشت پروکسی روی HTTP محلی گوش می‌دهد و پایان دادن به TLS کار IIS/nginx است. برای اینکه برنامه بداند HTTPS وجود دارد — و در نتیجه ریدایرکت به https و هدر HSTS را فعال کند — پورت HTTPS را اعلام کنید:

export ASPNETCORE_HTTPS_PORT=443     # یا HTTPS_PORT=443

یا در appsettings.Production.json:

"HTTPS_PORT": "443"

بدون این تنظیم، برنامه فرض می‌کند گواهی/HTTPS در کار نیست و نه ریدایرکت به https می‌سازد و نه هدر Strict-Transport-Security: ریدایرکت به آدرسی که TLS روی آن برقرار نیست، کاربر را از یک صفحهٔ سالم به صفحهٔ خطای گواهی می‌برد و HSTS مرورگر را برای تمام مدت max-age به همان آدرس قفل می‌کند. اگر سرور خودش مستقیماً HTTPS سرو کند (Kestrel با گواهی، یا پروفایل https در اجرای توسعه) این تشخیص خودکار است و تنظیم جداگانه لازم نیست.

هدرهای X-Forwarded-Proto و X-Forwarded-For را در پروکسی فعال کنید؛ اما توجه کنید برنامه برای تصمیم‌های خود به آن‌ها تکیه نمی‌کند: تشخیص HTTPS از پورت اعلام‌شده (بالا) می‌آید و آدرس کلاینت از سوکت خوانده می‌شود، چون این هدرها را هر کلاینتی می‌تواند جعل کند.

7.7 گواهی داخلی و اعتماد کلاینت‌ها (الزامی برای کارکرد افزونه)

اگر گواهی سرور از یک CA داخلی صادر شده باشد (نه CA عمومی)، نصب گواهی روی سرور کافی نیست: گواهی ریشه باید در مخزن Trusted Root هر کلاینت هم نصب شود. بدون آن، پنل در مرورگر باز می‌شود (کاربر هشدار گواهی را رد می‌کند) ولی افزونه نمی‌تواند به سرور وصل شود و پنل به‌اشتباه می‌گوید افزونه نصب نیست.

چرا: افزونه برای تأیید هویت سرور، /extension/fingerprint را با fetch می‌خواند. کلیک روی «Proceed» در هشدار گواهی مرورگر فقط روی بارگذاری خود صفحه اثر دارد و درخواست افزونه را باز نمی‌کند؛ پس آن درخواست با ERR_CERT_AUTHORITY_INVALID شکست می‌خورد — بدون هیچ خطای دیدنی در کنسول صفحه یا کنسول افزونه. نتیجه: افزونه صفحه را علامت‌دار نمی‌کند و پنل فکر می‌کند افزونه نصب نیست.

۱. فایل گواهی ریشه. اسکریپت tools/Install-HttpsCertificate.ps1 آن را کنار گواهی سرور export می‌کند (پیش‌فرض C:\certs\morobot):

C:\certs\morobot\<host>-root.cer

۲. نصب روی هر کلاینت (با دسترسی ادمین):

Import-Certificate -FilePath 'C:\certs\morobot\automator.krtax.ir-root.cer' -CertStoreLocation Cert:\LocalMachine\Root
# یا
certutil -addstore -f Root "C:\certs\morobot\automator.krtax.ir-root.cer"

سپس مرورگر را کامل ببندید و باز کنید (نه فقط تب) تا فرآیند شبکه گواهی تازه را ببیند.

۲.۱ نصب یک‌کلیکی روی کلاینت‌ها (بدون نیاز به دانش فنی)

سه فایل کنار هم کافی است: Run-InstallRootCA.cmd + Install-ClientRootCA.ps1 (هر دو در tools/) + فایل <host>-root.cer (خروجی گام ۱). کاربر فقط .cmd را دابل‌کلیک و UAC را تأیید می‌کند.

اسکریپت قبل از هر تغییری ریشه را اعتبارسنجی می‌کند (self-signed، CA=True، تطابق Subject پیش‌فرض CN=Internal Root CA، و در صورت دادن -Thumbprint تطابق اثر انگشت)، بعد نصب می‌کند، و در پایان خودش تأیید می‌کند: یک handshake واقعی TLS + درخواست بدون دورزدن اعتبارسنجی به /extension/fingerprint — یعنی همان چیزی که افزونه لازم دارد.

کدهای خروجی برای توزیع گروهی (SCCM/Intune/PDQ/RMM): 0 = نصب و تأیید شد، 2 = دسترسی ادمین لازم است، 1 = بقیهٔ خطاها.

دیالوگ تأیید ویندوز: در حالت -Scope User ویندوز هنگام افزودن ریشه به مخزن کاربر یک پنجرهٔ Security Warning نشان می‌دهد که کاربر باید Yes بزند — پس این حالت «یک کلیک انسانی» لازم دارد. در حالت سراسری (اجرای ادمین) چنین دیالوگی نیست و برای نصب بی‌سروصدا با RMM/SCCM مناسب است.

نکتهٔ کاربرِ بدون ادمین: -Scope User گواهی را در مخزن همان پروفایل ویندوز می‌گذارد؛ کروم و Edge آن را می‌خوانند، ولی Firefox مخزن جدا دارد و برای آن scope ماشین (و سوییچ -SetFirefoxEnterpriseRoots) لازم است.

۲.۲ بستهٔ MSI (برای توزیع بی‌سروصدا با SCCM/Intune/GPO/PDQ/RMM)

اگر سازمان ابزار توزیع نرم‌افزار دارد، به‌جای اسکریپت از بستهٔ MSI استفاده کنید. MSI همان کار اسکریپت را می‌کند (نصب ریشه در مخزن ماشین + فعال‌کردن ImportEnterpriseRoots برای Firefox) و چیزهایی دارد که اسکریپت ندارد: حذف استاندارد، Rollback در صورت خرابی نصب، و لاگ verbose استاندارد.

ساخت بسته (یک‌بار، روی ماشین خودتان — نیاز به .NET SDK؛ اسکریپت اگر WiX نباشد دستور نصبش را چاپ می‌کند):

tools\installer\Build-RootCaMsi.ps1 -CerPath C:\certs\morobot\automator.krtax.ir-root.cer -OutDir C:\certs\morobot
# خروجی: وب اتومیتورRootCA-1.0.0.msi + وب اتومیتورRootCA-1.0.0.msi.sha256

اسکریپت ساخت، بسته را قبل از تحویل خودش تأیید می‌کند: اعتبار ریشه، وجود سه Custom Action (نصب/rollback/حذف)، ترتیب زمان‌بندی آن‌ها، پالیسی رجیستری Firefox، و درستی payload گواهی؛ در پایان هم با یک extraction تستی ثابت می‌کند گواهی واقعاً داخل بسته است.

نکته‌ها:

• بسته per-machine و x64 است (بستهٔ 32 بیتی مقدار رجیستری Firefox را در WOW6432Node می‌نویسد و ۶۴ بیتی‌ها آن را نمی‌بینند) و برای اجرای بی‌سروصدا به دسترسی ادمین/SYSTEM نیاز دارد — که با SCCM/Intune/GPO/RMM فراهم است.
• گواهی زیر %ProgramFiles%\وب اتومیتور Root CA\ کپی می‌شود و با thumbprint همان ریشه دوباره حذف می‌شود؛ پس اگر روزی ریشه را عوض کردید، بستهٔ جدید نسخهٔ دیگری است و باید توزیع شود.
• تست: روی یک کلاینت با ادمین نصب کنید و در لاگ دنبال Return value 3 و CustomAction AddRootCert returned actual error code بگردید (نباید باشد)، سپس گام ۴ همین بخش را برای تأیید اجرا کنید.
• اگر بعداً ریشه را در -CerPath به گواهی دیگری تغییر دهید، باید -Version را هم بالا ببرید، وگرنه MSI آن را upgrade نمی‌شناسد.

۳. توزیع گروهی (توصیه‌شده در دامنه): GPO → Computer Configuration → Policies → Windows Settings → Security Settings → Public Key Policies → Trusted Root Certification Authorities → Import.

همین کار را می‌توان با بستهٔ MSI بخش ۲.۲ هم انجام داد و به‌جای Import دستی، Computer Configuration → Policies → Software Settings → Software Installation بسته را Publish/Assign کنید؛ مزیتش این است که حذف بسته هم از همان GPO مدیریت می‌شود.

۴. تأیید:

# ساده‌ترین و همان درخواستی که افزونه می‌زند (بدون دورزدن اعتبارسنجی):
(Invoke-WebRequest https://<host>/extension/fingerprint -UseBasicParsing).Content

# معادل با curl — نکته: --ssl-no-revoke لازم است
curl.exe -sS --ssl-no-revoke https://<host>/extension/fingerprint

دو خطای متفاوت را با هم اشتباه نگیرید:

• SEC_E_UNTRUSTED_ROOT (curl کد ۶۰) ⇒ ریشه روی کلاینت نیست — همین را باید نصب کنید.
• CRYPT_E_NO_REVOCATION_CHECK (curl کد ۳۵) ⇒ فقط بررسی ابطال (CRL/OCSP) ممکن نشده، چون ریشهٔ self-signed شما CRL ندارد. نشانهٔ خرابی نیست؛ کروم soft-fail می‌کند و گواهی را می‌پذیرد. به همین دلیل curl بدون --ssl-no-revoke اینجا نتیجهٔ گمراه‌کننده می‌دهد.

پس از اصلاح، در کنسول پنل مقدار document.documentElement.dataset.daExtensionFingerprint باید با مقدار متای da-server-fingerprint صفحه یکی باشد.

جابجایی سرور: اثر انگشت سرور از MachineGuid + نام ماشین + تعداد هسته + پلتفرم ساخته می‌شود. اگر برنامه را به ماشین/VM/کانتینر دیگری ببرید، اثر انگشت عوض می‌شود و افزونه‌های نصب‌شده روی کلاینت‌ها «بیگانه» می‌شوند؛ در آن صورت هر کلاینت باید بستهٔ سرور جدید را Load unpacked کند.

8. لایسنس

همه نصب‌ها (شامل Cloud و dev) از Admin → License درخواست فعال‌سازی و import لایسنس دارند.

8.1 مراحل فعال‌سازی

نصب → دوره آزمایشی (در صورت فعال بودن) → Admin/License → دریافت فایل activation-request
     → ارسال به پشتیبانی/فروشنده → دریافت license.morobot → Import در Admin/License

8.2 وارد کردن لایسنس

1. ورود به /Admin/License
2. بارگذاری فایل .morobot یا وارد کردن محتوای JSON
3. داده‌های موجود (کاربر، فرآیند، منبع) حذف نمی‌شوند — فقط اطلاعات لایسنس به‌روز می‌شود؛ import موفق همه ردیف‌ها را به «نمونه نصب» فعلی وصل می‌کند؛ import موفق همه ردیف‌ها را به «نمونه نصب» فعلی وصل می‌کند
4. برای ارتقا (مثلاً افزایش سقف کاربر): فایل لایسنس جدید با شماره نسخه بالاتر دریافت کنید

8.3 اطلاعات قابل مشاهده در پنل مدیریت

• نام سازمان، تاریخ اعتبار، سقف کاربر، شماره نسخه لایسنس
• نام سرور دیتابیس (بدون رمز)، وضعیت به‌روزرسانی
• دامنه / IP مجاز (در صورت تعریف در لایسنس؛ خالی = بدون قفل آدرس)
• نمایش داده نمی‌شود: امضای دیجیتال، رشته اتصال کامل، کلیدها

8.4 نشان کپی‌رایت

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

9. دوره آزمایشی ۳ روزه

• از اولین اجرا روی همان سرور شروع می‌شود (اثر انگشت سخت‌افزار/OS سرور، نه مرورگر کاربر)
• یک ردیف ثابت در جدول DeploymentTrialRecords نگه می‌دارد؛ حذف ردیف anchor در دیتابیس دوره آزمایشی را از نو نمی‌دهد
• ۳ روز بدون لایسنس: همه قابلیت‌ها فعال + نشان کپی‌رایت
• مدت دوره آزمایشی ممکن است در لایسنس سازمان متفاوت باشد (پیش‌فرض: ۳ روز)
• درخواست فعال‌سازی (activation-request.json) شامل ServerFingerprintHash است تا فروشنده بتواند نصب را تشخیص دهد
• اگر entitlement آزمایشی از نو ساخته شود (DeploymentTrialRecords جدید)، کاربران و فرآیندهای قدیمی (InstanceId متفاوت) بدون لایسنس قابل استفاده نیستند
• اگر entitlement آزمایشی از نو ساخته شود (DeploymentTrialRecords جدید)، کاربران و فرآیندهای قدیمی (InstanceId متفاوت) بدون لایسنس قابل استفاده نیستند

10. حالت محدود پس از انقضا

پس از پایان دوره آزمایشی یا انقضای لایسنس:

برای رفع محدودیت: لایسنس معتبر را در /Admin/License وارد کنید.

11. برندینگ سازمان

فقط با لایسنس معتبر: از مسیر /Admin/Branding

• نام برنامه، عنوان برند، نام سازمان
• آپلود لوگو و آیکون (favicon) — قبل از ذخیره، پنجرهٔ برش تصویر باز می‌شود تا اندازه و نسبت درست تنظیم شود
• پالت رنگ برند (رنگ اصلی، تیره/روشن، تأکید، پس‌زمینه‌ها، متن) با انتخابگر رنگ
• نمایش/پنهان‌کردن ویجت QR معرفی محصول

فرمت آیکون: آیکون برند باید PNG واقعی باشد؛ فایل JPEG (یا WebP) که فقط پسوندش .png شده کافی نیست. همین آیکون روی آیکون‌های افزونهٔ Chrome هم می‌نشیند و Chrome فقط PNG را به‌عنوان آیکون manifest می‌پذیرد؛ اگر محتوای فایل PNG نباشد، آیکون‌های پیش‌فرض افزونه دست‌نخورده می‌مانند.

تفکیک از تنظیمات سامانه: فیلدهای برندینگ فقط در /Admin/Branding قابل ویرایش‌اند و در /Admin/Settings نمایش داده نمی‌شوند — این دو صفحه دیگر روی هم اثر نمی‌گذارند.

11.1 تصویر پروفایل کاربر

هر کاربر از پنل → تنظیمات می‌تواند تصویر پروفایل خود را آپلود کند (با برش ۱:۱). تصویر در نوار بالای پنل و در فهرست کاربران پنل مدیریت به‌صورت آواتار نمایش داده می‌شود؛ در صورت نبود تصویر، حرف اول نام با رنگی مشتق از نام کاربر نمایش داده می‌شود.

12. به‌روزرسانی نرم‌افزار

• امکان بررسی به‌روزرسانی بسته به تنظیمات لایسنس
• آدرس پیش‌فرض بررسی: https://morobot.ir/checkupdate
• قرارداد API (GET): ?current={نسخه_نصب} → JSON:

{
  "version": "3.0.0",
  "notes": "یادداشت انتشار",
  "downloadUrl": "https://morobot.ir/download",
  "updateAvailable": true,
  "current": "2.9.0",
  "publishedUtc": "2026-09-24T00:00:00Z"
}

فیلدهای version، notes و downloadUrl برای سازگاری با نصب‌های قدیمی کافی است. روی سرور محصول (morobot.ir) یا در dev: GET https://localhost:7201/checkupdate?current=2.0.0

• API ادمین (نیاز به نقش Admin): GET /api/updates/status — وضعیت کش‌شده؛ POST /api/updates/check — بررسی آنلاین و به‌روزرسانی کش
• مدیر می‌تواند آدرس را در Settings → بخش «به‌روزرسانی» تغییر دهد
• بررسی دستی: Admin/License → «بررسی آپدیت»
• بررسی خودکار: سامانه هر ۶ ساعت یک‌بار بررسی می‌کند و در صورت وجود نسخهٔ جدید، به مدیر اعلان لحظه‌ای (SignalR) نشان می‌دهد — نیازی به refresh صفحه نیست
• سرور بدون اینترنت: آخرین نتیجه ذخیره‌شده نمایش داده می‌شود؛ بررسی خودکار بی‌اثر است و باید از روش آپدیت آفلاین (بخش ۱۳) استفاده شود

اعمال به‌روزرسانی آنلاین (جایگزینی فایل‌های برنامه) دستی است: دریافت بسته جدید از پشتیبانی، پشتیبان‌گیری، استخراج، راه‌اندازی مجدد — یا از مسیر آپدیت آفلاین برای بستهٔ آماده استفاده کنید.

دیتابیس: در اولین اجرا بعد از آپدیت، وب اتومیتور خودکار migrationهای EF Core را روی SQL Server اعمال می‌کند — نیازی به دستور جدا نیست (فقط سرویس را restart کنید). تعداد migrationهای در انتظار اعمال در لاگ راه‌اندازی ثبت می‌شود و در صورت شکست، پیام خطا نام migration مشکل‌دار را نشان می‌دهد.

13. آپدیت آفلاین (سرور بدون اینترنت)

برای سازمان‌هایی که سرور به اینترنت دسترسی ندارد: از مسیر /Admin/OfflineUpdate (لینک «آپدیت آفلاین» در منوی پنل مدیریت — فقط وقتی لایسنس امکان آپدیت داشته باشد).

13.1 بستهٔ آپدیت چیست

یک فایل zip که پشتیبانی/فروشنده برای شما می‌سازد. داخل آن:

morobot-update.json     ← مانیفست (نسخه، یادداشت، فهرست فایل‌ها با SHA-256)
update.ps1              ← اسکریپت اعمال آپدیت (فقط Windows)
وب اتومیتور.Web.dll|exe     ← فایل‌های برنامه
wwwroot/ …              ← سایر فایل‌ها

13.2 مراحل

1. فایل zip را از پشتیبانی دریافت کنید (نسخهٔ آن باید جدیدتر از نسخهٔ نصب‌شده باشد)
2. در /Admin/OfflineUpdate فایل را آپلود و «آپلود و بررسی» را بزنید
3. سامانه مانیفست را می‌خواند و امضای SHA-256 هر فایل را با مانیفست تطبیق می‌دهد؛ در صورت کوچک‌ترین مغایرت (فایل ناقص یا دست‌کاری‌شده) بسته رد می‌شود و چیزی روی سرور تغییر نمی‌کند
4. پس از تأیید، بسته در کارت «بستهٔ آماده‌شده» با نسخه و زمان نمایش داده می‌شود
5. سرویس را متوقف کنید، تیک تأیید را بزنید و «اعمال آپدیت و راه‌اندازی مجدد» را انتخاب کنید
6. اسکریپت update.ps1 فایل‌ها را جانشین می‌کند و برنامه را دوباره اجرا می‌کند؛ نتیجه در فایل update.log کنار اسکریپت ثبت می‌شود

اگر ترجیح می‌دهید دستی اعمال کنید، پوشهٔ آماده‌سازی را روی سرور باز کنید و دستور زیر را اجرا کنید (کارت «اعمال دستی» در همین صفحه دستور کامل را نشان می‌دهد):

powershell -ExecutionPolicy Bypass -File .\update.ps1 -TargetDir "C:\Apps\وب اتومیتور" -Restart

13.3 نکات

• اسکریپت قبل از کپی بررسی می‌کند که فایل‌های برنامه قفل نباشند؛ اگر سرویس هنوز در حال اجرا باشد با پیام روشن متوقف می‌شود (هیچ‌چیز نیمه‌اعمال نمی‌شود)
• در Linux فایل‌های بسته را دستی روی پوشهٔ نصب کپی کنید و سرویس را restart کنید
• پس از اعمال، migrationهای دیتابیس مثل بخش ۱۲ خودکار روی اولین اجرا اعمال می‌شوند
• «حذف بستهٔ آماده» بستهٔ آماده‌شده و فایل آرشیو آن را پاک می‌کند

13.4 تنظیمات (appsettings.json)

"وب اتومیتور": {
  "OfflineUpdate": {
    "UploadDirectory": "updates/uploaded",
    "StagingDirectory": "updates/staged",
    "MaxUploadMegabytes": 512,
    "RestartCommand": ""
  }
}

RestartCommand دستوری است که اسکریپت پس از موفقیت برای راه‌اندازی مجدد اجرا می‌کند؛ اگر خالی باشد اولین فایل اجرایی پوشهٔ مقصد اجرا می‌شود.

14. انتقال از دیتابیس قدیمی

اگر سازمان شما دیتابیس نسخهٔ قدیمی (Windows V2) دارد، به‌صورت پیش‌فرض این امکان در دسترس نیست. انتقال از دیتابیس قدیمی یک عملیات حساس است و فقط زمانی فعال می‌شود که در لایسنس امضاشدهٔ شما مجوز آن صادر شده باشد.

• با مجوز: لینک «انتقال از قدیمی» در منوی پنل مدیریت ظاهر می‌شود و /Admin/Migrate کار می‌کند
• بدون مجوز: آن صفحه ۴۰۴ برمی‌گرداند و لینکی در منو وجود ندارد
• برای دریافت این مجوز با پشتیبانی/فروشنده تماس بگیرید (در لایسنس، فیلد allowLegacyMigration)

15. کار با پنل و افزونه

15.1 افزونه وب اتومیتور Global (ضبط + اجرا + سلکتور)

یک افزونه به نام وب اتومیتور Global (extension-global) جایگزین سه افزونه جداگانه Recorder/Player/Selector شده است.

• Cloud و Enterprise: همان وب اتومیتور Global — آدرس سرور از پنلی که باز می‌کنید گرفته می‌شود
• آیکون: از برند وب اتومیتور (در Enterprise با برندینگ سفارشی، vendor می‌تواند آیکون‌ها را در بسته جایگزین کند — فایل‌های icon16/32/48/128.png باید PNG واقعی باشند، نه JPEG با پسوند png)
• افزونه‌های قدیمی Recorder/Player/Selector را حذف کنید و فقط Global + Smart (در صورت نیاز) نصب کنید

15.2 جریان کار پیشنهادی

1. وارد پنل همان سروری شوید که می‌خواهید با آن کار کنید (Cloud یا سازمانی)
2. از /Panel/Extension/Install افزونه‌ها را نصب کنید (یا از Chrome Web Store در Cloud)
3. یک بار وارد پنل شوید تا افزونه آدرس سرور را بگیرد
4. سپس فرآیند بسازید، Excel وصل کنید و Play/Record بزنید

قبل از ضبط یا اجرا حتماً پنل سرور موردنظر را باز کنید تا افزونه به همان سرور متصل شود.

15.3 استفاده همزمان از Cloud و Enterprise

افزونه در هر لحظه یک سرور فعال دارد — معمولاً آخرین پنلی که باز کرده‌اید.

اگر واقعاً به دو سرور همزمان در یک پروفایل نیاز دارید، از پشتیبانی بخواهید بسته افزونه با شناسه جدا (Extension ID متفاوت) تهیه شود تا هر دو کنار هم نصب شوند — این حالت استثنایی است.

15.4 نصب افزونه

Cloud: از پنل یا فروشگاه Chrome (در صورت انتشار رسمی)

Enterprise (on-prem):

1. ورود از /Panel/Account/Login
2. رفتن به /Panel/Extension/Install
3. Load unpacked از مسیر نمایش‌داده‌شده (یا دانلود zip هر افزونه)

15.5 نکات مهم

• افزونه روی رایانه کاربر نصب می‌شود، نه روی سرور
• سرور وب می‌تواند Windows یا Linux باشد — برای افزونه فرقی نمی‌کند
• کاربران می‌توانند Windows، macOS یا Linux داشته باشند — فقط Chrome/Edge لازم است
• اگر افزونه به سرور اشتباه وصل شد: پنل سرور درست را باز کنید، صفحه را refresh کنید، دوباره Record/Play بزنید

15.6 AppInstanceKey (مسیر افزونه)

در appsettings.json:

"وب اتومیتور": {
  "AppInstanceKey": "cloud-prod-ir"
}

مسیر پوشه افزونه روی ماشین (همگام‌سازی dev/local):

%LOCALAPPDATA%\webautomator\extension-global

(اگر برای چند استقرار روی یک PC مقدار AppInstanceKey ست شده باشد: %LOCALAPPDATA%\webautomator\{AppInstanceKey}\extension-global)

هر وب اتومیتور با دامنه + AppInstanceKey یکتا باشد تا روی یک PC تداخل نداشته باشد.

16. عیب‌یابی

تماس با پشتیبانی

برای دریافت لایسنس، بسته به‌روزرسانی یا پشتیبانی استقرار با پشتیبانی وب اتومیتور / فروشنده تماس بگیرید.