Overview
When trying to authenticate a mobile application to a vault with a pre-shared key, you may get errors like
Application was launched with an unsupported M-Files URL
Notes
Consider migrating towards a more modern authentication approach such as OpenID Connect and OAuth 2.0. This is a more secure and modern approach that also allows central user management and features like MFA.
Keep in mind that the usage of a pre-shared key (PSK) is not supported in M-Files Cloud Vaults.
Solution
There are several avenues to review and things to try that may help:
- Ensure you have the latest app version.
- See if the error you get is this "File format is not supported" when delivering pre-shared-key to iOS device with Outlook for iOS app which is caused by using the Microsoft Outlook mobile app for iOS and whether the solution there helps.
- Tap and hold the file in the device storage and select "add to M-Files", or single tap it and select the M-Files app to open it with, this may vary with the device, instead of opening the link from the email or as an M-Files link.
- Ensure there isn't a special character in the key that is invalid for a URL (such as ampersand, question mark, etc.). If in doubt, consider using only symbols like a-z, A-Z, 0-9, and some characters like !, @, but definitely not &, ?, =, /.
- Open the file with the link and double check that the casing matches the actual key and the documentation (e.g., the "&key=" part should be lowercase).
- Double check that Anonymous Authentication is enabled on the web site hosting the M-Files Classic Web.
- Confirm that the actual file the device got has the correct content (for example, copy it to a computer from the device storage to see it as text). If it arrived as attachment in an email, antivirus or email servers may have altered, truncated or even removed the contents of the file.
