matrix-org / matrix-org/matrix-spec

UIA fallback completion mechanism does not work well on mobile devices

Open
#758 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

A-social login
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 onAuthDone to 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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.