Get started with the Spectra Assure Portal
This quickstart guide is for users who want to try the ReversingLabs Spectra Assure Portal in 15 minutes or less.
In this guide, you will learn how to scan your first package, get its analysis report, and move the uploaded package to a project. To learn about all supported features and functionalities of the Portal, refer to the Navigate the Portal section of the documentation.
Prerequisitesโ
The following tasks should be completed before you start working with the Portal:
-
Get a user account. Follow the instructions in the Portal access guide.
-
Prepare a test package to work with. You can use any software package on your system for the purposes of this guide. To make sure the file you want to scan is supported, check the file format and the community/language coverage lists, as well as the scanning guidelines.
1. Upload a new packageโ
In this step, you will upload a software package to the Portal File Stream. This is the place where you can quickly analyze software packages without having to organize them, and view packages uploaded by other members of your Portal group.
-
Log in to your Portal account. You automatically land on the File Stream page.
-
Click the
Upload filebutton at the top right of the page. This prompts you to choose a file from your computer. -
Enter the required information about your file:
- Product - the full name of the software package
- Version - the software package version
- Publisher - the software publisher
- Platform - the system for which the software has been developed
- Category - the general purpose of the software package
- License - the type of license for the software package; all license types from the SPDX License List are supported
When uploaded, software packages are automatically analyzed and added to the File Stream page.
2. View the analysis reportโ
In this step, you will view the ReversingLabs SAFE report for the software package you uploaded.
- At the right end of each File Stream table row, you will find the
Actionsmenu, represented by three dots (โฎ). - Select the
View reportoption in that menu to access the report. This opens a new tab in the Portal interface with the SAFE report containing detailed analysis information.
3. Export analysis resultsโ
From the report page for your software package uploaded to File Stream, you can export and save different parts of the SAFE report to your local system. In the previous step, you opened the report and automatically landed on the Summary page.
- From the left-hand menu of the report, choose the Issues page.
- In the upper right corner of the Issues page, you will find the
Export as Sarifbutton. Clicking on it downloads the analysis results in the desired format to your default download location.
4. Move to a projectโ
In this step, you will move the uploaded software package from the File Stream to a project of your choice. Projects are ideal for keeping your package versions organized and preserved, because File Stream only keeps them for 90 days. Note that this action does not affect your quota.
-
Click on the File Stream tab in the header to go back to the File Stream page.
-
From the
Actionsmenu, represented by three dots (โฎ) at the end of each table row, chooseMove to Project. This opens a dialog. -
In the dialog, there are four steps you need to complete:
- Select project - create a new project
- Select package - create a new package inside that project
- Software info - edit the same information about your software package that you need to enter when you're uploading it directly to the Projects page. The
Is releasedcheckbox is not marked by default. All fields except forVersionare automatically filled. - Overview - once again check all the information on the package version you're moving, including its target location
-
If you need to change any information on the package version, you can switch back and forth between these steps by selecting them at the top of the dialog.
When finished, go to the Projects page to view your software package version that will be automatically reanalyzed.
You have successfully completed a basic workflow with ReversingLabs Spectra Assure Portal.
Explore the resources on this documentation website to learn how you can secure your software with the Portal.
Next stepsโ
- Read about other Projects features and workflows in the Projects documentation