Labs: Difference between revisions

From BigID Developer Portal
Line 58: Line 58:
# In PowerShell, navigate to the folder where you downloaded `websocat.exe`.   
# In PowerShell, navigate to the folder where you downloaded `websocat.exe`.   
# Connect to the server with this command:   
# Connect to the server with this command:   
   <syntaxhighlight lang="bash">websocat.exe -b wss://0-207.ssh.gcp.env.fyi/ssh</syntaxhighlight>
   <syntaxhighlight lang="bash">websocat.exe -b wss://0-0.ssh.gcp.env.fyi/ssh</syntaxhighlight>

Revision as of 20:21, 13 December 2024

In this article, you'll learn:

  • How to use the BigID Labs SSH Terminal

SSH Access[edit]

BigID Labs include an SSH terminal, providing direct system access. By default, only the user who launched the system can access both the BigID UI and the SSH terminal. However, users with email addresses ending in @bigid.com can access any lab system.

Web SSH Client[edit]

The Web SSH Client allows users to access their lab instance conveniently through their browser. To use it, simply add .ssh after the instance number in your URL (e.g., 123-456.ssh). This provides a secure, browser-based terminal interface for interacting with the lab system.

The following custom scripts are available exclusively within the Web SSH Client. These commands enhance your interaction with the instance and provide additional functionality:

Managing User Access[edit]

BigID Labs provide two scripts for adding or removing user access. Note that the original system owner cannot be removed using these scripts. Users must have a valid BigID account to gain access.

To grant access to a specific email address, use the `grant` script. This will enable both SSH and BigID UI access for the user:

To revoke access for a specific email address, use the `remove` script. Keep in mind that this does not immediately terminate the user's active sessions. It may take up to an hour for all sessions to close:

Transferring Files[edit]

  • Download a file: Use the `download` script, specifying the filename to retrieve the file immediately:
download file.txt
  • Upload a file: Use the `upload` script to open an upload dialog. Choose the file to upload, which will be placed in the current directory:
upload

Updating Support Scripts[edit]

Support scripts for BigID Labs are updated only when the system is created. To manually update these scripts, run the `update` command. This ensures you have the latest tools and features:

update

SSH Desktop Access[edit]

For users who prefer to access the SSH terminal directly from their desktop, the following instructions explain how to set up and connect using the websocat library:

For Mac[edit]

  1. Install the websocat library using Homebrew:
brew install websocat
  1. Connect to the server using the following command:
websocat -b wss://0-0.ssh.gcp.env.fyi/ssh

For Windows[edit]

  1. Download the latest version of websocat from Github.
  2. In PowerShell, navigate to the folder where you downloaded `websocat.exe`.
  3. Connect to the server with this command:
websocat.exe -b wss://0-0.ssh.gcp.env.fyi/ssh