I can't log in from Mobile Device
Problem
I cannot log in to MobileWMS from a mobile device; an error message is shown.
Contents
Troubleshooting connection
Step 1 - Network
Make sure you fulfill the Firewall / Network requirements
If On-Prem, make sure the Service Tier is running ()
Step 2 - Test access using browser on mobile
Test the connection to the Web-Service by entering the URL in a browser on the mobile device
Use MobiControl to connect to the device
Exit the lockdown
Long-press the back button
Select Administrator,
Use the code 192837
Open a browser
Enter the Webservice endpoint URL (ihttp://myserver:7047/ServiceTierName/WS/CRONUS%20International%20Ltd./Codeunit/MobileDocumentService)
You should see a login screen
Log in
You see a WSDL like below = Success: ✅ Try logging on from mobile
You see an Error message = Failure: ❌ Go to the "Known Error Messages" section
Common Setup Issues
If mobile devices are using Android OS,ensure that NTLM is enabled on the NAV service-tier, see: NTLM Authentication - Support Knowledge Base - Tasklet Factory Docs
The NAV SOAP Service Tier network Port must be open for the mobile devices to accces (default port 7047 but verify exact number in NAV!) - also, remember that even though a port is not blocked on the NAV server itself, the mobile devices can be connected to a "less secure" WiFi, where almost everything is blocked by default, so ensure free line of communication from mobile device to NAV server.
Disable any Software firewall on the Server (Note: should only be done for test purposes - after connection has been established, only specific port(s) used by mobile devices should be opened in firewall!)
This includes Windows Firewall.
If you are using a server name in the soap URL (i.e. https://mynavserver:5588) then DNS name resolution from WiFI to NAV server network must be available and working. If not, you can try substituting the server name with the IP address of the server (i.e. https://192.168.1.1:5588)
Verify that the user is created in NAV both as a Mobile User and that the user is added to a Mobile Group (see installation guide https://university.taskletfactory.com for help on how to do this.)
The server is setup to use NTLMv2 which is not supported by the standard configuration of Mobile WMS, enable this on the start.cfg as follows:
Known error messages
Find the error message and solution below and make sure you try the troubleshooting steps bellow
See also: Error Messages if you are running Business Central.
The username, password and domain combination is invalid
Solutions
Missing NTLM authentication
Activate NTLM on the NAV Service Tier
Incorrect login credentials
Type the correct Username/Password
Consider whether Domain should be empty
The user "domain\user" could not be found as a valid mobile user
Solution
This user can access the web service. But is a Mobile User.
Insert the user on the Page "Mobile Users"
Include the user in a Mobile Group on the page "Mobile Groups"
"An error occurred while sending the request Error: NameResolutionFailure" / "No such host is known"
Solution
Network/Firewall issue
Check that the device is on the correct Wifi-network
Specific for Android 10/11 devices;
Solution
Private DNS is set to On/Automatic on the device, which conflicts with the network setup on your location.
Go to Settings > Network & Internet > Advanced > Private DNS > set to Off
Unable to connect to the remote server No connection could be made because the target machine actively refused it
Solution
Network Firewall issue
Internal Server Error: Details: Service "CompanyName/Codeunit/MobileDocumentService" was not found!
Solution
Your Business Central user does not have the correct Permission Set assigned
See installation guide User Permissions (3/10)
“Profile update failed. Error details: Forbidden”
Solution
Make sure you do not have a Microsoft Azure Application Gateway that blocks the traffic between the device and the endpoint.
Sorry, the current permissions prevented the action. (Codeunit, MOB WS Dispatcher Execute: )
Solution
You are missing Permission Sets for the user.
See User Permissions (3/10)Check the On-Prem license includes both these modules:
6181280 - Tasklet Factory Mobile Base
6181290 - Tasklet Factory Mobile WMS
“Connection timed out”
The server (URL shown) did not respond.
Solution
Go to Step 2.
Operation was canceled
Solution
The network might be restricted so it cannot reach authentication services from Entra/Azure
Open up all internet access for the network and see if it changes; after they can restrict back to the needed services. (Potentially microsoft.services)
Object reference not set to an instance of an object.
Solution
Close and re-open the Mobile WMS -app
You have an invalid setup of "Mobile Language" and "Mobile Messages" in NAV/BC
See Installation Guide
or
Create the Mobile Language: "ENU"
Select "Create message"
Assign the language to your "Mobile Users"
You are using AAD authentication and have an error in start.cfg - See AAD section
“Getting reference data failed. Server response: Microsoft.Dynamics.Nav.Runtime.NavXmlCData variable not initialized.”
Solutions
You have an invalid setup of "Mobile Groups"
See Installation Guide
Go to "Mobile Groups" and add your users
“An error occurred while sending the request Error: ConnrectFailure (Connection refused)”
Solution
The service tier is not running on the server
Start it
Go to the Connection Troubleshooting section
This page isn't working HTTP ERROR 401
Solution
You are connecting to a HTTPS endpoint
You are using a device running Android 4.4
Set "allowSelfSignedCertificates" in start.cfg
“Error when Deserializing the response”
Details:
Name cannot begin with the ' ' charactor hexadecimal value 0xA0. Line 1, position 6
Solution
You are using an older version of Mobile WMS where the object Codeunit 99999 ANSI <-> ASCII converter is faulty Make the following change
On my hosting platform "User Name" does not match "Windows User Name"
Solution
Some providers (i.e. 1ClickFactory) offers to change the "User Name" to match the "Full Name" rather than the "Windows User Name"
Currently Mobile WMS requires that the (NAV) "User Name" and "Windows User Name" fully match (excluding domain).
Have your provider change this.
User name should be
Windows User name
orThe full Email-address (Only 1ClickFactory)
Use "Full Name" for the actual persons name.
“Error: TrustFailure (A call to SSPI failed, see inner exception"
Solution
This means that the SSL certificate might have expired.
Check whether it has expired and If it has expired, you will need to generate a valid certificate, apply it, and restart the service tier.
Azure Active Directory (AAD) authentication
Bad Request
This could be the result of the Redirect URI being incorrectly set to "Web"
Set up Azure Active Directory (AAD) authentication
“The reason phrase must not contain new-line characters”
Solution
This is likely a misconfiguration with Azure Active Directory authentication
Have you created a "Web"-registration instead of a "Mobile"-regstration?
“The reply URI specified in the request does not match the reply URIs configured for the application”
or
”No reply address is registered for the application.”
Message: AADSTS50011 or AADSTS500113
Solution
This is likely a misconfiguration with Azure Active Directory authentication
Make sure the Redirect URI points to: https://businesscentral.dynamics.com/
The application '...' (Mobile WMS) has not been authorized in the tenant
Message: AADSTS90099
Solution
This is likely a misconfiguration with Azure Active Directory authentication
Is the "API permissions" configured correctly?
“Chain Validation Failed” When Trying to Login
Getting Error When Trying to Login
Problem:
Getting the error 'Chain Validation Failed' when trying to login.
Solution:
Make sure the date and time on the device is setup correctly.
Mobile WMS keeps stopping
The Mobile WMS Version is too old and does not support Azure AD.
Solution
Upgrade Mobile WMS (minimum 1.5.0)
“Object reference not set to an instance of an object”
Solution
There is a format problem in Start.cfg
The <endpoint> element should encapsulate the <azureConfiguration> element.
“No such host is known”
Solution
Validate the Web-service is accessible from mobile browser
Go to Step 2.
“Internal server error” / “The username, password and domain combination is invalid”
If you are using Device Licenses for the users, this is most likely a missing setup in the Microsoft 365 Admin Center.
See https://docs.microsoft.com/en-us/dynamics365/business-central/dev-itpro/deployment/licensing
“Hostname nor servername provided, or not known”
Validate the Web-service is accessible from mobile browser
Go to Step 2