5) Security Document SFI Information Retrieval

Returns the information by inputting the path of the document to be encrypted and the SFI key to be queried.

API

Method	URL
POST	/api/header-info/keys

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
srcFileName	required	string	Encryption Document Path
companyId	required	string	Company ID using the target document (used when retrieving key data by company)
sfiKeys	required	array[]	List of SFI Keys for Querying (16 items) - DOC_BRANCH_UID - CREATE_PATH - VERIFICATION_DATA - SERVER_ID - WRITER_GROUP_HIERARCHY - EXTRA_INFO - WRITER_NAME - WRITER_GROUP_NAME - ENC_TYPE - DOCUMENT_GRADE - WRITER_ID - DOC_PARENT_BRANCH_UID - DOC_UID - CREATE_TIME - SERVER_NAME - DOCUMENT_TYPE

Response

Name	Type	Description
code	int	0: Success Value other than 0: Error
{입력 받은 SFI 키}	JSON	Data corresponding to the input SFI key
message	JSON	Error Message

Examples

Request

• Body

{
  "srcFileName": "E:\\test\\orgin\\test.xlsx",
  "companyId": "7FDKQsEK-QVGKyXA2-fx1LxIzy-SNIre0s9",
  "sfiKeys" : ["DOC_BRANCH_UID", "EXTRA_INFO", "SERVER_ID"]
}

Response

• success

• SFI data retrieval successful

{
    "code": 0,
    "DOC_BRANCH_UID": "Re*_vR7vpr9077*9W**_vSfquansgZR7",
    "EXTRA_INFO": "NO DATA",
    "SERVER_ID": "SCAM-ED72-262C-433A-9111"
}

• In the case of a general document

{
    "code": -36,
    "message": "This document is not encrypted."
}

• failure

• Status code : 401 UNAUTHORIZED

{
    "code": 40107,
    "message": "{\"code\":40107,\"message\":\"No matching license found\",\"detail\":\"License skms_connector_info information is empty.\"}"
}

• Status code : 400 Bad Request

{
    "code": 40001,
    "message": "Missing required input values"
}

{
    "code": 1020,
    "message": "Decryption of header failed"
}
 
{
    "code": 4010,
    "message": "Encryption algorithm not found"
}

• Other code requires checking the definition of errorCode in scsl.jar.