Skip to main content

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

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

API

Method	URL
POST	/api/search/ztca/evaluation

Request Body

Name	Required	Type	Description
licenseKey	required	string	SHIELDRM 관리자 페이지의 연동 앱 관리 메뉴에서 발급 받은 라이선스 입력
userId	required	string	인증/인가 서비스에 등록된 회사별 사용자 아이디
ipAddress	required	string	사용자 IP 주소
fileEvent	required	string	파일 이벤트
type	required	string	대상 문서 타입
ext	required	string	대상 문서 확장자
properties	optional	string	대상 문서 암호화 유형 DAC 아이디가 여러개인 경우 "\|" 로 구분 ex) DAC;user1\|DAC;user2
creatorSameLoginUser	optional	string	생성자 정보 확인 - 문서 생성자 아이디와 userId 의 일치 여부 : true / false

Response

Name	Type	Description
code	int	성공 여부 (성공:0)
message	string	"Success" : 성공 이외의 값 에러 메시지
conditionalPolicyName	string	조건부 정책명
conditionalPolicyId	string	조건부 정책 아이디
enforcementAttributes	jsonArray	집행 정책 목록
order	int	정책 우선 순위
category	string	평가 대상 범주
info	json	집행 정책 상세

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"
}

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