V-Blaze and V-Cloud Online Help

Redaction File

Note

V‑Cloud users cannot use custom redaction files. Contact support@vocitec.com for more information.

Use a text editor to create or update a redaction file. The text editor must be capable of saving in plain text. Freely available text editors such as Emacs, Vim, Nano, and Notepad++ work best as they save in plain text by default.

The redaction file must conform to standard JSON formatting and regular expression matching. Refer to JSON Structures for more information on JSON formatting. Additionally, the file must include the default rules and exclusions mentioned in Default Redaction Rules. Include custom redaction rules and exclusions after the defaults.

The following sample is a complete redaction file with some custom rules included:

[
  {
    "description": "exclude ordinal numbers from scrubbing",
    "regex": "^((\\d+/)?\\d+(st|nd|rd|th))([.,?]?)$",
    "repl": "",
    "text": false,
    "report": false,
    "audio": false
  },
  {
    "description": "exclude percentages from scrubbing",
    "regex": "^((\\d+\\.)?\\d+%)([.,?]?)$",
    "repl": "",
    "text": false,
    "report": false,
    "audio": false
  },
  {
    "description": "exclude clock times from scrubbing",
    "regex": "^(([1-9]|10|11|12):[0-5][0-9])([.,?]?)$",
    "repl": "",
    "text": false,
    "report": false,
    "audio": false
  },
  {
    "description": "exclude prices from scrubbing",
    "regex": "^(\\$\\d+(\\.\\d{2})?)([.,?]?)$",
    "repl": "",
    "text": false,
    "report": false,
    "audio": false
  },
  {
    "description": "exclude short floating point numbers (w/decimal point) from scrubbing",
    "regex": "^(\\d{1,4}[.]\\d{1,4})([.,?]?)$",
    "repl": "",
    "text": false,
    "report": false,
    "audio": false
  },
  {
    "description": "exclude 2-digit numbers for license plates from scrubbing",
    "regex": "^(\\d{2})([.,?]?)$",
    "repl": "",
    "text": false,
    "report": false,
    "audio": false
  },
  {
    "description": "replace credit card numbers with _CCN",
    "regex": "^(\\d{13,16})([.,?]?)$",
    "repl": "_CCN"
  },
  {
    "description": "replace CVV numbers with _CVV",
    "regex": "^(\\d{3})([.,?]?)$",
    "repl": "_CVV"
  },
  {
    "description": "replace all other digits with #",
    "regex": "\\d",
    "repl": "#"
  }
]

Once you've created the redaction file, place the file on each ASR server in the /opt/voci/state/ directory and adjust the permissions of the redaction file as necessary.

Important

If an /opt/voci/state/scrub.conf file exists, the default redaction configuration distributed with the ASR Engine will be ignored completely.