ICT - CLI Output Documentation

Anyone who has worked with the ICT CLI will know that when classifying a file, the CLI will output what is occuring in the classification process. This output will be written to the command line, here is an example of the output from successfully classifying a file:

[Information Centric Tagging][2018-05-23 11:07:44] Selected Options: VERBOSE=0, QUIET=0, CLASSIFY=1 (5), DECLASSIFY=0, OUTPATH=0 (), CLEAN=1
[Information Centric Tagging][2018-05-23 11:07:44] Obtaining configuration from Web-Service...
[Information Centric Tagging][2018-05-23 11:07:46] Classify operation
[Information Centric Tagging][2018-05-23 11:07:47] File classified correctly
[Information Centric Tagging][2018-05-23 11:07:47] Finished operation
[Information Centric Tagging][2018-05-23 11:07:47] All operations concluded successfully!​

This output from ICT is undocumented in the CLI user guide.

I have contacted ICT support and talked with backline engineering and they have told me that ICT will return 0 / 1 (success / fail), this can be found by typing %errorlevel% into the command line. They have confirmed that the console output text is not documented and suggested that I raise this as a feature request for ICT.

The only existing documentation for these console outputs are a connect article, written by myself (here).

I have discovered numerous outputs from ict including:

• File classified
• File already classified
• File not found
• No office products found

amongst others. I believe that these outputs should be included in the product documentation as the CLI will likely be used by developers. Since the CLI does not return a helpful exit code, a developer must parse this output (via Regex) and string match. This makes integrating ICT with other security solutions difficult because the program is relying on undocumented output.

So to summarise,

ICT CLI outputs text to the command line, I want documentation on what ICT outputs to the command line aswell as the reasons why it outputs the messages it does.