Logging In and Selecting Your Account

Once you know if you will use the GUI or the CLI to interact with Fuzzball and you have checked that you meet the prerequisites, you can log in. The GUI and CLI tabs below display instructions.

select

Please select either the GUI or CLI tab to see the appropriate instructions for your environment.

GUI

When you first visit the Fuzzball URL (provided by your administrator), you will be directed to a sign-on page. For the cloud instance it will look like this:

Fuzzball cloud instance sign-on page

After signing in you will be directed to the account selection page like so:

Fuzzball account selection page

You can select the account where you will use Fuzzball. Your administrator may have placed you in a shared account, and you will also have access to a personal account based on your username. In this example we’ve selected an account titled “SA”.

Fuzzball workflow page after account selection

If available, it’s a good idea to select a shared account managed by your administrator to complete this quick start guide. If you select your “User Account”, you may need to set up Resource Definitions before you can provision hardware to run your jobs. This is beyond the scope of the 15 minute tutorial.

After selecting your shared account, you may see the workflows that your colleagues have submitted. Sharing workflows is one of the benefits of using a shared account.

CLI

The Fuzzball CLI needs to know which context (i.e. Fuzzball installation) you want to interact with. The context is automatically determined by the GUI since you point your browser to a URL. But the CLI needs you to create the appropriate context before you login.

This command contains a series of URLs and an organization ID that you can obtain from your administrator.

$ fuzzball context create beta api.beta.fuzzball.io \
  https://auth.fuzzball.io/auth/realms/db17f530-ef85-429c-bcca-f6faa5ab86ce \
  fuzzball-cli
Configuration for "beta" created.
Configuration for "beta" now in use.

$ fuzzball context list
ACTIVE | NAME | ADDRESS                  | ACCOUNT NAME | ACCOUNT ID
*      | beta | api.beta.fuzzball.io:443 |              |

The first command creates the context (in this case named beta) so that you can access the appropriate Fuzzball cluster. The second command lists your available contexts and highlights (with a *) the currently used context. In this case, the only context available is obviously the one that is used.

If you have created more than one context and want to select the appropriate one, you can use use, the fuzzball context use <context name> command.

Now you can log into the context with the following command:

$ fuzzball context login
Logging into current cluster context...
Using a secure browser, open the link to complete login:
https://auth.fuzzball.io/auth/realms/db17f530-ef85-429c-bcca-f6faa5ab86ce/device?user_code=DPGB-URVO

Waiting for login completion...

The link will direct you to a web-based authentication workflow.

Alternately, you can log in without the use of a browser using the following syntax:

$ fuzzball context login --direct

You will then be prompted for a username and a password. For security reasons, the password input will not be displayed in your terminal.

If you use the --direct flag with the login command, Fuzzball looks in the environment for the variables $FUZZBALL_USER and $FUZZBALL_PASSWORD to use as credentials.

Once you are logged in you can select the account you want to use. You can list the accounts that you can access within the given context using the following command:

$ fuzzball account list
SELECTED | NAME                           | ID                                   | CREATED TIME          | LAST UPDATED
         | SA                             | 4ba9824b-0c12-43cf-9e9a-833881004a0d | 2023-02-14 01:57:04PM | 2023-02-14 01:57:04PM
*        | User Account (dgodlove@ciq.co) | 74a78835-1601-4364-a85c-0eee707b8017 | 2024-03-04 03:49:14PM | 2024-03-04 03:49:14PM

The * on the second line indicates the account that is selected for use. In this case I want to switch from the “User Account” to the organization account named “SA”, because it is already configured by my administrator allowing me to submit workflows.

To switch to a organization account you can use the following syntax with the ID obtained using the list command above.

$ fuzzball account select 4ba9824b-0c12-43cf-9e9a-833881004a0d
Account "SA" in use

$ fuzzball account list
SELECTED | NAME                           | ID                                   | CREATED TIME          | LAST UPDATED
*        | SA                             | 4ba9824b-0c12-43cf-9e9a-833881004a0d | 2023-02-14 01:57:04PM | 2023-02-14 01:57:04PM
         | User Account (dgodlove@ciq.co) | 74a78835-1601-4364-a85c-0eee707b8017 | 2024-03-04 03:49:14PM | 2024-03-04 03:49:14PM