Object PKCS#11 C++ Wrapper Documentation


Introduction

Recently I had to prototype some PKCS#11 code to test if the API supported symmetric key wrapping and double wrapping using RSA and ECDSA public keys. Coding with C, reading huge pdf docs and header files is just annoying. This is why I decided to start a PKCS#11 Object Oriented and well documented library. I hope it helps me and my team mates with our current projects. Moreover, if it suits you, please feel free to use, share and contribute :)

My goal is to implement this library to work with simple use cases and less code. If you wish to implement more complex applications, I recommend taking a look at Libp11 from OpenSC project.

Contribution

We are designing our objects to be used with RAII pattern. Functions should always return copies and pointers are not welcome for the end user (should be kept behind curtain). Sessions are closed the object is destructed. Always consider the context of the declaration to manage "close" and "finalize" functions.

Running code with SoftHSMv2

We wrote a PKCS11 mocker using lambda functions. In the test files we can write the PKCS11 function implementations on the fly. This allows us to test if the functions were indeed called dynamically and to evaluate the return value.

run the tests with:

$ make test

Status

Under development as of Oct 2015 Lucas Perin :)