Viakoo

Viakoo is an IoT device management platform that provides discovery, firmware and password remediation, and service assurance for physical security devices such as cameras and access control systems.

Use Cases the Adapter Solves

• Improve physical-security device visibility: Discover Viakoo-managed devices, including cameras, switches, streams, and access-control devices, in Axonius.
• Monitor device status and compliance: Review component status, compliance status, firmware version, and last-seen information to identify devices that need attention.
• Support site-based asset governance: Associate devices with their Viakoo site so teams can investigate assets in the right operational context.

Asset Types Fetched

• Devices

Data Retrieved through the Adapter

Devices - fields such as: Device Name, IP Address, MAC Address, Firmware Version

Before You Begin

Required Ports

• TCP port 443 (HTTPS)

Authentication Methods

The adapter uses OAuth 2.0 Resource Owner Password Credentials authentication through a Viakoo Azure AD B2C ROPC token endpoint.

APIs

Axonius uses the Viakoo API. The following endpoints are called:

• POST {Token URL} - Obtains an OAuth 2.0 access token.
• POST /reports/siteReport - Retrieves sites beneath the configured sphere or site and associated device-type counts.
• POST /component/list - Retrieves device components for each discovered site and component type.

Required Permissions

Viakoo user account (username/password) with read scope.

Supported From Version

Supported from Axonius version 10.0.1

Connecting the Adapter in Axonius

1. Navigate to the Adapter Catalog, search for Viakoo, and select the adapter.
2. Click Add Connection.
3. Provide the following parameters.

Required Parameters

1. Host Name or IP Address - Enter the Viakoo API base URL, including the https:// prefix. Use https://reader.viakoo.com for Production or https://api-testing.viakoo.com for Testing. Do not add a specific API endpoint to this value.
2. Token URL - Enter the OAuth 2.0 token URL for the Azure AD B2C ROPC policy provided by Viakoo.
3. Client ID - Enter the client ID that Viakoo issued for this integration. Testing and Production use separate client IDs.
4. User Name - Enter the Viakoo user account with read access.
5. Password - Enter the password for the specified User Name.
6. Scope - Enter the OAuth 2.0 scope supplied by Viakoo. Use the scope that matches the selected environment.
7. Sphere / Site ID - Enter the Viakoo sphere or site ID whose sites and devices the adapter retrieves.

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 Viakoo API.
3. HTTPS Proxy User Name - Enter the user name to use when connecting through HTTPS Proxy.
4. HTTPS Proxy Password - Enter the password to use when connecting through HTTPS Proxy.

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

Advanced Settings

• Components page size - Set the number of components retrieved per POST /component/list request. The default is 100; allowed values are from 1 to 1000.
• Component types to skip - Specify component types that the adapter should not retrieve. Use the device-type portion of the site report key without the Count suffix; for example, enter stream to skip stream components.