Skip to main content
 

How can we help?

Search

Admin Guide

  • Updated

Configure the Content Analyzer.

Extend the File Types That Acrolinx Checks

As an Acrolinx administrator you can extend the file types that Acrolinx checks. See the article How to Configure Acrolinx to Recognize Your File Type to learn more.

MSI Installer Properties

If you use the MSI installer properties to automate the installation of the Acrolinx Content Analyzer, you can use the properties in the following table to specify preferences during installation.

Property

Description

ACROLINX_SERVER_ADDRESS

Specify the Acrolinx URL.

Example

msiexec /i AcrolinxContentAnalyzer2019.msi /qb ACROLINX_SERVER_ADDRESS=https://demo-inc.acrolinx.com

Caution

Note: This property works for first-time installations only. The property gets ignored during an update and whichever Acrolinx URL is currently configured gets used instead.

ACROLINX_MIP_ACCEPTEDLABELS*

Microsoft Information Protection lets you add sensitivity labels to your content. To prevent writers from using Acrolinx to check content with sensitive data, you can set up the Content Analyzer to check content with certain labels.

Configure the names of labels that you want Acrolinx to check. If you list more than one label, separate with a semicolon. The values aren't case-sensitive.

This currently works for Word, PowerPoint, and Excel, but not for Outlook.

For example, you might create the following labels:

Caution

The values must be the "Name" (NOT the "Display name") of the sensitivity label

  • general

  • custom label

Example

msiexec.exe /i AcrolinxContentAnalyzer.msi /qn ACROLINX_SERVER_ADDRESS=https://demo.acrolinx.com  ACROLINX_MIP_ACCEPTEDLABELS=general;custom label

ACROLINX_MIP_PREVENTEMPTYLABELS*

Specify if Acrolinx should check content that doesn't have a sensitivity label assigned. You'd normally assign this kind of label to sensitive content via Microsoft Information Protection.

You can specify this property in Word, PowerPoint, and Excel. Currently, this isn't possible in Outlook.

The available values are:

  • true

  • false

Example

msiexec.exe /i AcrolinxContentAnalyzer.msi /qn ACROLINX_SERVER_ADDRESS=https://demo.acrolinx.com ACROLINX_MIP_PREVENTEMPTYLABELS=true

*Since an installer isn't available for Mac and Linux, set the environmental variables as follows:

Properties Without the MSI Installer

Mac

To configure the environmental variable via a .plist file, do the following:

  1. In the release folder, find the following lines in com.acrolinx.ca.plist and specify the values launchctl setenv ACROLINX_MIP_ACCEPTEDLABELS and launchctl setenv ACROLINX_MIP_PREVENTEMPTYLABELS. For example:

    launchctl setenv ACROLINX_MIP_ACCEPTEDLABELS General

    launchctl setenv ACROLINX_MIP_PREVENTEMPTYLABELS true

    Tip

    If you want to add multiple labels, use the following format:

    launchctl setenv ACROLINX_MIP_ACCEPTEDLABELS "General;Confidential"

  2. Copy the adjusted file to /Library/LaunchAgents.

  3. Sign out and sign back into your computer. When you sign back in, be sure to uncheck Reopen windows.

  4. Content Analyzer will use the specified values.

Linux

Use the bash script contentAnalyzerSetEnvironment.sh to set environment variables on clients. For example:

sudo bash contentAnalyzerSetEnvironment.sh "General;customlabel" true

Open Developer Tools

To analyze network behavior, you can open Chrome DevTools with the parameters --open-dev-tools or -o in your command line. Chrome DevTools will open in a Content Analyzer window.

Detailed Log Level

You also might want to see a more detailed log level. To enable debug logging, use the parameters --debug or -d in your command line.

Check Sites with Non-Standard SSL Certificates

The Content Analyzer accepts all certificates in your OS certificate store. If your organization uses non-standard SSL certificates, like a self-signed certificate, you can add that certificate to your OS certificate store.

The steps to add a certificate to the OS certificate store differ depending on your browser and your operating system. Below we describe how to add a certificate for a Windows 10 operating system via the Chrome browser.

Warning

Self-signed certificates aren’t considered secure. Only import a certificate that you're sure you trust. In general, importing untrustworthy certificates could make your system vulnerable.

To add an SSL certificate to your Windows 10 certificate store via the Chrome browser, follow these steps:

  1. Open Chrome and enter the URL that you want to check. You'll see a warning that your connection isn’t private.

  2. To open the certificate information, click the Not secure error to the left of the URL field, and click Certificate (Invalid) in the dropdown.

    53870730.png

  3. In the certificate information window, go to the Details tab and click Copy to file... This will open the certificate export wizard.

  4. In the certificate export wizard, follow the steps to name and save the certificate to a local folder.

  5. Open the saved certificate and click Install Certificate. This will open the certificate import wizard.

  6. Select the store location for the Current User and click Next.

  7. Select Place all certificates in the following store and click Browse.

  8. Select Trusted Root Certification Authorities and click OK.

  9. Click Next and complete the certificate import. Accept the warning message asking whether you really want to import this certificate.

  10. To check that it worked, open Chrome and enter the URL that you want to check. You should no longer see a warning. You can now check that site with the Content Analyzer.

Configure Extraction Settings

Most content doesn't just have text, it also includes images, diagrams, and sometimes markup like XML or HTML. To check correctly, Acrolinx needs to extract the text from your content. You can define the extraction settings using Content Profiles. You can configure your Content Profiles, but your guidance package also comes with default Content Profiles.