Bulk client side processing with scanii

Scanii's new java client (https://github.com/uvasoftware/scanii-java) provides a new interface for bulk processing content client side the same way a conventional antivirus product would, except, in our case utilizing our smarter content processing engine.

Setup

  1. Download Java (either the JRE or the JDK version 1.7 or above )
  2. Download our client binary from here

Running it from the console

$ java -jar scanii-java-2.10-shaded.jar --help
usage: scanii-cli [-h] -c CREDENTIALS [-e {us1,eu1,auto}] path

Scanii.com command line interface

positional arguments:
  path                   path to local content to be processed

optional arguments:
  -h, --help             show this help message and exit
  -c CREDENTIALS, --credentials CREDENTIALS
                         api credentials to use in the KEY:SECRET format
  -e {us1,eu1,auto}, --endpoint {us1,eu1,auto}
                         api endpoint to be used, see: http://docs.scanii.com/articles/understanding-api-endpoints.html (default: auto)

Processing all files in the ~/Desktop/files directory using your own API key/scret:

$ java -jar scanii-java-2.10-shaded.jar -c 39e0b01f9fa44163b6565ee7b92d9e81:12346789 ~/Desktop/files/
scanii-cli starting....
using endpoint: https://api.scanii.com/v2.0/
using key: 39e0b01f9fa44163b6565ee7b92d9e81
verifying connectivity to scanii service...OK
processing file list for path:[/Users/joe/Desktop/files/]...done
processing 16 files in batch mode
➝ /Users/joe/Desktop/files/.DS_Store | findings: [] completed: 0/16 (0%)
➝ /Users/joe/Desktop/files/virus/.DS_Store | findings: [] completed: 0/16 (0%)
➝ /Users/joe/Desktop/files/virus/eicar.com.gz | findings: [av.eicar-test-signature] completed: 0/16 (0%)
➝ /Users/joe/Desktop/files/virus/eicar.com | findings: [av.eicar-test-signature] completed: 0/16 (0%)
➝ /Users/joe/Desktop/files/virus/Virus.Linux.Alaeda | findings: [av.linux.alaeda.a] completed: 4/16 (25%)
➝ /Users/joe/Desktop/files/virus/.swp | findings: [] completed: 5/16 (31%)
➝ /Users/joe/Desktop/files/banner.pxm | findings: [] completed: 6/16 (38%)
➝ /Users/joe/Desktop/files/virus/trahun1.exe | findings: [av.crdf.malware-generic.2884091990.unofficial] completed: 7/16 (44%)
➝ /Users/joe/Desktop/files/scanii.png | findings: [] completed: 8/16 (50%)
➝ /Users/joe/Desktop/files/virus/b0be001.exe | findings: [] completed: 9/16 (56%)
➝ /Users/joe/Desktop/files/Scanii Security .pdf | findings: [] completed: 10/16 (62%)
➝ /Users/joe/Desktop/files/Screen Shot 2015-06-08 at 12.27.43 AM.png | findings: [] completed: 11/16 (69%)
➝ /Users/joe/Desktop/files/hoa 1.pdf | findings: [] completed: 12/16 (75%)
➝ /Users/joe/Desktop/files/virus/rain003.exe | findings: [] completed: 13/16 (81%)
➝ /Users/joe/Desktop/files/virus/v377?product_name=Kuyhaa.IDM.v6.23.11.Silent.Install.rar | findings: [] completed: 14/16 (88%)
➝ /Users/joe/Desktop/files/virus/suba002.exe | findings: [av.crdf.malware-generic.2462546599.unofficial] completed: 15/16 (94%)
>>
run summary:
>> 16 files processed in 7.02s
>> throughput: 959.1 KB/s
>>

Remember, you will need an scanii.com account and a API key to run the cli client, to create an account and manage keys go here: https://scanii.com

Last updated on 06/30/2015.