Network Access and Authentication Troubleshooting App
This Knowledge Base article describes how you can troubleshoot the network access and authentication between your mobile app and your servers.
To simplify the troubleshooting process, Appdome has created a dedicated iOS application called AuthVerifier. This debug app inspects your URL paths and assists in setting the correct network configuration, for example:
- Evaluate why certain URLs route through your VPN and corporate network while others don’t.
- Determine which URLs route through the configured enterprise tunnel
- Detect if the configured proxy actually routes connections to the backend host.
- Test various Appdome configurations (e.g. SSO, proxy, access, etc.)
Prerequisites for using AuthVerifier Debug App
- The AuthVerifier app (available upon request from the Appdome support team)
- Mobile iOS device connected to the app’s servers
- The servers URLs your app connects to during its run time
- Appdome account (for most use cases)
- Signing Credentials (for most use cases)
How to troubleshoot your network configuration with the AuthVerifier app
After you received the AuthVerifier App from the support team, depending on your use case, you’ll need to build it on Appdome’s platform according to your use case. For instance, to test your BlackBerry tunnel, you’ll want to build AuthVerifier with BlackBerry.
Once you downloaded the built app, install it in on your device. You can sideload the debug app using MacOS.
AuthVerifier App configuration options
Depending on your use case, and with the support team guidance, enable the relevant network connection method:
- Launch the app
- Enter the server URL that your app is connecting during its run time.
- Click on the requested browser type:
- Or, click on your network request method (optional)
- Optionally, click on Crawler to activate a crawler program on the entered URL (the program reads the URL page and other information, following the page links to other pages on the site until all pages have been read.)
- You can enable advanced options to the connection:
- Edit the request User-Agent header.
- Enable “Accept certs” to accept any certificate in your URL connection (e.g. privately signed, expired certificates).
- Enable “Handle 401” to identify the protected servers 401 or 30X response and navigate to the authentication URL.
- Toggle on URLProtocol
- If exist, enter your network proxy’s (<Domain>:<port>)
- To clear the app cache and cookies between test runs, Click on Clear Cache & Cookies.
What to Do With the Results?
Using the debug app is meant to assure that your network properly configured and to assist in understanding your network authentication process.
If you have a configured email client on your device, please email the app logs to Appdome support team.
Example Use Case – Verify Network connectivity to your resources protected by Azure
- Build AuthVerifier with Microsoft Azure AD SSO
- Install the debug app on an iOS device
- Launch the app
- Insert the URL of the protected resource you want to access in the address line.
- Tap UIWebView. If your Azure environment is set up and the Fusion Set was configured correctly, you should see a popup, leading to a login page:
- Complete the authentication (if possible)
- Regardless of the outcome (since this is a troubleshooting effort, we expect the something will not work as expected): Finally, click the Close button, and then click Send Logs
- Repeat the tests for other Browsers and other URLs you wish to test, as instructed by Appdome support.