Acrolinx for Adobe Experience Manager Admin Guide

How Acrolinx Interacts with Your Web Application

The following diagram illustrates how Acrolinx fits into the architecture of your web application. The web application communicates exclusively with your web server proxy. Your web server then passes checking requests on to the Core Platform. Acrolinx uses single sign-on to authenticate users with your web application.

General Configurations

Set Up Single Sign-On (SSO)

Before you can use Acrolinx for AEM, you'll need to set up SSO for Acrolinx. To do this, follow the process in our article on setting up Acrolinx for single sign-on.

Connect to Acrolinx

Before you can check your content, you'll need to configure AEM to route internal checking requests to Acrolinx.

To enable AEM to connect to Acrolinx, follow these steps:

  1. In AEM, open the Adobe Experience Manager Web Console by navigating to Tools > Operations > Web Console.
  2. Click the row Acrolinx Connection Settings and in the dialog box that appears, make the following changes:
    • In the Acrolinx Platform URL field, enter your Acrolinx URL.
    • In the Generic Password field, enter the password that you configured in the core server properties file when setting up Acrolinx for single sign-on.

  3. (Optional) If you want to forward cookies to your Acrolinx Core Platform, select the option Forward Cookies to Acrolinx.

    This setting is optional. In some environments, single sign-on only works when you forward cookies to your Acrolinx Core Platform. If your users have difficulty authenticating, try selecting this option.

  4. (Optional) Forward Acrolinx requests via a custom HTTP proxy. Select Turn on HTTP Proxy
    • In the HTTP Proxy URL field, enter your custom HTTP proxy URL.
  5. Click Save.

You can now run checks in AEM with Acrolinx!

Component Configuration

Since Acrolinx for AEM 1.7, the Acrolinx Configuration Assistant is obsolete. You now edit your AEM Content Profile to define components that you want Acrolinx to include or exclude.

To do this, you first identify any components that you use in your website, then you add them to your AEM Content Profile.

We recommend the following procedure to identify your components and update your Content Profile:

  1. In AEM, go to Tools > CRXDE Lite to open CRXDE Lite.
  2. Go to apps > [your AEM website] > components > content. You'll see a list of all the components that you've enabled in your website.
  3. In a separate browser tab, sign in to the Acrolinx Dashboard.
  4. Go to Guidance Settings > Content Profiles.
  5. Open your AEM Content Profile and go to the Extraction tab.
  6. Add any components to the Content Profile. For example, to include content from the image component, you'd enter the following:

    Tip

    In general, to include a component from AEM, set:

    • Filter mode = include
    • Break Level = sentence