SORACOM Users

SORACOM Peek を利用して VPG のパケットをキャプチャする

当ガイドでは、SORACOM Peek (以降、Peek)を利用して、IoT SIM が所属する VPG のパケットをキャプチャします。

はじめに

IoT SIM を利用するデバイスの通信時に SORACOM プラットフォームを通過する IP パケットをキャプチャするサービスです。 お客様はパケットキャプチャ用のサーバーを用意することなく、API を用いて簡単、安全にパケットをキャプチャできます。

Peek概要

当ガイドは以下の 7 つのステップです。

当ガイドの前提は以下のとおりです。

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

ステップ 1 : VPG を作成し、SIM を所属させる

現時点では、Peek は VPG に所属した SIM のパケットをキャプチャします。Peek を利用できる VPG のタイプは Type-E、Type-F です。

VPG を作成するを参照して新規に VPG を作成し、SORACOM IoT SIM の VPG 利用を有効にするを参照してパケットをキャプチャしたい SIM の VPG 利用を有効にします。オンラインの SIM の VPG 利用を有効にするには、必ずセッションの再作成が必要です。

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

作成した VPG の管理画面より [パケットキャプチャ] タブ > [キャプチャを開始] をクリックし、パケットキャプチャセッションを開始します。

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

注意
既にパケットキャプチャセッションが作成されている場合、別のパケットキャプチャセッションは作成できません。

パケットキャプチャセッションを SORACOM API で作成する場合は createPacketCaptureSession を使用します。

SORACOM CLI を使う場合は以下のコマンドを使用します。

soracom vpg create-packet-capture-session

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

作成した VPG の管理画面より [パケットキャプチャ] タブにて作成されたパケットキャプチャセッションが表示されます。各列の意味は以下となります。

意味
作成日時 パケットキャプチャセッションの作成が要求された日時
開始 パケットキャプチャセッションが開始された日時
ステータス パケットキャプチャセッションの状態です。各状態の意味はパケットキャプチャセッションの状態を参照してください
ファイル名 (PREFIX) 任意に入力されたパケットキャプチャセッションを識別する名前
キャプチャ時間 パケットキャプチャセッションを取得する期間 (秒)
パケットキャプチャファイル パケットキャプチャが完了するとダウンロードリンクが取得できるようになります
削除 削除できます

パケットキャプチャセッションを SORACOM API で確認する場合は listPacketCaptureSessions を使用します。

SORACOM CLI を使う場合は以下のコマンドを使用します。

soracom vpg list-packet-capture-sessions

ステップ 4 : パケットをキャプチャする

作成したパケットキャプチャセッションの状態が「CAPTURING」になると、パケットのキャプチャが開始されています。

デバイスでキャプチャする通信を開始します。たとえば SORACOM IoT SIM を USB ドングルなどで取り付けている Linux デバイスであれば以下のコマンドで SORACOM プラットフォームとの疎通を確認できます。

ping -c 4 pong.soracom.io

ステップ 5 : パケットをダウンロードする

作成したパケットキャプチャセッションの状態が「DONE」になると、パケットのキャプチャが完了しています。

「パケットキャプチャファイル」列の [リンクを取得] をクリックします。

次に「パケットキャプチャファイル」列の [ダウンロード] をクリックするとダウンロードが開始します。

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

ダウンロード URL を SORACOM API で確認する場合は getPacketCaptureSession を使用します。

SORACOM CLI を使う場合は以下のコマンドを使用します。この際、url パラメータ がエスケープされないよう --raw-output オプションを指定してください。

soracom vpg get-packet-capture-session

ステップ 6 : パケットを解析する

パケットは pcap 形式でダウンロードされますので、各種パケットアナライザで解析できます。ここでは Wireshark を例にした解析方法を紹介します。

Wireshark は Windows, mac などで利用できます。こちらのページよりダウンロードが可能です。ダウンロード・インストールしたら起動し、[ファイル] > [開く] より pcap ファイルを開いてください。

開いた pcap ファイルを元に、宛先やパケットの内容を調査できます。

ステップ 7 : パケットキャプチャセッションを削除する

セキュリティのため、パケットキャプチャセッションは作成後 7 日で自動削除されます。手動で削除する場合は「削除」列のゴミ箱アイコンをクリックします。

注意
VPG が不要であればVPG を削除するを実施してください。VPG を削除されない場合、基本料金が発生します。

パケットキャプチャセッション を SORACOM API で削除する場合は deletePacketCaptureSession を使用します。

SORACOM CLI を使う場合は以下のコマンドを使用します。

soracom vpg delete-packet-capture-session

Getting Started

SORACOM Air for セルラー

SORACOM Air for LoRaWAN

SORACOM Air for Sigfox

SORACOM Beam

SORACOM Canal/Direct/Door

SORACOM Endorse

SORACOM Funnel

SORACOM Funk

SORACOM Gate

SORACOM Harvest

SORACOM Inventory

SORACOM Junction

SORACOM Krypton

SORACOM Lagoon

SORACOM Mosaic

SORACOM Napter

SORACOM Orbit

SORACOM Peek

SORACOM LTE-M Button

GPS マルチユニット SORACOM Edition

IoT 体験キット

Device

サービス機能詳細

Developer Tools

Design Patterns

pagetop