آموزش ساخت دفترچه تلفن سیسکو (Cisco Contact List)

[sadeghi_en]

تلفن‌های Cisco از قابلیت نمایش و استفاده از دفترچه تلفن از طریق فایل‌های XML تحت وب پشتیبانی می‌کنند. این ویژگی به کاربران اجازه می‌دهد تا مخاطبین مورد نظر خود را به راحتی روی صفحه تلفن مشاهده و شماره‌گیری کنند.
این راهنما نحوه ساخت و راه‌اندازی این قابلیت را با استفاده از وب سرور Apache یا Nginx شرح می‌دهد. و میتوان یکی از این دو را به عنوان وب سرور استفاده کرد.

بخش اول: آشنایی با ساختار دفترچه تلفن

فایل دفترچه تلفن یک فایل با پسوند xml. بوده و ساختار آن به صورت زیر است. به عنوان مثال محتوای فایل directory.xml به شرح زیر است:

<?xml version="1.0" encoding="UTF-8"?>
<CiscoIPPhoneDirectory>
  <Title>Company Directory</Title>
  <Prompt>Select a contact</Prompt>

  <DirectoryEntry>
    <Name>Ali</Name>
    <Telephone>1001</Telephone>
  </DirectoryEntry>

  <DirectoryEntry>
    <Name>Zahra</Name>
    <Telephone>1002</Telephone>
  </DirectoryEntry>

  <DirectoryEntry>
    <Name>Sadeghi</Name>
    <Telephone>211</Telephone>
  </DirectoryEntry>

</CiscoIPPhoneDirectory>

• Title : عنوان صفحه دفترچه تلفن در تلفن.
• Prompt : پیام نمایشی برای راهنمایی کاربر.
• DirectoryEntry : لیست مخاطبین شامل
  Name نام مخاطب
  و Telephoneشماره داخلی یا شماره تلفن

در موارد بالا انگلیسی قابل قبول است و تلفن باید به این فایل دسترسی HTTP داشته باشد.

بخش دوم: نصب وب سرور

- درصورت استفاده از Apache :

1. نصب و فعال سازی Apache
   در سرور لینوکسی، دستورات زیر را به این صورت وارد کنید:

sudo apt update
sudo apt install apache2 -y
sudo systemctl enable apache2
sudo systemctl start apache2

2. بررسی اجرا بودن سرویس

sudo systemctl status apache2

3. بررسی اختصاص داشتن پورت 80 به Apache
   تلفن‌های Cisco برای فایل‌های “Directory URL” و “Services URL” از TFTP پشتیبانی نمی‌کنند. فقط HTTP (یا HTTPS) را می‌پذیرند.

ss -tulpn | grep :80

- درصورت استفاده از Nginx :

1. نصب و فعال سازی Nginx
   در سرور لینوکسی، دستورات زیر را به این صورت وارد کنید:

sudo apt update
sudo apt install nginx -y
sudo systemctl enable nginx
sudo systemctl start nginx

2. بررسی اجرا بودن سرویس

sudo systemctl status nginx

3. بررسی اختصاص داشتن پورت 80 به Nginx
   تلفن‌های Cisco برای فایل‌های “Directory URL” و “Services URL” از TFTP پشتیبانی نمی‌کنند. فقط HTTP (یا HTTPS) را می‌پذیرند.

ss -tulpn | grep :80

بخش سوم: مراحل ساخت دفترچه تلفن

1. ساخت فایل XML
   در سرور لینوکسی، فایل را به این صورت بسازید:

sudo nano /var/www/html/directory.xml

و محتوای بالا را در آن قرار دهید. سپس ذخیره کنید.

2. تنظیم مجوز دسترسی به فایل
   - درصورت استفاده از Apache :
   اطمینان حاصل کنید که فایل قابل خواندن توسط Apache باشد و دستورات زیر وارد شود:

sudo chmod 644 /var/www/html/directory.xml
sudo chown www-data:www-data /var/www/html/directory.xml

تنظیم MIME Type در Apache :

آپاچی باید فایل xml. را با MIME type مناسب ارسال کند.
بررسی یا افزودن خط زیر در فایل:

nano /etc/apache2/apache2.conf

محتوا زیر وارد شود.

AddType application/xml .xml
AddType text/xml .xml

- درصورت استفاده از Nginx :
اطمینان حاصل کنید که فایل قابل خواندن توسط Nginx باشد و دستور زیر وارد شود:

sudo chmod 644 /var/www/html/directory.xml

3. ریستارت سرویس

- درصورت استفاده از Apache :
بعد از تغییرات، سرویس Apache را ریستارت می کنیم.

sudo systemctl restart apache2

- درصورت استفاده از Nginx :
بعد از تغییرات، سرویس Nginx را ریستارت می‌کنیم.

sudo systemctl restart nginx

4. بررسی صحت ارائه فایل توسط وب سرور
   با استفاده از مرورگر یا ابزار curl:

curl http://server-ip/directory.xml

اگر کد 200 دریافت کردید، همه چیز درست است.

---

بخش چهارم: تنظیم تلفن Cisco برای استفاده از دفترچه تلفن

1. در فایل پیکربندی گوشی (SEP"MAC".cnf.xml) آدرس فایل XML دفترچه تلفن را تنظیم کنید:
   منظور از “MAC” مک آدرس تلفن می‌باشد.

<directoryURL>http://server-ip/directory.xml</directoryURL>

همچنین آن را به لیست سرویس‌ها در بخش زیر اضافه کنید:

<phoneServices>
  <phoneService type="1" category="0">
    <name>phone Books</name>
    <url>http://server-ip/directory.xml</url>
  </phoneService>
</phoneServices>

بخش Phone Services مربوط به تعریف سرویس‌های تلفن، در تلفن‌های Cisco IP Phone می باشد. و به تلفن می‌گوید که چه سرویس‌هایی روی منوی آن ظاهر شوند (مثل Missed Calls، Voicemail، دفترچه تلفن و…).

هر phoneService یک آیتم در منوی سرویس‌های تلفن است.

در فایل تنظیمات سرویس تلفن Cisco، ویژگی type در تگ برای مشخص کردن نوع سرویس استفاده می‌شود. این مقدار به تلفن می‌گوید که با چه نوع سرویسی سر و کار دارد (مثلاً سرویس معمولی، سرویس صندوق صوتی، و غیره).

type=“1” → سرویس XML (مثل دفترچه تلفن، سرویس سفارشی)

مورد (phone Books) به یک سرویس سفارشی روی سرور شما اشاره دارد و باید حاوی فایل XML مطابق استاندارد Cisco باشد.

3. راه‌اندازی مجدد تلفن
   پس از اعمال تنظیمات، گوشی را ریستارت می کنیم و مجدد رجیستر می کنیم.
   بعد از رجیستر داخلی، از دکمه directories روی تلفن وارد بخش phone Books می شویم و لیست مخاطبان در اینجا نمایش داده می شود.