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	画像ビューアのサポート
9	int	Text Viewerのサポート
10	int	Use UI Version(1, 2(Defaule;DS4.0))
11	boolean	Use Unicode(true(Default), False)
12	string	同じPCでのみMACアドレスがオープン可能です。

プロパティ (dssom.properties 参照)

Name	Type	Description
DSKEYENCRYPT_KEY	string	SOM生成のための固定キー入力(EKDATA2)
...

decisionFactor データ説明表

Key	Required	Type	Description
userId	required	string	条件付きポリシーの構成員に該当する文書変換をリクエストしたユーザーID
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"
}