Sonata - SIP プロビジョニング サーバー

プロビジョニングを何と比較すればよいのかわかりません。 もしかして猫と一緒？ なくても可能のようですが、あると少し良くなります。 特にそれが機能する場合））

問題の定式化:

1. SIP 電話を迅速、簡単、安全にセットアップしたいと考えています。 電話機を設置するとき、そしてそれを再設定するときはなおさらです。
2. 多くのベンダーは、独自の構成形式、構成を生成するための独自のユーティリティ、および構成を保護する独自の方法を持っています。 そして、私は本当は全員と関わりたくないのです。
3. 多くのプロビジョニング ソリューションは、a) XNUMX つのベンダーまたは XNUMX つの電話システムに焦点を当てており、b) 実装が非常に面倒で、多くのスクリプト、パラメータ、ブラー...

ポイント 3 については、優れたプロビジョニング システムがあることについてコメントします。 無料PBX, FusionPBX用, カズー用では、さまざまなベンダーの電話用のテンプレートが公開されています。 Yeastar PBX など、プロビジョニング モジュールでさまざまなメーカーの電話の動作を設定できる商用ソリューションもあります。

Habré には、さまざまなベンダーのデバイスのセットアップ方法に関するレシピも満載です。 時間, два。 しかし、よく言われるように、すべてのシステムには致命的な欠陥があります。 ということで、自分たちでバイクを作りましょう。

独自のフォーマット

xkcd で言われているように、14 のフォーマットを扱いたくない場合は、 15番目を考え出す。 したがって、どの電話にも一般的な設定を使用し、独自の json config 形式を作成します。

このようなもの：

{
   "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 を取得し、ログイン パスワードの MAC アドレスを書き留め、独自のスクリプトを使用してファイルを生成し、それを Apache Web サーバーに配置すれば、すべてがうまくいきます。

通常、マニュアルの次の段落には、生成された構成ファイルを暗号化することもできることが記載されています。

しかし、これらはすべて古典です。 スムージーと Twitter を使った最新のアプローチでは、Apache ほど強力ではないものの、小さなことを XNUMX つだけ実行する既製の Web サーバーを作成する必要があると言われています。 リンクを使用して構成を生成し、送信します。

ここでやめて、ほとんどすべての SIP 電話機は http/https 経由で設定を受信できるようになったので、他の実装 (ftp、tftp、ftps) は考慮していないことを思い出してください。 その後、各電話機は自身の MAC アドレスを認識します。 したがって、XNUMX つのリンクを作成します。XNUMX つはデバイス キーに基づく個人用リンク、もう XNUMX つは共通トークンと MAC アドレスの組み合わせを使用して動作する一般的なリンクです。

また、ゼロ構成については詳しく説明しません。 電話機を最初からセットアップする、つまりそれをネットワークに接続すると、動作し始めました。 いいえ、私のシナリオでは、電話機をネットワークに接続し、予備セットアップ（プロビジョニング サーバーから設定を受信するようにセットアップ）を行ってから、ピニャコラーダを飲み、プロビジョニングを通じて必要に応じて電話機を再設定します。 オプション 66 の配布は DHCP サーバーの責任です。

ちなみに「プロビジョニング」と言うのはもう飽きたので「プロビジョニング」と略しました、蹴らないで下さい。

そしてもう XNUMX つ、プロビジョニング サーバーには UI がありません。 ユーザーインターフェース。 おそらく、今のところはわかりませんが、なぜなら... 必要ないんです。 ただし、設定を保存/削除したり、サポートされているベンダーやモデルのリストを取得したりするための API があり、すべてが Swagger 仕様の規範に従って説明されています。

なぜ UI ではなく API なのでしょうか? なぜなら私はすでに独自の電話システムを持っており、資格情報のソースも持っているので、このデータを取得して必要な JSON をコンパイルし、プロビジョニング サーバーで公開するだけです。 そして、プロビジョニング サーバーは、json ファイルで指定されたルールに従って、必要なデバイスにその構成を提供します。デバイスが正しくない場合、またはこの json ファイルで指定された基準も満たさない場合は、構成を提供しません。

プロビジョニング マイクロサービスはこのようになりました。 呼ばれた ソナタ、ソースコードは GitHub で入手できます。 準備ができた Docker イメージ、docker の使用例 ここで.

主な特徴:

• いずれの場合も、構成へのアクセスは時間によって制限されます (デフォルトでは 10 分)。 構成を再度利用できるようにする場合は、構成を再度公開します。

• すべてのベンダーに XNUMX つの形式を適用し、すべての調整はソナタで削除され、標準化された JSON を送信し、利用可能な機器を設定します。

• デバイスに発行されたすべての設定がログに記録され、すべての問題領域がログで表示され、エラーが確認できます。

• トークンを使用して XNUMX つの共通リンクを使用することができます。各電話機は MAC アドレスを指定することで独自の設定を受け取ります。 またはキーを介した個人リンク。

• 管理（マネジメント）および電話機への設定のプロビジョニング（プロビジョニング）用の API はポートごとに分割されています

• テスト。 発行された構成の形式を修正し、テストで構成を発行する通常の状況をすべてカバーすることは、私にとって非常に重要でした。 これですべてが明確に機能します。

短所：

これまでのところ、Sonata 内では暗号化は一切使用されていません。 それらの。 もちろん、たとえば Sonata の前に nginx を置くことで https の使用を開始することもできます。 しかし、独自の方法はまだ使用されていません。 なぜ？ このプロジェクトはまだ若く、最初の XNUMX 台のデバイスが発売されました。 そしてもちろん、アイデアやフィードバックも収集します。 さらに、すべてを安全にしてネットワーク上で設定を盗聴できないようにするには、おそらく暗号化キー、TLS、およびそれらを使用したハリネズミに手間をかける価値がありますが、これは続きになります。

UIの欠如。 おそらく、これはエンド ユーザーにとっては重大な欠点ですが、システム管理者にとっては、本格的なアプリケーションよりもコンソール ユーティリティの方が重要です。 コンソール ユーティリティを作成する計画がありましたが、必要かどうかわかりません。

その結果は？

管理用の API を使用して複数の電話モデルをプロビジョニングするための、小規模でシンプルな Web サーバー。

もう一度言いますが、これはどのように機能するのでしょうか?

1. ソナタをインストールしています。
2. json 構成を作成し、sonata で公開します。
3. 次に、sonata からプロビジョニング リンクを受け取ります。
4. 次に、電話でこのリンクを示します。
5. デバイスが構成をロードしています

その後の操作は XNUMX つのステップのみです。

1. json 構成を作成し、sonata で公開します。
2. デバイスが構成をロードしています

どの携帯電話がプロモーション対象になりますか?

ベンダー Grandstream、Fanvil、Yealink。 ベンダー内の構成はほぼ同じですが、ファームウェアによって異なる場合があります。追加のテストが必要な場合があります。

どのようなルールを設定できますか?

時間までに。 設定を利用できるようになるまでの時間を指定できます。
MACアドレスによる。 デバイスの個人リンク経由で構成を送信する場合、MAC アドレスもチェックされます。
IPによる。 リクエストが行われた IP アドレスによる。

ソナタとどのように対話するか?

API 経由で、http リクエストを実行します。 API はインストール環境で利用できるようになります。 なぜならAPI は Swagger 仕様をサポートしており、次を使用できます。 オンラインユーティリティ API へのテストリクエスト用。

わかりました、素晴らしいです。 素敵な商品ですので、試してみてはいかがでしょうか？

最も簡単な方法は、リポジトリに基づいて Docker イメージをデプロイすることです ソナタのサンプル。 リポジトリにはインストール手順が含まれています。

Node.js を知っている場合はどうすればよいですか?

JavaScript の使用経験がある場合は、ここですべてがどのように機能するかすぐに理解できるでしょう。

ソナタの開発はあるのでしょうか？

目標を部分的に達成しました。 電話のセットアップの自動化というテーマに関するさらなる開発は私の課題です。 構成を拡張して電話ボタンを構成したり、アドレス帳プロビジョニングなどを追加したり、コメントに書き込んだりする機会もあります。

要約と謝辞

建設的な提案、反論、コメント、質問をいただければ幸いです。なぜなら... おそらく彼は何か理解できないことを説明したのかもしれない。

また、支援、アドバイス、テスト、およびテスト用の携帯電話の提供/寄付をしてくれたすべての同僚に感謝の意を表します。 実際、私が仕事上でコミュニケーションをとった多くの人たちが、程度の差こそあれこのプロジェクトに関わっていますが、 アスターコンフチャットやメールで。 アイデアや考えをありがとう。

出所： habr.com