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  account,  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@example.com, using a web browser.
       Then, enter a mhlogin command such as:

              mhlogin -user user@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-RC3                                      2016-10-10                                       MHLOGIN(1mh)