> For the complete documentation index, see [llms.txt](https://docs.prismacloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.prismacloud.io/content-collections/application-security/risk-management/monitor-and-manage-code-build/software-composition-analysis/sca-troubleshoot.md).

# Troubleshoot Software Composition Analysis (SCA) Issues

The section provides guidance for troubleshooting Software Composition Analysis (SCA) issues.

Errors occurring during an SCA scan can disrupt the scanning process in various ways. Some errors may prevent the scan from completing successfully, resulting in a failure to generate any results. In other cases, errors may cause the scan to produce incomplete or inaccurate results, leading to gaps in the analysis of software dependencies and potential vulnerabilities. These issues can compromise the effectiveness of the scanning process and hinder efforts to identify and address security risks in the software supply chain.

## View and Remediate SCA Scan Errors

You can view SCA scan errors on the Prisma Cloud console, allowing you to remediate them in your codebase.

1. In **Application Security**, select the **Projects** page > **Vulnerabilities** tab.

   If SCA scan issues are detected, a SCA error icon is displayed.
2. Select the icon to display a list of detected errors, a short description of each error, and the number of files in which the error was detected.

   <figure><img src="/files/E9t793mMevqxJJBfNk5p" alt="sca vulnerabilities2.1"><figcaption></figcaption></figure>
3. Select an error to display expanded details of the error, including the repository in which the issue was detected and a path to the files containing the issue.

   <figure><img src="/files/wug1tP51eRLVzJZNX6tt" alt="sca vulnerabilities details2.0"><figcaption></figcaption></figure>
4. Click the link to copy the file path > navigate to the file, and fix the error according to the solution provided in [SCA Error Message Types](#sca-error-type) below.

## SCA Error Message Types

The table below describes error messages that may be encountered during a failed **SCA** scan, along with suggested remediation.

| Error Type                                    | Error Message                         | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| --------------------------------------------- | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Main file misaligned with Lock file           | MAIN\_FILE\_NOT\_FIT\_LOCK\_FILE      | <p>The main file does not align with the contents of the lock file.<br><strong>Example</strong>: Inconsistency between <code>package.json</code> and <code>package-lock.json</code> files.<br><strong>Solution</strong>: Ensure that the main file and lock file exist and that their configurations are in sync. If the main file does not align with the lock file, it disrupts the native dependencies tree scan, leading to incomplete results. In such cases, only the main file will be scanned, and the full dependent tree will not be built.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Missing Lock file                             | LOCK\_FILE\_IS\_MISSING               | <p>The lock file provides essential dependency information for SCA scans. Without it, the tool may face challenges in accurately identifying vulnerabilities and comprehensively analyzing both direct and transitive dependencies, potentially compromising the effectiveness of the scan. Prisma Cloud Application Security supports specific lock files for various ecosystems, including <code>composer.lock</code> for <strong>PHP</strong>, <code>paket.lock</code> for <strong>.NET (Paket)</strong>, and <code>package-lock.json</code> for <strong>JavaScript (NPM)</strong>.<br><strong>Example</strong>: The <code>composer.json</code> file is present, but its lock file is missing. This absence of the lock file can impact the accuracy of vulnerability detection during the SCA scan.<br><strong>Solution</strong>: Ensure that the lock file exists and is scanned.</p>                                                                                                                                                                                                                                                                      |
| Missing Main file                             | MAIN\_FILE\_IS\_MISSING               | <p>The Main file serves as a key reference for dependency information. Without it, the SCA scan may encounter challenges in accurately identifying and assessing vulnerabilities within the project. This absence could limit the tool’s ability to comprehensively analyze both direct and transitive dependencies.<br><strong>Example</strong>: In a project, the <code>composer.lock</code> file exists without the main <code>composer.json file</code>. Without the composer.json file, the SCA tool loses information about the declared dependencies and their specific versions. This results in a partial view of the project’s dependencies, limiting the tool’s ability to accurately identify vulnerabilities. Consequently, the dependency tree remains incomplete, as the tool may only consider direct dependencies, overlooking transitive dependencies and potential security risks. In addition, it may lead to a misalignment with the project’s actual dependencies, as the tool relies on information provided in the <code>composer.json</code> file.<br><strong>Solution</strong>: Ensure that the main file exists, and is scanned.</p> |
| Corrupted file                                | CORRUPTED\_FILE                       | <p>Corrupted files pose a risk of inaccurate or incomplete vulnerability detection, as they may not conform to the required format for scanning. Consequently, Prisma Cloud may overlook critical information within these files, potentially leading to undetected security vulnerabilities in the scan results.<br><strong>Example #1</strong>: An empty file containing no data lacks the necessary information for the tool to assess dependencies and vulnerabilities.<br><strong>Example 2</strong>: <strong>Not UTF-8</strong> file - If a file is not encoded in UTF-8, as the scanner often expects files to adhere to standard encoding practices, and deviations from these standards could lead to parsing errors or misinterpretation of the file content.<br><strong>Solution</strong>: Fix the corrupted file.</p>                                                                                                                                                                                                                                                                                                                               |
| Access to private registry restricted         | NO\_ACCESS\_TO\_PRIVATE\_REGISTRY     | <p>If there is no access to a private registry, the SCA tool is unable to retrieve and analyze dependencies stored in that registry. The inability to access a private registry restricts the SCA tool from gathering essential information about project dependencies, potentially leading to incomplete scan results, overlooking vulnerabilities, or misidentifying dependencies.<br><strong>Example</strong>: Failed to connect private registry, cannot fix or build dependency tree.<br><strong>Solution</strong>: Grant the necessary access permissions to the SCA tool for the private registry.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Multiple external modules not supported       | MULTI\_MODULE\_NOT\_SUPPORTED         | <p>The SCA scanner does not support multi-module configurations for the framework, resulting in the detection of unsupported multi modules. As a result, the scan results may be incomplete as these modules remain unscanned, potentially leading to undetected vulnerabilities.<br><strong>Solution</strong>: Consider centralizing version information in a dedicated file within your project. For example, in a Gradle project, if multi-module is not supported, you can address the issue by maintaining the version information in a separate file.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| File exists in cloud                          | FILE\_EXISTS\_IN\_CLOUD               | <p>The file, such as a lock file or configuration file, already exists in the cloud storage. However, the SCA scanner cannot fix this file as it cannot change it. This may result in incomplete scan results, as these modules will not be scanned, potentially resulting in undetected vulnerabilities.<br><strong>Example</strong>: Maven multi-module parent in cloud.<br><strong>Solution</strong>: Review the cloud storage associated with the SCA tool and identify the duplicated file. Consider removing the redundant file or updating it to match the latest version from your project.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Unsupported file type for fix                 | FIX\_NOT\_SUPPORT\_THE\_FILE\_TYPE    | <p>Although the SCA scan successfully identifies vulnerabilities, it encounters a file type that does not support fixes. This may result in incomplete vulnerability detection and potentially leaving risks unidentified.<br><strong>Example</strong>: Docker files are not supported by direct fixes.<br><strong>Solution</strong>: Users must manually address and fix problems within the particular file type.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| YARN lock v2 not supported                    | YARN\_LOCK\_V2\_NOT\_SUPPORTED        | <p>The SCA scan has detected <code>Yarn.lock</code> v2 files. However, this version of the <code>Yarn.lock</code> file does not support SCA scans, as it lacks dependency provenance information necessary for accurate vulnerability detection. As a result, the scanner may encounter limitations in analyzing dependencies and identifying vulnerabilities accurately, potentially exposing the project to vulnerabilities.<br><strong>Solution</strong>: To resolve this issue, consider using a different version of the <code>Yarn.lock</code> file that supports SCA scans.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Multiple groups detected in Package-lock file | PACKAGE\_LOCK\_SUPPORT\_SINGLE\_GROUP | <p>Multiple lock file groups were detected in the <code>Package-lock</code> file of the repository. The SCA scanner is designed to handle single groups exclusively, and does not support multiple groups. As a result, vulnerabilities or issues within these multiple groups will not be detected or analyzed by the scanner, potentially leaving the system vulnerable to security risks.<br><strong>Solution</strong>: Consider restructuring the package lock file to support multiple groups.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.prismacloud.io/content-collections/application-security/risk-management/monitor-and-manage-code-build/software-composition-analysis/sca-troubleshoot.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
