Sonata - שרת אספקת SIP

אני לא יודע עם מה להשוות את ההקצאה. אולי עם חתול? נראה שאפשר בלעדיו, אבל איתו זה קצת יותר טוב. במיוחד אם זה עובד))

ניסוח הבעיה:

1. אני רוצה להגדיר טלפונים SIP במהירות, בקלות ובבטחה. בעת התקנת טלפון, ועוד יותר בעת הגדרתו מחדש.
2. לספקים רבים יש פורמטים משלהם לתצורה, כלי שירות משלהם ליצירת תצורות, ודרכי הגנה משלהם על תצורות. ואני לא באמת רוצה להתמודד עם כולם.
3. פתרונות אספקה ​​רבים, א) מתמקדים בספק אחד או במערכת טלפון אחת, ב) הם די מסורבלים ליישום, הרבה סקריפטים, פרמטרים, brrr...

לגבי נקודה 3, אעיר שיש מערכות אספקה ​​מצוינות עבור FreePBX, עבור FusionPBX, עבור קאזו, שבו תבניות לטלפונים של ספקים שונים זמינות לציבור. ישנם פתרונות מסחריים שבהם ניתן גם להגדיר את פעולתם של טלפונים מיצרנים שונים במודול האספקה, למשל, Yeastar PBX.

Habré גם מלא במתכונים כיצד להגדיר מכשירים מספקים שונים: זמן, два. אבל כמו שאומרים, לכל המערכות יש פגם קטלני. אז אנחנו ניצור את האופניים שלנו.

פורמט משלך

כמו שאומרים ב-xkcd, אם אתה לא רוצה להתמודד עם 14 פורמטים - לעלות עם ה-15. לכן, אנו משתמשים בהגדרות כלליות עבור כל טלפון ויוצרים פורמט תצורת json משלנו.

משהו כזה:

{
   "key": "sdgjdeu9443908",
   "token": "590sfdsf8u984",
   "model": "gxp1620",
   "vendor": "grandstream",
   "mac": "001565113af8",
   "timezone_offset": "GMT+03",
   "ntp_server": "pool.ntp.org",
   "status": true,
   "accounts": [
      {
         "name": "Мобилон",
         "line": 1,
         "sip_register": "sip.mobilonsip.ru",
         "sip_name": "sip102",
         "sip_user": "sip102",
         "sip_password": "4321",
         "sip_auth": "sip102"
      }
   ]
}

אז בכל טלפון אתה צריך להגדיר זמן מקומי וקווי SIP. הכל פשוט כאן. אתה יכול לראות דוגמאות נוספות כאן.

הקצאת שרת משלך

במדריכים של היצרן יש בדרך כלל נקודה שבה כתוב: קח csv, רשום את ה-login-password-mac-address שלך, צור קבצים באמצעות הסקריפט הקנייני שלנו, שים אותם מתחת לשרת האינטרנט של Apache והכל יהיה בסדר.

הפסקה הבאה של המדריך בדרך כלל אומרת לך שאתה יכול גם להצפין את קובץ התצורה שנוצר.

אבל כל אלו הן קלאסיקות. הגישה המודרנית עם שייקים וטוויטר אומרת שצריך ליצור שרת אינטרנט מוכן שלא יהיה חזק כמו אפאצ'י, אלא יעשה רק דבר אחד קטן. צור ושלח הגדרות באמצעות קישור.

בואו נעצור כאן ונזכור שכמעט כל מכשירי ה-SIP יכולים כעת לקבל הגדרות באמצעות http/https, כך שאנו לא שוקלים יישומים אחרים (ftp, tftp, ftps). לאחר מכן, כל טלפון יודע את כתובת ה-MAC שלו. לכן, נבצע שני קישורים: אחד אישי - מבוסס על מפתח המכשיר, השני כללי, שפועל באמצעות שילוב של אסימון משותף וכתובת MAC.

כמו כן, אני לא אתעכב על zero-config, כלומר. הגדרת הטלפון מאפס, כלומר. חיברת אותו לרשת וזה התחיל לעבוד. לא, בתרחיש שלי, אתה מחבר אותו לרשת, מבצע את ההגדרה המקדימה (מגדיר אותו כדי לקבל את התצורה משרת ההקצאה), ואז שותה פינה קולדה ומגדיר מחדש את הטלפון לפי הצורך באמצעות ההקצאה. ההפצה של אפשרות 66 היא באחריות שרת ה-DHCP.

אגב, נמאס לי לגמרי להגיד "הספקה", אז המילה התקצרה ל"הספקה", בבקשה אל תבעטו בי.

ועוד משהו: לשרת האספקה ​​שלנו אין ממשק משתמש, כלומר. ממשק משתמש. אולי, לעת עתה, אבל לא בטוח, כי... אני לא צריך את זה. אבל יש API לשמירה/מחיקה של הגדרות, קבלת רשימה של ספקים נתמכים, דגמים, הכל מתואר לפי הקנונים של מפרט ה-swagger.

למה ממשק API ולא ממשק משתמש? כי כבר יש לי מערכת טלפון משלי, ואז יש לי מקור של אישורים, שבו אני רק צריך לקחת את הנתונים האלה, לקמפל את ה-json הדרוש ולפרסם אותם בשרת האספקה. ושרת ההקצאה, לפי הכללים המפורטים בקובץ ה-json, ייתן למכשיר הנדרש את התצורה שלו או לא ייתן אותה אם המכשיר אינו תקין או אינו עומד בקריטריונים המצוינים גם ב-json זה.

כך יצא מיקרו-שירות ההקצאה. שקוראים לו סונטה, קוד המקור זמין ב-GitHub, יש גם תמונת docker מוכנה, דוגמה לשימוש ב-docker כאן.

תכונות עיקריות:

• בכל מקרה, גישה מוגבלת לתצורה לפי זמן, כברירת מחדל 10 דקות. אם ברצונך להפוך את התצורה לזמינה שוב, פרסם שוב את התצורה.

• פורמט אחד לכל הספקים, כל ההתאמות מוסרות בסונטה, אתה שולח json סטנדרטי, מגדיר כל ציוד זמין.

• כל ההגדרות שהונפקו למכשירים מתועדות, ניתן לראות את כל האזורים הבעייתיים ביומן וניתן לראות שגיאות

• אפשר להשתמש בקישור נפוץ אחד עם אסימון; כל טלפון מקבל תצורה משלו על ידי ציון כתובת ה-mac. או קישור אישי באמצעות מפתח.

• ממשקי API לניהול (ניהול) והקצאת הגדרות לטלפונים (הקצאה) מחולקים לפי יציאות

• מבחנים. היה לי מאוד חשוב לתקן את הפורמט של התצורה שהונפקה ולכסות את כל המצבים הרגילים של הוצאת תצורה עם בדיקות. כדי שהכל יעבוד בצורה ברורה.

חסרונות:

עד כה, לא נעשה שימוש בהצפנה בשום צורה בתוך Sonata. הָהֵן. אתה יכול כמובן להתחיל להשתמש ב-https על ידי הצבת nginx לפני סונטה למשל. אבל עדיין לא נעשה שימוש בשיטות קנייניות. למה? הפרויקט עדיין צעיר, הוא השיק את מאה המכשירים הראשונים שלו. וכמובן, אני אוסף רעיונות ומשוב. יתרה מכך, כדי לאבטח את הכל, כך שלא ניתן יהיה לרחרח את ההגדרות ברשת, כנראה שכדאי להתעסק איתם במפתחות הצפנה, tls והקיפוד, אבל זה יהיה המשך.

חוסר ממשק משתמש. אולי זה חיסרון משמעותי עבור משתמש הקצה, אבל עבור מנהל מערכת, כלי עזר למסוף חשוב יותר מיישום מלא. היו תוכניות ליצור כלי עזר למסוף, אבל אני לא בטוח אם יש צורך בכך?

התוצאה?

שרת אינטרנט קטן ופשוט להקצאת מספר דגמי טלפון עם API לניהול.

שוב, איך זה אמור לעבוד?

1. התקנת סונטה.
2. אנו יוצרים תצורה של json ומפרסמים אותה בסונטה.
3. לאחר מכן אנו מקבלים קישור להקצאה מסונטה.
4. לאחר מכן אנו מציינים את הקישור הזה בטלפון.
5. המכשיר טוען את התצורה

יש רק שני שלבים בפעולה הבאה:

1. אנו יוצרים תצורה של json ומפרסמים אותה בסונטה
2. המכשיר טוען את התצורה

אילו טלפונים יקודמו?

ספקים Grandstream, Fanvil, Yealink. ההגדרות בתוך הספק זהות פחות או יותר, אך עשויות להשתנות בהתאם לקושחה - ייתכן שיהיה צורך לבצע בדיקה נוספת.

אילו כללים אתה יכול לקבוע?

בזמן. אתה יכול לציין את הזמן שעד אליו התצורה תהיה זמינה.
לפי כתובת מק. בעת שליחת התצורה באמצעות הקישור האישי של המכשיר, תיבדק גם כתובת ה-mac.
לפי ip. לפי כתובת IP מהמקום שבו הוגשה הבקשה.

איך לקיים אינטראקציה עם סונטה?

באמצעות API, ביצוע בקשות http. ה-API יהיה זמין בהתקנה שלך. כי ה-API תומך במפרט ה-Swaggger, אתה יכול להשתמש בו כלי שירות מקוון עבור בקשות בדיקה ל-API.

אוקיי מעולה. דברים מגניבים, מה דעתך לנסות את זה?

הדרך הקלה ביותר היא לפרוס תמונת docker המבוססת על מאגר מדגם סונטה. המאגר מכיל הוראות התקנה.

מה אם אני מכיר את node.js?

אם יש לך ניסיון בשימוש ב-JavaScript, אז תבין במהירות איך הכל עובד כאן.

האם יהיה פיתוח סונטה?

השגתי חלקית את המטרות שלי. פיתוח נוסף הוא עניין של המשימות שלי בנושא אוטומציה של הגדרת הטלפון. יש גם הזדמנות להרחיב את ההגדרות כדי להגדיר כפתורי טלפון, להוסיף הקצאת פנקס כתובות, אולי משהו אחר, כתוב בהערות.

סיכום ותודות

אשמח לקבל הצעות/התנגדויות/הערות ושאלות בונות, כי... בהחלט יכול להיות שהוא תיאר משהו בצורה לא מובן.

אני גם מביע את תודתי לכל העמיתים שלי שעזרו, יעצו, בדקו וסיפקו/תרמו טלפונים לבדיקות. במציאות, אנשים רבים שעמם דיברתי בעבודה מעורבים בפרויקט בדרגות שונות, AsterConfה, בצ'אטים ובמיילים. תודה על הרעיונות והמחשבות.

מקור: www.habr.com