نرمافزار 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:
- مراجعه به یکی از سایتهای معتبر ساخت QR Code مانند:
https://www.qr-code-generator.com - انتخاب گزینه Text .
- قرار دادن محتوای JSON در بخش متن.
- کلیک بر روی گزینه Generate QR Code .
- دانلود کد QR تولید شده یا استفاده از آن بهصورت مستقیم از روی صفحه.
بخش سوم: وارد کردن تنظیمات در اپلیکیشن PortSIP Softphone
پس از تولید QR Code، مراحل زیر برای وارد کردن تنظیمات در اپلیکیشن PortSIP Softphone دنبال میشود:
- اجرای اپلیکیشن PortSIP Softphone روی دستگاه Android یا iOS
- انتخاب گزینه Scan QR Code در صفحه نخست یا از طریق منوی برنامه.
- اسکن QR Code تولید شده با دوربین.
- تأیید اطلاعات و تکمیل بخش Auth Name در بخش Advanced تنظیمات و انجام فرآیند رجیستر شدن بهصورت خودکار.
در صورتی که اطلاعات وارد شده در فایل JSON صحیح باشد، داخلی با موفقیت رجیستر شده و آماده برقراری تماس خواهد بود.
نکات امنیتی و کاربردی
- رمز عبور داخلیها نباید در اختیار افراد غیرمجاز قرار گیرد . برای امنیت میتوان در بخش pwd قبل از تولید QR ، خالی گذاشت تا این فیلد پسورد توسط کاربر وارد شود.
- فایل JSON را در محیطهای عمومی به اشتراک نگذارید .
- برای استفاده از TLS بهجای UDP، مقدار “pn”: “TLS” و پورت مناسب (مانند 5061) را وارد نمایید.
- در صورت نیاز به چند مسیر ارتباطی TCP، TLS، میتوان چند شیء در آرایه ts اضافه نمود.