MENU

Soracom

Users

テストサーバーを利用して Beam の設定方法と動作を確認する

以下の流れに沿ってソラコムが用意している Sandbox サーバを使って Beam の設定方法と動作の確認をします。TCP エントリポイント、HTTP エントリポイントの利用例をご紹介します。

Beam のエントリポイントには、SORACOM Air シリーズ (セルラー、LoRaWAN および Sigfox) 以外から接続できません。動作確認の際には SORACOM Air シリーズで通信を行っていることを確認してください。LoRaWAN および Sigfox での Beam のご利用に関しましては以下のドキュメントもあわせて参照してください。

IoT SIM グループの作成と設定

SORACOM Beam の設定はグループ単位で行います。そのため、Beam を使うためには IoT SIM をグループに登録する必要があります。今回は、SORACOM Beam の動作確認をするための専用のグループを作成してそこに IoT SIM を登録してみましょう。

まず IoT SIM 管理画面を開いて、SORACOM Beam による通信を行いたい IoT SIM にチェックマークを付けます。続いて、[操作] ボタンから [所属グループ変更] を選択します。

グループの変更

IoT SIM の所属グループを選択するためのダイアログが表示されますので、[新しい所属グループ] ドロップダウンから [新しいグループを作成…] を選択します。

新しいグループ

以下のようなグループ作成ダイアログが表示されます。グループの名称を入力して [グループ作成] ボタンをクリックします。 今回は “hello beam” というグループ名で作成してみましょう。

グループ作成

[グループ作成] ボタンを押すと元の [SIM の所属グループ変更] ダイアログに戻ります。 [新しい所属グループ] ドロップボックスが、今作成した hello beam グループになっていることを確認し [グループ変更] ボタンを押します。

グループ変更

TCP / SSL: TCP エントリポイントの設定例

Beam を使った通信では、デバイスから Beam のエントリポイントまでは閉域網での接続であるため平文でも安全に通信を行うことができます。さらに、 Beam から外部サーバへの通信は SSL で暗号化して送信できるため、暗号化処理による負荷をかけずに安全に通信を行えます。

このステップでは、TCP エントリポイントの動作確認をするための echo サーバー (tcps://beamtest.soracom.io:1234) を使って、TCP で送信されたデータを TCP over TSL で転送する操作を試してみましょう。

tcp/SSL概要

先ほど作成した hello beam グループに対し、SORACOM Beam の設定を行います。設定を行うためには、グループ管理画面を開き、hello beam グループを選択してグループ詳細画面を開きます。

グループ詳細

[SORACOM Beam 設定] グループの中にある [ + ▼ ] ボタンをクリックします。するとドロップダウン形式でメニューが表示されますので、対象となるエントリポイントを選択してください。 今回の例では TCP → TCP/TCPS エントリポイントを利用します。

tcp_entryポイント2

ダイアログが表示されますので、以下のように必要事項を設定して最後に [保存] ボタンを押してください。

項目
設定名echo over ssl
転送先-プロトコルTCP (SSL)
転送先-ホスト名beamtest.soracom.io
転送先-ポート名1234
オプション- IMSI ヘッダON

tcp_entryポイント

TCP エントリポイントの設定値の意味は エントリポイントリファレンス: TCP → TCP/TCPS エントリポイント を参照してください。

デバイスからの確認

Beam の設定を行った IoT SIM で接続されているデバイスから、上記で設定したエントリポイントに対して telnet で接続してみましょう。今回は暗号化処理と合わせて、IMSI ヘッダを付与するように設定しましたので、IMSI の情報が表示されるはずです。

Raspberry Pi などから telnet で接続し、出力を確認しましょう。echo サーバー (tcps://beamtest.soracom.io:1234) は、送信された文字列をオウム返し (エコーバック) するように設定されています。キーボードから何らかの文字列を入力し、エコーバックがあることを確認できれば設定完了です。

  • 接続先ホスト: beam.soracom.io
  • 接続先ポート番号: 8023
pi@raspberrypi:~$ telnet beam.soracom.io 8023
Trying 169.128.169.128...
Connected to beam.soracom.io.
Escape character is '^]'.
Hello Soracom Beam Client IMSI:4XXXXXXXXXXXXXX ! (←Beam によって IoT SIM の IMSI が付与されている)
hi        (←キーボードから入力)
hi        (←echoサーバからのエコーバック)

HTTP / HTTPS: HTTP エントリポイントの設定例

HTTP エントリポイントも、テスト用のサーバ (https://beamtest.soracom.io) を使って動作確認してみましょう。このテスト用サーバでは、Beam を使ってアクセスした際に、IMSI や HTTP ヘッダなどの Beam で付与された情報を確認できます。

HTTPエントリポイントのイメージ

まず、グループ設定ページで左下の + をクリックし、HTTP エントリポイントを追加します。 [SORACOM Beam 設定] グループの中にある [ + ▼ ] ボタンをクリックし、表示されたメニューの中から HTTP エントリポイントを選択します。

HTTPエントリポイントの追加

設定ダイアログが表示されたら、以下のように必要事項を設定して最後に [保存] ボタンを押します。カスタムヘッダについては、次のセクションで解説しますので、ここでは空欄にしておきます。

項目
設定名http over ssl
エントリポイント-パス/
転送先-プロトコルHTTPS
転送先-ホスト名beamtest.soracom.io
転送先-パス/
オプション- IMSI ヘッダON
カスタムヘッダなし (空欄)

HTTPエントリポイントの設定

HTTP エントリポイントの設定値の意味は エントリポイントリファレンス: HTTP エントリポイント を参照してください。

設定を保存後、Beam の設定を行った IoT SIM で接続されているデバイスから http://beam.soracom.io:8888 にアクセスすると、 IoT SIM の IMSI が表示されます。以下は Raspberry Pi からアクセスした時の出力例です。

pi@raspberrypi:~$ curl http://beam.soracom.io:8888
Hello SORACOM Beam Client xxxxxxxxxxxxxxx !

Beam の設定を変更し IMSI ヘッダを無効にすると、IMSI は表示されず “Hello Unknown Client…” というメッセージが表示されます。

カスタムヘッダの設定

Beam の HTTP エントリポイントでは、データ転送時にカスタムヘッダを追加・削除・置換できます。

SORACOM Beam 設定一覧で、先ほど追加した「http over ssl」の行の一番右にある[…] ボタンをクリックして設定ダイアログを開き、以下のように必要事項を設定して最後に [保存] ボタンを押してください。カスタムヘッダを追加するには、「ヘッダ操作」左下の [+] ボタンを押してください。

カスタムヘッダ

Beam の設定を行った IoT SIM で接続されているデバイスから http://beam.soracom.io:8888 にアクセスすると、以下のように表示されます。IoT SIM の IMSI と合わせて、カスタムヘッダも表示されていることが確認できます。以下は Raspberry Pi からアクセスした時の出力例です。

pi@raspberrypi:~$ curl http://beam.soracom.io:8888
Hello SORACOM Beam Client 4XXXXXXXXXXXXXX !

== HTTP Headers ==
HTTP_X_SORACOM_BEAM=SUCCESS
HTTP_X_SORACOM_IMSI=4XXXXXXXXXXXXXX

エラーログの確認

想定通りに動作しない場合は トラブルシューティングとサポート: エラーログを確認する を参照してください。

Beam 設定の無効化

Beam の利用にはリクエスト単位で料金がかかります。Beam を使わない場合には、設定を無効化するか、グループから登録解除してください。

  • Beam の設定を無効化する場合
    • [SORACOM Beam 設定] グループから無効化したい項目を選択し、設定名横のスイッチを[OFF]にします。
  • グループから登録解除する場合
    • IoT SIM 管理画面を開いて、SORACOM Beam による通信を行いたい IoT SIM にチェックマークを付けます。続いて、[操作] ボタンから [所属グループ変更] を選択します。
    • 表示されたダイアログで、[グループ解除]をクリックします。