vaikene.ee Git - evaf/blob - src/apps/PswGen/Generator/igenerator.h

   1 /**
   2  * @file PswGen/Generator/igenerator.h
   3  * @brief Interface for password generator modules
   4  * @author Enar Vaikene
   5  *
   6  * Copyright (c) 2011 Enar Vaikene
   7  *
   8  * This file is part of the eVaf C++ cross-platform application development framework.
   9  *
  10  * This file can be used under the terms of the GNU General Public License
  11  * version 3.0 as published by the Free Software Foundation and appearing in
  12  * the file LICENSE included in the packaging of this file. Please review the
  13  * the following information to ensure the GNU General Public License version
  14  * 3.0 requirements will be met: http://www.gnu.org/copyleft/gpl.html.
  15  *
  16  * Alternatively, this file may be used in accordance with the Commercial License
  17  * Agreement provided with the Software.
  18  */
  19
  20 #ifndef __PSWGEN_GENERATOR_IGENERATOR_H
  21 #  define __PSWGEN_GENERATOR_IGENERATOR_H
  22
  23 #include <QObject>
  24 #include <QString>
  25
  26 namespace eVaf {
  27 namespace PswGen {
  28
  29 /**
  30  * Password generator interface.
  31  *
  32  * This interface is used to generate strong passwords.
  33  */
  34 struct iGenerator
  35 {
  36
  37     /**
  38      * Flags for the password generator.
  39      */
  40     enum {
  41         ALPHANUMERIC            = 0x01              ///< Generated password contains only alphanumeric characters
  42     };
  43
  44     /**
  45      * Generates a strong password
  46      * @param name Name of the password
  47      * @param masterPassword Master password
  48      * @param length Length of the password (if zero, then uses the max length)
  49      * @param flags Flags for the generator
  50      * @return Generated password
  51      *
  52      * This function generates a strong password using the name and the master password string
  53      * as inputs. Calling this function with the same input always returns the same generated
  54      * password.
  55      *
  56      * The length of the password is specified with the length argument. However, the generated password
  57      * is never longer than possible with the particular cryptographic method.
  58      *
  59      * Optional flags can be used to fine-tune the generator.
  60      */
  61     virtual QString generatePassword(QString const & name, QString const & masterPassword, int length, uint flags = 0) const = 0;
  62
  63     /**
  64      * Returns the maximum length of generated passwords
  65      * @return Maximum length
  66      *
  67      * This function returns the maximum length of generated passwords that is possible with the cryptographic method
  68      * used by the module implementing this interface.
  69      */
  70     virtual int maxLength() const = 0;
  71
  72 };
  73
  74 } // namespace eVaf::PswGen
  75 } // namespace eVaf
  76
  77 Q_DECLARE_INTERFACE(eVaf::PswGen::iGenerator, "eVaf.PswGen.iGenerator/1.0")
  78
  79 #endif // igenerator.h