Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/Pkcs11Interop/Pkcs11Interop

Managed .NET wrapper for unmanaged PKCS#11 libraries
https://github.com/Pkcs11Interop/Pkcs11Interop

crypto cryptography hsm pkcs pkcs11 security smartcard

Last synced: about 2 months ago
JSON representation

Managed .NET wrapper for unmanaged PKCS#11 libraries

Awesome Lists containing this project

README 

        
Pkcs11Interop

=============

**Managed .NET wrapper for unmanaged PKCS#11 libraries**



[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://github.com/Pkcs11Interop/Pkcs11Interop/blob/master/LICENSE.md)

[![AppVeyor](https://ci.appveyor.com/api/projects/status/lb1jxb4t4203g3t9/branch/master?svg=true)](https://ci.appveyor.com/project/pkcs11interop/pkcs11interop/branch/master)

[![NuGet](https://img.shields.io/badge/nuget-pkcs11interop-blue.svg)](https://www.nuget.org/packages/Pkcs11Interop/)

[![Stack Overflow](https://img.shields.io/badge/stack-pkcs11interop-blue.svg)](https://stackoverflow.com/questions/tagged/pkcs11interop)

[![Twitter](https://img.shields.io/badge/twitter-p11interop-blue.svg)](https://twitter.com/p11interop)



## Table of Contents



* [Overview](#overview)

* [Documentation](#documentation)

* [Download](#download)

* [License](#license)

* [Support](#support)

* [Related projects](#related-projects)

* [About](#about)



## Overview



PKCS#11 is cryptography standard maintained by the OASIS PKCS 11 Technical Committee (originally published by RSA Laboratories) that defines ANSI C API to access smart cards and other types of cryptographic hardware.



Pkcs11Interop is managed library written in C# that brings full power of PKCS#11 API to the .NET environment. It loads unmanaged PKCS#11 library provided by the cryptographic device vendor and makes its functions accessible to .NET application.



Following figure presents the typical usage of Pkcs11Interop library in .NET application:



![Pkcs11Interop architecture](doc/images/pkcs11interop-architecture-small.png?raw=true)



Pkcs11Interop library:



* implements .NET wrapper for unmanaged PKCS#11 libraries

* is compliant with [PKCS#11 v2.40](https://github.com/Pkcs11Interop/PKCS11-SPECS/tree/master/v2.40) specification and PKCS#11 URI scheme defined in [RFC 7512](https://github.com/Pkcs11Interop/PKCS11-SPECS/tree/master/RELATED/RFC7512)

* is compatible with .NET Framework 2.0 and higher, .NET Core, Mono and Xamarin

* is supported on Windows, Linux, Mac OS X, Android and iOS

* is supported on both 32-bit and 64-bit platforms

* is open source and completely free for commercial use

* is used in production by several information security and financial organizations

* uses 100% managed and fully documented code

* contains code samples covering all methods of PKCS#11 API



Pkcs11Interop has been confirmed to be working with the following devices:



* Atos CardOS (former Siemens CardOS) smartcard

* Thales nShield Solo (former nCipher nShield) HSM

* SoftHSM (virtual HSM from OpenDNSSEC project)

* Feitian ePass 2003 token

* SafeNet ProtectServer HSM

* SafeNet Luna SA HSM

* Utimaco CryptoServer HSM

* Belgian and Slovak eID cards

* SmartCard-HSM



## Documentation



It is highly recommended that before you start using Pkcs11Interop you get familiar at least with *"Chapter 2 - Scope"*, *"Chapter 6 - General overview"* and *"Chapter 10 - Objects"* of [PKCS#11 v2.20](https://github.com/Pkcs11Interop/PKCS11-SPECS/tree/master/v2.20) specification (or equivalent chapters of any previous or subsequent specification version).



Pkcs11Interop API is fully documented with the inline XML documentation that is displayed by the most of the modern IDEs during the application development. Detailed [Pkcs11Interop API documentation](https://pkcs11interop.net/doc/) is also available online.



Following topics are covered by standalone documents:

* [Pkcs11Interop library architecture](doc/ARCHITECTURE.md)

* [Getting started with Pkcs11Interop](doc/GETTING_STARTED.md)

* [Pkcs11Interop code samples](doc/CODE_SAMPLES.md)

* [Troubleshooting Pkcs11Interop with PKCS11-LOGGER](doc/TROUBLESHOOTING.md)



## Download



Archives with the source code and binaries can be downloaded from [our releases page](https://github.com/Pkcs11Interop/Pkcs11Interop/releases/). Official [NuGet packages](https://www.nuget.org/packages/Pkcs11Interop/) are published in nuget.org repository. All official items are signed with [GnuPG key or code-signing certificate of Jaroslav Imrich](https://www.jimrich.sk/crypto/) and announced via [public mailing list](https://groups.google.com/d/forum/pkcs11interop).



## License



Pkcs11Interop is available under the terms of the [Apache License, Version 2.0](https://www.apache.org/licenses/LICENSE-2.0).  

[Human friendly license summary](https://www.tldrlegal.com/license/apache-license-2-0-apache-2-0) is available at tldrlegal.com but the [full license text](LICENSE.md) always prevails.



## Support



If you need help please pick one of the options that best suits your needs:



* Public [issue tracker](https://github.com/Pkcs11Interop/Pkcs11Interop/issues) available at GitHub.com

* Questions with [pkcs#11 tag](https://stackoverflow.com/questions/tagged/pkcs%2311) and [pkcs11interop tag](https://stackoverflow.com/questions/tagged/pkcs11interop) posted at StackOverflow.com

* Commercial support and consulting from the original developer available upon request at [[email protected]](mailto:[email protected])



## Related projects



* [Pkcs11Admin](https://www.pkcs11admin.net/)  

  GUI tool for administration of PKCS#11 enabled devices based on Pkcs11Interop library.

* [PKCS11-LOGGER](https://github.com/Pkcs11Interop/pkcs11-logger)  

  PKCS#11 logging proxy module useful for debugging of PKCS#11 enabled applications.

* [SoftHSM2-for-Windows](https://github.com/disig/SoftHSM2-for-Windows)  

  Pure software implementation of a cryptographic store accessible through a PKCS#11 interface.



## About



Pkcs11Interop has been written by [Jaroslav Imrich](https://www.jimrich.sk).  

Please visit project website - [pkcs11interop.net](https://www.pkcs11interop.net) - for more information.