4) Conditional Policy Query and Enforcement Policy Reception

Conditional Policy Query and Enforcement Policy Reception API

API

Method	URL
POST	/api/search/ztca/evaluation

Request Body

Name	Required	Type	Description
licenseKey	required	string	Enter the issued license in the integration app management menu of the SHIELDRM admin page.
userId	required	string	User IDs by company registered in the authentication/authorization service
ipAddress	required	string	User IP Address
fileEvent	required	string	File Events
type	required	string	Target Document Type
ext	required	string	Target Document Extension
properties	optional	string	Document Encryption Types If there are multiple DAC IDs, separate them with "|". ex) DAC;user1|DAC;user2
creatorSameLoginUser	optional	string	Check Constructor Information - Whether the document creator ID matches the userId   : true / false

Response

Name	Type	Description
code	int	Success status (Success:0)
message	string	"Success" : Success Other Value Error Message
conditionalPolicyName	string	Conditional Policy Name
conditionalPolicyId	string	Conditional Policy ID
enforcementAttributes	jsonArray	Execution Policy List
order	int	Policy Priorities
category	string	Evaluation Target Categories
info	json	Execution Policy Details

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

• success

[조건부 정책 조회 성공]
{
   "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"
}

• Internal Service Failure

{
   "code": 50001,
   "message": "An unexpected error has occurred in the internal system"
}