connaccount.c File Reference

Connection Credentials. More...

#include "config.h"
#include <stdbool.h>
#include <stdio.h>
#include <string.h>
#include <sys/types.h>
#include "mutt/lib.h"
#include "core/lib.h"
#include "gui/lib.h"
#include "connaccount.h"
#include "editor/lib.h"
#include "history/lib.h"
#include "accountcmd.h"
#include "globals.h"

Include dependency graph for connaccount.c:

Go to the source code of this file.

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

Detailed Description

Connection Credentials.

Authors

• Pietro Cerutti
• Richard Russon
• Ryan Kavanagh

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.c.

Function Documentation

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 51 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_NONE)
  {
    /* The external command might interact with the screen */
    if (OptGui)
      mutt_need_hard_redraw();
    return 0;
  }
  else if (!OptGui)
  {
    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, NeoMutt->username, sizeof(cac->user));
 
    struct Buffer *buf = buf_pool_get();
    const int rc = mw_get_field(prompt, buf, MUTT_COMP_UNBUFFERED, HC_OTHER, 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_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 100 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_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 130 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_NONE)
  {
    /* The external command might interact with the screen */
    if (OptGui)
      mutt_need_hard_redraw();
    return 0;
  }
  else if (!OptGui)
  {
    return -1;
  }
  else
  {
    char prompt[512] = { 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 = mw_get_field(prompt, buf, MUTT_COMP_PASS | MUTT_COMP_UNBUFFERED,
                                HC_OTHER, 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_unsetpass()

void mutt_account_unsetpass

(

struct ConnAccount *

cac

)

Unset ConnAccount's password.

Parameters

cac	ConnAccount to modify

Definition at line 177 of file connaccount.c.

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

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 195 of file connaccount.c.

{
  if (!cac || !cac->get_field)
    return NULL;
 
  /* The oauthbearer token includes the login */
  if (mutt_account_getlogin(cac) != 0)
    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, NeoMutt->env);
  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_NONE);
  mutt_file_fclose(&fp);
  filter_wait(pid);
 
  /* The refresh cmd in some cases will invoke gpg to decrypt a token */
  if (OptGui)
    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"), (long) 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);
 
  // Clamp snprintf return to actual buffer size to prevent over-read
  if (oalen >= (int) sizeof(oauthbearer))
    oalen = sizeof(oauthbearer) - 1;
 
  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, char);
  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: