In this article, you learn about filtering and sorting options. As well as, bulk actions you can take to address the identified issues.
You can refer to Creating Tickets and Ignoring Issues for more information on completing bulk actions.
Regardless of the type of issue you are reviewing, all issues are automatically filtered into two tabs:
- Active - All issues that require additional attention
- Ignored - Issues that have been reviewed and ignored
You have multiple filters to refine your search.
|Direct||Filter issues that are direct dependencies.|
|Transitive||Filter issues that are transitive dependencies.|
|Ticketed||Filter issues that already have a ticket associated.|
|Not Ticketed||Filter issues that have no associated tickets.|
|Denied||Filter Licensing issues that are denied.|
|Flagged||Filter Licensing issues that have been flagged.|
|Unlicensed||Filter Licensing issues that have been listed as unlicensed.|
|Declared||Filter Licensing issues that are found in Declared licenses only|
|Discovered||Filter Licensing issues that are found in Discovered licenses only|
You can select Reset all filters to remove existing filters at any time to display all identified issues.
|Anytime||Filter Licensing issues that have been detected during any time frame.|
|Last 7 days||Filter Licensing issues that have been detected within the last 7 days|
|Last 14 days||Filter Licensing issues that that have been detected within the last 14 days|
|Last 30 Days||Filter Licensing issues that have been detected within the last 30 days|
The package manager filter enables a user to filter issues to only issues created by a particular ecosystem or package manager.
The package manager filter will only display options from available ecosystems in the given issue scope (Global, project, release group)
|Project Label||Filter to licensing issues detected in project(s) that use a FOSSA provided or user defined project label for additional business context. Multiple labels may be selected using |
The top-level team filters enables a user to filter to only issues detected by projects within the selected team(s). This filter displays issues for all teams by default
|Team(s)||Filter to licensing issues detected in project(s) within a specific team. Multiple team(s) may be selected using |
Depending on the number of issues that are listed in your central inbox, it is helpful to sort issues based on specific criteria to support your remediation process. You can sort Issues based on:
- When the Issue was found by FOSSA (newest to oldest or oldest to newest)
- The package name (ascending or descending alphabetical order)
- Issue count per semantic version (Most issues or least issues)
The default sorting is set to Issue count when grouped by version and Package name (A to Z) when ungrouped.
You can initiate actions by selecting the checkbox next to any issue, giving you access to the action menu.
Available actions will depend on product type (licensing, security, quality), issue status (active, ignored), issue scope (global, release group, project), and action type (individual, bulk). Please see the table below for a detailed breakdown.
|Action||Description||Action type(s)||Product type(s)||Issue status||Issue scope(s)|
|Ignore (in current versions only)||Ignore the selected issue(s) for the current semantic version of the affected package. Doing so will ignore in only the selected, affected project(s).|
A new project revision containing any other semantic version of the package will generate a new active issue.
|individual, bulk||licensing, security, quality||active||global, release group, project|
|Ignore (Auto-ignore in all versions)||only available for individual project issues|
Ignore the detected issue for all semantic versions of the affected package. Doing so will ignore in only the selected, affected project.
Doing so will only apply to the selected issue type (Denied/Flagged license or a CVE)
A new project revision containing any other semantic version of the package will be auto-ignored. Please see the auto-ignored section for full details.
|Create ticket||Create a ticket (JIRA) containing all selected issues. Please see Creating a Jira Ticket for full usage and configuration details.|
Doing so with a previously ticketed issue(s) selected will link to the new ticket only.
|individual, bulk||licensing, security, quality||active, ignored||global, release group, project|
|Unlink ticket||Remove the association between the selected issue(s) and any linked tickets.||individual, bulk||licensing, security, quality||active, ignored||global, release group, project|
|Download CSV||Download a csv containing all selected issues scoped by issue status(active or ignored)||individual, bulk||licensing, security, quality||active, ignored||global, release group, project|
|Unignore||Change selected issue(s) status from ignored to active.|
Note doing so will not end any existing auto-ignore rules. Please see the auto-ignore section for more details on stopping auto-ignore rules.
|individual, bulk||licensing, security, quality||ignored||global, release group, project|
You can action more than one issue at a time across all affected projects by using the select all or checking the boxes of the applicable issues in the global issues view.
By default FOSSA issues will be grouped by semantic version. A user may change to the ungrouped view by selecting
Version in the issue inbox header and changing to
In order to persist an ignore decision across all versions of a package or across all projects, you can create an auto-ignore rule.
Given the potential for unintended acceptance of risk by ignoring in all versions, we highly recommend extreme diligence when applying these options.
Auto-ignore is scoped to the combination of:
- Issue type
Applicable issue types:
- Denied license
- Flagged license
- Any CVE (security issue)
Given a user has the necessary permissions, Auto-ignore permissions, when a user ignores they will see options for
Where should it be ignored? &
The following options provide the user an ability to persist ignore decisions beyond the scope of selected project or global issue
|In this project||Creates an auto-ignore rule scoped to only the selected project|
|Include release groups||Creates an auto-ignore rule scoped to the selected project & any release group containing the selected project. Including future release groups|
|In this release group||Creates an auto-ignore rule scope to only the selected release group (Release group issue inbox only)|
|In the licensing policy||Creates an auto-ignore rule scoped to the policy used by the selected project. Any other project or release group using this same policy will receive the auto-ignore rule|
|Globally||Creates an auto-ignore rule scoped to all projects & release groups regardless of policy|
By design, auto-ignore rules persist to their selected scope for current and future projects. Please see "Managing Auto-ignore rules" for details on terminating rules.
The following options provide the user an ability to persist ignore decisions beyond the scope of the selected package version
|Selected Version||Creates an auto-ignore rule scoped to the current package version only|
|All versions||Creates an auto-ignore rule scope to all versions of the package, current and future.|
If a user selects scopes of
in this projectand
selected versionno auto-ignore rule is created. This issue will become active whenever a few package version is submitted or a new project is detected.
Within any issue inbox (Global, Project, Release group) a user may select
View Ignore Rules to navigate to all applicable rules
The Global issue inbox will contain all auto-ignore rules across every scope (Global, Policy, Release group, Project)
The Project/Release group issue inbox will contain only applicable Project/Release group auto-ignore rules and all global auto-ignore rules
Ignore rules contain the following metadata:
|Issue Ignored||A combination of the license issue type (Denied, Flagged, Unlicensed) and the specific license ignored|
|Package||The name of the package|
|Version||Either a specific package version or |
|By||User who created the auto-ignore rule|
|Note||Ignore reason provided when creating the auto-ignore rule. Please note these will also appear on issue details when applicable|
A user may use the action icon to the far right to remove any auto-ignore rule.
See the table below for a detailed breakdown of permission required to create auto-ignore rules
|Release group||Requires |
|Project + release group||Requires |
|Global||Requires Requires |
The FOSSA issue detail UI has been updated with an easy to use issue drawer to quickly review and triage issues. A user can open the issue drawer by selecting anywhere within the desired issue's row.
At the top right corner of an issue drawer a user can
Share , or
Close the issue drawer.
|Issue Drawer Control||Description|
|Expand||Opens a full screen view of the selected issues in a separate tab|
|Share||Allows a user to copy a link to the expanded view of the selected issue|
|Close||Closes the selected issue drawer|
The issue sub nav for a licensing issue is composed of the following sections:
|Issue Details||Describes the type of issue (Flagged, Denied, Unlicensed) , the package depth per project, and any additional notes included for the license by your selected policy|
|File Matches||Describes where we found the detected license (Declared or Discovered), which specific file, and which lines of code we detected evidence of the selected license.|
|Dependency||Relevant information regarding the package itself, such as name, version, depth, and package manager/ecosystem|
|All Licenses||A breakdown of every license detected on the package and whether that is a Declared or Discovered identification|
A user may use the dropdown within the file matches section to explore additional file paths
The project sub nav for a security issue contains the following metadata:
|Project Name||Title of the project in FOSSA|
|Issue Status||Whether the issue is |
|View Path||The origin and dependency path to determine where the package was detected within the project|
Time and user stamped comments to track issue triage conversations.
You can now see other affected projects along with their statuses and associated tickets.
Updated about 1 month ago