15) SOM 파일 생성

SOM 파일 생성

API

Method	URL
POST	/api/som/createFile

Request Body

Name	Required	Type	Description
licenseKey	required	string	SHIELDRM 관리자 페이지의 연동 앱 관리 메뉴에서 발급 받은 라이선스 입력
srcFilePath	required	string	원본파일 절대 경로 - DS 보안 문서는 som 파일 생성을 지원하지 않음 - 해당 문서가 som 파일인 경우 파일 복사 후 성공 리턴
dstFilePath	required	string	생성될 외부전송 보안파일 절대경로 - 파일 확장자명은 exe로 표기하여야 함
somSetRights	required	arrayString	SLSomFileLinker.DSSOMSetRights() 함수로 설정한 권한
properties	required	json	dssom.properties로 설정한 옵션
decisionFactor	optional	json	등록된 조건부 정책 적용을 위한 추가 정보 입력 (아래의 decisionFactor 데이터 설명표 및 샘플 데이터 참고)

somSetRights

index	Type	Description
0	string	패스워드 문자열 - 패스워드는 영문과 숫자로만 가능
1	int	다른 이름 저장 권한
2	int	프린트 권한
3	int	읽기 횟수
4	int	프린트 횟수
5	int	파기 권한
6	int	유효기간
7	int	OLESOM Viewer 지원
8	int	Image Viewer 지원
9	int	Text Viewer 지원
10	int	Use UI Version(1, 2(Defaule;DS4.0))
11	boolean	Use Unicode(true(Default), False)
12	string	MAC address 가 같은 pc에서만 오픈 가능

properties (dssom.properties 참고)

Name	Type	Description
DSKEYENCRYPT_KEY	string	SOM 생성을 위한 고정키 입력(EKDATA2)
...

decisionFactor 데이터 설명표

Key	Required	Type	Description
userId	required	string	조건부 정책의 구성원에 해당하는 문서 변환을 요청한 사용자 아이디
ipAddress	required	string	조건부 정책의 위치(IP)에 해당하는 문서 변환을 요청한 사용자 IP

• 샘플 데이터

{
  "userId": "user1@socam.info",
  "ipAddress": "10.10.10.100"
}

Response

Name	Type	Description
code	int	0 : 성공 이외의 값 : 에러
message	string	실패 시 에러 메시지

Examples

Request

• Body

{
  "licenseKey": "EFB4-19136-DB9E-201B9",
  "srcFilePath": "D:\\opt\\shieldrm\\data\\test\\test.pptx",
  "dstFilePath": "D:\\opt\\shieldrm\\data\\test\\test.exe",
  "somSetRights": "[\"1111\",1,1,2,0,1,1,1,0,0,2,true,\"10-FF-E0-7F-06-C6\"]",
  "properties": "{\"SiteInfo\":\"\",\"DocUIDWithoutMAC\":0,\"DSKEYENCRYPT_KEY\":\"EhH9NMxViK0XFXho/DEZZg==\",\"useDSvFive\":0,\"useAutoGenDocUID\":1,\"useHashDispersed\":1,\"LimitPwdFail\":0}",
  "decisionFactor": "{\"userId\":\"user1@socam.info\",\"ipAddress\":\"10.10.10.100\"}"
}

Response

• 성공

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

• 실패

• Status code : 500 INTERNAL_SERVER_ERROR

[SDF 컨테이너 모듈(SCSL) 에러]
{
  "code": -61,
  "message": "EXCEPTION error"
}