DRM-Broker 보호 템플릿 ID 마이그레이션 가이드

1. 개요 📖

DRM-Broker의 레이블 보호/해제 기능을 MIP 서비스에서 SDF로의 전환에 맞춰, 보호 템플릿 ID → 민감도 레이블 ID 자동 마이그레이션에 필요한 설정 및 절차, 상태 코드를 설명합니다.

항목	Scope	비고
token 접근 범위	PolicyInfo.ReadWrite	Add

기존 Key (Deprecated ❌)	신규 Key (사용 ✅)
Cloud_MIP_Label_Guid	Cloud_Sensitivity_Label_Guid
Cloud_MIP_Unprotect_Label_Guid	Cloud_Sensitivity_Unprotect_Label_Guid

⚠️ 중요: 기존 Key는 더 이상 사용되지 않으며, 신규 Key만 사용됩니다.

구분	동작 방식
기존 고객	서비스 시작 시 1회 자동 마이그레이션
신규 고객	마이그레이션 미지원, 신규 Key 사용

차단 조건	코드	설명
Cloud_MIP_Label_Guid 마이그레이션 실패	-5306	MIP 보호 기능을 수행할 수 없음
Cloud_MIP_Unprotect_Label_Guid 마이그레이션 실패 & 기존 값 존재 & Cloud_MIP_Unprotect_Policy = 1	-5307	공동편집 문서를 수정한 경우 지정된 레이블로 업데이트 수행 불가능

📚 참고: Cloud_MIP_Unprotect_Policy 및 Cloud_Sensitivity_Unprotect_Label_Guid의 상세 동작 방식은 MIP 정책에 따른 민감도레이블 적용 사양을 참조 바랍니다.

Enum Constant	Code 값	Code 설명	비고
GRAPH_API_TOKEN_ACQUISITION_FAILED	-5301	failed to acquire access token	Graph API AccessToken 발급 과정에서의 오류
SKIPPED_NO_LEGACY	-5302	no legacy value and no builtin sensitivity field	기존 Key가 null이며, 신규 Key가 존재하지 않음
SKIPPED_BUILTIN_SENSITIVITY_EXISTS	-5303	builtin sensitivity exists or not equal to legacy value	빌트인 프로파일에 신규 Key가 존재하고, 기존 Key와 다름
TEMPLATE_MATCH_FAILED	-5304	no sensitivity label found matching the protection template ID	Protection Template ID에 매핑되는 민감도 레이블 ID를 찾지 못함
BUILTIN_PROFILE_UPDATE_FAILED	-5305	migration fail - failed to update builtin profile with the migrated label ID	마이그레이션 이후 빌트인 프로파일 업데이트 실패
PROTECT_LABEL_MIGRATION_BLOCKED	-5306	mip protect block - protect label migration failed	Cloud_MIP_Label_Guid 마이그레이션 실패로 보호 기능을 수행할 수 없음
UNPROTECT_LABEL_MIGRATION_BLOCKED	-5307	unprotect block - unprotect label migration failed	Cloud_MIP_Unprotect_Policy가 1일 때 사용할 레이블 마이그레이션 상태가 비정상
UNEXPECTED_EXCEPTION	-5399	unexpected exception occurred during label migration	예기치 못한 예외