# Usage of insecure websocket connection

## Overview

* **Rule ID**: `javascript_lang_websocket_insecure`
* **Applicable Languages**: Javascript
* **Weakness ID**: CWE-319

## Description

Your application is vulnerable when connecting to APIs via insecure websocket connections. This risk arises because data transmitted over these connections can be intercepted or altered by attackers. Make sure all websocket connections in your application use SSL to encrypt data in transit, protecting it from unauthorized access.

## Remediation Guidelines

* **Avoid** starting websocket connections without SSL, as these connections are susceptible to interception and compromise.

  ```javascript
  const client = new WebSocket('ws://insecure-api.com'); // insecure
  ```
* **Ensure** that all websocket connections are secured with SSL. This encrypts the transmitted data, safeguarding it from eavesdropping and tampering.

  ```javascript
  const client = new WebSocket('wss://secure-api.com');

  ```

## References

* [**OWASP insecure transport**](https://owasp.org/www-community/vulnerabilities/Insecure_Transport)
* [**CWE-319: Cleartext Transmission of Sensitive Information**](https://cwe.mitre.org/data/definitions/319.html)
* [**OWASP Top 10: A02:2021 - Cryptographic Failures**](https://owasp.org/Top10/A02_2021-Cryptographic_Failures/)

## Configuration

To omit this rule during a scan, and to provide you with continuous 24/7 code-level scanning, you can employ our [**SAST TOOL**](https://scopy.sec1.io/login)


---

# Agent Instructions: 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:

```
GET https://docs.sec1.io/user-docs/4-sast/3-javascript/usage-of-insecure-websocket-connection.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
