---

mediumrdhbase.h

Go to the documentation of this file.

/***************************************************************************
 $RCSfile: mediumrdhbase.h,v $
                             -------------------
    cvs         : $Id: mediumrdhbase.h,v 1.17 2003/05/16 15:40:57 aquamaniac Exp $
    begin       : Tue Aug 27 2002
    copyright   : (C) 2002 by Martin Preuss
    email       : openhbci@aquamaniac.de

 ***************************************************************************
 *                                                                         *
 *   This library is free software; you can redistribute it and/or         *
 *   modify it under the terms of the GNU Lesser General Public            *
 *   License as published by the Free Software Foundation; either          *
 *   version 2.1 of the License, or (at your option) any later version.    *
 *                                                                         *
 *   This library 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     *
 *   Lesser General Public License for more details.                       *
 *                                                                         *
 *   You should have received a copy of the GNU Lesser General Public      *
 *   License along with this library; if not, write to the Free Software   *
 *   Foundation, Inc., 59 Temple Place, Suite 330, Boston,                 *
 *   MA  02111-1307  USA                                                   *
 *                                                                         *
 ***************************************************************************/

#ifndef MEDIUMRDHBASE_H
#define MEDIUMRDHBASE_H

#ifdef __cplusplus
#include <string>
#endif /* __cplusplus */
#include <openhbci/medium.h>
#ifdef __cplusplus
#include <openhbci/cryptkey.h>
#include <openhbci/rsakey.h>

namespace HBCI {

class DLLIMPORT MediumRDHBase: public Medium {
public:
    MediumRDHBase(const Hbci *hbci);

    virtual ~MediumRDHBase();

    virtual Error selectContext(int country,
                                const string &instcode,
                                const string &userid)=0;

    virtual Error createMedium(int country,
                               const string &instcode,
                               const string &userid,
                               const string &pin="")=0;

    virtual Error mountMedium(const string &pin="")=0;

    virtual Error unmountMedium(const string &pin="")=0;

    virtual Error changePIN();

    virtual Error changeContext(int context, int country=0,
                                const string instcode="",
                                const string userid="",
                                const string custid="",
                                const string server="");

    virtual unsigned int nextSEQ()=0;

    virtual void resetSEQ()=0;

    virtual void setSEQ(int seq)=0;

    virtual bool isMounted()=0;

    virtual string mediumId() const =0;

    virtual int securityMode() const { return HBCI_SECURITY_RDH;};

    virtual const string& mediumName() const =0;

    virtual MediumType mediumType() const =0;

    virtual int signKeyNumber() const =0;

    virtual int signKeyVersion() const =0;

    virtual int cryptKeyNumber() const =0;

    virtual int cryptKeyVersion() const =0;

    virtual const string &cryptKeyOwner() const =0;

    virtual Error getContext(int num,
                             int &countrycode,
                             string &instcode,
                             string &userid,
                             string &server) const =0;
    virtual string createMessageKey() const =0;

    virtual string encryptKey(const string &srckey) =0;

    virtual string decryptKey(const string &srckey) =0;

    virtual Error verify(const string &data, const string &signature) =0;

    virtual string sign(const string &data) =0;

    virtual Error createUserKeys(bool activate=true)=0;

    virtual Error activateKeys()=0;

    virtual Pointer<RSAKey> getTempSignKey()=0;

    virtual Pointer<RSAKey> getTempCryptKey()=0;

    virtual Error setInstituteCryptKey(Pointer<RSAKey> cryptkey) =0;

    virtual Error setInstituteSignKey(Pointer<RSAKey> signkey) =0;

    virtual void setSystemId(const string &newid) =0;
    virtual bool hasInstSignKey() const =0;

    virtual Pointer<RSAKey> userPubCryptKey() const =0;

    virtual Pointer<RSAKey> userPubSignKey() const =0;
    virtual string getInstIniLetterModulus(bool crypt=false) const =0;

    virtual string getInstIniLetterExponent(bool crypt=false) const =0;

    virtual string getInstIniLetterHash(bool crypt=false) const =0;

    virtual int getInstKeyNumber(bool usecrypt = false) const =0;
    virtual int getInstKeyVersion(bool usecrypt = false) const =0;

    virtual string getUserIniLetterModulus() const =0;

    virtual string getUserIniLetterExponent() const =0;

    virtual string getUserIniLetterHash() const =0;

    virtual int getUserKeyNumber() const =0;

    virtual int getUserKeyVersion() const =0;
    const static unsigned int minPinSize;
};

} /* namespace HBCI */

typedef HBCI::MediumRDHBase HBCI_MediumRDHBase;
extern "C" {
#else /* __cplusplus */
    typedef struct HBCI_MediumRDHBase HBCI_MediumRDHBase;
#endif /* __cplusplus */

    extern HBCI_Medium *HBCI_MediumRDHBase_Medium(HBCI_MediumRDHBase *h);
    extern HBCI_MediumRDHBase *HBCI_Medium_MediumRDHBase(HBCI_Medium *h);
    extern int 
    HBCI_MediumRDHBase_hasInstSignKey(const HBCI_MediumRDHBase *h);
    extern char *
    HBCI_MediumRDHBase_getInstIniLetterExponent(const HBCI_MediumRDHBase *h, 
                                                int usecrypt);
    extern char *
    HBCI_MediumRDHBase_getInstIniLetterHash(const HBCI_MediumRDHBase *h, 
                                            int usecrypt);
    extern char *
    HBCI_MediumRDHBase_getInstIniLetterModulus(const HBCI_MediumRDHBase *h, 
                                               int usecrypt);
    extern int 
    HBCI_MediumRDHBase_getInstKeyNumber(const HBCI_MediumRDHBase *h, 
                                        int usecrypt);
    extern int 
    HBCI_MediumRDHBase_getInstKeyVersion(const HBCI_MediumRDHBase *h, 
                                         int usecrypt);

    extern char *
    HBCI_MediumRDHBase_getUserIniLetterExponent(const HBCI_MediumRDHBase *h);
    extern char *
    HBCI_MediumRDHBase_getUserIniLetterHash(const HBCI_MediumRDHBase *h);
    extern char *
    HBCI_MediumRDHBase_getUserIniLetterModulus(const HBCI_MediumRDHBase *h);
    extern int 
    HBCI_MediumRDHBase_getUserKeyNumber(const HBCI_MediumRDHBase *h);
    extern int 
    HBCI_MediumRDHBase_getUserKeyVersion(const HBCI_MediumRDHBase *h);
#ifdef __cplusplus
}
#endif /* __cplusplus */

#endif

---