Online Authentication

Visionular's products require online authentication to function. When the transcoding process is started, the Visionular encoder algorithm module will request a license from Visionular's authentication server and report active information for authentication statistics from time to time. This method does not limit the specific machine the customer uses, and the customer can flexibly activate/expand/replace the transcoding server without applying for a license from Visionular in advance. During this process:

  1. Configuration Verification: Ensure configuration file (wz_license.cnf) is properly set up and accessible

  2. License Generation: The authentication server generates a temporary wz_license.key file

  3. License Activation: This license file key enables all product features. Full functionality becomes available immediately upon successful authentication

Authentication Communication Details

Authentication Endpoint

http://stat.visionular.com/api/wzauth

Typical Information Reported Includes:

  • Network interface / MAC address
  • Local IP address
  • CPU core count
  • Host identifier
  • Encoder version and runtime statistics

Reporting Frequency

Authentication messages are sent:

  • Once when the encoder starts
  • Every 5 minutes while encoding is running
  • Once when a encoding task completes

Message Size

Each request is typically less than 2 KB.

Example of Information Shared with Visionular

{ 
  "auth_ver": "v3.8.0 (GNU 10.2.1)", 
  "contract_id": "tstreport", 
  "arch": "x86_64", 
  "host_id": "0000000d-68747541-69746e65-444d416300000000-00000000-00000000-00000000|08:00:27:90:01:c3", 
  "token": "9efa3eaa780793324d0a168bb2f92cf0", 
  "tmsec": 1772678364, 
  "local_ip": "192.168.10.122", 
  "local_host": "ubu22", 
  "nprocs": 8, 
  "cpu_cores": 8, 
  "limit_cpus": 8, 
  "mem_limit": 15970, 
  "mem_total": 15970, 
  "limit_cpuset": "", 
  "stat_list": [ 
    { 
      "start_time": 1772678355, 
      "end_time": 1772678364, 
      "duration": 15120, 
    } 
  ] 
}

Configuration Options

Choose one of the following setup methods:

  • Basic Configuration: Place both executive binary (e.g., ffmpeg) and wz_license.cnf in the same directory

  • Advanced Configuration: To maintain configuration files in a custom location, set the following environment variables to specify paths for both wz_license.cnf and wz_license.key:

Set a custom directory for the cnf/key files: 

export WZ_LICENSE_PATH=/path/to/license_dir

Set a proxy for external network access: 

export WZ_LICENSE_ALL_PROXY=http://proxy_domain:proxy_port

Please note:

  • Ensure the executing user has read and write permissions in the target directory

  • Verify that wz_license.key is successfully generated after authentication

Authentication Issues

Common Errors & Solutions

Error Type Symptoms Resolution
Path Configuration Missing config file Ensure wz_license.cnf is in the binary directory or specify custom paths
Network Connection send request failed, errno: HPE_USER[24] Verify network connectivity and firewall permissions
License Expiration errno:4, "contract error" Renew license through Visionular Support
Host Whitelisting errno:8, "host error" Register host in license whitelist or contact support

Diagnostic Procedures

Network Check:

curl http://stat.visionular.com/health

Expected response:

{"code":0,"msg":"Success","data":""}