Troubleshooting SSO for Mobile Apps
This Knowledge Base Article describes how you can use an iOS app available on Appdome to validate the availability of the configured Single Sign-On connection for your mobile apps. After establishing the connecivity you can enhance your app with this Single Sign-On connection.
To assist users with the SSO troubleshooting process, Appdome has created an SSO Slim app that is available to all users. This app assists in troubleshooting your SSO configuration Built into mobile apps.
Prerequisites for Using SSO Slim iOS App
- The SSO Slim app (available upon request at firstname.lastname@example.org or via the chat window on the Appdome platform.)
- Mobile iOS device that can access your configured SSO through the network.
- The SSO login URL.
- Appdome account.
- Setup Mail on your iOS device to send JSON.
Guide to Troubleshooting Built App Connections to Hosts
After receiving the SSO Slim App from the Appdome Service Delivery team, you can Build it on Appdome with all of the features in your app’s use case. Here is a helpful article on Building apps with all desired features on Appdome end to end.
After Signing the Built app, Deploy it to an iOS device.
Using SSO Slim to Validate SSO Configuration Accessibility for Mobile Apps
Steps to using SSO Slim for iOS:
- Launch the app.
- Enter the app login URL.
- Click Settings in the app.
- This is where you can Clear Cache and Cookies and Change User Agent in the SSO Slim app.
- Click Start.
- This is where you can see if the app login URL is accessible to an app if it navigates to a login page.
- If it doesn’t navigate you can gather logs at this point to see more information.
- Click Set Hub to change the Hub URL that the app is connecting to.
Testing the app login:
- After clicking Start with your app login URL, type in an app account if the app login page navigates.
- Then click Sign In
- If you’d like to test with ADFS, click With ADFS
- If the app login completes successfully your app is ready to be Built with SSO
- You can click Stop at this point and you’ll gain a JSON that can be emailed.
Viewing the JSON from SSO Slim:
- The JSON from the email can be opened with Xcode, Text Wrangler, or another text viewing app.
- In the JSON you can see the results of the Sending request to this app login URL.
- With this Sending request, there will also be a GET request to the URL that you can view details on.
- In this JSON, you can also see details on the connection request to the app login URL with certificate results.
How Do I Learn More?
You can gather iOS device logs and view them to see more information on the SSO connectivity for your mobile app.
If you have any questions, please send them our way at email@example.com or via the chat window on the Appdome platform.