Soracom

Users

ドキュメント

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

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

Beam のエントリポイントは、SORACOM Air シリーズ (セルラー、LoRaWAN および Sigfox) および SORACOM Inventory のデバイス以外からは接続できません。

LoRaWAN および Sigfox での Beam のご利用に関しましては以下のドキュメントもあわせて参照してください。

SORACOM Beam を有効にして TCP → TCP/TCPS エントリポイントを設定する 

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

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

tcp/SSL概要

Beam の設定はグループに対して行います
ここでは、グループの設定を変更する操作のみを説明します。グループの仕組みやグループを作成する操作ついて詳しくは、グループ設定 を参照してください。
  1. SIM グループ画面で [SORACOM Beam 設定] をクリックします。

    SIM グループ画面を表示する操作について詳しくは、グループの設定を変更する を参照してください。

  2. [+][TCP → TCP/TCPS エントリポイント] の順にクリックします。

    tcp_entryポイント2

    ダイアログが表示されます。

  3. 以下のように必要事項を設定して最後に [保存] をクリックします。

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

    tcp_entryポイント

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

  4. IoT SIM が所属するグループを切り替えます。

    IoT SIM の Beam の設定が完了しました。

デバイスからの確認 

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 にチェックマークを付けます。続いて、[操作] ボタンから [所属グループ変更] を選択します。
    • 表示されたダイアログで、[グループ解除]をクリックします。