# Nodeware integration

{% hint style="info" %}
If you’re new to integrations in Rewst, read through our introductory integration documentation [here](https://docs.rewst.help/documentation/integrations).
{% endhint %}

## What does the Nodeware integration do?

Our Nodeware integration enhances automation capabilities in network vulnerability management. Automatically identify, prioritize, and remediate security vulnerabilities across networks, and access vulnerability reporting from within your PSA.

## Set up the Nodeware integration

### Set up steps in Nodeware

1. Log in to your Nodeware account.
2. Click on **Reports** in the left side menu.
3. Copy the **API Key,** displayed in the lower right corner. You'll need this value to authenticate your API calls.\
   ![](https://1835401289-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQQ1EHVcEsGKBPVHmiav%2Fuploads%2FW80IEtobl1PA4m8BrnyB%2FScreenshot%202025-02-20%20at%2010.33.04%E2%80%AFAM.png?alt=media\&token=36145b99-18d0-495f-a2cb-5db6522e92ce)

### Set up steps in Rewst

1. Navigate to **Marketplace > Integrations** in the left side menu of your Rewst platform.
2. In the Integrations page, search for the Nodeware integration.\
   ![](https://1835401289-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQQ1EHVcEsGKBPVHmiav%2Fuploads%2FbmDfksI8BHgPzqUOSE4e%2FScreenshot%202025-02-18%20at%202.43.57%E2%80%AFPM.png?alt=media\&token=43f7c971-cffa-4b5c-8246-6643ff9c9daa)
3. Paste the API key copied from Nodeware into the **API Key** field of the form.
4. Click **Save Configuration**.<br>

   <figure><img src="https://1835401289-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQQ1EHVcEsGKBPVHmiav%2Fuploads%2FLBHtfrkDWY7XkCJ9tQ9U%2FScreenshot%202025-02-18%20at%203.12.49%E2%80%AFPM.png?alt=media&#x26;token=f7ecce71-7769-4e18-8dd5-aafda7971815" alt=""><figcaption></figcaption></figure>
5. Rewst will do a quick validation of your input. Once completed, you'll see a new section beneath the configuration form for[ organization mapping](https://docs.rewst.help/documentation/integrations#what-is-organization-mapping). Complete your mapping as desired. <br>

## Test the Integration

Saving your configuration during integration setup automatically triggers a test API call to verify that your setup is correct. If something is wrong with your credentials and the integration fails, you'll receive an error message in the Rewst platform.<br>

<figure><img src="https://1835401289-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQQ1EHVcEsGKBPVHmiav%2Fuploads%2FJiDKPfPK6dC0Xhd8Ecv6%2FScreenshot%202025-02-20%20at%208.34.57%E2%80%AFAM.png?alt=media&#x26;token=fdd2aa2b-b956-4a5f-b4d3-b241bf7acd06" alt=""><figcaption><p>The error message, shown when the Nodeware integration configuration fails</p></figcaption></figure>

{% hint style="success" %}
Got an idea for a new Integration? Rewst is constantly adding new integrations to our integrations page. Submit your idea or upvote existing ideas here in our [Canny feedback collector](https://rewst.canny.io/integrations).
{% endhint %}

## Nodeware actions and endpoints

{% hint style="info" %}
For more on how actions work in Rewst, check out our [introductory actions documentation here](https://docs.rewst.help/documentation/workflows/actions-in-rewst).
{% endhint %}

Nodeware's complete documentation can be found [here](https://api.nodeware.com/api/msp/).

| Category            | Action                              | Description                                                                                                                          |
| ------------------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| **Alerts**          | Get All Alerts For a Customer       | Returns a list of alerts given a specific `customer_token`                                                                           |
| **Assets**          | Get an Asset                        | Returns a single asset, internal or external, given the `uuid`                                                                       |
|                     | Delete An External Asset            | Deletes an external asset, given the `uuid`                                                                                          |
|                     | Update An Asset                     | Update a single asset given the `uuid`                                                                                               |
|                     | Rescan An Asset                     | Request a rescan for an Asset, given the `uuid`                                                                                      |
|                     | Asset CVE Data                      | Get information about CVEs discovered on an Asset, given the `uuid`                                                                  |
|                     | Apply Credentials To An Asset       | Apply Credentials to an Asset, given the `uuid`, to enable credentialed scanning                                                     |
|                     | Clear Credentials For An Asset      | Remove credentials for an Asset, given the `uuid`, to disable credentialed scanning                                                  |
|                     | Decommission An Asset               | Decommission an asset no longer in use and optionally provide justification                                                          |
|                     | Pause Or Unpause Scanning For Asset | Pause vulnerability scans for an Asset, or resume vulnerability scans if already paused                                              |
|                     | Get All Assets For a Customer       | Returns all assets for a given customer by `customer_token`                                                                          |
|                     | Add An External Asset               | Adds an external asset, or assets, for a given customer by `customer_token`                                                          |
| **Credentials**     | Get All Credentials                 | Get all credentials for a given customer by `customer_token`                                                                         |
|                     | Delete a Credential                 | Remove a credential given the `uuid`. Credentials cannot be modified, only deleted and re-created                                    |
|                     | List All Benchmarks                 | List all Benchmarks that can be run against an Asset during a Credentialed Scan. A benchmark must match the asset’s operating system |
| **Customers**       | Get All Customers                   | Returns all customers                                                                                                                |
|                     | Add a Customer                      | None                                                                                                                                 |
|                     | Get a Customer                      | Gets a single customer given the `customer_token`                                                                                    |
|                     | Delete a Customer                   | Deletes a customer, given the `customer_token`, and any related data. THIS ACTION CANNOT BE UNDONE                                   |
|                     | Update a Customer                   | Update a single customer given the `customer_token`                                                                                  |
| **Downloads**       | Get Sensor And Agent Download Links | Returns an object with links to install files for Sensors and Agents                                                                 |
| **Generic Request** | Nodeware API Request                | Generic action for making authenticated requests against the Nodeware API                                                            |
| **Reports**         | Get Available Report Types          | Returns list of available report formats                                                                                             |
| **Reports**         | Generate a Report For a Customer    | Returns generation status message                                                                                                    |
|                     | Retrieve a Report                   | Returns download link for specific report given a `customer_token`, `report_id`, and `format`                                        |
|                     | Delete a Report                     | Returns status of report deletion, given a `customer_token` and `report_id` to be deleted                                            |
| **Sensors**         | Get a Sensor                        | Gets a single sensor given the `uuid`                                                                                                |
|                     | Update a Sensor                     | Configures a sensor given the `uuid`                                                                                                 |
|                     | Get All Sensors                     | Gets all sensors for a customer given the `customer_token`                                                                           |
|                     | Connect a Sensor                    | Connect a sensor using a 4 character connect code                                                                                    |
|                     | Activate a Sensor                   | Activate a sensor given the uu`id`                                                                                                   |
|                     | Deactivate a Sensor                 | Deactivate a sensor given the `uuid`                                                                                                 |
|                     | Disconnect a Sensor                 | Disconnect a sensor given the `uuid` from the customer it’s currently associated to                                                  |


---

# 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.rewst.help/documentation/integrations/integration-guides/nodeware-integration.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.
