メインコンテンツまでスキップ

7) AIP ラベルの解除

AIPドキュメントを一般的なドキュメントに変換

API

MethodURL
POST/api/internal/unProtect

Request Header

NameRequiredDescription
Authorizationrequiredユーザー認証手段、JWT値
Authorization: Bearer {JWT}
参考 : JWT値は認証/認可サービスを通じて発行されます。

Request Body

NameRequiredTypeDescription
companyIdrequiredstring対象文書を使用する会社ID(会社別キー データ照会時に使用)
srcFilePathrequiredstring元のAIP文書のパス
- Azure OpenidTenantがないか、Actionの作成に失敗した場合、文書を一般文書と見なす
dstFilePathrequiredstring解除された一般文書のパス
extraInfooptionalstringJSON形式の追加情報入力(下記のextraInfoデータ説明表およびサンプルデータを参照)
extraInfo データ説明表
KeyRequiredTypeDescription
sourcerequiredjson
namerequiredstring呼び出しシステム名
fromrequiredstring呼び出しシステムURL
userjson
idstringユーザーID
namestringユーザー名
departstringユーザー全体部門 (上位グループ/中位グループ/下位グループ)
dutystringユーザー職名
  • サンプルデータ
{
"source": {
"name": "EKMS",
"from": "https://devekms.softcamp.co.kr"
},
"user": {
"id": "ekmsTest@softcamp.co.kr",
"name": "ekmsTest",
"depart": "임직원/연구소/개발실/개발1팀",
"duty": "과장"
}
}

Response

NameTypeDescription
codeint0 : 成功
0以外の値 : エラー
messagestring"OK" : 成功
その他の値 エラーメッセージ

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

  • 成功
{
"code": 0,
"message" : "OK"
}
  • 失敗
  • 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\"}"
}