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.
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/
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
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
Choose a group (via side bar)
1. From the console side menu bar 2. Select [Groups] 3. From the group list, choose “hello soracom”.
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/HTTPSMQTT MQTT/MQTTSTCP TCP/TCPSTCP HTTP/HTTPSUDP HTTP/HTTPS
Selecting BEAM configuration
1. Select [SORACOM Beam] configuration 2. Select [+] 3. Select the preferred entry point/ protocol conversion
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
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.
BEAM configuration – Setting custom headers
1. Enter configuration name, e.g. “http with customer header”
2. Select [+] in [Custom headers]
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.
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
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.
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
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
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
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
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.