HTTP status 401 Unauthorized error prevents KIC processing

Question / Problem: 

Kofax Import Connector (KIC) is not processing messages and an error is shown in the KCPlug-In Logs: 

ERROR [Thread=13] [MCMessageProvider] Cannot retreive message headers. EventID:38015
System.Net.WebException: The request failed with HTTP status 401: Unauthorized.

Why is this error encountered and how it the error resolved?

Answer / Solution: 

This issue can occur if there is a misconfiguration or missing entry for the KCPlugIn Process Password and does not occur if User Profiles is disabled. 

A sample of the full error is below: 

ERROR [Thread=13] [MCMessageProvider] Cannot retreive message headers. EventID:38015
System.Net.WebException: The request failed with HTTP status 401: Unauthorized.
at System.Web.Services.Protocols.SoapHttpClientProtocol.ReadResponse(SoapClientMessage message, WebResponse response, Stream responseStream, Boolean asyncCall)
at System.Web.Services.Protocols.SoapHttpClientProtocol.Invoke(String methodName, Object[] parameters)
at Kofax.KCS.ImportConnector.tws.tsl1Service.ReceiveMessage(ReceiveMessage ReceiveMessage1)
at Kofax.KCS.ImportConnector.MessageSource.MC.CommonMessageProvider.PollQueue(String queue, Int32& noMsgCount, Int32 queueCount)
at Kofax.KCS.ImportConnector.MessageSource.MC.MCMessageProvider.GetNextMessageHeaderLocal() 
 

Steps to Resolve: 

1. Access the KCPlugIn - Connection Configuration screen
2. Update the "Process Password" field
3. Save and Restart the KCPlug-In Service

Applies to: