본문으로 건너뛰기

21) DS 헤더를 사용한 암호화

DS 헤더를 사용한 보안 문서 생성

API

MethodURL
POST/api/internal/encryption/header

Request Header

NameRequiredDescription
Authorizationrequired사용자 인증 수단, JWT값
Authorization: Bearer {JWT}
참고 : JWT값은 인증/인가 서비스를 통해 발급 받는다.

Request Body

NameRequiredTypeDescription
companyIdrequiredstring대상 문서를 사용하는 회사ID(회사 별 키 데이터 조회 시 사용)
docuKeyrequiredstring평문 문서 암호화에 사용될 유저키로 만들어진 DocuKey
encHeaderInforequiredstring암호화할 DS 헤더 정보 (base64Encode)
srcFilePathrequiredstring원본 일반 문서 경로
dstFilePathrequiredstring암호화된 보안 문서 경로

Response

NameTypeDescription
codeint0 : 성공
0 이외의 값 : 에러
messagestring"OK" : 성공
이외의 값 에러 메시지

Examples

Request

  • Body
{
"companyId": "7FDKQsEK-QVGKyXA2-fx1LxIzy-SNIre0s9",
"docuKey" : "UdEOPB2vjsrd0rB9d93blQ==",
"encHeaderInfo" : "eyJlbmNyeXB0ZWQiOnRydWUsImZpbGUiOnsicGF0aCI6IkQ6XF....(생략).....",
"srcFilePath" : "/opt/shieldrm/data/test.xlsx",
"dstFilePath" : "/opt/shieldrm/data/test_enc.xlsx"
}

Response

  • 성공
{
"code": 0,
"message" : "OK"
}

Response

  • 실패
[암호화 문서인 경우]
{
"code": 40010,
"message": "File is already encrypted."
}

[SCSL 실패]
{
"code": -61,
"message": "EXCEPTION error"
}