CardControlSamTransactionManagerAdapter.h

Go to the documentation of this file.

/**************************************************************************************************
 * Copyright (c) 2022 Calypso Networks Association https://calypsonet.org/                        *
 *                                                                                                *
 * See the NOTICE file(s) distributed with this work for additional information regarding         *
 * copyright ownership.                                                                           *
 *                                                                                                *
 * This program and the accompanying materials are made available under the terms of the Eclipse  *
 * Public License 2.0 which is available at http://www.eclipse.org/legal/epl-2.0                  *
 *                                                                                                *
 * SPDX-License-Identifier: EPL-2.0                                                               *
 **************************************************************************************************/
 
#pragma once
 
/* Calypsonet Terminal Calypso */
#include "WriteAccessLevel.h"
 
/* Keyple Card Calypso */
#include "CalypsoCardAdapter.h"
#include "CardSecuritySettingAdapter.h"
#include "CmdSamCardCipherPin.h"
#include "CmdSamCardGenerateKey.h"
#include "CmdSamDigestClose.h"
#include "CmdSamGetChallenge.h"
#include "CmdSamSvPrepareDebitOrUndebit.h"
#include "CmdSamSvPrepareLoad.h"
#include "CmdCardSvReload.h"
#include "CmdCardSvDebitOrUndebit.h"
#include "CommonControlSamTransactionManagerAdapter.h"
 
namespace keyple {
namespace card {
namespace calypso {
 
using namespace calypsonet::terminal::calypso;
using namespace keyple::core::util::cpp;
 
class CardControlSamTransactionManagerAdapter final
: public CommonControlSamTransactionManagerAdapter<CardSecuritySettingAdapter> {
public:
    CardControlSamTransactionManagerAdapter(
        const std::shared_ptr<CalypsoCardAdapter> targetCard,
        const std::shared_ptr<CardSecuritySettingAdapter> securitySetting,
        const std::vector<std::vector<uint8_t>>& transactionAuditData);
 
    std::shared_ptr<uint8_t> computeKvc(const WriteAccessLevel writeAccessLevel,
                                        const std::shared_ptr<uint8_t> kvc) const;
 
    std::shared_ptr<uint8_t> computeKif(const WriteAccessLevel writeAccessLevel,
                                        const std::shared_ptr<uint8_t> kif,
                                        const std::shared_ptr<uint8_t> kvc) const;
 
    SamTransactionManager& processCommands() override;
 
    std::shared_ptr<CmdSamGetChallenge> prepareGetChallenge();
 
    void prepareGiveRandom();
 
    const std::shared_ptr<CmdSamCardGenerateKey> prepareCardGenerateKey(
        const uint8_t cipheringKif,
        const uint8_t cipheringKvc,
        const uint8_t sourceKif,
        const uint8_t sourceKvc);
 
    const std::shared_ptr<CmdSamCardCipherPin> prepareCardCipherPin(
        const std::vector<uint8_t>& currentPin,
        const std::vector<uint8_t>& newPin);
 
    const std::shared_ptr<CmdSamSvPrepareLoad> prepareSvPrepareLoad(
        const std::vector<uint8_t>& svGetHeader,
        const std::vector<uint8_t>& svGetData,
        const std::shared_ptr<CmdCardSvReload> cmdCardSvReload);
 
    const std::shared_ptr<CmdSamSvPrepareDebitOrUndebit> prepareSvPrepareDebitOrUndebit(
        const bool isDebitCommand,
        const std::vector<uint8_t>& svGetHeader,
        const std::vector<uint8_t>& svGetData,
        const std::shared_ptr<CmdCardSvDebitOrUndebit> cmdCardSvDebitOrUndebit);
 
    void prepareSvCheck(const std::vector<uint8_t>& svOperationData);
 
    void initializeSession(
        const std::vector<uint8_t>& openSecureSessionDataOut,
        const uint8_t kif,
        const uint8_t kvc,
        const bool isSessionEncrypted,
        const bool isVerificationMode);
 
    void updateSession(const std::vector<std::shared_ptr<ApduRequestSpi>>& requests,
                       const std::vector<std::shared_ptr<ApduResponseApi>>& responses,
                       const int startIndex);
 
    const std::shared_ptr<CmdSamDigestClose> prepareSessionClosing();
 
    void prepareDigestAuthenticate(const std::vector<uint8_t>& cardSignatureLo);
 
private:
    class DigestManager {
    public:
        const uint8_t mSessionKif;
 
        const uint8_t mSessionKvc;
 
        bool mIsDigestInitDone = false;
 
        const std::vector<uint8_t> mOpenSecureSessionDataOut;
 
        const bool mIsSessionEncrypted;
 
        const bool mIsVerificationMode;
 
        std::vector<std::vector<uint8_t>> mCardApdus;
 
        CardControlSamTransactionManagerAdapter *mParent;
 
        DigestManager(CardControlSamTransactionManagerAdapter* parent,
                      const std::vector<uint8_t>& openSecureSessionDataOut,
                      const uint8_t kif,
                      const uint8_t kvc,
                      const bool isSessionEncrypted,
                      const bool isVerificationMode);
 
        void updateSession(const std::vector<std::shared_ptr<ApduRequestSpi>>& requests,
                           const std::vector<std::shared_ptr<ApduResponseApi>>& responses,
                           const int startIndex);
 
        void prepareCommands();
 
        void prepareDigestInit();
 
        void prepareDigestUpdate();
 
        void prepareDigestClose();
    };
 
    std::shared_ptr<CalypsoSamAdapter> mControlSam = nullptr;
 
    const std::shared_ptr<CalypsoCardAdapter> mTargetCard;
 
    const std::shared_ptr<CardSecuritySettingAdapter> mCardSecuritySetting;
 
    std::shared_ptr<DigestManager> mDigestManager;
};
 
}
}
}