pkcs11wrapper

Readme.txt asli

Proyek ini tidak digunakan lagi, silakan gunakan xipki/ipkcs11wrapper(lebih disukai) atau xipki/jpkcs11wrapper sebagai gantinya.

Prasyarat

• JRE / JDK 8 (build 162+) atau lebih tinggi

Gunakan xipki/pkcs11wrapper di proyek Anda

• Maven

  
      org.xipki.iaik
      sunpkcs11-wrapper
      1.4.10
  

• Atau salin file jar berikut ke classpath Anda:

• sunpkcs11-wrapper-1.4.7.jar

JDK17 atau lebih tinggi

Untuk menggunakan pkcs11wrapper di JDK 17 atau lebih tinggi, silakan tambahkan opsi java berikut:

--add-exports=jdk.crypto.cryptoki/sun.security.pkcs11.wrapper=ALL-UNNAMED

Tes JUnit

• Konfigurasikan perpustakaan dan PIN modul HSM Anda dalam file example/data/pkcs11.properties .

• mvn test

• Untuk mengaktifkan tes kecepatan gunakan -PspeedTests

• Secara default tes kecepatan akan berjalan dengan 2 thread, Anda dapat mengubah nilainya melalui properti Java speed.threads , misalnya -Dspeed.threads=5 untuk menggunakan 5 thread.

• Secara default tes kecepatan akan memakan waktu 3 detik, Anda dapat mengubah nilainya melalui properti Java speed.duration , misalnya -Dspeed.duration=10s selama 10 detik.

Perubahan dibandingkan dengan mikma/pkcs11wrapper

• Tidak diperlukan perpustakaan eksternal

• Memerlukan OpenJDK atau Oracle Java Runtime 1.8 atau lebih tinggi

• Mendukung PKCS#11 versi 2.40

• Mendukung EdDSA Ed25519 (pembuatan Tanda Tangan dan Keypair)

• Port dari mikma/pkcs11wrapper ke proyek ini

• Untuk *SecretKey , silakan gunakan konstruktor ValuedSecretKey(long keyType) sebagai gantinya, misalnya gunakan new ValuedSecretKey(PKCS11Constants.CKK_AES) untuk AES SecretKey.

• Untuk ECDSAPrivateKey dan ECDSAPublicKey , silakan gunakan ECPrivateKey dan ECPublicKey sebagai gantinya.

• iaik.pkcs.pkcs11.objects.Object diubah namanya menjadi iaik.pkcs.pkcs11.objects.PKCS11Object .

• Token.closeAllSession() tidak dapat didukung, karena tidak didukung di JNI yang mendasarinya (penyedia SunPKCS11 JDK). Silakan kelola sesi Anda sendiri. Anda dapat menutup satu sesi dengan Session.closeSession() .

• Berbeda dengan wrapper PKCS#11 asli, kami hanya memanggil Module.initialize() satu kali per .so/.dll asli. Setelah Module.finalize(Object) dipanggil, modul tidak dapat diinisialisasi lagi.