> ## Documentation Index
> Fetch the complete documentation index at: https://docs.threataware.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Snow

> Connect ThreatAware to Snow for software asset management and license tracking

## Overview

The Snow integration enables ThreatAware to collect read-only data from your Snow platform, providing visibility into software assets and helping validate your software asset management controls.

<Info>
  **Connection Method**: API with Firewall Configuration
  **Setup Time**: 20 minutes
  **Access Required**: Snow Administrator account
</Info>

## Data collected

The Snow integration provides:

* Software asset inventory
* License information
* Asset usage patterns
* Compliance tracking data

## Use cases

<CardGroup cols={2}>
  <Card title="Software Asset Tracking" icon="box">
    Monitor software installations and usage across your environment
  </Card>

  <Card title="License Management" icon="file-contract">
    Track and validate software licenses to ensure compliance
  </Card>

  <Card title="Asset Inventory" icon="database">
    Maintain an accurate inventory of software assets
  </Card>

  <Card title="Compliance Monitoring" icon="shield-halved">
    Verify software deployment meets organisational standards
  </Card>
</CardGroup>

## Setup instructions

<Steps>
  <Step title="Log in to ThreatAware">
    Access the ThreatAware dashboard and navigate to **Settings → Integrations**.
  </Step>

  <Step title="Locate Snow Integration">
    Use the search bar to find **Snow** in the integrations list.
  </Step>

  <Step title="Create API User in Snow">
    Log in to the **Snow Management and Configuration Center** with an administrator account.

    * Create a new user account
    * Assign the role **API Users**
    * Document the username and password for later use
  </Step>

  <Step title="Configure Firewall Rules">
    Set up firewall port forwarding to the Snow server:

    * Create a port forward on your firewall to the Snow server
    * Restrict access to ThreatAware's current allowlist IP addresses, available in-product under **Settings → Integrations → AWS Account / IP Whitelist Info**

    <Warning>
      Only allow connections from ThreatAware's IP addresses. Do not open the port to all traffic.
    </Warning>
  </Step>

  <Step title="Configure in ThreatAware">
    Click **Connect** in the integration setup.

    * Enter the **Public IP Address** of the Snow server
    * Enter the **Forwarded Port** configured on your firewall
    * Enter the **Username** and **Password** for the Snow API user
    * Click **Connect** to establish the integration
  </Step>

  <Step title="Verify Connection">
    After connecting, verify the integration status:

    * Check that the **Integration Status** shows as **Active**
    * Wait for initial data synchronization (typically 1 hour)
    * Verify data appears in ThreatAware
  </Step>
</Steps>

## Required credentials

<AccordionGroup>
  <Accordion title="Public IP Address" icon="globe">
    **Field Name**: Snow Server Public IP
    **Type**: String
    **Description**: The publicly accessible IP address of your Snow server

    Example: `203.0.113.42`
  </Accordion>

  <Accordion title="Forwarded Port" icon="network-wired">
    **Field Name**: Snow Forwarded Port
    **Type**: Integer
    **Description**: The port number configured on your firewall for the Snow server

    Example: `8080` or `443`
  </Accordion>

  <Accordion title="Username" icon="user">
    **Field Name**: Snow API Username
    **Type**: String
    **Description**: The username for the Snow API user created with the API Users role

    Example: `threataware-api` or `svc_snow`
  </Accordion>

  <Accordion title="Password" icon="lock">
    **Field Name**: Snow API Password
    **Type**: Password (encrypted)
    **Description**: The password for the Snow API user account

    <Tip>
      Store this credential securely in your organisation's password manager.
    </Tip>
  </Accordion>
</AccordionGroup>

## Verification and testing

After setup, verify the integration is working correctly:

1. **Check Integration Status**
   * Navigate to **Settings → Integrations** in ThreatAware
   * Confirm the Snow integration shows **Active** status
   * Check the last sync timestamp

2. **Verify Firewall Configuration**
   * Ensure the firewall port forward is active
   * Test connectivity from the ThreatAware platform

3. **Verify Data Collection**
   * Wait for the initial data sync
   * Search for devices in ThreatAware
   * Verify Snow data appears in device details

## Troubleshooting

<AccordionGroup>
  <Accordion title="Invalid Credentials Error" icon="triangle-exclamation">
    **Symptoms**: Integration status shows authentication failure

    **Solutions**:

    * Verify the **Username** and **Password** are correct
    * Ensure the user account is not locked or expired
    * Confirm the Snow API user has the correct role assigned
    * Check that credentials are entered without extra spaces
  </Accordion>

  <Accordion title="Connection Timeout" icon="clock">
    **Symptoms**: Integration fails to connect or times out

    **Solutions**:

    * Verify the **Public IP Address** and **Forwarded Port** are correct
    * Test the connection from a local machine to ensure the port is accessible
    * Check firewall rules allow connections from ThreatAware's IP addresses
    * Confirm the Snow server is running and accessible
    * Review network connectivity between ThreatAware and your Snow server
  </Accordion>

  <Accordion title="Firewall Rule Issues" icon="ban">
    **Symptoms**: Integration connects initially but drops or fails to sync

    **Solutions**:

    * Verify firewall rules restrict access only to ThreatAware's dedicated IPs
    * Check that the port forward is properly configured
    * Ensure the Snow Management and Configuration Center documentation is followed
    * Contact your network team to verify the port forward is active
  </Accordion>

  <Accordion title="No Data After 1 Hour" icon="database">
    **Symptoms**: Integration shows active but no data appears

    **Solutions**:

    * Wait up to 1 hour for initial data sync
    * Verify there is software asset data in Snow to collect
    * Check the API user has the necessary permissions
    * Review integration logs in ThreatAware (contact support if needed)
  </Accordion>
</AccordionGroup>

## Additional resources

<CardGroup cols={2}>
  <Card title="Snow Documentation" icon="book" href="https://www.snowsoftware.com">
    Official Snow documentation for platform guidance
  </Card>

  <Card title="ThreatAware Support" icon="life-ring" href="mailto:help@threataware.com">
    Contact ThreatAware support for integration assistance
  </Card>
</CardGroup>

## Best practices

<Tip>
  **Security Considerations**

  * Create a dedicated service account for ThreatAware in Snow
  * Document credentials in your organisation's password manager
  * Restrict firewall access to ThreatAware's IPs only
  * Monitor integration logs for authentication failures
  * Rotate credentials annually per your security policy
</Tip>

<Tip>
  **Network Configuration**

  * Ensure the firewall port forward is configured before attempting connection
  * Use TLS/SSL encryption for the connection when available
  * Monitor network latency between ThreatAware and Snow server
  * Keep firewall rules updated with any ThreatAware IP changes
</Tip>