Device tunneling for beginners

In this guide, we will walk through the process of using Spacebridge for inbound communication with to your Hologram SIM. We will be using a Raspberry Pi in this example, but you can securely tunnel into any device that gives you port level access.

For more information on Spacebridge visit the Secure Tunneling with Spacebridge guide.

Creating a secure device tunnel

1. First, enable secure device tunneling for your device so that you can connect using the Spacebridge client. This guide walks through the process.
   
   
   
2. Next, you'll want to make sure your end device has an open data session. Using a Raspberry Pi, that is as simple as issuing a sudo hologram network connect command on the terminal via our Python SDK.
   
   
   
3. Open the Spacebridge desktop client downloaded from our Downloads page. This will ask for an API Key which can be found under the Settings section of your dashboard in the API page.
   
   
   
   
4. After the API key is entered, the Spacebridge client will ask us what organization our device is in. Double-click on the desired organization.
   
   
   
5. This will open a screen where you can select devices with secure device tunneling enabled, a Device Port (the port of the device that is hosting the SIM), and a Local Port (the port on the computer you are using). Since we want to SSH we will set the Device Port to 22 (the standard SSH port) and the Local Port to a value over 1024 so we'll use 5000. To start the tunnel we hit the Done button.
   
   
   
6. Once your tunnel is set up you will get a pop up telling you what ports are being forwarded.
   
   
   
7. Last we SSH into the device. In this case, it is a Raspberry Pi.
   
   
   
8. To close the tunnel, open the Spacebridge client and hit the Close Tunnel button.