Avanan

Avanan is an API‑based inline protection platform that offers multi‑layer threat detection and security event management across SaaS applications.

Asset Types Fetched

• Users, Alerts/Incidents

Before You Begin

Ports

• TCP port 80/443

Authentication Method

• Application ID/Secret Key

APIs

Axonius uses the Avanan SmartAPI and the Avanan MSP SmartAPI.

Permissions

• Authentication requires credentials: You must obtain the following from Avanan Support:

  • Application ID (App ID)
  • Secret Key
  • These are tied to your MSP or tenant account and are not publicly self-generated.

• Access Token Generation: A valid JWT token must be retrieved by calling the /auth endpoint using: * Your App ID * A time-based request signature (x-av-sig) * A unique request ID (x-av-req-id)​* Token Usage: The JWT token returned must be included in all subsequent API requests via the x-av-token header. Without it, requests will be unauthorized.

Supported From Version

Supported from Axonius version 7.0.6

Connecting the Adapter in Axonius

To connect the adapter in Axonius, provide the following parameters:

Required Parameters

1. Host Name or IP Address - The hostname or IP address of the Avanan server. Use the correct base URL based on your tenant's region (All endpoints follow the pattern: {region_url}/v1.0/{endpoint}).

2. Application ID - Enter the application ID to be used to get the token.
3. Secret Key - Enter the secret key that should be shared and stored securely.

Optional Parameters

1. Verify SSL - Select whether to verify the SSL certificate of the server against the CA database inside of Axonius. For more details, see SSL Trust & CA Settings.

2. HTTPS Proxy - Connect the adapter to a proxy instead of directly connecting it to the domain.

3. HTTPS Proxy User Name - The user name to use when connecting to the value supplied in Host Name or IP Address via the value supplied in HTTPS Proxy.

4. HTTPS Proxy Password - The password to use when connecting to the server using the HTTPS Proxy.

To learn more about common adapter connection parameters and buttons, see Adding a New Adapter Connection.

Advanced Settings

📘

Note

Advanced settings can either apply to all connections for this adapter, or to a specific connection. Refer to ​Advanced Configuration for Adapters.

• Fetch Incidents from the last X days (optional, default: 30) - Specify the number of days back to fetch the incidents.

📘

Note

To learn more about Adapter Configuration tab advanced settings, see Adapter Advanced Settings.