Quick start with Xygeni GUI

Xygeni GUI app is a graphical wrapper for the Xygeni CLI. It is used to run a basic initial scan and directly access the scan results. If the Xygeni CLI is not already installed on your system (if it is not configured as a command in the PATH), the Xygeni GUI will download it to your local environment (usually $HOME/.xygeni). This eliminates the need to manually download the scanner to use the Xygeni GUI.

Xygeni GUI does not include all the features of the Xygeni CLI. It is used to launch a scan by simply selecting the location of the repository or local directory to analyze, the name, and the scanners you want to run.

You can follow the steps below for a quick start guide to using the Xygeni GUI:

1. Install the Xygeni GUI

2. Fetch your Xygeni API token

3. Introduce the token in the Xygeni Token textfield

4. Select a local directory and application name

5. Run the scan

6. Open the results

1. How to install

The following software is required for the Xygeni scanner to work properly

Linux

• Download the Xygeni Local Scanner compressed file from here.

• Decompress the file

• Give the "execute.sh" file execution rights

• Run the execut.sh file

Windows

For more information about the different screens go here.

2. Fetch your Xygeni API token

Active Xygeni account credentials are mandatory to run the script, so make sure you’ve signed up first! Visit Create a Free Trial account or Log in to Xygeni

Go your profile pannel and navigate to Organization/Personal Tokens:

Create a new token. The difference betweeen Organization tokens and Personal tokens is who can see and revoke those tokens. Select either one and generate a new token.

In order to run scans, the only permission that is needed is the "Upload scan results" permission. However, if you want to use the same token with the REST API, you’ll need to grant it additional permissions.

3. Introduce the token in the Xygeni Token textfield

Paste or write the token that was fetched on the last step on the Xygeni Token text field. You can use the Eye icon to see the value of the written text.

If the token is valid, a green glow will appear.

4. Select a local directory and application name

Introduce the path to a directory to be scanned. You can do this using the folder button, which will open the system's directory selector. If the introduced value is not a valid directory, the textfield will have a red glow.

Optionally, you can specify a name for the project to be scanned; otherwise, the name of the entered folder will be used.

5. Run the scan

Press the launch scan button to run the scanner.

6. Open the results

When the scan is complete, the results button will become active. Pressing it will take you to the Dashboard results screen.