Skip to main content

7) Unlabeling AIP

Convert AIP documents to regular documents

API

Method	URL
POST	/api/internal/unProtect

Request Header

Name	Required	Description
Authorization	required	User authentication method, JWT value Authorization: Bearer `{JWT}` Note: The JWT value is issued through the authentication/authorization service.

Request Body

Name	Required	Type	Description
companyId	required	string	Company ID using the target document (used when retrieving key data by company)
srcFilePath	required	string	Original AIP document path - If the Azure OpenidTenant is missing or the Action creation fails, consider the document as a regular document.
dstFilePath	required	string	Released General Document Path
extraInfo	optional	string	Input additional information in JSON format (refer to the extraInfo data description table and sample data below)

extraInfo Data Description Table

Key Required Type Description
source required json
name required string Call System Name
from required string Call System URL
user json
id string User ID
name string Username
depart string All User Departments (Top Group/Middle Group/Lower Group)
duty string User Job Title

Sample Data
{
  "source": {
    "name": "EKMS",
    "from": "https://devekms.softcamp.co.kr"
  },
  "user": {
    "id": "ekmsTest@softcamp.co.kr",
    "name": "ekmsTest",
    "depart": "임직원/연구소/개발실/개발1팀",
    "duty": "과장"
  }
}

Response

Name	Type	Description
code	int	0 : Success Value other than 0: Error
message	string	"OK" : Success Other Value Error Message

Examples

Request

Body

{
    "companyId": "gNzvLhk8-cVXfQ41A-FSfFVW0m-w4yc4M00",
    "srcFilePath" : "/opt/shieldrm/data/encFile.xlsx",
    "dstFilePath" : "/opt/shieldrm/plainFile.xlsx",
    "extraInfo" : "{\"source\":{\"name\":\"EKMS\",\"from\":\"https://devekms.softcamp.co.kr\"},\"user\":{\"id\":\"ekmsTest@softcamp.co.kr\",\"name\":\"ekmsTest\",\"depart\":\"임직원/연구소/개발실/개발1팀\",\"duty\":\"과장\"}}"
}

Response

success

{
    "code": 0,
    "message" : "OK"
}

failure

Status code : 401 UNAUTHORIZED

{
    "code": 40001,
    "message": "Invalid token"
}

Status code : 500 INTERNAL_SERVER_ERROR

[AIP SDK 에러]
{
    "code": 60001,
    "message": "com.microsoft.informationprotection.internal.gen.Error: NoAuthTokenError: Client application failed to provide authentication token for HTTP request., CorrelationId=a2d2f6b1-4265-482b-bc7d-18c88f8284bd, CorrelationId.Description=PolicyProfile"
}

[내부 서비스 에러]
{
    "code": 50001,
    "message": "{\"code\":40101,\"message\":\"Invalid token\",\"detail\":\"invalid_token\"}"
}

Convert AIP documents to regular documents
Examples