1) 보안문서 헤더 조회

암호화 대상 문서 경로를 입력 받아 보안 문서의 헤더 정보를 리턴

API

Method	URL
POST	/api/header-info

Request Header

Name	Required	Description
Authorization	required	사용자 인증 수단, JWT값 Authorization: Bearer {JWT} 참고 : JWT값은 인증/인가 서비스를 통해 발급 받는다.

Request Body

Name	Required	Type	Description
srcFileName	required	string	암호화 문서 경로
companyId	required	string	대상 문서서를 사용하는 회사ID(회사 별 키 데이터 조회 시 사용)

Response

Name	Type	Description
result	JSON	헤더 정보 JSON 데이터

Examples

Request

• Body

{
  "srcFileName": "E:\\test\\orgin\\test.xlsx",
  "companyId" : "7FDKQsEK-QVGKyXA2-fx1LxIzy-SNIre0s9"
}

Response

• 성공

• DAC 문서 헤더 정보 샘플

{
    "Custom_Type": 0,
    "errcode": 0,
    "Document_ID": "[0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]",
    "Server_ID_Hash": "[-107, 25, -70, 18, -67, 81, 52, 2, -51, 110, 64, -92, -46, -20, 35, 66, 50, -3, 11, 70]",
    "CREATE_PLACE": "",
    "DAC": [
        {
            "DAC_PRINT_MARKING": "1",
            "DAC_PRINT_NUM_LIMIT": "",
            "DAC_GRADE_ACCESS_CLASS_ID": "",
            "DAC_TYPE_NAME": "SECURITYDOMAIN",
            "DAC_TYPE": "1",
            "DAC_READ_NUM_LIMIT": "",
            "DAC_DECRYPT": "0",
            "DAC_SUBGROUP_EXCLUDE": "",
            "DAC_PRINT": "1",
            "DAC_GRADE_ACCESS_USER_ID_EXCLUDE": "",
            "DAC_AUTO_DESTROY": "0",
            "DAC_READ": "1",
            "DAC_EXPIRE_DATE": "",
            "DAC_TYPE_ID": "securitydomain",
            "DAC_EDIT": "1",
            "DAC_SOM": "0",
            "DAC_GRADE_ACCESS_GROUP_ID": "",
            "DAC_GRADE_ACCESS_USER_ID_INCLUDE": "",
            "DAC_CHANGE_AUTH": "0"
        },
        {
            "DAC_PRINT_MARKING": "1",
            "DAC_PRINT_NUM_LIMIT": "",
            "DAC_GRADE_ACCESS_CLASS_ID": "",
            "DAC_TYPE_NAME": "test",
            "DAC_TYPE": "0",
            "DAC_READ_NUM_LIMIT": "",
            "DAC_DECRYPT": "0",
            "DAC_SUBGROUP_EXCLUDE": "",
            "DAC_PRINT": "1",
            "DAC_GRADE_ACCESS_USER_ID_EXCLUDE": "",
            "DAC_AUTO_DESTROY": "0",
            "DAC_READ": "1",
            "DAC_EXPIRE_DATE": "",
            "DAC_TYPE_ID": "test",
            "DAC_EDIT": "1",
            "DAC_SOM": "0",
            "DAC_GRADE_ACCESS_GROUP_ID": "",
            "DAC_GRADE_ACCESS_USER_ID_INCLUDE": "",
            "DAC_CHANGE_AUTH": "0"
        }
    ],
    "Encrypted_Header_Size": 1456,
    "Header_Hash": "[15, -21, -75, -114, 39, -54, -67, -40, -64, 77, 33, -16, -10, 45, 93, -91, -53, -107, -94, -19]",
    "Document_Type": 2,
    "Algorithm": "AES",
    "DESC": "SCDSA004",
    "Create_Place": 1,
    "SFI": {
        "DOC_BRANCH_UID": "77*9CX9D7Z6G6ryU77*9OO*_veuaru*_",
        "CREATE_PATH": "Server/테스트.pptx",
        "VERIFICATION_DATA": "",
        "SERVER_ID": "SCAM-ED72-262C-433A-0004",
        "WRITER_GROUP_HIERARCHY": "",
        "EXTRA_INFO": "{\"sciServerId\":\"\"}",
        "WRITER_NAME": "Server",
        "WRITER_GROUP_NAME": "Server",
        "ENC_TYPE": "",
        "DOCUMENT_GRADE": "",
        "WRITER_ID": "Server",
        "DOC_PARENT_BRANCH_UID": "",
        "DOC_UID": "",
        "CREATE_TIME": "2025-04-11 06:57",
        "SERVER_NAME": "SCI 테스트 서버",
        "DOCUMENT_TYPE": ""
    },
    "Normal_Doc_Size": 3166469
}

• MAC 문서 헤더 정보 샘플

{
    "Custom_Type": 0,
    "errcode": 0,
    "Document_ID": "[48, 48, 48, 48, 48, 48, 51, 0, 0, 0, 0, 0, 0, 0, 0, 0]",
    "Server_ID_Hash": "[-107, 25, -70, 18, -67, 81, 52, 2, -51, 110, 64, -92, -46, -20, 35, 66, 50, -3, 11, 70]",
    "CREATE_PLACE": "",
    "Encrypted_Header_Size": 944,
    "Header_Hash": "[-65, -67, -3, 82, -3, 59, 106, 84, -30, 87, -30, 90, 60, 28, -59, 126, 104, 112, 79, 81]",
    "Document_Type": 1,
    "Algorithm": "AES",
    "DESC": "SCDSA004",
    "MAC": {
        "MAC_CATEGORY_NAME": "비밀",
        "MAC_CATEGORY": "0000003"
    },
    "Create_Place": 1,
    "SFI": {
        "DOC_BRANCH_UID": "66Wf44K*C0x6CuuPpOe6lmrmkI8r64yZ",
        "CREATE_PATH": "Server/테스트.pptx",
        "VERIFICATION_DATA": "",
        "SERVER_ID": "SCAM-ED72-262C-433A-0004",
        "WRITER_GROUP_HIERARCHY": "",
        "EXTRA_INFO": "{\"sciServerId\":\"\"}",
        "WRITER_NAME": "Server",
        "WRITER_GROUP_NAME": "Server",
        "ENC_TYPE": "",
        "DOCUMENT_GRADE": "",
        "WRITER_ID": "Server",
        "DOC_PARENT_BRANCH_UID": "",
        "DOC_UID": "",
        "CREATE_TIME": "2025-04-11 06:58",
        "SERVER_NAME": "SCI 테스트 서버",
        "DOCUMENT_TYPE": ""
    },
    "Normal_Doc_Size": 3166469
}

• GRADE 문서 헤더 정보 샘플

{
    "Custom_Type": 0,
    "errcode": 0,
    "Document_ID": "[48, 48, 48, 48, 48, 48, 52, 0, 0, 0, 0, 0, 0, 0, 0, 0]",
    "Server_ID_Hash": "[-107, 25, -70, 18, -67, 81, 52, 2, -51, 110, 64, -92, -46, -20, 35, 66, 50, -3, 11, 70]",
    "CREATE_PLACE": "Server",
    "DAC": [
        {
            "DAC_PRINT_MARKING": "1",
            "DAC_PRINT_NUM_LIMIT": "",
            "DAC_GRADE_ACCESS_CLASS_ID": "",
            "DAC_TYPE_NAME": "SECURITYDOMAIN",
            "DAC_TYPE": "1",
            "DAC_READ_NUM_LIMIT": "",
            "DAC_DECRYPT": "0",
            "DAC_SUBGROUP_EXCLUDE": "",
            "DAC_PRINT": "1",
            "DAC_GRADE_ACCESS_USER_ID_EXCLUDE": "",
            "DAC_AUTO_DESTROY": "0",
            "DAC_READ": "1",
            "DAC_EXPIRE_DATE": "",
            "DAC_TYPE_ID": "securitydomain",
            "DAC_EDIT": "1",
            "DAC_SOM": "0",
            "DAC_GRADE_ACCESS_GROUP_ID": "",
            "DAC_GRADE_ACCESS_USER_ID_INCLUDE": "",
            "DAC_CHANGE_AUTH": "0"
        },
        {
            "DAC_PRINT_MARKING": "1",
            "DAC_PRINT_NUM_LIMIT": "",
            "DAC_GRADE_ACCESS_CLASS_ID": "",
            "DAC_TYPE_NAME": "test",
            "DAC_TYPE": "0",
            "DAC_READ_NUM_LIMIT": "",
            "DAC_DECRYPT": "0",
            "DAC_SUBGROUP_EXCLUDE": "",
            "DAC_PRINT": "1",
            "DAC_GRADE_ACCESS_USER_ID_EXCLUDE": "",
            "DAC_AUTO_DESTROY": "0",
            "DAC_READ": "1",
            "DAC_EXPIRE_DATE": "",
            "DAC_TYPE_ID": "test",
            "DAC_EDIT": "1",
            "DAC_SOM": "0",
            "DAC_GRADE_ACCESS_GROUP_ID": "",
            "DAC_GRADE_ACCESS_USER_ID_INCLUDE": "",
            "DAC_CHANGE_AUTH": "0"
        },
        {
            "DAC_PRINT_MARKING": "0",
            "DAC_PRINT_NUM_LIMIT": "",
            "DAC_GRADE_ACCESS_CLASS_ID": "0000001;",
            "DAC_TYPE_NAME": "비밀등급",
            "DAC_TYPE": "2",
            "DAC_READ_NUM_LIMIT": "",
            "DAC_DECRYPT": "0",
            "DAC_SUBGROUP_EXCLUDE": "",
            "DAC_PRINT": "0",
            "DAC_GRADE_ACCESS_USER_ID_EXCLUDE": "",
            "DAC_AUTO_DESTROY": "0",
            "DAC_READ": "1",
            "DAC_EXPIRE_DATE": "",
            "DAC_TYPE_ID": "0000004",
            "DAC_EDIT": "0",
            "DAC_SOM": "0",
            "DAC_GRADE_ACCESS_GROUP_ID": "SECURITYDOMAIN",
            "DAC_GRADE_ACCESS_USER_ID_INCLUDE": "SECURITYDOMAIN",
            "DAC_CHANGE_AUTH": "0"
        },
        {
            "DAC_PRINT_MARKING": "0",
            "DAC_PRINT_NUM_LIMIT": "",
            "DAC_GRADE_ACCESS_CLASS_ID": "0000001;",
            "DAC_TYPE_NAME": "비밀등급",
            "DAC_TYPE": "7",
            "DAC_READ_NUM_LIMIT": "",
            "DAC_DECRYPT": "0",
            "DAC_SUBGROUP_EXCLUDE": "",
            "DAC_PRINT": "0",
            "DAC_GRADE_ACCESS_USER_ID_EXCLUDE": "",
            "DAC_AUTO_DESTROY": "0",
            "DAC_READ": "0",
            "DAC_EXPIRE_DATE": "",
            "DAC_TYPE_ID": "0000004",
            "DAC_EDIT": "0",
            "DAC_SOM": "0",
            "DAC_GRADE_ACCESS_GROUP_ID": "SECURITYDOMAIN",
            "DAC_GRADE_ACCESS_USER_ID_INCLUDE": "SECURITYDOMAIN",
            "DAC_CHANGE_AUTH": "0"
        }
    ],
    "Encrypted_Header_Size": 2288,
    "Header_Hash": "[-106, -104, -84, 98, -48, 14, 58, 127, -23, -66, -115, -84, -99, -17, -50, -35, -118, 79, -81, 49]",
    "Document_Type": 4,
    "Algorithm": "AES",
    "DESC": "SCDSA004",
    "Create_Place": 1,
    "SFI": {
        "DOC_BRANCH_UID": "77*9eGLvv71d65Si77*9DOyolGfnjq3q",
        "CREATE_PATH": "Server/테스트.pptx",
        "VERIFICATION_DATA": "",
        "SERVER_ID": "SCAM-ED72-262C-433A-0004",
        "WRITER_GROUP_HIERARCHY": "",
        "EXTRA_INFO": "{\"sciServerId\":\"\"}",
        "WRITER_NAME": "Server",
        "WRITER_GROUP_NAME": "Server",
        "ENC_TYPE": "",
        "DOCUMENT_GRADE": "0000004",
        "WRITER_ID": "SECURITYDOMAIN",
        "DOC_PARENT_BRANCH_UID": "",
        "DOC_UID": "",
        "CREATE_TIME": "2025-04-11 06:57",
        "SERVER_NAME": "SCI 테스트 서버",
        "DOCUMENT_TYPE": "none"
    },
    "Normal_Doc_Size": 3166469
}

• 일반 문서인 경우

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

• 실패

• Status code : 401 UNAUTHORIZED

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

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

• 이외의 코드는 scsl.jar errorCode 정의 확인 필요