변환
기능 상세
자료 접근에 일부 제한이 있음을 알려드립니다.
파일 변환 기능에 대한 상세 내용은 다음 에서 확인 하실 수 있습니다.
파일/폴더에 대한 우클릭 메뉴
1. 단일 파일 선택 시
| 사용자 화면 | 내용 | 비고 |
|---|---|---|
![]() | 단일 보안문서 우클릭 | MIP문서로 변환 매뉴 추가 |
![]() | 단일 MIP문서 우클릭 | MIP레이블 삭제 매뉴 추가 |
2. 다중 파일/폴더 선택 시
| 사용자 화면 | 내용 | 비고 |
|---|---|---|
![]() | 다중 폴더/파일 우클릭 | 커스텀 정책(DS_MIP_SHELL_MENU)설정 |
3. 우클릭 메뉴 실행 화면
| 사용자 화면 | 내용 | 비고 |
|---|---|---|
![]() | MIP 레이블 생성 | 대상문서 : 일반문서 MIP, 보안문서, 패스워드 설정된 일반문서는 변환 목록에서 제외 ZTCAP 정책에 따라 지정된 MIP 레이블 문서로 변환 통합 로그 : 사용 SCI 로그 : 미사용 |
![]() | MIP 레이블 삭제 | 대상문서 : MIP 일반, 보안문서는 변환 목록에서 제외 커스텀 정책 DS_MIP_SHELL_MENU:SHELL_AIP_DELETE 설정 시 매뉴 추가 통합 로그 : 사용 SCI 로그 : 미사용 |
![]() | MIP 문서로 변환 | 대상문서 : 보안문서 MIP, 일반문서는 변환 목록에서 제외 ZTCAP 정책에 따라 지정된 MIP 레이블 문서로 변환 통합 로그 : 사용 SCI 로그 : 미사용(원본 보안문서의 해제 로그 미전송) |
![]() | DRM 문서로 변환 | 대상문서 : MIP 문서 일반, 보안문서는 변환 목록에서 제외 ZTCAP 정책에 따라 지정된 보안문서로 변환 통합 로그 : 사용 SCI 로그 : 사용(변환 된 보안문서 생성 로그 전송) |
4. 항목 별 우클릭 메뉴
참고
정책 세팅에 따라 일부 항목이 상이할 수 있습니다.
| 구분 | 상세 |
|---|---|
| 일반 문서 | •MIP 생성 └ MIP, 보안문서, 패스워드 설정된 일반문서는 변환 목록에서 제외 • 일반 문서 암호화 |
| DRM 문서 | •MIP 문서로 변환 └ MIP, 일반문서는 변환 목록에서 제외 • 보안 문서 파기 • 보안문서 암호화 해제 • 접근 대상 변경 • 외부전송 보안파일 생성 |
| MIP 문서 | •DRM 문서로 변환 └ 일반, 보안문서는 변환 목록에서 제외 • MIP 레이블 삭제 └ 일반, 보안문서는 변환 목록에서 제외 • 일반 문서 암호화 |
| 다중 파일 (Multi-Select) | •MIP 레이블 생성 └ 일반문서만 변환 목록에 해당 • MIP 레이블 삭제 └ MIP 문서만 변환 목록에 해당 • DRM 문서로 변환 └ MIP 문서가 변환 목록에 해당 • MIP 문서로 변환 └ DRM 문서가 변환 목록에 해당 └ MIP, 일반문서는 변환 목록에서 제외 • 일반문서 암호화 |
| 폴더 (Folder) | •MIP 레이블 생성 └ 일반문서만 변환 목록에 해당 • MIP 레이블 삭제 └ MIP 문서만 변환 목록에 해당 • DRM 문서로 변환 └ MIP 문서가 변환 목록에 해당 • MIP 문서로 변환 └ DRM 문서가 변환 목록에 해당 • 폴더 내 파일 암호화 └ 암호화 지원 확장자 (Localset) • 폴더 내 파일 복호화 • 폴더 내 파일 단순 암호화 └ 암호화 미지원 확장자 (Localset) |
5. (구) 우클릭 메뉴 실행 화면
C:\Windows\Softcamp\Security365\DS365\x64\ 경로에 DS365Agent64.exe 파일이 없을 경우 동작
| 사용자 화면 | 내용 | 비고 |
|---|---|---|
![]() | AIP 레이블 생성 | 대상문서 : 일반문서 ZTCAP 정책에 따라 지정된 AIP 레이블 문서로 변환 통합 로그 : 사용 SCI 로그 : 미사용 |
![]() | AIP 레이블 삭제 | 대상문서 : AIP 문서 커스텀 정책 DS_MIP_SHELL_MENU:SHELL_AIP_DELETE 설정 시 매뉴 추가 통합 로그 : 사용 SCI 로그 : 미사용 |
![]() | AIP 문서로 변환 | 대상문서 : 보안문서 ZTCAP 정책에 따라 지정된 AIP 레이블 문서로 변환 통합 로그 : 사용 SCI 로그 : 미사용(원본 보안문서의 해제 로그 미전송) |
![]() | DRM 문서로 변환 | 대상문서 : AIP 문서 ZTCAP 정책에 따라 지정된 보안문서로 변환 통합 로그 : 사용 SCI 로그 : 사용(변환 된 보안문서 생성 로그 전송) |
MIP 문서 변환 시 소유주 유지 기능
MIP 문서가 DRM문서로 변환 후 다시 MIP문서로 변환 시 처음 MIP문서의 Owner Id가 유지되는 기능
1. 개요
로컬에서 A사용자가 생성하여 소유자 권한이 있는 MIP 문서에서 DRM 변환 후 B사용자가 해당 문서를 MIP 변환할 경우 최종 문서는 B 사용자에게 소유자 권한이 있는 MIP 문서로 변환됨
해당 문서를 궁극적으로 다수 변환하더라도 A사용자가 소유자 권한을 갖도록 하는 기능
2. 흐름도
3. 기타 및 제약사항
- MIP 문서의 사용자 ownerId 정보는 MIP 해제시에는 유지되지 않습니다. DRM문서로 변환시면 정보가 연계됩니다.
- ownerId 정보는 DRM 문서 헤더 VFI에 들어가며 ( DSBSDT_VFI_MIP_OWNER_ID ) SDSWizard - 6.0.0.13 이상 버전에서 보안문서 헤더 기능에서 확인 가능합니다.
- 현재 DS 6.0에서 문서 변환은 사용자 토큰이 아닌 ssevtr app이 발급 받은 access Token을 사용하며, 해당 앱이 InformationProtectionPolicy.Read.All 권한이 Microsoft Entra ID에서 설정이되어있어야 합니다. 해당 설정이 정상적으로 적용되어있어야 ownerId 유지 기능이 정상적으로 동작합니다.
클라우드 다운로드 문서 변환
클라우드 저장소에서 다운로드 받은 문서에 대한 변환 기능을 수행합니다.
- 대상이 되는 클라우드 저장소는 Ztcap 정책의
zoneIdentifierURL 목록으로 결정 됩니다. 기본 포함 대상은 OneDrive · SharePoint · Teams 이며, Google Drive 는 3-3 항을 참고하십시오. - 변환 방식에 대한 정의는 Ztcap 정책에 따릅니다.
1.개요
- 클라우드 저장소(OneDrive, SharePoint, Teams, Google Drive)에서 다운로드 받은 문서에 대한 변환 기능을 제공합니다.
- 변환에 대한 정책은 Ztcap 정책에 따릅니다.
본 기능은 브라우저·Teams 앱의 다운로드 시점을 ZoneIdentifier(MoTW) 기록 후킹으로 감지하며(DownloadFile_FromCloud 이벤트), OneDrive/SharePoint 싱크 폴더와 Google Drive 가상 드라이브의 파일 복사를 처리하는 통제 카테고리의 ‘외부 저장소 다운로드 시’(CopyFileFrom_OneDrive / CopyFileFrom_Sharepoint / CopyFileFrom_GoogleDrive)와는 트리거·경로가 다른 별개 기능입니다.
대상 클라우드 저장소는 정책이 결정합니다
클라이언트의 다운로드 감지는 특정 클라우드 도메인에 종속되지 않습니다. 다운로드 파일에 ZoneIdentifier 가 기록되는 시점을 후킹해 정책 질의를 수행하고, 어떤 클라우드 저장소를 변환 대상으로 볼지는 Ztcap 정책의 zoneIdentifier URL 목록이 결정합니다.
따라서 신규 클라우드 저장소 지원은 클라이언트 패치가 아니라 정책 URL 등록으로 이뤄집니다. Google Drive 역시 3-3 항의 절차로 URL 을 등록하면 동일하게 동작합니다.
2. 관련 커스텀 정책
해당 정책 값이 필수 적으로 필요합니다. 없는 경우 다운로드 시점을 감지 하지 못하여 다운로드 변환 기능이 동작하지 않을 수 있습니다.
HOOK_LOAD_DYNAMIC 커스텀 정책이 설정되어 있어야 브라우저·Teams 프로세스에 후킹 모듈이 로드되어 다운로드 시점을 감지할 수 있습니다. 모듈 인젝션 문자열 등 상세 정책값은 변환 상세 페이지에서 관리합니다.
3. Ztcap 정책 관련
3-1 기능 동작시 Endpoint에서 ztcap으로 질의되는 decisionFactors 예시
// 단일 문서(docx Mip문서) 다운로드시 문서에 대한 질의 json
{
"decisionFactors": [
{
"category": "document",
"target": {
"info": {
"ext": "docx",
"zoneIdentifier": "https://softcamp-my.sharepoint.com/personal/jaekwon_lee_softcamp_co_kr/_layouts/15/download.aspx?UniqueId=ed4e27ad%2Dda48%2D476b%2Da99a%2Dd517a54ad6db"
},
"type": "mip"
}
},
{
"category": "storage",
"target": {
"info": {
"folder": "%USERS%\\Downloads"
},
"type": "local"
}
},
{
"category": "fileEvent",
"target": {
"info": {
"event": "DownloadFile_FromCloud"
},
"type": "local"
}
}
]
}
// 여러문서 선택시 Zip파일에 대한 질의 json
{
"decisionFactors": [
{
"category": "document",
"target": {
"info": {
"ext": "zip",
...
"zoneIdentifier": "https://japaneast1-mediap.svc.ms/transform/zip?cs=fFNQTw"
},
"type": "zipArchive"
}
},
{
"category": "storage",
"target": {
"info": {
"folder": "%USERS%\\Downloads"
},
"type": "local"
}
},
{
"category": "fileEvent",
"target": {
"info": {
"event": "DownloadFile_FromCloud"
},
"type": "local"
}
}
]
}
3-2 ztcap 정책 설정시 주의 사항
⚠️정책 설정시 아래사항이 반드시 고려되어 Ztcap 정책이 설정되어야 기능이 동작합 니다.
-
decisionFactors중 category가 document인 json객체의 target.info.zoneIdentifier의 정책 설정이 필요합니다.
- decisionFactors중 category가 document인 json객체의 target.info.zoneIdentifier 의 정책값은 다운로드시 다운로드문서에 입력되는 ZoneIdentifier Url을 포함 할 수 있는 값이 설정되어야함.
- 예시 ) 다운로드 받은 문서의 Url이
https://japaneast1-mediap.svc.ms/transform/zip?cs=fFNQTw라 가정할때 Ztcap 정책에 설정 되어야 하는 decisionFactors중 category가 document인 json객체의 target.info.zoneIdentifier 의 정책값은 "*mediap.svc.ms/transform/zip*" 과 같이 Url의 일부분 앞뒤로 와일드카드(*)를 붙여 설정함.
-
decisionFactors중 category가 document인 json객체의 target.type 의 정책값은
"ds"가 들어가는 것을 권장하지 않음 ( 클라우드에 DRM 문서가 있다는 가정인데 이 기능은 기본적으로 클라우드의 일반 문서 및 mip문서를 DRM 문서로 변환하기 위한 기능 ) -
decisionFactors중 category가 fileEvent인 json객체의 target.info.event는 반드시 "DownloadFile_FromCloud" 값으로 설정
//Ztcap 정책 예시
"category": "document",
"targets": [
{
"type": "normal",
"use": true,
"operation": "AND",
"info": {
"ext": [
"pptx",
"zip",
"xlsx",
"pdf",
"ppt",
"doc",
"xls",
"docx"
],
"zoneIdentifier": [ // 다운로드 받은 문서의 zoneidentifier url이 정책에 포함되어야함
"*microsoftonline.com*",
"*sharepoint.com*",
"*mediap.svc.ms/transform/zip*"
]
}
}
....
{
"category": "fileEvent",
"targets": [
{
"type": "local",
"use": true,
"operation": "OR",
"info": {
"event": [
"DownloadFile_FromCloud" // 파일 이벤트는 DownloadFile_FromCloud가 설정되어야함함
]
}
}
]
}
3-3 ztcap 정책 설정시 기본 포함 정책
클라우드 저장소에서 문서 다운로드 시 문서 Zone.identifier에 들어간 URL 정보가 기본적으로 ztcap 정책에 포함되어야하며, 차후 고객사나 클라우드 쪽 변경사항에 따라 URL 정책의 추가가 필요할 수 있습니다.
Microsoft 365 (OneDrive · SharePoint · Teams)
- ztcap 정책의 아래의 URL 값이 정책으로 포함되어야합니다.
*mediap.svc.ms/transform/zip**sharepoint.com**microsoftonline.com*
Google Drive
Google Drive 의 기본 포함 URL 은 실측 확정 전입니다.
Google Drive 다운로드 시 문서에 기록되는 Zone.Identifier URL 값이 아직 확정되지 않았습니다. 아래 두 경우가 서로 다른 도메인을 남길 수 있으므로 양쪽 모두 확인해 정책에 등록해야 합니다.
- Drive 에 저장된 파일 본문의 다운로드
- Docs · Sheets · Slides 의 Office · PDF 내보내기
확인은 아래 「클라우드 저장소 URL 정책 추가 방법」 절차를 그대로 사용합니다. 값이 확정되면 본 항의 기본 포함 목록으로 반영합니다.
클라우드 저장소 URL 정책 추가 방법
1단계 — 다운로드한 파일의 Zone.Identifier 파일 확인
# 명령 프롬프트(cmd)에서 확인
more < "filename:Zone.Identifier"
2단계 — Zone.Identifier 파일에서 확인된 URL 정보를 바탕으로 정책 추가
ReferrerUrl또는HostUrl필드의 값을 확인합니다.- URL 의 도메인 부분을 정책에 추가합니다. 정책 추가 시 자동으로 도메인 앞뒤에 와일드카드(*)가 붙어 등록됩니다.
- 예시 —
https://example-cloud.com/download→example-cloud.com입력 →*example-cloud.com*적용 후 추가 완료
4. 적용 방법
- 모듈 패치
- Ztcap 정책 설정 ( 3. Ztcap 정책 관련 항목 적용 필수 )
- 커스텀 정책 설정
5. 제약사항
- 브라우저의 시크릿 창 이용 시 지원되지 않습니다.
- 사유 : 시크릿 창에서는 브라우저가 ZoneIdentifier 영역에 다운로드 받은 Url정보를 남기지 않음. 따라서 다운로드 url을 기반으로 동작하는 조건부 정책상 다운로드 변환 정책이 동작 할 수 없기 때문에 시크릿 모드에서는 다운로드 변환기능이 지원이 안됨.
- 본 제약은 Google Drive 를 포함한 모든 클라우드 저장소에 동일하게 적용됩니다.
- Ztcap 정책의
zoneIdentifier목록에 URL 이 등록되지 않은 클라우드 저장소는 다운로드 변환이 동작하지 않습니다.
- 클라이언트는 다운로드 시점만 감지하고 대상 클라우드 판별은 정책이 수행하므로, 신규 클라우드 저장소 지원은 정책 URL 등록으로 이뤄집니다 (3-3 항 참조).
- Google Drive 는 기본 포함 URL 이 실측 확정 전이므로, 확정 전까지는 고객 환경에서 확인한 URL 을 직접 등록해야 동작합니다.
- 훅 방식으로 다운로드 시점을 잡아 개발된 기능이라 아래 지원 버전 외의 브라우저나 그 이상의 브라우저에서 zoneidentifier 정보를 write하는 로직이 변경시 기능 동작이 되지 않을 수 있습니다.
| 프로그램 | 버전 |
|---|---|
| Msedge | |
| Chrome | ![]() |
| TeamsApp | ![]() |
- 윈도우 및 문서보안 커스텀 정책 설정
- ZoneIdentifier 사용 On/Off 윈도우 설정(레지스트리)은 다음과 같이 설정되어야 합니다.
- 레지스트리 경로 : HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Policies\Attachments
- 레지스트리 값 : SaveZoneInformation : 2 (또는 해당 항목이 없어야 다운로드 시 문서변환 기능 동작 함)
| SaveZoneInformation 값 | Zone Identifier (MoTW) 저장 여부 | 보안 경고 표시 여부 (일반적으로) |
|---|---|---|
| 1 (Enabled) | 저장하지 않음 | 표시되지 않음 |
| 2 (Disabled/Not Configured) | 저장함 | 표시됨 |
- 문서보안 커스텀 정책
- DS_NOT_USE_SENDLOG_ZONE_IDF 커스텀 정책 0 또는 정책 미사용(제거)
- 위 커스텀 정책이 1로 설정되어 있을 경우 다운로드 되는 문서 파일에 ZoneIdentifier 등록되지 않습니다. (SaveZoneInformation : 1 설정함)
- 클라우드 다운로드 문서변환 기능은 ZoneIdentifier 등록 시점의 hooking 으로 동작합니다.
- DS_NOT_USE_SENDLOG_ZONE_IDF 커스텀 정책 0 또는 정책 미사용(제거)
변환 실패 시 실패 사유 상세 확인
1. 개요
문서 변환 작업 수행 시 정책에 의해 차단된 문서에 대하여, 사용자가 어떤 정책의 어떤 사유로 변환이 실패하였는지 직접 확인할 수 있는 기능입니다.
기존에는 변환 실패 시 단순 실패 메시지만 표시되어 사용자가 원인을 파악하기 어려웠으나, 본 기능을 통해 정책별 평가 결과와 한글화된 사유를 제공함으로써 사용자의 자가 진단이 가능하도록 합니다.
2. 동작 흐름
- 사용자가 문서 변환 작업을 실행합니다.
- 변환이 완료되면 변환 결과 리스트에 문서 별 성공/실패 상태가 표시됩니다.
- 실패 문서에 노출된 [상세 보기] 버튼을 클릭하면 실패 사유 상세 모달이 표시됩니다.
- 모달에서 해당 문서에 적용된 정책의 평가 결과를 우선순위 순으로 확인할 수 있습니다.
3. 변환 결과 리스트
변환 작업 수행 후 결과 리스트에서 각 문서별 성공/실패 상태를 시각적으로 구분하여 표시합니다.
| 사용자 화면 | 내용 | 비고 |
|---|---|---|
![]() | 실패 항목 우측에 [상세 보기] 버튼 노출 | 정책 기반 실패 항목에 한정 |
4. 실패 사유 상세 모달
실패 문서의 [상세 보기] 버튼 클릭 시, 해당 문서에 대한 정책 평가 결과를 확인할 수 있는 모달이 표시됩니다.
4.1 정책 목록
- 해당 문서에 적용된 정책 목록을 우선순위(priority) 순으로 정렬하여 표시합니다.
- 각 정책은 기본 접힌 상태로 표시되며, 클릭 시 펼쳐져 상세 평가 결과를 확인할 수 있습니다.
- 실제로 변환 결과를 결정한 정책은 사용자가 식별할 수 있도록 별도 강조 표시됩니다.
4.2 정책별 평가 결과
각 정책 항목을 펼쳤을 때, 다음 항목의 평가 결과가 단계별로 표시됩니다.
| 평가 항목 | 설명 |
|---|---|
| 조건 (Condition) | 정책이 적용되기 위한 조건(파일 확장자, 경로, 사용자, 그룹 등)의 매칭 여부 |
| 제외 조건 (Excluded Condition) | 해당 정책의 적용에서 제외되는 조건의 매칭 여부 |
| 결정 팩터 (Decision Factor) | 정책이 최종적으로 적용 또는 차단을 결정한 요소 (예: 라벨, 분류 결과 등) |
4.3 매칭 사유(matchReason) 유형별 표시
정책 평가 결과로 반환되는 매칭 사유 유형에 따라 사용자에게 명확한 안내를 제공하도록 UI를 분기하여 표시합니다.
문서 종료 시 변환 진행 안내
1. 개요
문서 종료 시점에 등급 적용과 문서 변환이 함께 수행되는 구조에서, 다수 파일(약 10개 수준)이 동시에 종료되면 작업이 한꺼번에 들어와 순차적으로 처리됩니다(하나가 진행되는 동안 나머지는 대기). 등급 설정 유무와 무관하게 변환만으로도 다수 작업이 몰릴 수 있습니다.
본 기능은 이 시점에 사용자에게 어떤 파일이 처리 중이고 어디까지 진행됐는지 를 별도 알림 창으로 안내하여, 처리 중 사용자가 다른 작업을 시도하거나 임의 종료하지 않도록 가시화합니다.
2. 기능 요약
사용자 작업 프로세스(Office 등)를 종료하면 변환 진행 안내 창이 자동으로 표시됩니다.
- 안내 창 구성
- 제목: 진행 중 / 완료 두 상태로 동적 전환
- 대상 파일 목록: 파일 1행 = 1문서. 파일 형식 아이콘 + 파일명 + 상태 Badge
- 상태 Badge: 변환 중(스피너) / 성공(녹색 체크) / 실패(빨강 느낌표) 3종
- 안내 문구: 진행 중에는 "변환 중에는 프로그램 실행과 문서 열기가 일시적으로 제한됩니다" 안내. 실패 항목이 있는 경우 별도 안내 문구 표시
- 도움말 링크: "도움이 필요하세요?" 버튼 — 관리자가 구성한 외부 URL 열기
- 확인 버튼: 진행 중에는 비활성화 → 모든 작업 완료 시 활성화 + 5초 후 자동 닫힘
- 다국어 6개국 지원 (KOR / ENG / JPN / CHN / DEU / RUS)
- 다중 PID 동시 종료 시에도 단일 호스트 창에 모든 항목 누적 (별도 창 다발 방지)
- 모든 작업 완료 신호가 일정 시간 동안 도달하지 않으면 안내 창이 자체적으로 완료 상태로 전환되어 자동 닫힙니다 (영구 표시 방지)
3. 동작 흐름
- 사용자가 Office 등 작업 프로세스의 마지막 문서를 닫거나 프로세스를 종료
- 클라이언트가 종료를 감지하고 닫히는 문서 각각에 대해 조건부 정책 평가 시작
- 첫 번째 정책 평가 직전 — 안내 창 표시(이미 표시된 창이 있으면 항목 누적)
- 각 파일 처리 완료 시 — 해당 항목의 Badge 가 "변환 중" → "성공" 또는 "실패" 로 전환
- 닫는 프로세스의 모든 정책 처리 완료 시 — 안내 창 제목이 완료 상태로 변경, 확인 버튼 활성화
- 5초 후 — 안내 창 자동 닫힘 (사용자가 확인 버튼으로 직접 닫는 것도 허용)
4. 사용자 화면
| 상태 | 화면 |
|---|---|
| 변환 진행 중 | ![]() |
| 변환 완료 | ![]() |
진행 중에는 확인 버튼이 비활성화되어 작업 완료 전 사용자가 창을 닫을 수 없습니다. 모든 항목이 마감되면 확인 버튼이 활성화되고, 5초 후 자동으로 닫힙니다.
5. 리소스 정보 — DSRes*.ini 추가 키
6개국 리소스 파일에 공통으로 [DocCloseProgress] 섹션을 추가합니다. 각 키는 운영 환경의 시스템 로케일에 해당하는 INI 파일에서 우선 조회되며, 키가 비어 있거나 INI 가 구버전인 경우 안내 창은 영어 기본값으로 안전하게 폴백합니다.
| 키 | 용도 | 비고 |
|---|---|---|
TITLE_IN_PROGRESS | 안내 창 제목 — 진행 중 상태 | 예) "문서 종료 후 문서 변환 및 보안 등급 적용 중" |
TITLE_DONE | 안내 창 제목 — 완료 상태 | 예) "문서 변환 및 보안 등급 적용 완료" |
INFO_IN_PROGRESS | 진행 중 안내 문구 — 2문장 (\n 으로 구분) | 1문장: 프로그램 실행·문서 열기가 일시적으로 제한된다는 안내 / 2문장: 파일 수·크기에 따라 시간이 걸릴 수 있다는 안내 |
INFO_FAILED | 완료 시 실패 항목이 있을 때 노출되는 안내 문구 | 예) "실패한 파일이 있습니다. 잠시 후 다시 시도하거나 관리자에게 문의하세요." |
BUTTON_CONFIRM | 확인 버튼 라벨 | 예) "확인" |
BUTTON_HELP | 도움말 버튼 라벨 | 예) "도움이 필요하세요?" |
STAGE_CONVERTING | 항목 Badge — 변환 중 텍스트 | 예) "변환 중" |
STAGE_SUCCESS | 항목 Badge — 성공 텍스트 | 예) "성공" |
STAGE_FAILED | 항목 Badge — 실패 텍스트 | 예) "실패" |
HELP_URL | "도움이 필요하세요?" 버튼 클릭 시 열리는 외부 URL | 언어 무관. 관리자가 구성 |
- 키 누락 시: 해당 키만 영어 기본값으로 폴백 (그 외 키는 INI 값 사용)
- INI 자체가 구버전 (
[DocCloseProgress]섹션 자체 없음): 안내 창 전체가 영어 기본값으로 표시되며, 변환·정책 처리 동작 자체는 영향 없음
화이트 리스트 문서 변환
화이트 리스트 정책에 따라 1:1 매핑 방식으로 문서를 변환하는 기능입니다. DS 6.0 ENT의 appAuth 모드에서만 동작합니다.
1. 개요
운영자가 사전에 정의한 원본 → 대상 매핑 정책에 등록된 문서에 한해 변환을 허용합니다. 정책에 등록되지 않은 문서의 변환은 모두 차단됩니다. 변환 정책은 커스텀 정책으로 설정합니다.
2. 관련 커스텀 정책
| 항목 | 값 |
|---|---|
| ID | DS_MIP_DOC_CONV_WHITE_LIST |
| TYPE | EDIT |
| 정책값 형식 | TARGET_DOC_TYPE:ID|DEST_CONVERT_DOC:ID |
3. 정책 형식 설명
TARGET_DOC_TYPE— 원본 문서의 타입DEST_CONVERT_DOC— 변환 대상 문서의 타입ID— 문서 식별자 (MIP 라벨 ID, 등급 문서 ID, 범주 문서 ID 등)
4. 문서 타입 (Type)
| 타입 | 설명 |
|---|---|
MIP | MIP 라벨이 지정된 문서 |
MAC | 범주(MAC) 문서 |
GRADE | 등급이 지정된 문서 |
DAC | 개인 문서 (ID 생략 가능 — 로그인 사용자의 개인 문서로 변환) |
5. 정책 예시
예시 1 — ABCD 라벨 ID를 갖는 MIP 문서를 등급 문서 ID GRADEID0001 로만 변환 허용:
MIP:ABCD|GRADE:GRADEID0001
예시 2 — 범주 문서 ID MAC000002 를 MIP 라벨 ID EFGH 로만 변환 허용:
MAC:MAC000002|MIP:EFGH
예시 3 — 두 정책 동시 적용 (세미콜론 ; 으로 구분):
MIP:ABCD|GRADE:GRADEID0001;MAC:MAC000002|MIP:EFGH
6. 제약 사항
- WhiteList 방식이므로 정책에 등록되지 않은 모든 문서의 변환은 차단됩니다.
- DS 6.0 ENT에서 개인·등급·범주 문서로 직접 변환할 때 Linker 기능이 사용되어, 변환된 문서가 Linker 문서 아이콘으로 표시될 수 있습니다.
Teams 코파일럿 탭 이용한 파일 업로드 시 Endpoint 사전 변환
1. 개요
Microsoft Teams 데스크톱 앱의 Copilot 탭에 사용자가 보안 문서를 파일 업로드 / 드래그 앤 드롭 / 붙여넣기 방식으로 첨부할 때, 사용자의 PC(Endpoint) 측에서 사전에 변환한 뒤 Teams 로 전달하는 기능입니다.
1-1. 본 기능이 필요한 이유
본 기능은 기본적으로 Teams Copilot 의 프롬프트가 DRM 보안 문서의 내용을 직접 읽을 수 없다는 제약을 해결하기 위해 개발되었습니다. DRM 보안 문서를 Copilot 탭에 첨부하면 Copilot 이 문서 내용을 인식하지 못해 답변이 깨지거나 질의가 실패합니다.
이를 회피하기 위해 본 기능은 사용자가 Copilot 탭에 보안 문서를 첨부하는 시점에 Teams 가 클라우드로 보내기 직전, 사용자 PC 에서 Copilot 이 읽을 수 있는 형식으로 사전 변환합니다. 동시에 변환 지연으로 발생하던 다음 두 가지 문제도 함께 해결됩니다.
- 클라우드 측 변환 지연으로 인한 Copilot 질의 오류
- 변환이 완료되기 전 Copilot 이 보안 문서의 내용을 부분적으로 읽어 답변이 깨지는 현상
1-2. 변환 방향은 조건부 정책으로 자유롭게 설정 가능
본 기능의 변환 방향은 고정되어 있지 않습니다. 운영자가 ZTCAP 조건부 정책을 어떻게 구성하느냐에 따라 자유롭게 결정할 수 있습니다.
- 표준 시나리오 — DRM → MIP 변환: Copilot 이 직접 읽지 못하는 DRM 보안 문서를 MIP(Microsoft Information Protection) 라벨이 적용된 문서로 변환. 본 기능의 주된 사용 케이스.
- 예시 — MIP → DRM 변환: 운영 정책상 MIP 문서를 Copilot 에 첨부할 때 DRM 보안 문서로 다시 변환하여 전달하는 시나리오. ZTCAP 정책의 변환 방향 항목을 그렇게 구성하면 가능.
- 그 외 ZTCAP 이 지원하는 다른 변환 방향 (예: 일반 문서 → DRM 등) 도 동일한 정책 구성 방식으로 적용 가능합니다.
즉, 본 기능은 "Copilot 탭 첨부 시점에 Endpoint 에서 사전 변환을 수행" 하는 트리거·인프라 를 제공하며, 실제 변환 방향은 관리자가 ZTCAP 조건부 정책의 변환 방향 항목으로 자유롭게 결정합니다.
1-3. 다운로드 변환과의 관계
본 기능은 클라우드 다운로드 시 Endpoint 측에서 사전 변환을 수행하는 기존 클라우드 다운로드 문서변환 기능 의 업로드 방향 대칭판 이며, 동일한 조건부 정책(ZTCAP) 인프라와 SCRA·SCPD 모듈 구조를 재사용합니다.
📌 요약: Teams Copilot 탭에 보안 문서를 첨부하면, Teams 가 클라우드로 보내기 직전에 PC 에서 ZTCAP 조건부 정책에 따라 자동 변환한 결과만 업로드합니다. 표준 사용은 DRM → MIP 변환이며, 정책 구성에 따라 MIP → DRM 등 다른 방향도 가능합니다.
2. 관련 커스텀 정책
본 기능은 두 개의 커스텀 정책과 함께 동작합니다. 둘 모두 SHIELD DRM 관리자 페이지의 정책 관리 화면에서 설정합니다. HOOK_LOAD_DYNAMIC의 상세 정책값(모듈 인젝션 문자열)은 변환 상세에서 관리합니다.
2-1. DS_MIP_INIT.CopilotDocuConv — Copilot 탭·경로 식별 보강 정책 (선택)
본 기능은 출하 시점에 측정한 Teams Copilot 탭의 윈도우 캡션 패턴(Copilot | Microsoft Teams 등) 과 사용자 문서 경로 패턴(시스템 폴더 제외) 을 클라이언트 내부에 내장하고 있습니다. 다만 Teams 의 캡션이 향후 업데이트로 바뀌거나, 고객사가 특정 비표준 경로를 사용·차단해야 할 때 클라이언트 재배포 없이 정책만으로 보강할 수 있도록 본 정책을 도입했습니다.
| ID | DS_MIP_INIT (기존 정책의 CopilotDocuConv 키) |
|---|---|
| TYPE | JSON |
| 정책값 형식 | DS_MIP_INIT JSON 의 하위 객체로 CopilotDocuConv 추가 |
| 적용 방식 | Union (합집합) — 클라이언트 내장 fallback 값에 정책에 명시된 패턴이 추가됨. 운영자는 새로 추가할 패턴만 명시하면 됩니다 (fallback 을 복제할 필요 없음). |
정책 값 예시 (JSON):
{
"CopilotDocuConv": {
"captionPatterns": [
"Copilot | Microsoft Teams",
"Copilot 그룹 채팅 | Microsoft Teams"
],
"excludePathPatterns": [
"c:\\users\\public\\share-temp\\"
]
}
}
captionPatterns: Copilot 탭 활성 시 EnumWindows 가 발견해야 하는 윈도우 캡션 패턴 목록. 부분 매칭.excludePathPatterns: 사용자 문서 경로 중 본 변환에서 제외할 경로 prefix 목록. 시스템 폴더(c:\windows\/c:\program files) 는 항상 제외이며 정책으로 변경 불가.
📌 정책 미설정 시 동작: 클라이언트 내장 fallback 값만으로 정상 동작합니다. 본 정책은 캡션·경로 변경 대응이 필요할 때만 설정하면 됩니다.
⚠️ 한국어 패턴: 정책 데이터가 한국어를 포함하더라도 UTF-8 인코딩으로 정상 해석됩니다. 출하 시점에 ANSI(CP949) 인코딩 환경에서도 동작하도록 fallback 처리가 적용되어 있습니다.















