connaccount.h File Reference

Connection Credentials. More...

#include <stdbool.h>
#include <stdint.h>

Include dependency graph for connaccount.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	ConnAccount
	Login details for a remote server. More...

Macros
#define	MUTT_ACCT_NO_FLAGS   0
	No flags are set. More...
#define	MUTT_ACCT_PORT   (1 << 0)
	Port field has been set. More...
#define	MUTT_ACCT_USER   (1 << 1)
	User field has been set. More...
#define	MUTT_ACCT_LOGIN   (1 << 2)
	Login field has been set. More...
#define	MUTT_ACCT_PASS   (1 << 3)
	Password field has been set. More...
#define	MUTT_ACCT_SSL   (1 << 4)
	Account uses SSL/TLS. More...

Typedefs
typedef uint8_t	MuttAccountFlags
	Flags, Which ConnAccount fields are initialised, e.g. MUTT_ACCT_PORT. More...

Enumerations
enum	ConnAccountField {   MUTT_CA_HOST = 1 , MUTT_CA_LOGIN , MUTT_CA_USER , MUTT_CA_PASS ,   MUTT_CA_OAUTH_CMD }
	Login credentials. More...

Functions
int	mutt_account_getlogin (struct ConnAccount *account)
	Retrieve login info into ConnAccount, if necessary. More...
char *	mutt_account_getoauthbearer (struct ConnAccount *account, bool xoauth2)
	Get an OAUTHBEARER/XOAUTH2 token. More...
int	mutt_account_getpass (struct ConnAccount *account)
	Fetch password into ConnAccount, if necessary. More...
int	mutt_account_getuser (struct ConnAccount *account)
	Retrieve username into ConnAccount, if necessary. More...
void	mutt_account_unsetpass (struct ConnAccount *account)
	Unset ConnAccount's password. More...

Detailed Description

Connection Credentials.

Authors

• Brendan Cully

Copyright

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Definition in file connaccount.h.

Macro Definition Documentation

MUTT_ACCT_NO_FLAGS

#define MUTT_ACCT_NO_FLAGS   0

No flags are set.

Definition at line 42 of file connaccount.h.

MUTT_ACCT_PORT

#define MUTT_ACCT_PORT   (1 << 0)

Port field has been set.

Definition at line 43 of file connaccount.h.

MUTT_ACCT_USER

#define MUTT_ACCT_USER   (1 << 1)

User field has been set.

Definition at line 44 of file connaccount.h.

MUTT_ACCT_LOGIN

#define MUTT_ACCT_LOGIN   (1 << 2)

Login field has been set.

Definition at line 45 of file connaccount.h.

MUTT_ACCT_PASS

#define MUTT_ACCT_PASS   (1 << 3)

Password field has been set.

Definition at line 46 of file connaccount.h.

MUTT_ACCT_SSL

#define MUTT_ACCT_SSL   (1 << 4)

Account uses SSL/TLS.

Definition at line 47 of file connaccount.h.

Typedef Documentation

MuttAccountFlags

typedef uint8_t MuttAccountFlags

Flags, Which ConnAccount fields are initialised, e.g. MUTT_ACCT_PORT.

Definition at line 41 of file connaccount.h.

Enumeration Type Documentation

ConnAccountField

enum ConnAccountField

Login credentials.

Enumerator
MUTT_CA_HOST	Server name.
MUTT_CA_LOGIN	Login name.
MUTT_CA_USER	User name.
MUTT_CA_PASS	Password.
MUTT_CA_OAUTH_CMD	OAuth refresh command.

Definition at line 32 of file connaccount.h.

{
  MUTT_CA_HOST = 1,  
  MUTT_CA_LOGIN,     
  MUTT_CA_USER,      
  MUTT_CA_PASS,      
  MUTT_CA_OAUTH_CMD, 
};

Function Documentation

mutt_account_getlogin()

int mutt_account_getlogin

(

struct ConnAccount *

cac

)

Retrieve login info into ConnAccount, if necessary.

Parameters

cac	ConnAccount to fill

Return values

0	Success
-1	Failure

Definition at line 98 of file connaccount.c.

{
  if (cac->flags & MUTT_ACCT_LOGIN)
    return 0;
  if (!cac->get_field)
    return -1;
 
  const char *login = cac->get_field(MUTT_CA_LOGIN, cac->gf_data);
  if (!login && (mutt_account_getuser(cac) == 0))
  {
    login = cac->user;
  }
 
  if (!login)
  {
    mutt_debug(LL_DEBUG1, "Couldn't get user info\n");
    return -1;
  }
 
  mutt_str_copy(cac->login, login, sizeof(cac->login));
  cac->flags |= MUTT_ACCT_LOGIN;
  return 0;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_account_getoauthbearer()

char * mutt_account_getoauthbearer	(	struct ConnAccount *	cac,
		bool	xoauth2
	)

Get an OAUTHBEARER/XOAUTH2 token.

Parameters

cac	Account to use
xoauth2	Generate a deprecated XOAUTH2 token

Return values

ptr	OAuth token
NULL	Error

Run an external command to generate the oauth refresh token for an account, then create and encode the OAUTHBEARER token based on RFC7628.

Note

Caller should free the token

Definition at line 193 of file connaccount.c.

{
  if (!cac || !cac->get_field)
    return NULL;
 
  /* The oauthbearer token includes the login */
  if (mutt_account_getlogin(cac))
    return NULL;
 
  const char *cmd = cac->get_field(MUTT_CA_OAUTH_CMD, cac->gf_data);
  if (!cmd)
  {
    /* L10N: You will see this error message if (1) you have "oauthbearer" in
       one of your $*_authenticators and (2) you do not have the corresponding
       $*_oauth_refresh_command defined. So the message does not mean "None of
       your $*_oauth_refresh_command's are defined." */
    mutt_error(_("No OAUTH refresh command defined"));
    return NULL;
  }
 
  FILE *fp = NULL;
  pid_t pid = filter_create(cmd, NULL, &fp, NULL);
  if (pid < 0)
  {
    mutt_perror(_("Unable to run refresh command"));
    return NULL;
  }
 
  size_t token_size = 0;
  char *token = mutt_file_read_line(NULL, &token_size, fp, NULL, MUTT_RL_NO_FLAGS);
  mutt_file_fclose(&fp);
  filter_wait(pid);
 
  /* The refresh cmd in some cases will invoke gpg to decrypt a token */
  if (!OptNoCurses)
    mutt_need_hard_redraw();
 
  if (!token || (*token == '\0'))
  {
    mutt_error(_("Command returned empty string"));
    FREE(&token);
    return NULL;
  }
 
  if ((!xoauth2 && (token_size > 512)) || (xoauth2 && (token_size > 4096)))
  {
    mutt_error(_("OAUTH token is too big: %ld"), token_size);
    FREE(&token);
    return NULL;
  }
 
  /* 4500 is chosen to allow for both a token that is 4096-long plus a
   * username that can be up to 320-long. */
  char oauthbearer[4500] = { 0 };
  int oalen = 0;
  if (xoauth2)
  {
    oalen = snprintf(oauthbearer, sizeof(oauthbearer),
                     "user=%s\001auth=Bearer %s\001\001", cac->login, token);
  }
  else
  {
    oalen = snprintf(oauthbearer, sizeof(oauthbearer),
                     "n,a=%s,\001host=%s\001port=%d\001auth=Bearer %s\001\001",
                     cac->login, cac->host, cac->port, token);
  }
  FREE(&token);
 
  size_t encoded_len = oalen * 4 / 3 + 10;
  assert(encoded_len < 6010); // Assure LGTM that we won't overflow
 
  char *encoded_token = mutt_mem_malloc(encoded_len);
  mutt_b64_encode(oauthbearer, oalen, encoded_token, encoded_len);
 
  return encoded_token;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_account_getpass()

int mutt_account_getpass

(

struct ConnAccount *

cac

)

Fetch password into ConnAccount, if necessary.

Parameters

cac	ConnAccount to fill

Return values

0	Success
-1	Failure

Definition at line 128 of file connaccount.c.

{
  if (cac->flags & MUTT_ACCT_PASS)
    return 0;
  if (!cac->get_field)
    return -1;
 
  const char *pass = cac->get_field(MUTT_CA_PASS, cac->gf_data);
  if (pass)
  {
    mutt_str_copy(cac->pass, pass, sizeof(cac->pass));
  }
  else if (mutt_account_call_external_cmd(cac) != MUTT_ACCT_NO_FLAGS)
  {
    /* The external command might interact with the screen */
    if (!OptNoCurses)
      mutt_need_hard_redraw();
    return 0;
  }
  else if (OptNoCurses)
  {
    return -1;
  }
  else
  {
    char prompt[256] = { 0 };
    snprintf(prompt, sizeof(prompt), _("Password for %s@%s: "),
             (cac->flags & MUTT_ACCT_LOGIN) ? cac->login : cac->user, cac->host);
    cac->pass[0] = '\0';
 
    struct Buffer *buf = buf_pool_get();
    const int rc = buf_get_field(prompt, buf, MUTT_COMP_PASS | MUTT_COMP_UNBUFFERED,
                                 false, NULL, NULL, NULL);
    mutt_str_copy(cac->pass, buf_string(buf), sizeof(cac->pass));
    buf_pool_release(&buf);
    if (rc != 0)
      return -1;
  }
 
  cac->flags |= MUTT_ACCT_PASS;
  return 0;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_account_getuser()

int mutt_account_getuser

(

struct ConnAccount *

cac

)

Retrieve username into ConnAccount, if necessary.

Parameters

cac	ConnAccount to fill

Return values

0	Success
-1	Failure

Definition at line 49 of file connaccount.c.

{
  if (cac->flags & MUTT_ACCT_USER)
    return 0;
  if (!cac->get_field)
    return -1;
 
  const char *user = cac->get_field(MUTT_CA_USER, cac->gf_data);
  if (user)
  {
    mutt_str_copy(cac->user, user, sizeof(cac->user));
  }
  else if (mutt_account_call_external_cmd(cac) != MUTT_ACCT_NO_FLAGS)
  {
    /* The external command might interact with the screen */
    if (!OptNoCurses)
      mutt_need_hard_redraw();
    return 0;
  }
  else if (OptNoCurses)
  {
    return -1;
  }
  else
  {
    /* prompt (defaults to unix username), copy into cac->user */
    char prompt[256] = { 0 };
    /* L10N: Example: Username at myhost.com */
    snprintf(prompt, sizeof(prompt), _("Username at %s: "), cac->host);
    mutt_str_copy(cac->user, Username, sizeof(cac->user));
 
    struct Buffer *buf = buf_pool_get();
    const int rc = buf_get_field(prompt, buf, MUTT_COMP_UNBUFFERED, false, NULL, NULL, NULL);
    mutt_str_copy(cac->user, buf_string(buf), sizeof(cac->user));
    buf_pool_release(&buf);
    if (rc != 0)
      return -1;
  }
 
  cac->flags |= MUTT_ACCT_USER;
  return 0;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_account_unsetpass()

void mutt_account_unsetpass

(

struct ConnAccount *

cac

)

Unset ConnAccount's password.

Parameters

cac	ConnAccount to modify

Definition at line 175 of file connaccount.c.

{
  cac->flags &= ~MUTT_ACCT_PASS;
  memset(cac->pass, 0, sizeof(cac->pass));
}

Here is the caller graph for this function: