Axonius Documentation
  1. Connecting Adapters
  2. Adapters S

Splashtop

Splashtop is a remote access and remote support tool.

Use Cases the Adapter Solves

  • Remote Access Asset Visibility: Track and monitor all devices managed through Splashtop remote access, ensuring complete visibility of endpoints accessed remotely across your organization.
  • User Access Control: Identify which users have remote access capabilities and their group memberships, enabling better security posture management and access governance.

Types of Assets Fetched

This adapter fetches the following types of assets:

  • Devices, Users

Data Retrieved through the Adapter

Devices - Fields such as Name, Hostname, Last Seen, Operating System

Users - Fields such as Email, User Status, Role,Associated Groups (Group ID, Display Name, Name)

Before You Begin

Required Ports

  • TCP port 443 (HTTPS)

Authentication Methods

Splashtop supports two authentication methods:

API Key Authentication - Recommended for most deployments. Requires an API Key generated from the Splashtop console.

OAuth 2.0 Authentication - Requires Client ID, Client Secret, MFA Code, and Redirect URI configured in Splashtop.

APIs

Axonius uses the Splashtop Open APIs. The following endpoints are called:

User Data:

  • GET /api/open/v1/users/basic_info
  • GET /api/open/v1/teams/{team_id}/users

Device Data:

  • GET /api/open/v1/teams/{team_id}/computers
  • GET /api/open/v1/teams/{team_id}/inventory

Group Data (when "Fetch User and Computer Groups" is enabled):

  • GET /api/open/v1/teams/{team_id}/groups
  • GET /api/open/v1/teams/{team_id}/groups/{group_id}/members
  • GET /api/open/v1/teams/{team_id}/groups/{group_id}/computers

Required Permissions

The value supplied in Client ID must be associated with the following scopes in order to fetch assets:

Minimum Required Scopes:

  • users - Required to fetch user information
  • team_computers - Required to fetch computer/device information
  • inventory - Required to fetch software inventory data
  • logs - Required to fetch session and configuration logs

Additional Scope for Group Data:

  • team_groups - Required when "Fetch User and Computer Groups" advanced setting is enabled
⚠️

Important

If you plan to enable the "Fetch User and Computer Groups" advanced setting, you must include the team_groups scope in your OAuth application or API Key permissions. Without this scope, the group endpoints will return permission errors.

Supported From Version

Supported from Axonius version 6.0

Connecting the Adapter in Axonius

Navigate to the Adapters page, search for Splashtop, and click on the adapter tile.

Click Add Connection.

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

Required Parameters

  1. Host Name or IP Address (required) - The hostname or IP address of the Splashtop server. Default: https://webapi.splashtop.com

  2. 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.

Authentication Parameters

Choose one of the following authentication methods:

Option 1: API Key Authentication (recommended)

  1. API Key (optional) - An API Key associated with a user account that has the Required Permissions to fetch assets.
📘

Note

When API Key is supplied, no other authentication fields are necessary.

Option 2: OAuth 2.0 Authentication

  1. Client ID and Client Secret (optional) - Credentials associated with a user account that has the Required Permissions to fetch assets.
📘

Note

When API Key is not supplied, Client ID and Client Secret are required.

  1. MFA Code (optional) - The code provided in the query params of the OAuth2 redirection.

  2. Redirect URI (optional) - The URL that is registered in the product as the URI that should be using the token.

Splashtop(1)

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 (optional) - Connect the adapter to a proxy instead of directly connecting it to the domain.

  3. HTTPS Proxy User Name (optional) - 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 (optional) - 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. To learn more about Adapter Configuration tab advanced settings, see Adapter Advanced Settings.

Fetch User and Computer Groups - Select this option to fetch user groups and computer groups from Splashtop. When enabled, the adapter will retrieve group memberships and enrich both user and device assets with their associated groups.

Updated 3 days ago