From 4e924cc7aeb4edceb84d43d97f0542539f614cdd Mon Sep 17 00:00:00 2001 From: Eduardo Chappa Date: Sun, 24 Oct 2021 13:59:42 -0600 Subject: * Improvements to Alpine help for xoauth2 and corrections to the menu for authorization using the device method. --- pith/pine.hlp | 50 ++++++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 44 insertions(+), 6 deletions(-) (limited to 'pith') diff --git a/pith/pine.hlp b/pith/pine.hlp index 53f4864c..48db2823 100644 --- a/pith/pine.hlp +++ b/pith/pine.hlp @@ -140,7 +140,7 @@ with help text for the config screen and the composer that didn't have any reasonable place to be called from. Dummy change to get revision in pine.hlp ============= h_revision ================= -Alpine Commit 607 2021-10-23 21:25:07 +Alpine Commit 608 2021-10-24 13:59:38 ============= h_news ================= @@ -2282,18 +2282,56 @@ You are trying to connect to a server that uses the XOAUTH2 method of authentication.

-In order to set this up, you need to authenticate in the target server -and authorize Alpine to access your email account. +In order to complete this process use a browser in the same computer +that you are using Alpine to open the given URL.

-After you have authorized Alpine, the server will generate an -"access code." In order to use this code, press 'C' -and copy and paste this code back into Alpine. +You will be sent to authenticate and later to authorize Alpine access to +your email. Once you have completed the authorization process you will get +a code. Input this code into Alpine by pressing 'C'. If you do not see a +code, but see an error message in your browser, copy and paste the URL of +the error page and paste into alpine after pressing the 'C' key.

After you have input the code, Alpine will conclude logging you into your account. +

+If your version of Alpine was compiled to save passwords, then Alpine will save +the refresh and access tokens securely, otherwise you will have to repeat this +process every time you login to this server. + +

+<End of setting up XOAUTH2 Authentication help> + + +====== h_oauth2_start_device ====== + + +Setting up XOAUTH2 Authentication Using the Device Flow + + +

Setting up XOAUTH2 Authentication Using the Device Flow

+ +You are trying to connect to a server that uses the XOAUTH2 method of +authentication. + +

+In order to complete this process use a browser in the same computer +that you are using Alpine to open the given URL and enter the code that you +were given by Alpine in that screen. + +

+You will be sent to authenticate and later to authorize Alpine access to +your email. Once you have completed the authorization process Alpine will +get the refresh and access tokens from the service servers and the authentication +process will be completed by Alpine. + +

+If your version of Alpine was compiled to save passwords, then Alpine will save +the refresh and access tokens securely, otherwise you will have to repeat this +process every time you login to this server. +

<End of setting up XOAUTH2 Authentication help> -- cgit v1.2.3-70-g09d2