Skip to main content

4) 조건부 정책 질의 및 집행 정책 수신

조건부 정책 질의 및 집행 정책 수신 API

API

MethodURL
POST/api/search/ztca/evaluation

Request Body

NameRequiredTypeDescription
licenseKeyrequiredstringSHIELDRM 관리자 페이지의 연동 앱 관리 메뉴에서 발급 받은 라이선스 입력
userIdrequiredstring인증/인가 서비스에 등록된 회사별 사용자 아이디
ipAddressrequiredstring사용자 IP 주소
fileEventrequiredstring파일 이벤트
typerequiredstring대상 문서 타입
extrequiredstring대상 문서 확장자
propertiesoptionalstring대상 문서 암호화 유형
DAC 아이디가 여러개인 경우 "|" 로 구분
ex) DAC;user1|DAC;user2
creatorSameLoginUseroptionalstring생성자 정보 확인
- 문서 생성자 아이디와 userId 의 일치 여부
  : true / false

Response

NameTypeDescription
codeint성공 여부 (성공:0)
messagestring"Success" : 성공
이외의 값 에러 메시지
conditionalPolicyNamestring조건부 정책명
conditionalPolicyIdstring조건부 정책 아이디
enforcementAttributesjsonArray집행 정책 목록
    orderint정책 우선 순위
    categorystring평가 대상 범주
    infojson집행 정책 상세

Examples

Request

  • Body
 {
"licenseKey": "A4CD-BCBE6-D1DF-8BFB9",
"userId": "ekms2@softcamp.co.kr",
"ipAddress": "10.10.10.100",
"fileEvent": "encryption",
"type": "ds",
"ext": "pptx",
"properties": "MAC;0000001",
"creatorSameLoginUser": "false"
}

Response

  • 성공
[조건부 정책 조회 성공]
{
"code": 0,
"message": "Success",
"conditionalPolicyName": "test",
"conditionalPolicyId": "ePs0qUsi-mZ6KUyKV-uhTvXHQh-1w35aKNa",
"enforcementAttributes": [
{
"order": 0,
"category": "convert",
"info": {
"auth": "011111000",
"detail": "DAC;test@test.com",
"forcedEncryptPolicy": "false",
"type": "ds"
}
}
]
}

[조건에 맞는 조건부 정책이 존재하지 않음]
{
"code": 1621,
"message": "Conditional policies does not exist that match the conditions"
}

[존재하지 않는 userId]
{
"code": 1200,
"message": "User not found"
}
  • 내부 서비스 실패
{
"code": 50001,
"message": "An unexpected error has occurred in the internal system"
}