source: terepaima/signHash/cryptotoken.h @ 0f7c727

#ifndef CRYPTOTOKEN_H
#define CRYPTOTOKEN_H

#include <QObject>

#include "pkcs11.h"

class CryptoToken
{

public:

    /**
     * @brief Constructor de la clase CryptoToken
     */
    explicit CryptoToken();

    /**
     * @brief Destructor de la clase
     */
    virtual ~CryptoToken();

    /**
     * @brief Inicializa el Criptoki
     * @return retorna si inicializa el Criptoki
     */
    bool initializeCriptoki();

    /**
     * @brief Finaliza el criptoki
     */
    void finalize();

    /**
     * @brief Abre una sesion en el dispositivo criptografico
     * @param Pin PIN del dispositivo
     * @param slotID slot asociado a la sesión en el dispositivo
     * @param requiredlogin si se requiere el login, por defecto si
     * @return handle de la sesión
     */
    CK_SESSION_HANDLE openSession(char * Pin, CK_SLOT_ID & slotID, bool requiredlogin = true);

    void closeSession(CK_SESSION_HANDLE hSession);

    /**
     * @brief Retorna un handle a la clave privada encontrada dentro del dispositivo
     * @param hSession handle de la sesión abierta en el dispositivo
     * @param slotID identificador de slot
     * @param id etiqueta de la clave dentro del dispositivo
     * @return
     */
    CK_OBJECT_HANDLE getPrivateKey(CK_SESSION_HANDLE hSession, CK_SLOT_ID slotID, QString id);

    /**
     * @brief firma digitalmente unos datos con la tarjeta inteligente
     * @param hSession handle a la sesion abierta en la tarjeta
     * @param privateKey handle a la clave privada de la tarjeta
     * @param someData datos a firmar (CK_BYTE_PTR: unsigned char *)
     * @param someDataLen longitud de los datos a firmar
     * @param sign firma de los datos
     * @param signLen longitud de la firma de los datos
     * @return firma electronica de los datos pasados en someData
     */
    bool signSomeData(CK_SESSION_HANDLE hSession, CK_OBJECT_HANDLE privateKey, CK_BYTE_PTR someData,
            CK_ULONG someDataLen, CK_BYTE_PTR sign, CK_ULONG_PTR signLen );

    /**
     * @brief Retorna información del modulo PKCS11
     * @return cadena con informacion del modulo PKCS11
     */
    QString getInfoCryptoki();

    /**
     * @brief Retorna error de pkcs11 en formato de cadena QString
     * @param rv
     * @return cadena con el error
     */
    QString returnErrorToQString(CK_RV rv);

};

#endif // CRYPTOTOKEN_H