# Software Packages

Fetches software package data from Tanium, providing insights into installed software and package configurations within your Tanium instance.

**Sync Type: Full Sync**

## Description

The Tanium Software Packages input connector retrieves software package data from your Tanium instance.

- Configurable scheduling using cron expressions
- Support for synthetic data generation for testing purposes

## Requirements

1. A Tanium instance with API access enabled
2. An API token with permissions to access software package data
3. The base URL of your Tanium instance (e.g., `https://<customerName>-api.cloud.tanium.com` for cloud or `https://<server>` for on-prem).

## Setup Instructions

1. **Generate an API Token**:
   - Log in to your Tanium instance.
   - Navigate to **Administration > Permissions > API Tokens**.
   - Click **Create API Token**.
   - Fill in the **Description** field with a meaningful name for your token.
   - Select the **Expiry** duration in days.
   - Configure **Allow whitelist IPs** if needed for enhanced security requirements. For most deployments, using `0.0.0.0/0` (all IPs) is recommended for operational simplicity. If your organization requires IP restrictions, whitelist Monad's IP addresses:
     - For Monad SaaS: see [Monad egress IP addresses](../../guides/egress-ip-addresses.mdx)
     - For Monad on-premises: Your Monad instance's IP address
   - Click **Create** to generate the token.
   - Copy the generated token and store it securely.

2. **Obtain the Base URL**:
   - Note the API URL of your Tanium instance (e.g., `https://<customerName>-api.cloud.tanium.com` for cloud or `https://<server>` for on-prem).

3. **Configure the Connector**:
   - Use the API token and base URL in the configuration settings for the connector.

## Configuration

The following configuration defines the input parameters. Each field's specifications, such as type, requirements, and descriptions, are detailed below.

### Settings

| Setting  | Type   | Required | Description                                                                                                                             |
| -------- | ------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| Base URL | string | Yes      | The base URL of your Tanium instance (e.g., `https://<customerName>-api.cloud.tanium.com` for cloud or `https://<server>` for on-prem). |
| Cron     | string | Yes      | Cron expression to schedule the connector runs.                                                                                         |
| API Rate Limit | object | No | Optional limit on the connector's outbound request rate to the source API. Leave blank to use the connector's default behavior. See [API Rate Limiting](../../../guides/rate-limiting) for the field format, limits, and how to choose a value. |

### Secrets

| Secret    | Type   | Required | Description                                   |
| --------- | ------ | -------- | --------------------------------------------- |
| API Token | string | Yes      | The API token for authentication with Tanium. |

## Best Practices

1. **API Token Security**: Keep your API token secure and never commit it to version control.
2. **Cron Scheduling**: Use an appropriate cron expression to balance data freshness and API usage.

## Troubleshooting

### Common Issues

1. **Authentication Errors**:
   - Verify the API token is correct and has not expired.
   - Ensure the token has the necessary permissions to access software package data.
   - Check if the token was created with appropriate expiry duration.
   - Verify that Monad's IP addresses are whitelisted if IP restrictions were configured during token creation.
   - Regenerate the token if it has expired or permissions have changed.

2. **Connection Issues**:
   - Verify the base URL is correct and accessible from your network.
   - Check for firewall or network restrictions that may block access to the Tanium instance.

3. **IP Whitelist Issues**:
   - If you configured IP whitelisting during token creation, ensure Monad's IP addresses are included:
     - For Monad SaaS: see [Monad egress IP addresses](../../guides/egress-ip-addresses.mdx)
     - For Monad on-premises: Your Monad instance's IP address
   - Consider using `0.0.0.0/0` for simpler configuration if your security policies allow it.
   - Check if your organization uses NAT or proxy servers that might change the outbound IP.
   - Update the token's IP whitelist if Monad's IP addresses have changed.

4. **Invalid Cron Expression**:
   - Ensure the cron expression is valid. Refer to [Cron Expression Syntax](https://crontab.guru/) for guidance.

5. **Missing Data**:
   - Verify that the Tanium instance contains software package data.
   - Check the connector logs for errors or warnings.

## Related Articles

- [Tanium On-Prem API Documentation](https://help.tanium.com/bundle/ug_gateway_onprem/page/gateway/overview.html)
- [Tanium Cloud API Documentation](https://help.tanium.com/bundle/ug_gateway_cloud/page/gateway/overview.html)