View source for PKCS11 token usage with opensc

== Summary == 

Basic command line usage of a PKCS#11 token

== Requirements ==

* Operating system: Ubuntu 18.04 bionic amd64
* Packages: opensc opensc-pkcs11

== Description ==

The documentation uses the [[Feitian ePass 2003 FIPS 140-2 Level 2]] tokens which can be used with the open source project [https://github.com/OpenSC/OpenSC OpenSC].

The default configuration of the tokens, according to the manufacturer, is as follows:

* Default User PIN: 12345678
* Default SO PIN: entersafe

=== Basic information gathering ===

We are going to get some basic informations using the command line tool [https://linux.die.net/man/1/pkcs11-tool pkcs11-tool]

List the number of available tokens:

 $ pkcs11-tool --module /usr/lib/x86_64-linux-gnu/opensc-pkcs11.so -L
 Available slots:
 Slot 0 (0x0): Feitian ePass2003 00 00
 C_GetTokenInfo() failed: rv = CKR_TOKEN_NOT_PRESENT
 Slot 1 (0x4): Alcor Micro AU9560 01 00
   (empty)



== Used Hardware ==

[[Feitian ePass 2003 FIPS 140-2 Level 2]]

== Courses ==

None yet

== References ==

* https://github.com/OpenSC/OpenSC
* https://linux.die.net/man/1/pkcs11-tool

[[Category:Documentation]]