PrivX
  • 08 Mar 2022
  • 2 Minutes to read
  • Dark
    Light
  • PDF

PrivX

  • Dark
    Light
  • PDF

Article Summary

PrivX provides privileged access to on-prem and cloud environments, including control access to servers, network devices and other critical infrastructure according to user roles and privileges.

Types of Assets Fetched

This adapter fetches the following types of assets:

  • Devices
  • Users

Parameters

  1. Host Name or IP Address (required) - The hostname or IP address of the PrivX server.
  2. OAuth Client ID, OAuth Client Secret, API Client ID and API Client Secret (required) - The credentials for an API client that has the Required Permissions to fetch assets.
  3. Verify SSL (required, default: False) - Verify the SSL certificate offered by the value supplied in Host Name or IP Address. For more details, see SSL Trust & CA Settings.
    • If enabled, the SSL certificate offered by the value supplied in Host Name or IP Address will be verified against the CA database inside of Axonius. If the SSL certificate can not be validated against the CA database inside of Axonius, the connection will fail with an error.
    • If disabled, the SSL certificate offered by the value supplied in Host Name or IP Address will not be verified against the CA database inside of Axonius.
  4. HTTPS Proxy (optional, default: empty) - A proxy to use when connecting to the value supplied in Host Name or IP Address.
    • If supplied, Axonius will utilize the proxy when connecting to the value supplied in Host Name or IP Address.
    • If not supplied, Axonius will connect directly to the value supplied in Host Name or IP Address.
  5. For details on the common adapter connection parameters and buttons, see Adding a New Adapter Connection.

image.png

APIs

Axonius uses the SSH PrivX API.

Required Ports

  • HTTPS port 443

Required Permissions

The value supplied in OAuth Client ID, OAuth Client Secret, API Client ID and API Client Secret must have read access to devices and users.

To create an API client:

  1. Log as a system admin to the PrivX server
  2. Go to SettingsDeploymentIntegrate with PrivX using API Clients
    image.png
  3. Click ADD API CLIENT.
    image.png
  4. Select the following permissions:
    • users-view
    • hosts-view
  5. Click SAVE.
    The client API credential will be displayed. Use those in the adapter connection parameters.

Version Matrix

This adapter has only been tested with the versions marked as supported, but may work with other versions. Please contact Axonius Support if you have a version that is not listed and it is not functioning as expected.

VersionSupportedNotes
SSH PrivX Authentication API: 1.0.1Yes
SSH PrivX Local User Store API: 1.0.3Yes
SSH PrivX Host Store API: 1.0.3Yes

What's Next
Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.