GITBOOK-7359: new page: IDES; TS for 0kb downloads of cli or lang-ser…

…ver in windows
snyk · Jun 20, 2024 · f604f9b · f604f9b
1 parent 955006e
commit f604f9b
Show file tree

Hide file tree

Showing 2 changed files with 28 additions and 0 deletions.
diff --git a/docs/SUMMARY.md b/docs/SUMMARY.md
@@ -301,6 +301,7 @@
       * [Server returned HTTP response code 403 for URL](scm-ide-and-ci-cd-workflow-and-integrations/use-snyk-in-your-ide/troubleshooting-ides/server-returned-http-response-code-403-for-url.md)
       * [Maven Scans with Private Repositories](scm-ide-and-ci-cd-workflow-and-integrations/use-snyk-in-your-ide/troubleshooting-ides/maven-scans-with-private-repositories.md)
       * [Error executing binary because of corporate policy (Windows)](scm-ide-and-ci-cd-workflow-and-integrations/use-snyk-in-your-ide/troubleshooting-ides/error-executing-binary-because-of-corporate-policy-windows.md)
+      * [IDE plugin fails with "Scan failed" on windows systems with .exe download blocking](scm-ide-and-ci-cd-workflow-and-integrations/use-snyk-in-your-ide/troubleshooting-ides/ide-plugin-fails-with-scan-failed-on-windows-systems-with-.exe-download-blocking.md)
   * [Snyk CI/CD integrations](scm-ide-and-ci-cd-workflow-and-integrations/snyk-ci-cd-integrations/README.md)
     * [Snyk Code in the CI/CD pipeline](scm-ide-and-ci-cd-workflow-and-integrations/snyk-ci-cd-integrations/use-snyk-code-in-the-ci-cd-pipeline.md)
     * [Snyk CI/CD Integration deployment and strategies](scm-ide-and-ci-cd-workflow-and-integrations/snyk-ci-cd-integrations/snyk-ci-cd-integration-deployment-and-strategies/README.md)

diff --git a/...plugin-fails-with-scan-failed-on-windows-systems-with-.exe-download-blocking.md b/...plugin-fails-with-scan-failed-on-windows-systems-with-.exe-download-blocking.md
@@ -0,0 +1,27 @@
+# IDE plugin fails with "Scan failed" on windows systems with .exe download blocking
+
+## **Problem**
+
+When you are using Snyk plugins in an IDE on Windows systems, the Snyk scan may fail.&#x20;
+
+You may see an error message in the logs that indicates `Error running command snyk.start: command 'snyk.workspace.scan' not found. This is likely caused by the extension that contributes snyk.start.`
+
+## **Cause**
+
+This issue is often seen on Windows systems that have company policy in a firewall or other tool to prevent automatic .exe download by showing an interactive popup requesting approval.&#x20;
+
+In the IDE, this popup is not shown, and the .exe file cannot be downloaded. This may result in a 0KB file being created in the download location.&#x20;
+
+To determine if this is the case, navigate to the location for the CLI or Language Server shown in your Snyk plugin settings in the IDE. If either the CLI or Language Server files are 0KB, this is likely the issue.
+
+## **Solution**
+
+The preferred solution for this is to allowlist [static.snyk.io](http://static.snyk.io/) in the baseline policy for .exe files, so that downloads from this location are exempt from .exe popup approvals for all users.&#x20;
+
+You can use the following temporary solutions in the interim if the preferred solution will take time to approve.&#x20;
+
+* Manually download the relevant .exe file directly from either [Snyk CLI Releases](https://github.com/snyk/cli/releases) or [Snyk Language Server Releases](https://github.com/snyk/snyk-ls/releases), and place it in the location listed in your plugin settings. Ensure that you turn off the option to Automatically Manage Dependencies.
+
+or
+
+* If the CLI exe is downloaded, you can use it to provide the language server function. Redirect the language server location to the CLI location in the plugin settings, and ensure that you turn off the option to Automatically Manage Dependencies.&#x20;