src/password.h

   1 /*
   2  * Claws Mail -- a GTK based, lightweight, and fast e-mail client
   3  * Copyright (C) 2016 Claws Mail team
   4  *
   5  * This program is free software; you can redistribute it and/or modify
   6  * it under the terms of the GNU General Public License as published by
   7  * the Free Software Foundation; either version 3 of the License, or
   8  * (at your option) any later version.
   9  *
  10  * This program is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13  * GNU General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU General Public License
  16  * along with this program. If not, see <http://www.gnu.org/licenses/>.
  17  *
  18  */
  19
  20 #ifndef __PASSWORD_H
  21 #define __PASSWORD_H
  22
  23 #include <glib.h>
  24
  25 #ifndef PASSWORD_CRYPTO_OLD
  26 /* Returns a pointer to primary passphrase, asking the user
  27  * if necessary. Do not free the return value. */
  28 const gchar *primary_passphrase();
  29
  30 /* Returns TRUE if there is a primary passphrase set in preferences. */
  31 gboolean primary_passphrase_is_set();
  32 /* Returns TRUE if input contains correct primary passphrase, as set
  33  * in preferences. */
  34 gboolean primary_passphrase_is_correct(const gchar *input);
  35 /* Returns TRUE if primary passphrase is entered (unlocked). */
  36 gboolean primary_passphrase_is_entered();
  37 /* Removes (locks) primary passphrase, if it was entered previously
  38  * in current session. */
  39 void primary_passphrase_forget();
  40
  41 /* Changes primary passphrase. Also triggers reencryption of all stored
  42  * passwords using the new primary passphrase.
  43  * oldp - old primary passphrase; if NULL, it will be retrieved using
  44  *        primary_passphrase()
  45  * newp - new primary passphrase */
  46 void primary_passphrase_change(const gchar *oldp, const gchar *newp);
  47 #endif
  48
  49 /* Wrapper around the old, DES-CBC-broken implementation which
  50  * returns a newly allocated string for the encrypt/decrypt result.
  51  * This is for compatibility with with the rest of password-related
  52  * functions.*/
  53 gchar *password_encrypt_old(const gchar *password);
  54 gchar *password_decrypt_old(const gchar *password);
  55
  56 #ifdef PASSWORD_CRYPTO_GNUTLS
  57 /* GNUTLS implementation */
  58 gchar *password_encrypt_gnutls(const gchar *password,
  59                 const gchar *encryption_passphrase);
  60 gchar *password_decrypt_gnutls(const gchar *password,
  61                 const gchar *decryption_passphrase);
  62 #define password_encrypt_real(n, m) password_encrypt_gnutls(n, m)
  63 #define password_decrypt_real(n, m) password_decrypt_gnutls(n, m)
  64 #endif
  65
  66 /* Wrapper function that will apply best encryption available,
  67  * and return a string ready to be saved as-is in preferences. */
  68 gchar *password_encrypt(const gchar *password,
  69                 const gchar *encryption_passphrase);
  70
  71 /* This is a wrapper function that looks at the whole string from
  72  * prefs (e.g. including the leading '!' for old implementation),
  73  * and tries to do the smart thing. */
  74 gchar *password_decrypt(const gchar *password,
  75                 const gchar *decryption_passphrase);
  76
  77 #endif /* __PASSWORD_H */