pkcs11wrapper

원본 Readme.txt

이 프로젝트는 더 이상 사용되지 않습니다. 대신 xipki/ipkcs11wrapper(선호) 또는 xipki/jpkcs11wrapper를 사용하십시오.

전제조건

• JRE / JDK 8(빌드 162+) 이상

프로젝트에서 xipki/pkcs11wrapper 사용

• 메이븐

  <dependency>
      <groupId>org.xipki.iaik</groupId>
      <artifactId>sunpkcs11-wrapper</artifactId>
      <version>1.4.10</version>
  </dependency>

• 또는 다음 jar 파일을 클래스 경로에 복사합니다.

• sunpkcs11-wrapper-1.4.7.jar

JDK17 이상

JDK 17 이상에서 pkcs11wrapper를 사용하려면 다음 java 옵션을 추가하세요.

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

JUnit 테스트

• example/data/pkcs11.properties 파일에서 HSM 모듈의 라이브러리와 PIN을 구성합니다.

• mvn test

• 속도 테스트를 활성화하려면 -PspeedTests 사용하세요.

• 기본적으로 속도 테스트는 2개의 스레드로 실행됩니다. Java 속성 speed.threads 통해 값을 변경할 수 있습니다(예: 5개의 스레드를 사용하려면 -Dspeed.threads=5 .

• 기본적으로 속도 테스트는 3초가 소요됩니다. Java 속성 speed.duration 통해 값을 변경할 수 있습니다(예: 10초 동안 -Dspeed.duration=10s .

mikma/pkcs11wrapper와 비교한 변경 사항

• 외부 라이브러리가 필요하지 않습니다

• OpenJDK 또는 Oracle Java Runtime 1.8 이상이 필요합니다.

• PKCS#11 버전 2.40 지원

• EdDSA Ed25519 지원(서명 및 키 쌍 생성)

• mikma/pkcs11wrapper에서 이 프로젝트로 포팅

• *SecretKey 의 경우 생성자 ValuedSecretKey(long keyType) 대신 사용하십시오. 예를 들어 AES SecretKey의 경우 new ValuedSecretKey(PKCS11Constants.CKK_AES) 사용하십시오.

• ECDSAPrivateKey 및 ECDSAPublicKey 의 경우 대신 ECPrivateKey 및 ECPublicKey 사용하세요.

• iaik.pkcs.pkcs11.objects.Object 이름이 iaik.pkcs.pkcs11.objects.PKCS11Object 로 변경되었습니다.

• Token.closeAllSession() 기본 JNI(JDK의 SunPKCS11 공급자)에서 지원되지 않으므로 지원할 수 없습니다. 세션을 직접 관리하시기 바랍니다. Session.closeSession() 으로 단일 세션을 닫을 수 있습니다.

• 원래 PKCS#11 래퍼와는 달리, 기본 .so/.dll당 한 번만 Module.initialize() 호출합니다. Module.finalize(Object) 가 호출되면 모듈을 더 이상 초기화할 수 없습니다.