SORACOM Beam Hands-on

1. Hands-on Series
SORACOM Beam

2. Introduction
• Ship devices set with data sent to fixed address & have end users change the destination
themselves after receiving the SIM.
• Offload encryption to the cloud by using resource light protocols to send data to BEAM and
convert it to higher security protocols. E.g. UDP to HTTPs or MQTT to MQTTs
• Connect directly to any cloud.
SORACOM Beam is a service designed to offset the load associated with encryption, advanced
processing, and connection settings from IoT devices onto the cloud.

3. Reading materials for BEAM:
• Service Overview
• Getting Started - Beam
Resources
Laptop
Wi-Fi Hotspot/
Personal Hotspot
AIR SIM Global
SETUP
used
• Command Prompt
• Internet browser
• Putty
• Packet Sender
IoT Platform Beam test server
Simulation of
IoT Device (*)
Cellular
Network
Public
Internet
* This setup is for demonstration & testing purpose only. The SIM should reside in the IoT device to secure communication.
Pre-requisite Hands-on Series:
• Getting Started
• SORACOM AIR
Now log on to https://console.soracom.io/

4. 1. Open the SORACOM console at https://console.soracom.io/ .
2. Check the Air SIM you want to communicate with SORACOM Harvest.
3. Select [Change group] from the [Action] button.
Setup a Group

5. Create a group (via Actions menu)
1. Select [Create…]
2. Enter the group name, e.g. “hello soracom” and click [Create]
Alterna)ve
op)on

6. Choose a group (via side bar)
1. From the console side menu bar
2. Select [Groups]
3. From the group list, choose “hello soracom”.

7. BEAM CONFIGURATION
SORACOM Beam configurations consist of entry and exit points from
SORACOM platform and the protocols intended for each. BEAM can also
directly send data to cloud services like AWS IoT, IBM Watson, or
Microsoft Azure Event Hub
Before
conversion
After
conversion
HTTP HTTP/HTTPS
MQTT MQTT/MQTTS
TCP TCP/TCPS
TCP HTTP/HTTPS
UDP HTTP/HTTPS

8. Selecting BEAM configuration
1. Select [SORACOM Beam] configuration
2. Select [+]
3. Select the preferred entry point/ protocol conversion

9. BEAM configuration – HTTP Entry point
1. Enter configuration name, e.g.
“http over ssl” & Path
2. Enter hostname of your cloud
endpoint & Path, e.g.
“beamtest.soracom.io”
A test server is available for HTTP Entry
Point testing. Access it at:
https://beamtest.soracom.io

10. BEAM configuration – HTTP Entry point
1. Select the IMSI header to [ON] to
append SIM identifier metadata to
data.
2. Click [SAVE] to save configuration
3. Access the URL:
http://beam.soracom.io:8888 from
a SORACOM Air-enabled device.
4. The IMSI headers for that HTTP
connection will be displayed.

11. BEAM configuration – Setting custom headers
1. Enter configuration name, e.g.
“http with customer header”
2. Select [+] in [Custom headers]

12. BEAM configuration – Setting custom headers
1. Add desired [Action], [Header name], and [Header value] fields in custom header
2. Access the URL: http://beam.soracom.io:8888 from a SORACOM Air-enabled device.
3. The Custom headers and IMSI header for that HTTP connection will be displayed.

13. BEAM configuration – TCP to TCP(S)
1. Enter configuration name, e.g.
“echo over ssl”
2. Enter hostname of your TCPS
endpoint & port number, e.g.
“beamtest.soracom.io” and 1234
A test server is available for TCP to TCPs
Entry Point testing.
Access it at:
https://beamtest.soracom.io

14. BEAM configuration – TCP to TCP(S)
1. Select the IMSI header and IMEI header
to [ON]
2. Click [SAVE] to save configuration
3. Telnet beam.soracom.io with port 8023
from a SORACOM Air-enabled device.
4. The IMSI & IMEI as well as the echo
service is available.

15. BEAM configuration – TCP to HTTP(S)
1. Enter configuration name, e.g. “TCP to HTTPs”
2. Enter hostname of your HTTPS endpoint & Path, e.g.
“beamtest.soracom.io”
A test server is available for TCP to HTTPS
Entry Point testing.
Access it at: https://beamtest.soracom.io

16. BEAM configuration – TCP to HTTP(S)
1. Select the IMSI header and IMEI header to
[ON]
2. Click [SAVE] to save configuration
3. Telnet beam.soracom.io with port 23080
from a SORACOM Air-enabled device.
4. Each TCP request is answered with a HTTPs
response

17. BEAM configuration – UDP to HTTP(S)
1. Enter configuration name, e.g.
“The UDP Story”
2. Enter hostname of your HTTPS
endpoint & Path, e.g.
“beamtest.soracom.io”
A test server is available for TCP to HTTPS
Entry Point testing.
Access it at: https://beamtest.soracom.io

18. BEAM configuration – UDP to HTTP(S)
1. Select the IMSI header to [ON] if required
2. Click [SAVE] to save configuration
3. Using a tool, e.g. “Packet Sender”, you can send a UDP packet, e.g. “Beam UDP” to
beam.soracom.io with port 23080 from a SORACOM Air-enabled device
4. Successful response is received

19. BEAM conclusion
You have now mastered the art of using BEAM!
It is time for you to make complex services…
• Minimize your data payload by using the protocol conversion feature
• Send data directly to cloud
• Change destination end points in an instant & keep device management
simple.
Find out about our other services to find out how you can send the data
without ever passing through public internet.

20. BEAM configuration – Website entry point
1. Enter configuration name, e.g.
“http over ssl” & Path
2. Enter hostname of your cloud
endpoint & Path, e.g.
“beamtest.soracom.io”
A test server is available for Website
Entry Point testing.
Access it at:
https://beamtest.soracom.io