이 문서에서는 알려진 문제, 일반적인 오류 및 MIP(Microsoft Information Protection) SDK를 사용하는 애플리케이션에 권장되는 수정 사항을 설명합니다. SDK에 대한 일반적인 질문은 MIP SDK FAQ를 참조하세요.
웹앱 초기화
문제: 웹 애플리케이션을 초기화 InternalError: 'KeyStoreWin32::OpenKey failure: NCryptOpenKey:-2147024894'하지 못하는 이유는 무엇인가요?
정책 SDK는 앱 초기화 중에 프로필을 로드하지 못할 수 있습니다. 웹 앱의 환경 변수 설정에서 WEBSITE_LOAD_USER_PROFILE=1을(를) 설정하고 애플리케이션을 다시 시작하세요.
- 이름: WEBSITE_LOAD_USER_PROFILE
- 값: 1
문제: OnDiskEncrypted 캐싱이 구성된 경우 애플리케이션이 실패 KeyStoreWin32::OpenKey failure: NCryptOpenKey:-2146893788 하는 이유는 무엇인가요?
Windows 로그인 프로필을 사용할 수 없는 경우 임시 프로필을 만들 수 있습니다. 이 임시 프로필을 사용하여 OnDiskEncrypted 캐싱에 대한 Windows 레지스트리를 읽으면 MIP SDK 로그에서 OpenKey 오류가 발생하고 Windows 운영 체제 이벤트 로그는 이를 이벤트 ID 1511 및 1515로 캡처합니다. 이 문제를 해결하려면 관리자에게 문의하여 기본 임시 프로필 문제를 해결합니다.
오류: "파일 형식이 지원되지 않음"
문제: PDF 파일을 보호하거나 레이블을 지정하려고 할 때 다음 오류가 발생하는 이유는 무엇인가요?
파일 형식이 지원되지 않음
이 예외는 디지털 서명 또는 암호로 보호된 PDF 파일을 보호하거나 레이블을 지정하려고 시도하여 발생합니다. PDF 파일 보호 및 레이블 지정에 대한 자세한 내용은 Microsoft Information Protection 사용하여 PDF 암호화에 대한 새로운 지원을 참조하세요.
오류: "NoPolicyException: 레이블 정책에 데이터가 포함되지 않았습니다."
문제: MIP SDK를 사용하여 레이블 또는 목록 레이블을 읽으려고 할 때 다음 오류가 발생하는 이유는 무엇인가요?
NoPolicyException: 레이블 정책에 데이터가 포함되어 있지 않음, CorrelationId=GUID, CorrelationId.Description=PolicyProfile, NoPolicyError.Category=SyncFile, NoPolicyError.Category=SyncFile
이 오류는 레이블 정책이 Microsoft Purview 포털에 게시되지 않음을 나타냅니다. 레이블링 정책을 구성하려면 민감도 레이블 및 해당 정책 만들기 및 구성을(를) 따르세요.
레이블 지정 정책이 게시된 경우 사용자 계정이 레이블 정책 구성의 게시된 섹션에 포함된 그룹에 포함되어 있는지 확인합니다. 자세한 내용은 민감도 레이블 만들기 및 게시를 참조하세요.
게스트 사용자를 포함한 외부 사용자는 다른 조직의 레이블 정책에 액세스할 수 없습니다. 이러한 사용자를 수용하려면 재시도 메커니즘을 구현합니다.
NoPolicyException이 발생하면 ProtectionOnlyEngine 속성 true을(를) FileEngineSettings로 설정한 후 요청을 다시 시도하세요. 레이블 지정 작업은 해당 IFileEngine 인스턴스에 사용할 수 없지만 보호 작업은 사용할 수 있습니다.
오류: "System.ComponentModel.Win32Exception: LoadLibrary 실패"
문제: MIP SDK .NET 래퍼를 사용할 때 다음 오류가 발생하는 이유는 무엇인가요?
System.ComponentModel.Win32Exception: MIP.Initialize()를 호출할 때 [sdk_wrapper_dotnet.dll]에 대해 LoadLibrary가 실패했습니다.
애플리케이션에 필요한 런타임이 없거나 릴리스로 빌드하지 않았습니다. 자세한 내용은 앱에 필요한 종속성이 있는지 확인하세요.
오류: "ProxyAuthError 예외"
문제: MIP SDK를 사용할 때 다음 오류가 발생하는 이유는 무엇인가요?
ProxyAuthenticationError: 프록시 인증이 지원되지 않습니다.
MIP SDK는 인증된 프록시를 지원하지 않습니다. 이 메시지를 해결하려면 프록시 관리자에게 프록시를 무시하도록 Microsoft Purview Information Protection 서비스 엔드포인트를 설정하도록 요청합니다.
Office 365 URL 및 IP 주소 범위 페이지에는 해당 엔드포인트가 나열됩니다. MIP SDK를 사용하려면 substrate.office.com(9행), Microsoft Purview Information Protection 서비스 엔드포인트(73행) 및 *.office.com(*.protection.outlook.com 엔드포인트의 일부)가 프록시 인증을 우회해야 합니다.
오류: 스트림 출력을 사용하여 이미지 파일에 레이블을 지정할 때 "알 수 없는 오류"
문제: 출력에 스트림을 사용하여 이미지 파일 형식에서 레이블 또는 보호를 추가하거나 제거하려고 할 때 "알 수 없는 오류"가 발생하는 이유는 무엇인가요?
출력에 스트림을 사용하는 경우 이미지 파일에 대한 레이블 또는 보호를 수정하려면 스트림에 읽기 및 쓰기 권한이 모두 있어야 합니다.