From ba0295305fe2a35212847bfc0a3002b18a9df076 Mon Sep 17 00:00:00 2001 From: Christoph Wurst Date: Fri, 13 Aug 2021 10:39:55 +0200 Subject: [PATCH] Document client login flow login name mismatch Signed-off-by: Christoph Wurst --- developer_manual/client_apis/LoginFlow/index.rst | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/developer_manual/client_apis/LoginFlow/index.rst b/developer_manual/client_apis/LoginFlow/index.rst index 0e429a8e1..8cf1dde68 100644 --- a/developer_manual/client_apis/LoginFlow/index.rst +++ b/developer_manual/client_apis/LoginFlow/index.rst @@ -155,3 +155,12 @@ This will return a 404 until authentication is done. Once a 200 is returned it i Use the server and the provided credentials to connect. Note that the 200 will only be returned once. + + +Troubleshooting +--------------- + +Login name vs. email login +^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Nextcloud allows authentication with user's *login name*, which can be their UID, an email address and similar. The identifier used for the session in which the user generates the app password will be stored into the database record of the generated app password. Therefore the identifier used in the web session that authorizes a client must match the identifier used in the connecting client.