Soracom Beam

Test Servers for Soracom Beam

Soracom provides test servers that you can use to verify how Beam forwards connections from a device. You can configure Beam settings to forward connection requests to one of the following test servers in order to confirm that forwarding is successful.

HTTPS Test Server

Configure Beam for HTTP entry point using the following Destination parameters:

Ensure that the IMSI Header or SIM ID Header option is enabled.

Then from the device, simply make an HTTP request to the Entry point http://beam.soracom.io:8888.

Beam will receive the request from the device, append the device IMSI or SIM ID to the HTTP request header, and forward it to the test server. The test server will return a JSON response containing a greeting and the forwarded X-Soracom-Imsi and/or X-Soracom-Sim-Id header values.

For a step-by-step example, see Sending a POST Request to the HTTPS Test Server.

HTTPS Test Server (with WebSocket)

Configure Beam for Website entry point using the following Destination parameters:

Ensure that the IMSI Header or SIM ID Header option is enabled.

Then from the device, make a WebSocket connection to the Entry point ws://beam.soracom.io:18080.

Beam will receive the request from the device, append the device IMSI or SIM ID to the HTTP request header, and forward it to the test server. The test server will return a JSON response containing a greeting and the forwarded X-Soracom-Imsi and/or X-Soracom-Sim-Id header values.

For a step-by-step example, see Communicating with the HTTPS Test Server Using WebSocket.

MQTTS Test Server

Configure Beam for MQTT entry point using the following Destination parameters:

Then, connect to the same test server using an MQTT client with the same host name, port number, username, and password. You can then use your MQTT client to subscribe to a message topic. When your device publishes an MQTT message on the topic, your MQTT client should receive the message.

For a step-by-step example, see Establishing an MQTTS Connection with the MQTTS Test Server.

TCPS Test Server

Configure Beam for TCP → TCP/TCPS entry point using the following Destination parameters:

Ensure that the IMSI Header or SIM ID Header option is enabled.

Then from the device, make a telnet connection to the Entry point on host beam.soracom.io and port 8023.

Beam will receive the TCP request from the device, append the device IMSI or SIM ID to the initial message, and forward it to the test server. The test server then accepts the connection and returns a greeting message containing the forwarded header information in the TCP session.

For a step-by-step example, see Sending Data to the TCPS Test Server.