mhlogin(1mh) - phpMan

MHLOGIN(1mh)                                                                         MHLOGIN(1mh)

NAME
       mhlogin - nmh login to external (OAuth) services

SYNOPSIS
       mhlogin [-help] [-version] [-user username] [-saslmech mechanism] [-authservice service]
            [-browser command] [-snoop]

DESCRIPTION
       mhlogin currently only supports OAuth for Gmail.  Run  mhlogin  -user  username  -saslmech
       xoauth2 -authservice gmail and load the printed URL in your browser.  Login to a Gmail ac-
       count, grant authorization, and copy and paste the code into the mhlogin prompt.  Be  sure
       to use the same account with the -user switch to send.  See the EXAMPLES section below for
       an example.

       The -browser switch causes mhlogin to load the URL directly into a  new  browser  session.
       The command argument must include the browser invocation name, and can include any browser
       arguments in the -browser argument string, e.g., 'google-chrome --new-window'.

       The -snoop switch can be used to view the HTTP transaction.

       All parameters configuring the service may be overridden by profile components,  and  even
       though  only  Gmail is supported out of the box, the user can define new services entirely
       in the profile.  Profile components are prefixed by oauth-service-,  for  example,  oauth-
       gmail-credential-file  which  specifies  where  mhlogin should write credentials and where
       send should read them.

EXAMPLES
   Gmail
       First, login to the Gmail account that you want to use, e.g, user AT example.com, using a web
       browser.  Then, enter a mhlogin command such as:

              mhlogin -user user AT example.com -saslmech xoauth2 -authservice gmail -browser 'google-chrome --new-window'

       The  username  should  be  a complete email address.  Respond to the prompt in the browser
       window, then copy and paste the authorization code in response to the mhlogin prompt.

PROFILE COMPONENTS
       oauth-gmail-credential-file: oauth-gmail
       oauth-gmail-client_id:       nmh project client_id
       oauth-gmail-client_secret:   nmh project client_secret
       oauth-gmail-auth_endpoint:   https://accounts.google.com/o/oauth2/auth
       oauth-gmail-redirect_uri:    urn:ietf:wg:oauth:2.0:oob
       oauth-gmail-token_endpoint:  https://accounts.google.com/o/oauth2/token
       oauth-gmail-scope:           https://mail.google.com/

SEE ALSO
       send(1)

DEFAULTS
       `-saslmech' xoauth2

nmh-1.7.1                                   2016-10-10                               MHLOGIN(1mh)

Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache
Under GNU General Public License
2025-12-23 16:21 @216.73.216.1 CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)