Acrolinx

Context

The Acrolinx configuration is configured in the censhare Admin Client. The Acrolinx widget is available in the Content editor of censhare Web. To set up the integration, the Acrolinx module must be enabled. To configure the integration, you need an Acrolinx account to connect to. The content language guidelines that you want to use in censhare must be defined in Acrolinx.

Prerequisites

Users need an Acrolinx account with the respective credentials for SSO via the censhare platform.

Introduction

censhare Web provides integrated content and translation management. Users can thus carry out asset management and content management on the same platform. With the native Content editor application, censhare provides a WYSIWYG editor to edit content directly on an asset page. The Content editor integrates with translation tools and applications like Translation with Memory, the XLIFF exporter, or the Lionbridge connector.

Acrolinx is a platform that uses artificial intelligence for real-time content analyses. Acrolinx users can define language-specific and audience-specific rules for their content. Thes rules comprise grammar and spelling checks, terminology, style, and tone of the content.

The Acrolinx integration for censhare makes the rules that you define in Acrolinx available in the content editor of censhare Web. The content is analyzed and the score is shown in the widget. Authors can see in real-time if their content conforms with the content guidelines.

The Acrolinx integration uses Single Sign-On (SSO) to authenticate a user that is logged into censhare Web. If a censhare Web user opens the Main content asset and goes to the Content tab, the Acrolinx interface starts automatically and retrieves the profile from the Acrolinx server.

Acrolinx configuration

The configuration is done in the censhare Admin Client. In the Configuration/Modules folder, open the Acrolinx settings configuration dialog.

Enable the Acrolinx module

In the General setup area of the Acrolinx settings dialog:

1. In the Server name field, select the server on which the module runs. 

2. Activate the Enabled field.

3. Optionally, add the desired Roles that can access Acrolinx.

Server URL and authentication key

Note: To use the SSO authentication with censhare Web, you must configure the core server properties of your Acrolinx application. For more information, see the Acrolinx documentation.

1. In the Acrolinx server field of the Acrolinx settings dialog, enter the URL through which censhare accesses Acrolinx. For example, https://your-company.acrolinx.com/.

2. In the SSO secret key field, enter the secret key of the SSO certificate.

3. Click OK to save the configuration.

4. Update the server configuration.

Language mapping

Note: Before you can add the language mapping, complete the previous configuration and update the server configuration. Otherwise, censhare cannot load the available languages from the Acrolinx server.

To add a language mapping:

1. In the header bar of the censhare Admin Client, click  and select Acrolinx settings. This action initializes the Acrolinx integration and imports the available languages from the Acrolinx server.

2. Open the Acrolinx settings configuration you created.

3. In the Language mapping area, select a censhare content language and a corresponding Acrolinx language for rules and guidelines.

4. To add more mappings, click  and repeat the previous step.

5. Click OK to save the nconfiguration.

6. Update the server configuration again.

7. If necessary, synchronize the remote servers.

Truststore configuration

To enable secure access of Acrolinx to censhare, you must add an SSL certificate to the truststore of the censhare Server. To get an SSL certificate, please contact the Acrolinx support.

1. Store the Acrolinx SSL certificate on the censhare Server.

   Look up the truststore path in the censhare Admin Client, in the Configuration/Server/General configuration. The certificate must be added there. The default path is @current.runtime.dir@config/truststore.

2. To add the certificate to the truststore, execute the following command in a terminal window:

   keytool -import 
            -alias <ALIAS_NAME> 
            -file ~/<PATH>/ssl.acrolinx.com.cer 
            -keystore censhare-Server/work/runtime.master/config/truststore

3. Restart the censhare Server.

Note: On production systems, we recommend to use SSL certification for third-party access to the censhare server. If you do not need SSL certification on your system, you can disable the truststore in the censhare Admin Client. Open the Configuration/Server/General configuration, disable the javax.net.ssl.trustStore property, and restart the censhare server.

Testing & troubleshooting

To test your configuration, log in to censhare Web and open the Main content asset of a Text asset. Go to the Content tab. The Acrolinx widget initializes in the right column of the main area.

The following configuration errors can occur:

The following errors can occur during the initialization:

Result

You have learned how to integrate Acrolinx into the Content editor of censhare Web.

Related content

Acrolinx documentation (redirects to Acrolinx)