Водич за интеграцију потписивања

include(FetchContent)
FetchContent_Declare(
    LibreMiddleware
    GIT_REPOSITORY https://github.com/LibreSCRS/LibreMiddleware.git
    GIT_TAG        4.0.0
)
FetchContent_MakeAvailable(LibreMiddleware)

target_link_libraries(MyApp PRIVATE
    LibreSCRS::Signing
    LibreSCRS::Trust
    LibreSCRS::Plugin
    LibreSCRS::SmartCard
    LibreSCRS::Auth
)

cmake -B build -DFETCHCONTENT_SOURCE_DIR_LIBREMIDDLEWARE=/path/to/LibreMiddleware

#include <LibreSCRS/Auth/CredentialProvider.h>
#include <LibreSCRS/Plugin/CardPluginService.h>
#include <LibreSCRS/Secure/String.h>
#include <LibreSCRS/Signing/SigningRequest.h>
#include <LibreSCRS/Signing/SigningResult.h>
#include <LibreSCRS/Signing/SigningService.h>
#include <LibreSCRS/Signing/TsaProvider.h>
#include <LibreSCRS/SmartCard/CardSession.h>
#include <LibreSCRS/SmartCard/MonitorService.h>
#include <LibreSCRS/Trust/TrustConfig.h>
#include <LibreSCRS/Trust/TrustStoreService.h>

#include <iostream>

namespace lsc = LibreSCRS;

int main()
{
    // 1. Конструишите trust store. Фабрика је noexcept и враћа употребљив
    //    сервис чак и када је мрежа недоступна — пакетски и (опционо)
    //    системски анкори су одмах доступни, док eager Trusted-List
    //    преузимања раде на интерним радним нитима.
    lsc::Trust::TrustConfig trustConfig;
    trustConfig.cacheDirectory = "/var/cache/myapp/tl-cache";
    // trustConfig.sources.push_back({...});   // опционо EU LOTL / национални TL-ови

    auto trustResult = lsc::Trust::TrustStoreService::create(std::move(trustConfig));
    if (!trustResult) {
        std::cerr << "Trust store init failed: "
                  << trustResult.error().userMessage.defaultText << '\n';
        return 1;
    }
    std::shared_ptr<lsc::Trust::TrustStoreService> trust = *trustResult;

    // 2. Конструишите SigningService. TsaProvider се позива у време
    //    потписивања за нивое B-T / B-LT / B-LTA; staticTsa() је
    //    помоћна фабрика која увек враћа исти URL без аутентификације.
    //    Прослеђивањем подразумевано конструисаног TsaProvider{} се
    //    искључује TSA — B-B потписивање и даље ради, а виши нивои тада
    //    падају са Status::TsaUnreachable.
    auto tsa = lsc::Signing::staticTsa("http://timestamp.digicert.com");
    auto signingService = std::make_shared<lsc::Signing::SigningService>(trust, std::move(tsa));

    // 3. Откријте card plugin + отворите сесију. CardPluginService скенира
    //    конфигурисани директоријум додатака; MonitorService прати PC/SC
    //    догађаје. Праве апликације се претплаћују на MonitorService и
    //    позивају findPluginForCard(atr) када картица стигне; помоћник
    //    испод сажима тај след у један app-specific корак.
    lsc::Plugin::CardPluginService plugins{"/usr/local/lib/librescrs/plugins"};
    lsc::SmartCard::MonitorService monitor;
    auto session = openFirstSession(monitor, plugins);   // помоћник специфичан за апликацију
    if (!session) {
        std::cerr << "No card available\n";
        return 1;
    }
    auto atr = session->atr();                            // std::span<const std::uint8_t>
    auto cardPlugin = plugins.findPluginForCard(atr);
    if (!cardPlugin) {
        std::cerr << "Ниједан додатак не одговара ATR-у ове картице\n";
        return 1;
    }

    // 4. Изградите захтев за потписивање. Engine чита из inputFile и
    //    пише потписан излаз у outputFile — не постоји улаз преко
    //    бафера бајтова на јавном API-ју.
    auto request = lsc::Signing::SigningRequest::Builder{}
                       .inputFile("document.pdf")
                       .outputFile("document-signed.pdf")
                       .format(lsc::Signing::SignatureFormat::Pades)
                       .level(lsc::Signing::SignatureLevel::B_T)
                       .build();

    // 5. PIN провајдер — позива га сервис када картица захтева PIN.
    //    Провајдер прима AuthRequirement који описује шта да прикупи и
    //    враћа CredentialResult. У GUI хосту ово обично отвара PIN
    //    дијалог; у batch алатима чита из сигурног упита или env
    //    променљиве.
    lsc::Auth::CredentialProvider pinProvider =
        [](const lsc::Auth::AuthRequirement&) {
            lsc::Secure::String pin{"1234"};  // хост прикупља, нулира се при уништавању
            return lsc::Auth::CredentialResult::ok({{"pin", std::move(pin)}});
        };

    // 6. Потпишите. Позив блокира за време трајања операције (PIN
    //    верификација + APDU потпис на картици + опционо TSA повратно
    //    путовање). GUI хостови ово покрећу на радној нити.
    auto result = signingService->sign(request, std::move(pinProvider), cardPlugin, session);

    if (result.status != lsc::Signing::SigningResult::Status::Ok) {
        std::cerr << "Signing failed: "
                  << result.userMessage.defaultText << '\n';
        return 1;
    }

    // 7. Успех — потписан документ је на диску на путањи на коју је
    //    engine писао (тј. outputFile() са којим је захтев изграђен).
    std::cout << "Signed: " << result.outputPath->string() << '\n';
    return 0;
}

SigningService(std::shared_ptr<Trust::TrustStoreService> trustService,
               TsaProvider tsa);

SigningResult sign(const SigningRequest& request,
                   Auth::CredentialProvider credentialProvider,
                   std::shared_ptr<Plugin::CardPlugin> cardPlugin,
                   std::shared_ptr<SmartCard::CardSession> session);

auto result = signingService->sign(request, pinProvider, cardPlugin, session);
if (result.status != LibreSCRS::Signing::SigningResult::Status::Ok) {
    using S = LibreSCRS::Signing::SigningResult::Status;
    switch (result.status) {
        case S::TrustStoreUnavailable:  /* TL преузимање / конфиг одбијен  */ break;
        case S::InvalidRequest:         /* null plugin/session, празан cb  */ break;
        case S::UserCancelled:          /* провајдер је вратио cancel      */ break;
        case S::PinVerificationFailed:  /* погрешан PIN                    */ break;
        case S::CardBlocked:            /* PIN за потписивање је блокиран  */ break;
        case S::TsaUnreachable:         /* B-T+ захтеван, TSA није успео   */ break;
        case S::SigningEngineError:     /* libresign / APDU цевовод        */ break;
        default: break;                 // append-only enum; задржите default
    }
    log(result.userMessage.defaultText);
    if (result.diagnosticDetail) {
        log(*result.diagnosticDetail);
    }
}