# Solarwinds

**Early Access**: This integration is provided as an Open Authorization API (OAA) connector package. Contact our support team for more information.

## Veza SolarWinds Connector

Veza Connector for SolarWinds Organizations. Enables discovery of SolarWinds Users and their type.

#### Veza Application Mapping

| SolarWinds       | OAA Application | Notes |
| ---------------- | --------------- | ----- |
| SolarWinds-Orion | Application     |       |
| Users            | Local User      |       |

#### Discovered Properties

| Entity | Property      | Description                                                                       |
| ------ | ------------- | --------------------------------------------------------------------------------- |
| Users  | `AccountId`   | User's ID (name) provided by SolarWinds.                                          |
| Users  | `Enabled`     | User account is enabled or not.                                                   |
| Users  | `AccountType` | Defines the type of user account. (LDAP, SAML or Orion accounts)                  |
| Users  | `Orion User`  | If User is having normal Orion account, Orion User would be true else false.      |
| Users  | `LDAP User`   | If User is having Windows individual account, LDAP User would be true else false. |
| Users  | `SAML User`   | If User is having SAML individual account, SAML User would be true else false.    |
| Users  | `AllowAdmin`  | If User is Admin, AllowAdmin would be 'Y' else 'N'.                               |

#### Limitations

* Information about the users with enabled accounts will be only fetched.
* Depending on the SolarWinds configuration and plan level, the connector may not be able to retrieve SolarWinds User's email addresses to use for identity mapping.

### Setup

#### SolarWinds

1. Setup the SolarWinds Orion Instance. (Note the IP address and port number)
2. Once the users are created, note the credentials. (Username and password)
3. Ensure that SSL configurations are setup correctly and the server is reachable by the integration.

#### Veza

1. Generate an API key for your Veza user. API keys can be managed in the Veza interface under Administration -> API Keys. For detailed instructions consult the Veza User Guide.

### Running the Connector

#### Command Line

1. Install the requirements:

   ```
   pip3 install -r requirements.txt
   ```
2. Set the Secrets:

   ```
   export VEZA_API_KEY="ZXldTcj...JCWGU3Qlo1OHR3RTBfc00yN3lfSFk="
   export SOLARWINDS_USERNAME="XXXXX...XX"
   export SOLARWINDS_PASSWORD="XXXXXXXXXXX"
   ```
3. Run the connector:

   ```
   ./veza_solarwinds.py --veza-url https://<your-org>.vezacloud.com
   ```

#### Parameters

| CLI Parameter              | Environment Variable       | Description                                                       |
| -------------------------- | -------------------------- | ----------------------------------------------------------------- |
| `--veza-url`               | `VEZA_URL`                 | the URL of the Veza instance system                               |
| n/a                        | `VEZA_API_KEY`             | API key for Veza connection                                       |
| `--solarwinds-host`        | `SOLARWINDS_HOST`          | \[http/https]://\<solarwinds-ip-address\|solarwinds-domain-name>  |
| `--solarwinds-port-number` | `SOLARWINDS_PORT_NUMBER`   | port\_number of the SolarWinds instance                           |
| n/a                        | `SOLARWINDS_USERNAME`      | Username of SolarWinds User Account                               |
| n/a                        | `SOLARWINDS_USER_PASSWORD` | Password of SolarWinds User Account                               |
| `--debug`                  | n/a                        | Enable verbose debug output                                       |
| `--save-json`              | n/a                        | Save OAA Payload as local JSON file before upload                 |
| `--create-report`          | n/a                        | Create/update a Veza Report. Defaults to true for first discovery |

#### Reports

On first discovery, connector will automatically populate Veza Insights Queries and Report associated with SolarWinds. Queries created include:

* List all SolarWinds Users
* SolarWinds Users not used in last 90 days
* SolarWinds Administrators
* SolarWinds Users Related to Okta Users
* SolarWinds Users Not Related to Okta Users
* SolarWinds Users Related to Deactivated Okta Users
* List SolarWinds LDAP Users
* List SolarWinds SAML Users


---

# 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.veza.com/4yItIzMvkpAvMVFAamTf/integrations/integrations/solarwinds.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.