서명데이터

서명데이터란?

서명데이터(kcp_sign_data)는 가맹점 부인 방지와 요청 데이터의 무결성 검증을 위한 데이터입니다.
NHN KCP로부터 발급받은 개인키로 SHA256withRSA 알고리즘을 사용하여 문자열을 인코딩하는 방식으로 이루어집니다.

개인키 발급 및 관리 방법은 KCP PG-API를 확인하세요.

1. 서명데이터 생성

Cancel API 서명데이터(kcp_sign_data)는 아래 규칙으로 원문을 조합한 뒤,
개인키로 SHA256withRSA 서명을 생성하고 Base64로 인코딩하여 전달합니다.

서명 원문 조합 규칙

kcp_sign_data = site_cd + "^" + tno + "^" + mod_type

생성 흐름

파라미터 설명

2. 코드 예시 (JSP)

아래는 Java(JSP) 환경에서 서명데이터를 생성하는 예시입니다.
개인키 파일(PKCS8)을 로드한 뒤 SHA256withRSA 서명을 생성하고, Base64로 인코딩하여 반환합니다.

// JSP 예시

public static String makeSignatureData(String targetData){
  String signData  = null;
  PrivateKey priKey = null;
  priKey = loadSplMctPrivateKeyPKCS8();

  byte[ ] btArrTargetData = targetData.getBytes( StandardCharsets.UTF_8 );
  try {
      Signature sign = Signature.getInstance( "SHA256WithRSA" );
      sign.initSign( priKey );
      sign.update( btArrTargetData );
      byte[ ] btArrSignData = sign.sign();
      signData = Base64.getEncoder().encodeToString( btArrSignData );

  } catch (NoSuchAlgorithmException e) {
      e.printStackTrace();
  } catch (InvalidKeyException e) {
      e.printStackTrace();
  } catch (SignatureException e) {
      e.printStackTrace();
  }
  return signData;
}