Form authentication allows you to index the HTML of your Sitecore items that can only be accessed while being authenticated. This method uses the credentials entered in the Coveo.SearchProvider.Custom.config, which are initially configured during the installation of the Coveo for Sitecore package, to log in.

Icon

The password is encrypted in the Coveo.SearchProvider.Custom.config file. To change the credentials, you should instead go to the Sitecore Control Panel, and under Coveo Search > Configuration, select Sitecore Credentials.

One of the use cases of this method is with the HtmlContentInBodyWithRequestsProcessor pipeline, which uses an Http Get request to fetch the content of a page at indexing time, and attempts a form authentication using the Post method when the page is secured.

To configure your processor to allow form authentication, follow these steps:

Open the Coveo.SearchProvider.Custom.config file. It is usually located under <Sitecore Instance>\Website\App_Config\Include\Coveo.

In the defaultIndexConfiguration node, add the following nodes:

Enter the following information in the nodes:

formsAuthLoginPage: the URL of your login page.

formsAuthUserControl: the id of the username text field.

formsAuthPasswordControl: the id of the password text field.

Icon

You can obtain the id of those fields by inspecting the logging page with your browser of choice.

formsAuthLoginCommand: Enter the name of the button and its value, with the following syntax: