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 with a Hologram Nova, but you can Spacebridge into any device that gives you port level access.
For more information on Spacebridge visit the Secure Tunneling with Spacebridge guide.
1) Enable Spacebridge. To do so, go to the Devices section of the Dasboard, select the SIM that you wish to tunnel into, select the Spacebridge tab, and scroll down to the Spacebridge 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 Hologram Nova, that is as simple as issuing a
sudo hologram network connect command on the terminal via our Python SDK.
3) Open the Spacebridge Client downloaded from our Downloads page. This will ask for an API Key which can be found on the Dashboard's API page in the Settings Section.
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.