👱🏿 🎯 🔐 アスタリスクを使用した自動プロビジョニング（自動調整）Polycom電話 👩‍🎨 🔁 ⛓️

タスク：MACアドレスに基づいて、できればデバイスを箱から出さずに、電話（または他の加入者デバイス）を自動的にセットアップします。

加入者デバイスの一元化された構成のアイデアは長い間私にあり、最終的にプロジェクトの1つでその実装を見つけました。投稿の最後のビデオ。

私が出会ったほぼすべての（Cisco、Polycom、D-Link、Escene）IP電話は、何らかの形で、サーバーからの集中構成をサポートしています。自動プロビジョニングによる自動プロビジョニング。この場合、Polycom電話を使用した例を検討しますが、本質的には、同様のアプローチにより、特定の調整で任意の電話を構成できます。

どのように機能しますか（Polycomについて）？

電話機はデフォルトで、DHCPを介してIPアドレスを取得するように設定されています。アドレス自体に加えて、電話機はDHCPから多くのオプションを受け取ります。通常、ゲートウェイ、ネットマスク、およびDNSサーバーが示されます。さらに、SNTPサーバーなどを指定できます。ポリコムはデフォルトでオプション66と160を見て、そこで自動プロビジョニングサーバーのアドレス/名前を見つけようとします。電話機は、サーバーアドレスを検出すると、デフォルトでFTP（HTTP、HTTPS、TFTPもサポート）経由でログインとパスワードとして使用して接続を試みます。

ユーザー名	PlcmSpIp
パスワード	PlcmSpIp

電話機はサーバーにバージョン（sip.verファイル）とファームウェアファイル自体および構成ファイルを要求します。電話機は新しいファームウェアをダウンロードして更新し、再起動後にサーバーに再度接続し、ソフトウェアが更新を必要としないことを確認し、XML形式の構成ファイルをダウンロードして適用します。一般に、マシンは次のファイルを要求します。

ファイル名	説明
0000000000.cfg	一般的な構成ファイル（ダウンロードする内容と場所を指定）
* .sip.ld（分割用） sip.ld（結合用）*	対応するモデルの電話ファームウェア（0000000000.cfgから設定）、
sip.ver	ソフトウェアバージョン
1234123adba.cfg	MACアドレス1234123adbaを使用した電話設定

*-Polycomには2つのバージョンの統合ソフトウェアがあります（かなりの重量があります）-全員に適した、分割-電話の行ごとに個別の小さなsip.ldファイルがあります（ネットワークの負荷を軽減します）。

それがすべてだと思われる、電話は行く準備ができています！実際、小さなシステムの場合はそのまま、つまり十分：

電話の製造元のWebサイトからファームウェアをダウンロードしますsupport.polycom.com/PolycomService/support/us/support/voice/index.html
0000000000.cfgでは、電話がサーバーからダウンロードする構成ファイルを指定します（CONFIG_FILES = "custom.cfg"）。これで十分です。デフォルトで。
すべてのデバイスに共通の設定を含むcustom.cfgを作成します。
デバイス<MASAddress> .cfgごとに複数のconfファイルを作成します。これには、各サブスクライバーに固有の情報が含まれます。一般的に、彼のSIPログインとパスワードのみ。

このソリューションを使用すると、小規模なVoIPインフラストラクチャを迅速に展開できますが、大規模なシステムでは、同じタイプのファイルを多数作成する必要があり、便利で柔軟性があまりありません。また、退屈です。

だから私はもっと洗練された方法で行った：

FTP経由で、HTTPを介してファイルを受信するように電話を構成します：8088
Asteriskでは、phoneprovを使用して、users.confファイルに基づいて各電話の構成ファイルを動的に生成します。

このセットアップ方法では、MACをusers.confに追加して新しいデバイスを追加し、ユーザー名とパスワードをそこに設定するだけで十分です。残りの構成は自動的に行われます。

次に、何をする必要があるかをさらに詳しく検討します。

DHCPセットアップ

この場合、構成を介して各デバイスの静的アドレスを設定します。デバイスは、1回目と2回目のブートでのみ動的アドレスを必要とし、3回目は既に完全に構成され、静的IPを持っています。したがって、私はレンタル時間を設定します-5分、空のアドレスプールを占有しないように。一般的な場合、各MACに対して予約を行うことにより、アドレスを動的に配布することもできます。さらに、プロビジョニングサーバーのアドレスを含むオプション66または160を好みに追加する必要があります。 Windowsでは、これは次のように行われます。

私の場合、Mikrotik：

そのため、プロビジョニングサーバーのアドレスを含むアドレスとオプション66を動的に配布する必要があります。私の場合、動的アドレスの範囲は20〜99であり、静的アドレスの101〜199の範囲により、加入者の内部番号は自分のIPと一致します。

FTPを介した電話のセットアップ

FTP経由で設定するには、FTPが必要です。（CentOS）を設定します。

yum install -y vsftpd chkconfig vsftpd on service vsftpd start

/etc/vsftpd/vsftpd.confで設定できます。

polycomが接続を試みるユーザーを作成します。

 useradd PlcmSpIp passwd PlcmSpIp

パスワードの複雑さを考えると、このユーザーができるだけ無力であることを確認する価値があります。

ファームウェアを含むアーカイブをダウンロードし、/ home / PlcmSpIpに解凍します

ファームウェアをダウンロードするときは、警告を注意深く読んでください。ほとんどの場合、ローダーの更新もダウンロードする必要があります。また、/ home / PlcmSpIpディレクトリに解凍します。

現時点では、ネットワークに接続された電話機は、電源がオンになると、新しいブートローダーとファームウェアをポンプアウトし、ソフトウェアを更新する必要があります。

構成ファイルを操作する

それから、私は手でXMLを編集しようとして多くの時間を失いました。読者の皆さん、XMLの世界でObi-Wan-Kenobiでない場合は、テキストエディターで設定を編集しないでください。構成を処理するために、XML Notepad 2007を使用しました。結合バージョンのファームウェアをダウンロードした場合、configフォルダーには、* .cfg拡張子とpolycomConfig.xsd XMLスキーマを持ついくつかの構成ファイルがあります。

* .cfg-構成ファイルの例はテーマ別にグループ化されています

polycomConfig.xsd	スキーム
video-integration.cfg	ビデオ統合のセットアップ
video.cfg	ビデオハングアウトを設定する
site.cfg	多くのことがあり、おそらくすべての設定もあります
sip-interop.cfg	一口、通話、トーンの設定
sip-basic.cfg	一口設定
region.cfg	地域設定
reg-basic.cfg	SIP登録-基本
reg-advanced.cfg	SIP登録-拡張
H323.cfg	H323設定
features.cfg	保留転送設定の転送
device.cfg	デバイス設定、ネットワークシステム
applications.cfg	アプリケーション設定

各ファイルには次のような行があります。

 <polycomConfig xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="polycomConfig.xsd">

つまり、XMLエディターで構成ファイルを開くと、同じフォルダー内でpolycomConfig.xsdスキーマファイルが検索され、構成ファイルのすべての可能なフィールドと使用可能な値のリストまたは短いコメントが含まれます。この段階で、ダウンロードがHTTP経由であるべきことをデバイスに示し、構成ファイルへのhttpパスを指定する必要があります。

polycomConfig.xsdがあるフォルダーで、次の内容のテキストファイルcustom.cfgを作成します。

 <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <polycomConfig xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="polycomConfig.xsd"> </polycomConfig>

XMLエディターで開きます。含まれるフィールドをGoogleで検索するか、管理者が600ページの指示を使用してメーカーの電話を設定する必要があります。

しかし、ほとんどの場合、すべてが直感的です。最初に、polycomConfigコンテキストメニューまたは単にpolycomConfigに立っているときにctrl + insertを使用して、要素（おそらくセクションまたは他のことを言う必要がありますが、私は知らないので、XMLエディターと呼ばれる名前を付けます）

ドロップダウンリストで、デバイスを選択します device要素にdevice.dhcp要素を作成するのと同じ方法で、デバイスの設定に関心があります。

ここで、Alt + Insert属性を作成するか、device.dhcpのコンテキストメニューから、使用可能な値のツールチップをホバーすると、使用可能な属性のドロップダウンリストが開きます。

Staticを設定します-この場合、これはDHCPオプション160と66が無視されることを意味します。同じ方法で他のパラメーターを設定すると、次のファイルが作成されます。

 <?xml version="1.0" encoding="utf-8" standalone="yes"?> <polycomConfig xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="polycomConfig.xsd"> <device device.set="1"> <device.dhcp device.dhcp.bootSrvUseOpt="Static" device.dhcp.enabled="1"> <device.dhcp.enabled device.dhcp.enabled.set="1" /> <device.dhcp.bootSrvUseOpt device.dhcp.bootSrvUseOpt.set="1" /> </device.dhcp> <device.prov device.prov.serverName="http://192.168..:8088/phoneprov/" device.prov.serverType="HTTP"> <device.prov.serverName device.prov.serverName.set="1" /> <device.prov.serverType device.prov.serverType.set="1" /> </device.prov> </device> </polycomConfig>

<デバイスdevice.set = "1">	デバイス設定を設定する
device.dhcp.bootSrvUseOpt = "静的"	DHCPオプション66および160を無視する
device.dhcp.enabled = "1"	DHCPを使用する
<device.dhcp.enabled device.dhcp.enabled.set = "1" />	設定値dhcp.enabled
<device.dhcp.bootSrvUseOpt device.dhcp.bootSrvUseOpt.set = "1" />	bootSrvUseOpt値を設定します
device.prov.serverName = "http：//192.168.xxx.xxx：8088 / phoneprov /"	ファイルパス
device.prov.serverType = "HTTP"	プロビジョニングサーバータイプ
<device.prov.serverName device.prov.serverName.set = "1" />	serverNameを設定します
<device.prov.serverType device.prov.serverType.set = "1" />	serverTypeを設定します

太字の属性には特に注意を払う必要があります。これはスイッチのようなものです。パラメータの値を入力するだけでは十分ではありません。具体的に「はい」と言う必要もあります。このパラメータを適用する必要があります。 <Device device.set = "1">は特に重要です。このパラメーターが0の場合、デバイス要素のすべての設定は無視されます。

アスタリスク設定

これで、起動時に192.168.xxx.xxxからファイルを要求するようになりました：8088 / phoneprov /。それらを無から昇華させる必要があります。この値に対して、アスタリスクには特別なモジュールがあり、テンプレートに基づいてファイルを自動的に生成し、アスタリスクの組み込みHTTPサーバーを介してそれらをアップロードできます。詳細についてはこちらをご覧ください。特に次のように記載されています。

/etc/asterisk/manager.confに以下が含まれていることを確認してください。

[一般]

enabled = yes; -おそらく必要ですが、理由はわかりませんが

webenabled = yes; -おそらく必要ですが、理由はわかりませんが

/etc/asterisk/http.confに以下が含まれていることを確認してください。

[一般]

enabled = yes; 組み込みHTTPサーバーを含む

bindaddr = 192.168.xxx.xxx; IP-サーバーが利用可能になる

bindport = 8088; -なぜならポート80はApacheによって占有され、8088を使用します

httpサーバーからファイルを要求する場合、phoneprovはファイルテンプレートを取得し、users.confから取得した変数を置き換えます。これは特に便利で、ダイヤルプランのテキスト機能を使用できます。たとえば、構成ファイルが小文字でユーザーのMACアドレスに形成されると、テンプレート内の$ {TOLOWER（$ {MAC}）}が置き換えられます。

次の変数をテンプレートで使用できます。

 fullname = User Two ; ${DISPLAY_NAME} secret = test ; ${SECRET} username = 6001 ; ${USERNAME} macaddress = deadbeef4dad ; ${MAC} label = 6001 ; ${LABEL} cid_number = 6001 ; ${CALLERID}    : ${SERVER} –   phoneprov.conf    ,    bindaddr  http.conf ${SERVER_PORT} -   bindport  sip.conf,    ,  5060

res_phoneprov自体の構成ファイルは/etc/asterisk/phoneprov.confです。このファイルでは、パス/ var / lib /アスタリスク/ phoneprov /に関連する静的ファイルのディレクトリ、静的ファイルのリスト、動的に生成されるファイルのテンプレートおよび名前テンプレートのリストを指定する必要があります。以下に例を示します。

 [general] serveraddr=192.168.. ;   ${SERVER}. serverport=5060 ;   ${SERVER_PORT}. default_profile=polycom ;        users.conf [polycom] staticdir => configs/ ;    , ,  ,    ..,   /var/lib/asterisk/phoneprov/ mime_type => text/xml static_file => 2345-12345-001.bootrom.ld static_file => 2345-12360-001.bootrom.ld static_file => 2345-12365-001.bootrom.ld static_file => 2345-12365-002.bootrom.ld static_file => 2345-12375-001.bootrom.ld static_file => 2345-12375-002.bootrom.ld static_file => 2345-12450-001.bootrom.ld static_file => 2345-12450-002.bootrom.ld static_file => 2345-12500-001.bootrom.ld static_file => 2345-12560-001.bootrom.ld static_file => 2345-12600-001.bootrom.ld static_file => 2345-12600-002.bootrom.ld static_file => 2345-12670-001.bootrom.ld static_file => 2345-12670-002.bootrom.ld static_file => 3111-15600-001.bootrom.ld static_file => 3111-30900-001.bootrom.ld static_file => 3111-40000-001.bootrom.ld static_file => bootrom.ld static_file => sip.ver static_file => sip.ld static_file => 000000000000-directory.xml ;-    static_file => languages/Website_dictionary_language_ru-ru.xml static_file => SoundPointIPLocalization/Russian_Russia/SoundPointIP-dictionary.xml ;------------ ${TOLOWER(${MAC})}.cfg => 000000000000.cfg ; ,    http://192.168..:8088/phoneprov/111111111111.cfg      000000000000.cfg   111111111111.cfg,         users.conf      macaddress=111111111111 ${TOLOWER(${MAC})}-custom.cfg => 000000000000-phone.cfg ;   http://192.168..:8088/phoneprov/111111111111-custom.cfg    111111111111-custom.cfg         users.conf      macaddress=111111111111

静的ファイルを使用すると、すべてが簡単になります。ファイルがphoneprov.confに登録され、適切なアドレスに配置されている場合、Webサーバーから使用できます。

ダイナミックでは、もう少し複雑に見えますが、すべてが明確になります。サンプルテンプレートを次に示します。

000000000000.cfg

 <?xml version="1.0" encoding="utf-8" standalone="yes"?> <APPLICATION APP_FILE_PATH="sip.ld" CONFIG_FILES="${TOLOWER(${MAC})}-custom.cfg" MISC_FILES="" LOG_FILE_DIRECTORY="" OVERRIDES_DIRECTORY="" CONTACTS_DIRECTORY="" LICENSE_DIRECTORY="" USER_PROFILES_DIRECTORY="" CALL_LISTS_DIRECTORY=""> </APPLICATION>

デフォルトでは、すべての電話は1234123adba.cfgファイルを要求します。1234123adbaは電話のMACアドレスです。電話はリクエストhttp：//192.168.xxxx.xxx：8088 / phoneprov / 1234123adba.cfgを送信します。このテンプレートには変数が1つしかなく、CONFIG_FILES = "$ {TOLOWER（$ {MAC}）}-custom.cfg"ディレクティブはCONFIG_FILES = "1234123adba-custom.cfg"になり、設定ファイル1234123adbaをダウンロードする必要があることを電話機に伝えます。 -custom.cfg。電話機は、 http：//192.168.xxx.xxx：8088 / phoneprov / 1234123adba.cfg-custom.cfgというリクエストを送信します。サーバーは、2番目のテンプレート000000000000-phone.cfgに基づいて別の動的ファイルを生成します。

000000000000-phone.cfg

 <?xml version="1.0" encoding="utf-8" standalone="yes"?> <polycomConfig xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="polycomConfig.xsd"> <call call.callsPerLineKey="2"></call> <reg reg.1.address="${USERNAME}" reg.1.auth.password="${SECRET}" reg.1.auth.userId="${USERNAME}" reg.1.label="${USERNAME}" reg.1.outboundProxy.address="${SERVER}" reg.1.lineKeys="2" reg.1.auth.domain="${SERVER}" reg.1.displayName="${USERNAME}" reg.1.server.1.address="${SERVER}" reg.1.server.1.register="1"></reg> <device device.set="1"> <device.dhcp device.dhcp.bootSrvUseOpt="Static" device.dhcp.enabled="0"> <device.dhcp.enabled device.dhcp.enabled.set="1" /> <device.dhcp.bootSrvUseOpt device.dhcp.bootSrvUseOpt.set="1" /> </device.dhcp> <device.dns device.dns.serverAddress="192.168.xxx.1" device.dns.altSrvAddress="8.8.8.8"> <device.dns.serverAddress device.dns.serverAddress.set="1" /> </device.dns> <device.prov device.prov.serverName="http://192.168.xxx.xxx:8088/phoneprov/" device.prov.serverType="HTTP"> <device.prov.serverName device.prov.serverName.set="1" /> <device.prov.serverType device.prov.serverType.set="1" /> </device.prov> <device.net device.net.ipAddress="192.168.XXX.${USERNAME}" device.net.subnetMask="255.255.255.0" device.net.IPgateway="192.168.xxx.1"> <device.net.ipAddress device.net.ipAddress.set="1" /> <device.net.subnetMask device.net.subnetMask.set="1" /> <device.net.IPgateway device.net.IPgateway.set="1" /> </device.net> <device.sntp device.sntp.gmtOffset="14400" device.sntp.serverName="pool.ntp.org"> <device.sntp.gmtOffset device.sntp.gmtOffset.set="1" /> <device.sntp.serverName device.sntp.serverName.set="1" /> </device.sntp> </device> <dialplan dialplan.1.digitmap="" dialplan.1.digitmap.timeOut="" dialplan.1.impossibleMatchHandling="2" /> <lcl> <lcl.ml lcl.ml.lang="Russian_Russia" /> </lcl> <tcpIpApp> <tcpIpApp.sntp.daylightSavings tcpIpApp.sntp.daylightSavings.enable="0" /> </tcpIpApp.sntp> </tcpIpApp> </polycomConfig>

ここではいくつかの変数が使用されます：

$ {SECRET}は、users.confのポピー1234123adbaを使用して、ユーザーの説明の秘密の値を置き換えます

$ {USERNAME}は、ユーザーの説明のユーザー名の値を、users.confのポピー1234123adbaに置き換えます。

$ {SERVER}は、phoneprov.confの値を置き換えます

注意してください！ phoneprov.confを変更した後、設定を厳しくするためにリロードが必要です。

すべての準備が整ったら、コンソールで確認します。

phoneprovショールート

静的ルートを表示する必要があります。動的ルートは、users.confにautoprov = yesのユーザーとmasアドレスがある場合にのみ表示されます

users.confの構成

/etc/asterisk/users.confを作成するためのほとんどすべてが残っています。ここでも、最適化の機会がありました。 Android向けのzxingアプリケーションを使用して、電話機のすべてのMACアドレスをボックスから直接スキャンし、同じアプリケーションからメールに送信しました。小規模の場合、各ポピーに何らかのアカウントを関連付けることが依然として当てはまります。各macaddress = .......のために書く手、どういうわけか私はしたくありませんでした。表形式のデータに基づいてアスタリスク構成を自動的に生成するためのファイルを作成しました。これにはパスワードジェネレータもあります。

列をコピーしてusers.confに貼り付けるだけです。このプロジェクトの携帯電話はすべて同じです。全員のテンプレートを作成し、ユーザーの説明にMACとパスワードのみを追加するのが理にかなっているからです。

/etc/asterisk/users.conf

 ... [def](!) ;-   type=friend fromuser="CPZ" host=dynamic nat=no disallow=all allow=ulaw allow=alaw hasvoicemail = no hassip = yes hasiax = no hash323 = no hasmanager = no qualify=yes autoprov = yes ;-      context=full [101](def) secret=XAHNGNCCXGR macaddress=0004f24ab859 [102](def) secret=OSANPHVZIEX macaddress=0004f24abdd6 [103](def) secret=AHUDYLSXFGT macaddress=0004f24ab766 ……

すべての準備が整ったら、コンソールで確認してください：phoneprov show routes

静的ルートと動的ルートの両方が表示されるはずです。ブラウザ192.168.xxxx.xxxをチェックするために残ります：8088 / phoneprov / 1234123adba.cfgたとえば、電話をオンにすると、すべてが自動的に行われます。

セキュリティを忘れないでください。インフラストラクチャを展開した後、設定またはソフトウェアを更新する必要があるまで、ftpサーバーを無効にし、アスタリスクで組み込みWebサーバーを無効にすることをお勧めします。突然構成を頻繁に変更する必要がある場合は、HTTPSを使用してください。

アスタリスクを使用した自動プロビジョニング（自動調整）Polycom電話