Skip to content

Commit c773274

Browse files
sunkuprfc2822
andauthored
Add recommendation on using OAuth and app passwords (#49)
* Add recommendation on using OAuth and app passwords * Update text --------- Co-authored-by: Ricki Hirner <[email protected]>
1 parent 0f269f2 commit c773274

File tree

2 files changed

+10
-1
lines changed

2 files changed

+10
-1
lines changed

introduction.rst

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,13 +36,20 @@ How to start using DAVx⁵ on your Android device:
3636
#. Open DAVx⁵.
3737
#. Follow the instructions of the start screen (permissions, battery saving etc.).
3838
#. Tap on "⊕ Add account" to add a new account.
39-
#. Enter your base URL / email address and login credentials.
39+
#. Login using provider-specific login (preferred if supported) or base URL / email address and login credentials.
4040
You can get the base URL from your service provider and/or our `list of tested services <https://www.davx5.com/tested-with/>`_.
4141
#. Finish the steps to add the account.
4242
#. Select the address books and calendars/task lists you want to synchronize so that the respective switches are enabled.
4343
#. Force sync ("🗘 Synchronize") if you want the data to be available immediately.
4444
#. Access your address books, events and tasks using your favorite apps (Contacts, Calendar, OpenTasks, …).
4545

46+
If there's no provider-specific login for your provider, we recommend using an :abbr:`app password
47+
(server-generated random password that is only intended for a specific client and that can be used as a password substitute)`
48+
for DAVx⁵ (if supported by the server). To do so, open the Web interface of your service, go to authentication settings and
49+
look for something like *Create app password*. You can then use the app password instead of your account password in DAVx⁵.
50+
**Using a dedicated app password for each app — like DAVx⁵ — keeps your account password private and allows you to
51+
revoke access at any time.**
52+
4653
When you create a contact/event, select the desired DAVx⁵ account as storage location.
4754
Local contacts/events will stay on your phone and not be synchronized. If you're using DAVx⁵ the first time, you may
4855
want to :faq:`transfer your local contacts to the CardDAV server <existing-contacts-are-not-synced>`.

settings.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -86,6 +86,8 @@ Authentication
8686
User name / password / client certificate
8787
You can change the credentials used for synchronization at any time here (for instance, when your password has been changed on the server).
8888

89+
This option is not available when the account uses OAuth for authentication (provider-specific login).
90+
8991
CalDAV
9092
------
9193

0 commit comments

Comments
 (0)