matrix-org / matrix-org/matrix-spec
UIA fallback completion mechanism does not work well on mobile devices
Nobody has claimed this yet.
- Dominant language
- HTML
- Stars
- 330
- Forks
- 150
- Avg merge
- 2h 21m
- Merged PRs (30d)
- 3
Description
https://matrix.org/docs/spec/client_server/r0.6.1#fallback describes a mechanism by which an application can be notified when a user-interactive auth step completes:
This allows the client to either arrange for the global function
onAuthDoneto be defined in an embedded browser, or to use the HTML5 cross-document messaging API, to receive a notification that the authentication stage has been completed.
However, modern best-practice discourages the use of embedded browsers (ie, webviews) and indeed some identity providers refuse any requests made from such browsers. For example Google says:
This user-agent is not permitted to make an OAuth authorization request to Google as it is classified as an embedded user-agent (also known as a web-view). Per our policy, only browsers are permitted to make authorization requests to Google.
This means that mobile apps have to use a regular browser to complete the auth step, so have no way of knowing when the step completes, and the user ends up stuck in a "you can go back your app now" page.
Note that "UIA fallback" is used for all user-interactive authentication via SSO providers, which is to say that anybody who logged in via SSO and performs an action which requires their identity to be reconfirmed will hit this problem.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reading the UIA fallback section in the linked Matrix client-server specification and the described embedded-browser and cross-document messaging behavior. Compare it with the mobile browser and SSO constraints described here. Done would require an agreed mechanism that lets mobile clients detect completion without relying on embedded browsers.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- html
- Domain
- authentication, documentation
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 25/100