Skip to main content

Connecting to a TotalAgility Server

Article # 3036902 - Page views: 228


How to configure Kofax Mobile Capture App to connect to a TotalAgility Server



Before the Kofax Mobile Capture App can connect to a TotalAgility server, it must be provided with the server and login information via the Settings page.



To configure the KMC App to connect to a TotalAgility Server:

  1. Set the Kofax Server toggle to Off
  2. In the Hostname field, enter the hostname, IP Address, or Fully Qualified Domain Name of the KTA server

    If connecting via HTTPS, the value entered into the Hostname field must match the Common Name (CN) value in the server SSL certificate's subject line.

  3. In the Server Type field, select Kofax TotalAgility 
  4. Set the SSL toggle to On if the TotalAgility server requires an HTTPS connection

    The Kofax Mobile Capture App requires the use of a Certificate Authority-signed SSL Certificate on the server.  If the KTA server is using a Self-Signed SSL certificate, the KMC App will reject the certificate and refuse to connect via HTTPS.

  5. Do not change the Port field value unless the TotalAgility server requires a connection on a non-standard port.
  6. Leave the URL field blank unless the TotalAgility server requires a non-standard URL path.
  7. Leave the Anonymous toggle set to Off unless instructed otherwise by the TotalAgility administrator
  8. In the Domain field, enter the domain portion of the UserID (if using an ActiveDirectory UserID)
  9. In the Username field, enter the Username portion of the UserID
  10. In the Password field, enter the password associated with the user account
  11. In the Email address field, enter the email address associated with the user account
  12. Click Login

If the login fails with the error "Check your username and password" then log in to KTA designer with admin credentials, so you can create resources.

In the Resources you should see Device users. The users that you are using should be under the device users category. Also try to give all permissions to the user trying to logon like Designer , Device and so on.

The created user should have enough permissions to logon through Mobile and to login Designer. So add all required users to Device and Designer category.


Level of Complexity 



Applies to  

Product Version Build Environment Hardware
Kofax Mobile Capture App ALL ALL ALL N/A
Kofax TotalAgility 7.9





Article # 3036902
  • Was this article helpful?