Labs: Difference between revisions

Revision as of 20:12, 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. Additionally, several custom commands are available to interact with the machine beyond standard terminal functions.

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:

grant [email protected]

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:

remove [email protected]

Transferring Files[edit]

You can upload and download files to and from your lab instance using the following commands:

- **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

@@ Line 1: / Line 1: @@
 {{Box/start}}
 In this article, you'll learn:
-* How to Use the BigID Labs SSH Terminal
+* How to use the BigID Labs SSH Terminal
 {{Box/end}}
-== SSH ==
+== SSH Access ==
-All BigID labs contain an SSH component. This allows you to access the terminal of the system. By default only the user who has spun up the system has access to the BigID UI and the SSH terminal. Users with emails ending in bigid.com can access any lab system. There are a few commands that allow you to interact with the machine beyond regular terminal commands.
+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. Additionally, several custom commands are available to interact with the machine beyond standard terminal functions.
-=== Adding and Removing Access ===
+=== Managing User Access ===
-BigID labs come with two scripts to add and remove users from the system. The original owner of the machine cannot be removed with these scripts. These users will still need to have a BigID account to access the system.
+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.
-The grant script allows you to grant an email address access to the system. This will grant both SSH and BigID UI 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:
-<syntaxhighlight lang="BASH">grant [email protected]</syntaxhighlight>
+<syntaxhighlight lang="bash">grant [email protected]</syntaxhighlight>
-The remove script allows you to remove an email address that was previously granted access. Note that this will not kick the user out of active sessions. It may take up to an hour for all active sessions of the user to close.
+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:
-<syntaxhighlight lang="BASH">remove [email protected]</syntaxhighlight>
+<syntaxhighlight lang="bash">remove [email protected]</syntaxhighlight>
-=== Uploading and Downloading Files ===
+=== Transferring Files ===
-Users can also upload and download files to their lab instances. The download script takes in a filename and will immediately download a file.
+You can upload and download files to and from your lab instance using the following commands:
-<syntaxhighlight lang="shell">download file.txt</syntaxhighlight>
+- **Download a file**: Use the `download` script, specifying the filename to retrieve the file immediately.
-The upload script will spawn an upload dialog for the user to choose a filename and file to upload. Note that this will upload the file to directory where the command was called.
+<syntaxhighlight lang="bash">download file.txt</syntaxhighlight>
-<syntaxhighlight lang="shell">upload</syntaxhighlight>
+- **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:
-=== Updating Lab Support Scripts ===
+<syntaxhighlight lang="bash">upload</syntaxhighlight>
-Labs support scripts are occasionally changed. Given the ephemeral nature of labs, these scripts are only updated on system creation. If you want to update them manually, you may do so by executing the update command.
+=== Updating Support Scripts ===
-<syntaxhighlight lang="sh">update</syntaxhighlight>
+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:
+<syntaxhighlight lang="bash">update</syntaxhighlight>