Soracom

SORACOM Peek (以下、Peek) の「パケットキャプチャセッション」を作成すると、一定時間 IoT SIM のパケットをキャプチャできます。これを、Peek for SIM と呼びます。

パケットキャプチャセッションが終了すると、pcap 形式のパケットキャプチャファイルをダウンロードできます。パケットキャプチャファイルは、Wireshark などのパケットアナライザで解析できます。

準備

あらかじめ、以下の準備をしてください。

• オペレーターを作成する

• IoT SIM を取り付けたデバイスで、SORACOM プラットフォームに接続する。

  各種デバイスでの IoT SIM の使用例については、各種デバイスで SORACOM Air を使用する を参照してください。

ステップ 1: 新しいパケットキャプチャセッションを作成する

1. ユーザーコンソール にログインします。

2. [メニュー] → [SORACOM AIR FOR セルラー] → [SIM 管理] の順にクリックします。

   SIM 管理画面が表示されます。

3. パケットをキャプチャする IoT SIM にチェックを入れて、[操作] → [パケットキャプチャ] の順にクリックします。

   

   SIM 詳細画面の [パケットキャプチャ] タブが表示されます。

4. [キャプチャを開始] をクリックします。

   

   「パケットキャプチャセッションを開始」画面が表示されます。

5. 以下のパラメータを設定して、[キャプチャを開始] をクリックします。

   項目	説明
   [ファイル名 (PREFIX)]	パケットキャプチャファイルのプレフィックス (先頭に付与する文字列) を指定します (最大 100 文字)。使用できる文字は、半角英数字 (a ～ z、A ～ Z、0 ～ 9) または記号 (_、-) です。
   [キャプチャ時間 (秒)] *	60 ～ 86400 秒 (24 時間) の範囲で指定します。

   

   パケットキャプチャセッションが作成され、「パケットキャプチャセッション」画面が表示されます。

ステップ 2: パケットキャプチャセッション一覧を確認する

作成されたパケットキャプチャセッションは、SIM 詳細画面の [パケットキャプチャ] タブに表示されます。表示される内容は以下のとおりです。

ステップ 3: パケットを送信する

作成したパケットキャプチャセッションのステータスが REQUESTED に変わったことを確認し、ステップ 1: 新しいパケットキャプチャセッションを作成する でチェックを入れた IoT SIM を利用するデバイスで通信してください。

SORACOM プラットフォームにパケットが届くとパケットのキャプチャが開始され、ステータスが CAPTURING に変わります。

たとえば、SORACOM IoT SIM を USB ドングルなどで取り付けた Linux デバイスであれば、以下のコマンドで SORACOM プラットフォームにパケットを送信できます。

$ ping -c 4 pong.soracom.io

パケットキャプチャセッションを途中で停止する

[キャプチャ時間 (秒)] で指定した時間が経過する前に、パケットキャプチャセッションを停止できます。

1. SIM 詳細画面の [パケットキャプチャ] をクリックし、停止するパケットキャプチャセッションの [停止] をクリックして、[停止] をクリックします。

   

   パケットキャプチャセッションが停止され、ステータスの表示が POSTPROCESSING に変わり、続けて STOPPED または DONE に変わります。

   

2. ステータスの表示が変わらない場合は、[パケットキャプチャ] タブの右上にある (リフレッシュボタン) をクリックします。

ステップ 4: パケットキャプチャファイルをダウンロードする

パケットキャプチャセッションのステータスが DONE または STOPPED になると、pcap 形式のパケットキャプチャファイルをダウンロードできます。

1. SIM 詳細画面の [パケットキャプチャ] をクリックし、[パケットキャプチャファイル] の [リンクを取得] をクリックします。

   

   パケットキャプチャファイルのダウンロード URL が取得され、[ダウンロード] と表示されます。

2. [ダウンロード] をクリックします。

   

   pcap 形式のパケットキャプチャファイルがダウンロードされます。

   ダウンロードが開始されない場合、お使いのネットワークでアクセスがブロックされていないか確認してください。

ステップ 5: キャプチャしたパケットを確認する

Wireshark で pcap 形式のファイルを確認する操作を説明します。Wireshark は Windows や Mac OS で利用できるアプリケーションです。あらかじめ、ダウンロードおよびインストールしてください。

1. Wireshark を起動し、[ファイル] → [開く] の順にクリックし、ステップ 4: パケットキャプチャファイルをダウンロードする でダウンロードした pcap 形式のファイルを選択します。

2. 宛先やパケットの内容を調査します。

   

   Wireshark の操作方法について

   Wireshark · Documentation を参照してください。

SORACOM CLI / SORACOM API の場合

SORACOM CLI または SORACOM API を利用しても、IoT SIM のパケットをキャプチャできます。

$ soracom sims create-packet-capture-session --sim-id {sim_id} --duration 300 --prefix "sim-peek-test"

$ soracom sims list-packet-capture-sessions --sim-id {sim_id}

$ soracom sims delete-packet-capture-session --sim-id {sim_id} --session-id {session_id}

$ soracom sims stop-packet-capture-session --sim-id {sim_id} --session-id {session_id}

$ soracom sims get-packet-capture-session --sim-id {sim_id} --session-id {session_id} --raw-output

$ curl -v -X POST https://api.soracom.io/v1/sims/{sim_id}/packet_capture_sessions \
-H "X-Soracom-API-Key: $X_SORACOM_API_KEY" \
-H "X-Soracom-Token: $X_SORACOM_TOKEN" \
-H "Content-Type: application/json" \
-d '{
  "duration": 300,
  "prefix": "sim-peek-test"
}'

$ curl -v -X GET https://api.soracom.io/v1/sims/{sim_id}/packet_capture_sessions \
-H "X-Soracom-API-Key: $X_SORACOM_API_KEY" \
-H "X-Soracom-Token: $X_SORACOM_TOKEN"

$ curl -v -X DELETE https://api.soracom.io/v1/sims/{sim_id}/packet_capture_sessions/{session_id} \
-H "X-Soracom-API-Key: $X_SORACOM_API_KEY" \
-H "X-Soracom-Token: $X_SORACOM_TOKEN"

$ curl -v -X POST https://api.soracom.io/v1/sims/{sim_id}/packet_capture_sessions/{session_id}/stop \
-H "X-Soracom-API-Key: $X_SORACOM_API_KEY" \
-H "X-Soracom-Token: $X_SORACOM_TOKEN"

$ curl -v -X GET https://api.soracom.io/v1/sims/{sim_id}/packet_capture_sessions/{session_id} \
-H "X-Soracom-API-Key: $X_SORACOM_API_KEY" \
-H "X-Soracom-Token: $X_SORACOM_TOKEN"