In this guide, we will go over the step by step process of using Spacebridge to get inbound access to your Hologram SIM. We will be using a Raspberry Pi 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) Enable Spacebridge. To do so, go to the Devices section of your dashboard, select the SIM that you wish to tunnel into, select the Device tunneling tab, and scroll down to the Device tunneling card. Hit the Enable tunneling button.
2) Next, you'll want to make sure your end device is in an open session. Since we are 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 pop open a screen where you can select your Spacebridge-enabled devices, 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 simply SSH into the device. In this case, it is a Raspberry Pi.
8) To close the tunnel, simply go back to the Spacebridge client and hit the Close Tunnel button.