راهنمای جامع رجیستر داخلی در PortSIP Softphone با استفاده از JSON و QR Code

نرم‌افزار PortSIP Softphone یکی از ابزارهای محبوب در زمینه برقراری تماس‌های VoIP از طریق پروتکل SIP است. این نرم‌افزار قابلیت رجیستر کردن داخلی‌ها به‌صورت دستی یا از طریق QR Code را فراهم می‌سازد. در این مقاله، نحوه ساخت فایل JSON جهت تنظیم خودکار داخلی و تبدیل آن به QR Code برای استفاده در اپلیکیشن PortSIP Softphone شرح داده می‌شود.

بخش اول: ساختار استاندارد فایل JSON

برای استفاده از قابلیت QR Code در PortSIP Softphone، می‌بایست یک فایل JSON با ساختار مشخص تهیه گردد. در ادامه، نمونه‌ای از این فایل برای رجیستر داخلی شماره 45367 ارائه شده است:

{
  "name": "User 45367",
  "dn": "domain.ir",
  "wdn": "proxy.ir",
  "ts": [
    {
      "pn": "UDP",
      "port": "5060"
    }
  ],
  "ip": "proxy.ir",
  "private": "proxy.ir",
  "ext": "45367",
  "pwd": "Aa!61787",
  "user": "45367",
  "v": 1
}

توضیح پارامترها:

کلید توضیح
name نام نمایشی کاربر در برنامه
dn نام دامنه نمایشی
wdn دامنه واقعی سرور SIP یا proxy
ts Transport Settings (مثل UDP، TCP، TLS و شماره پورت)
pn نوع پروتکل انتقال SIP (UDP, TCP, TLS)
port پورت اتصال SIP، پیش‌فرض 5060 برای UDP
ip آدرس IP یا دامنه سرور SIP
private IP داخلی سرور یا همان ip تکراری برای NAT
ext داخلی کاربر (Extension)
user نام کاربری SIP معمولاً برابر با ext
pwd رمز عبور SIP
v نسخه قالب JSON، باید 1 باشد برای PortSIP Mobile

قابل ذکر است Authentication Name (همان Auth Name یا Auth ID) در PortSIP Mobile با user یکی است.

اگر سرور شما از نام کاربری متفاوت برای احراز هویت استفاده می‌کند (مثلاً user = 500 ولی auth_name = user500auth)، این روش جواب نمی‌دهد باید تنظیمات را به صورت دستی در PortSIP Mobile وارد کنید چون QR اجازه تنظیم auth_name مجزا را نمی‌دهد.

بخش دوم: تبدیل فایل JSON به کد QR

پس از آماده‌سازی فایل JSON، برای وارد کردن تنظیمات به PortSIP Softphone لازم است این فایل به کد QR تبدیل شود. این کار را می‌توان از طریق وب‌سایت‌های معتبر انجام داد.

مراحل تبدیل فایل JSON به QR Code:

  1. مراجعه به یکی از سایت‌های معتبر ساخت QR Code مانند:
    https://www.qr-code-generator.com
  2. انتخاب گزینه Text .
  3. قرار دادن محتوای JSON در بخش متن.
  4. کلیک بر روی گزینه Generate QR Code .
  5. دانلود کد QR تولید شده یا استفاده از آن به‌صورت مستقیم از روی صفحه.

بخش سوم: وارد کردن تنظیمات در اپلیکیشن PortSIP Softphone

پس از تولید QR Code، مراحل زیر برای وارد کردن تنظیمات در اپلیکیشن PortSIP Softphone دنبال می‌شود:

  1. اجرای اپلیکیشن PortSIP Softphone روی دستگاه Android یا iOS
  2. انتخاب گزینه Scan QR Code در صفحه نخست یا از طریق منوی برنامه.
  3. اسکن QR Code تولید شده با دوربین.
  4. تأیید اطلاعات و تکمیل بخش Auth Name در بخش Advanced تنظیمات و انجام فرآیند رجیستر شدن به‌صورت خودکار.

در صورتی که اطلاعات وارد شده در فایل JSON صحیح باشد، داخلی با موفقیت رجیستر شده و آماده برقراری تماس خواهد بود.

نکات امنیتی و کاربردی

  • رمز عبور داخلی‌ها نباید در اختیار افراد غیرمجاز قرار گیرد . برای امنیت میتوان در بخش pwd قبل از تولید QR ، خالی گذاشت تا این فیلد پسورد توسط کاربر وارد شود.
  • فایل JSON را در محیط‌های عمومی به اشتراک نگذارید .
  • برای استفاده از TLS به‌جای UDP، مقدار “pn”: “TLS” و پورت مناسب (مانند 5061) را وارد نمایید.
  • در صورت نیاز به چند مسیر ارتباطی TCP، TLS، می‌توان چند شیء در آرایه ts اضافه نمود.
2 پسندیده