説明

以下のHTTP APIは、すべてのMilesightルーターで利用可能です。ユーザーは、以下の手順に従ってこれらのAPIを呼び出し、デバイスを直接制御および管理できます。

要件

• Milesightルーター/CPE
• Linuxシステム

設定

ステップ1. LinuxシステムにCurlソフトウェアをインストールする

sudo apt install curl

インストール結果を確認:

curl -V

Curl ソフトウェアが正常にインストールされている場合、後でソフトウェアのバージョンを確認できます。

Curl ソフトウェアが正常にインストールされている場合、後でソフトウェアのバージョンを確認できます。

ステップ 2. Milesight ルーターのウェブ GUI にアクセスし、Network > Firewall > Security を選択し、SSH アクセスサービスを有効にし、Save をクリックします。

ステップ 3. ルーターのウェブ GUI にアクセスし、「cgi」メッセージを取得して API トークンキーを取得します。

1) Google ブラウザを開き、ルーターの IP アドレスにアクセスします。

2) Main Menu > More Tools > Developer Tools をクリックして開発者ツールを開きます。

3) アカウントとパスワードを入力してルーターにログインします。その後、右側のテキストボックスに「cgi」メッセージが表示されます。View Source をクリックします。

4) 現在の cgi コンテンツをコピーします。

ステップ 4. ステップ 3 の「cgi」コンテンツを以下のコマンドに貼り付けます。IPアドレス「192.168.22.105」をデバイスのIPアドレスに必ず変更してください。

curl -H “Content-Type:application/x-www-form-urlencoded” -c ./cookie.txt -X POST –data ‘{“id”:”1″,”execute”:1,”core”:”user”,”function”:”login”,”values”:[{“username”:”admin”,”password”:”sI/7ewBCeWunDs6JXXtSHg==”}]}’ http://192.168.22.105/cgi

次に、以下の応答が返されます。これは、トークンキーが正常に取得され保存されたことを意味します。

ステップ5. トークンキーを正常に取得後、ユーザーはルーターの他のAPIをリモートで呼び出すことができます。

以下に参照用の関連する一般的なAPIコマンドを一覧表示します。ユーザーはステップ3.を繰り返し実行することで、他のAPIコマンドを取得できます。

注意:

以下のコマンド内の青色部分を必ず置き換えてください。

1) ルーターから電話番号「17799999999」にSMSを送信し、SMSの内容は「123456」とします。

curl -H “Content-Type:application/x-www-form-urlencoded” –b ./cookie.txt -X POST –data ‘{“id”:27,”execute”:1,”core”:”yruo_sms”,”function”:”send”,”values”:[{“base”:”yruo_sms”,”index”:1,”value”:{“destination”:”17799999999“,”content”:”123456“}}]}:’ http://192.168.22.105/cgi

2) SMS送信履歴のクエリ。

curl -H “Content-Type:application/x-www-form-urlencoded” -b ./cookie.txt -X POST –data ‘{“id”:7,”execute”:1,”core”:”yruo_sms”,”function”:”query_outbox”,”values”:[{“base”:”query_outbox”,”limit”:10,”start”:0,”language”:”en”,”key”:”time”,”order”:0,”start_date”:””,”end_date”:””,”from”:”17799999999″}]}’ http://192.168.22.105/cgi

3) SMS履歴をクエリルーターが受信しました。

curl -H “Content-Type:application/x-www-form-urlencoded” -X POST -b ./cookie.txt –data ‘{“id”:6,”execute”:1,”core”:”yruo_sms”,”function”:”query_inbox”,”values”:[{“base”:”query_inbox”,”limit”:10,”start”:0,”language”:”en”,”key”:”time”,”order”:0,”start_date”:””,”end_date”:””,”from”:””}]}’ http://192.168.22.105/cgi

4) セルラー通信のトラフィック消費量をクエリします。

curl -H “Content-Type:application/x-www-form-urlencoded” -b ./cookie.txt -X POST –data ‘{“id”:97,”execute”:1,”core”:”yruo_status”,”function”:”get”,”values”:[{“base”:”yruo_celluar”}]}:’ http://192.168.22.105/cgi

5) ログの深刻度レベルを「デバッグ」レベルに変更します。

curl -H “Content-Type:application/x-www-form-urlencoded” -b ./cookie.txt -X POST –data ‘{“id”:14,”execute”:1,”core”:”yruo_log”,”function”:”set”,”values”:[{“base”:”log_settings”,”index”:1,”value”:{“loglevel”:8}}]}’ http://192.168.22.105/cgi

6) ルーターを再起動します。

curl -H “Content-Type:application/x-www-form-urlencoded” -b ./cookie.txt -X POST –data ‘{“id”:6,”execute”:1,”core”:”yruo_upgrade”,”function”:”reboot”,”values”:[{}]}’ http://192.168.22.105/cgi

注意: 関連するSMS APIを使用する場合、SIMカードがメッセージの送受信が可能であることを確認してください。

7) HTTPS証明書をインポート（sessionid=cookie td）

td_value=$(grep -w “td” cookie.txt | awk ‘{print $7}’) curl ‘http://192.168.40.50/cgi-bin/file-import’ -b ./cookie.txt -F “sessionid=$td_value” -F “filename=type=https&file=certificate” -F “file=@/home/mia/test.crt” –insecure -v

「/home/mia/test.crt」 を自分の証明書のパスに置き換えてください。

8) ルーターログのダウンロード

td_value=$(grep -w “td” cookie.txt | awk ‘{print $7}’) curl -X POST “http://192.168.40.50/cgi-bin/file-export” -b ./cookie.txt -d “sessionid=$td_value” -d “file=all” -d “type=log” -o exported_log_file.tar

指定したファイルをダウンロードするには、「file」タイプを変更できます。
すべてのファイルをダウンロードするには、「file=all」を使用します。
VPNファイルをダウンロードするには、「file=vpn.log」と記述できます。

 

-以上-