Upcoming Changes to Microsoft Information Protection Metadata Storage

Published 11-19-2020 12:44 PM 4,555 Views
Microsoft

In Microsoft Information Protection (MIP) SDK version 1.7, changes were made to support a new label metadata storage location for Office files – Word, Excel, and PowerPoint. For your applications and services to continue reading and writing MIP sensitivity labels for Office file types, it’s critical that you update to MIP SDK version 1.7. Applications running older versions will not be capable of reading the updated metadata format.

 

Metadata Storage

Historically, MIP SDK, the Office native labeling experience, and Azure Information Protection client have written MIP label metadata in a custom XML part. As customers enable features that require the new storage location, all MIP-enlightened applications and services will migrate this metadata to a new storage location upon save. New files will have the metadata written to the new location only.

 

Updates to the Office file formats are detailed in the protocol documentation listed below.

 

[MS-OFFCRYPTO]: Sensitivity Labels

2.6

[MS-OFFCRYPTO]: Sensitivity Label Metadata

2.6.1

[MS-OFFCRYPTO]: LabelInfo Stream Locations

2.6.2

[MS-OFFCRYPTO]: LabelInfo versus Custom Document Properties

2.6.3

[MS-OFFCRYPTO]: ext Element

2.6.4.6

[MS-OFFCRYPTO]: CT_ClassificationExtenstionList

2.6.5.3

[MS-OFFCRYPTO]: CT_ClassificationLabel

2.6.5.4

[MS-OFFCRYPTO]: LabelInfo Stream

3.12

[MS-OI29500]: Sensitivity Label Information Part

3.4.1.5

 

Required Action

Start updating your applications and services to MIP SDK 1.7 today. Without this update your customers and partners will be unable to take advantage of future experiences and features that may depend on this updated storage location.

 

Resources

 

 

2 Comments
Occasional Visitor

Hello,

 

Do you have more information about when these changes will start to roll-out in Office applications? (an estimated date or period, or an Office version maybe?)

 

 

Visitor

@Tom Moser 

 

Thanks for this, there doesn't appear to be any Release Notes available for this latest version (1.7.145) on the Version History page of the documentation (https://docs.microsoft.com/en-us/information-protection/develop/version-release-history), will this be available soon or is there somewhere else that has the detail of this version documented?

%3CLINGO-SUB%20id%3D%22lingo-sub-1916861%22%20slang%3D%22en-US%22%3ERe%3A%20Upcoming%20Changes%20to%20Microsoft%20Information%20Protection%20Metadata%20Storage%3C%2FLINGO-SUB%3E%3CLINGO-BODY%20id%3D%22lingo-body-1916861%22%20slang%3D%22en-US%22%3E%3CP%3EHello%2C%3C%2FP%3E%3CP%3E%26nbsp%3B%3C%2FP%3E%3CP%3EDo%20you%20have%20more%20information%20about%20when%20these%20changes%20will%20start%20to%20roll-out%20in%20Office%20applications%3F%20(an%20estimated%20date%20or%20period%2C%20or%20an%20Office%20version%20maybe%3F)%3C%2FP%3E%3CP%3E%26nbsp%3B%3C%2FP%3E%3CP%3E%26nbsp%3B%3C%2FP%3E%3C%2FLINGO-BODY%3E%3CLINGO-SUB%20id%3D%22lingo-sub-1931583%22%20slang%3D%22en-US%22%3ERe%3A%20Upcoming%20Changes%20to%20Microsoft%20Information%20Protection%20Metadata%20Storage%3C%2FLINGO-SUB%3E%3CLINGO-BODY%20id%3D%22lingo-body-1931583%22%20slang%3D%22en-US%22%3E%3CP%3E%3CA%20href%3D%22https%3A%2F%2Ftechcommunity.microsoft.com%2Ft5%2Fuser%2Fviewprofilepage%2Fuser-id%2F3319%22%20target%3D%22_blank%22%3E%40Tom%20Moser%3C%2FA%3E%26nbsp%3B%3C%2FP%3E%3CP%3E%26nbsp%3B%3C%2FP%3E%3CP%3EThanks%20for%20this%2C%20there%20doesn't%20appear%20to%20be%20any%20Release%20Notes%20available%20for%20this%20latest%20version%20(1.7.145)%20on%20the%20Version%20History%20page%20of%20the%20documentation%20(%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Finformation-protection%2Fdevelop%2Fversion-release-history%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noreferrer%22%3Ehttps%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Finformation-protection%2Fdevelop%2Fversion-release-history%3C%2FA%3E)%2C%20will%20this%20be%20available%20soon%20or%20is%20there%20somewhere%20else%20that%20has%20the%20detail%20of%20this%20version%20documented%3F%3C%2FP%3E%3C%2FLINGO-BODY%3E%3CLINGO-SUB%20id%3D%22lingo-sub-1904418%22%20slang%3D%22en-US%22%3EUpcoming%20Changes%20to%20Microsoft%20Information%20Protection%20Metadata%20Storage%3C%2FLINGO-SUB%3E%3CLINGO-BODY%20id%3D%22lingo-body-1904418%22%20slang%3D%22en-US%22%3E%3CP%3EIn%20Microsoft%20Information%20Protection%20(MIP)%20SDK%20version%201.7%2C%20changes%20were%20made%20to%20support%20a%20new%20label%20metadata%20storage%20location%20for%20Office%20files%20%E2%80%93%20Word%2C%20Excel%2C%20and%20PowerPoint.%20For%20your%20applications%20and%20services%20to%20continue%20reading%20and%20writing%20MIP%20sensitivity%20labels%20for%20Office%20file%20types%2C%20it%E2%80%99s%20critical%20that%20you%20update%20to%20MIP%20SDK%20version%201.7.%20Applications%20running%20older%20versions%20will%20not%20be%20capable%20of%20reading%20the%20updated%20metadata%20format.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CH2%20id%3D%22toc-hId--1186476795%22%20id%3D%22toc-hId--1187310129%22%3EMetadata%20Storage%3C%2FH2%3E%0A%3CP%3EHistorically%2C%20MIP%20SDK%2C%20the%20Office%20native%20labeling%20experience%2C%20and%20Azure%20Information%20Protection%20client%20have%20written%20MIP%20label%20metadata%20in%20a%20%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Fopenspecs%2Foffice_standards%2Fms-oi29500%2F329b6ef3-5848-403b-97e9-069503df5e3a%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noreferrer%22%3Ecustom%20XML%20part%3C%2FA%3E%3CEM%3E.%20%3C%2FEM%3EAs%20customers%20enable%20features%20that%20require%20the%20new%20storage%20location%2C%20all%20MIP-enlightened%20applications%20and%20services%20will%20%3CSTRONG%3Emigrate%20%3C%2FSTRONG%3Ethis%20metadata%20to%20a%20new%20storage%20location%20upon%20save.%20New%20files%20will%20have%20the%20metadata%20written%20to%20the%20new%20location%20only.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3EUpdates%20to%20the%20Office%20file%20formats%20are%20detailed%20in%20the%20protocol%20documentation%20listed%20below.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CTABLE%20width%3D%22701%22%3E%0A%3CTBODY%3E%0A%3CTR%3E%0A%3CTD%20width%3D%22403%22%3E%3CP%3E%3CSTRONG%3E%5BMS-OFFCRYPTO%5D%3A%20Sensitivity%20Labels%3C%2FSTRONG%3E%3C%2FP%3E%0A%3C%2FTD%3E%0A%3CTD%20width%3D%22298%22%3E%3CP%3E%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Fopenspecs%2Foffice_file_formats%2Fms-offcrypto%2Fe45ba92e-b121-4b51-a153-057a903ed252%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noreferrer%22%3E2.6%3C%2FA%3E%3C%2FP%3E%0A%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20width%3D%22403%22%3E%3CP%3E%3CSTRONG%3E%5BMS-OFFCRYPTO%5D%3A%20Sensitivity%20Label%20Metadata%3C%2FSTRONG%3E%3C%2FP%3E%0A%3C%2FTD%3E%0A%3CTD%20width%3D%22298%22%3E%3CP%3E%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Fopenspecs%2Foffice_file_formats%2Fms-offcrypto%2F9c2ee962-71ec-4dd3-8d00-37f4f864982a%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noreferrer%22%3E2.6.1%3C%2FA%3E%3C%2FP%3E%0A%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20width%3D%22403%22%3E%3CP%3E%3CSTRONG%3E%5BMS-OFFCRYPTO%5D%3A%20LabelInfo%20Stream%20Locations%3C%2FSTRONG%3E%3C%2FP%3E%0A%3C%2FTD%3E%0A%3CTD%20width%3D%22298%22%3E%3CP%3E%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Fopenspecs%2Foffice_file_formats%2Fms-offcrypto%2F0c4ec12d-aba0-4dd4-8fd1-710da6735219%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noreferrer%22%3E2.6.2%3C%2FA%3E%3C%2FP%3E%0A%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20width%3D%22403%22%3E%3CP%3E%3CSTRONG%3E%5BMS-OFFCRYPTO%5D%3A%20LabelInfo%20versus%20Custom%20Document%20Properties%3C%2FSTRONG%3E%3C%2FP%3E%0A%3C%2FTD%3E%0A%3CTD%20width%3D%22298%22%3E%3CP%3E%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Fopenspecs%2Foffice_file_formats%2Fms-offcrypto%2F13939de6-c833-44ab-b213-e0088bf02341%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noreferrer%22%3E2.6.3%3C%2FA%3E%3C%2FP%3E%0A%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20width%3D%22403%22%3E%3CP%3E%3CSTRONG%3E%5BMS-OFFCRYPTO%5D%3A%20ext%20Element%3C%2FSTRONG%3E%3C%2FP%3E%0A%3C%2FTD%3E%0A%3CTD%20width%3D%22298%22%3E%3CP%3E%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Fopenspecs%2Foffice_file_formats%2Fms-offcrypto%2Fd49c1d62-2fc8-4067-b363-a4414e54fa1c%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noreferrer%22%3E2.6.4.6%3C%2FA%3E%3C%2FP%3E%0A%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20width%3D%22403%22%3E%3CP%3E%3CSTRONG%3E%5BMS-OFFCRYPTO%5D%3A%20CT_ClassificationExtenstionList%3C%2FSTRONG%3E%3C%2FP%3E%0A%3C%2FTD%3E%0A%3CTD%20width%3D%22298%22%3E%3CP%3E%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Fopenspecs%2Foffice_file_formats%2Fms-offcrypto%2F5f01e822-9e74-42ee-a207-7da41fa07e7a%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noreferrer%22%3E2.6.5.3%3C%2FA%3E%3C%2FP%3E%0A%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20width%3D%22403%22%3E%3CP%3E%3CSTRONG%3E%5BMS-OFFCRYPTO%5D%3A%20CT_ClassificationLabel%3C%2FSTRONG%3E%3C%2FP%3E%0A%3C%2FTD%3E%0A%3CTD%20width%3D%22298%22%3E%3CP%3E%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Fopenspecs%2Foffice_file_formats%2Fms-offcrypto%2F80e2b2e1-bd48-415d-a3b9-aa61a108f651%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noreferrer%22%3E2.6.5.4%3C%2FA%3E%3C%2FP%3E%0A%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20width%3D%22403%22%3E%3CP%3E%3CSTRONG%3E%5BMS-OFFCRYPTO%5D%3A%20LabelInfo%20Stream%3C%2FSTRONG%3E%3C%2FP%3E%0A%3C%2FTD%3E%0A%3CTD%20width%3D%22298%22%3E%3CP%3E%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Fopenspecs%2Foffice_file_formats%2Fms-offcrypto%2F8d6d414d-ac0b-40ee-ac87-af2e6401c128%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noreferrer%22%3E3.12%3C%2FA%3E%3C%2FP%3E%0A%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20width%3D%22403%22%3E%3CP%3E%3CSTRONG%3E%5BMS-OI29500%5D%3A%20Sensitivity%20Label%20Information%20Part%3C%2FSTRONG%3E%3C%2FP%3E%0A%3C%2FTD%3E%0A%3CTD%20width%3D%22298%22%3E%3CP%3E%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Fopenspecs%2Foffice_standards%2Fms-oi29500%2Fc0599e21-b77f-475e-99e0-bd647f60bcbb%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noreferrer%22%3E3.4.1.5%3C%2FA%3E%3C%2FP%3E%0A%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3C%2FTBODY%3E%0A%3C%2FTABLE%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CH2%20id%3D%22toc-hId-1301036038%22%20id%3D%22toc-hId-1300202704%22%3ERequired%20Action%3C%2FH2%3E%0A%3CP%3E%3CSTRONG%3EStart%20updating%20your%20applications%20and%20services%20to%20MIP%20SDK%201.7%20today.%20%3C%2FSTRONG%3EWithout%20this%20update%20your%20customers%20and%20partners%20will%20be%20unable%20to%20take%20advantage%20of%20future%20experiences%20and%20features%20that%20may%20depend%20on%20this%20updated%20storage%20location.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3EResources%3C%2FP%3E%0A%3CUL%3E%0A%3CLI%3E%3CA%20href%3D%22https%3A%2F%2Faka.ms%2Fmipsdkdocs%22%20target%3D%22_self%22%20rel%3D%22noopener%20noreferrer%22%3EMIP%20SDK%20Documentation%3C%2FA%3E%3C%2FLI%3E%0A%3CLI%3E%3CA%20href%3D%22https%3A%2F%2Faka.ms%2Fmipsdksamples%22%20target%3D%22_self%22%20rel%3D%22noopener%20noreferrer%22%3EMIP%20SDK%20Samples%3C%2FA%3E%3C%2FLI%3E%0A%3CLI%3E%3CA%20href%3D%22https%3A%2F%2Faka.ms%2Fmipsdknuget%22%20target%3D%22_self%22%20rel%3D%22noopener%20noreferrer%22%3EMIP%20SDK%20NuGet%20Packages%3C%2FA%3E%3C%2FLI%3E%0A%3CLI%3E%3CA%20href%3D%22https%3A%2F%2Faka.ms%2Fmipsdkbins%22%20target%3D%22_self%22%20rel%3D%22noopener%20noreferrer%22%3EMIP%20SDK%20Binaries%3C%2FA%3E%3C%2FLI%3E%0A%3C%2FUL%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%3C%2FLINGO-BODY%3E%3CLINGO-TEASER%20id%3D%22lingo-teaser-1904418%22%20slang%3D%22en-US%22%3E%3CP%3EIn%20Microsoft%20Information%20Protection%20(MIP)%20SDK%20version%201.7%2C%20changes%20were%20made%20to%20support%20a%20new%20label%20metadata%20storage%20location%20for%20Office%20files%20%E2%80%93%20Word%2C%20Excel%2C%20and%20PowerPoint.%20For%20your%20applications%20and%20services%20to%20continue%20reading%20and%20writing%20MIP%20sensitivity%20labels%20for%20Office%20file%20types%2C%20it%E2%80%99s%20critical%20that%20you%20update%20to%20MIP%20SDK%20version%201.7.%20Applications%20running%20older%20versions%20will%20not%20be%20capable%20of%20reading%20the%20updated%20metadata%20format.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%3C%2FLINGO-TEASER%3E%3CLINGO-LABS%20id%3D%22lingo-labs-1904418%22%20slang%3D%22en-US%22%3E%3CLINGO-LABEL%3EMicrosoft%20Information%20Protection%3C%2FLINGO-LABEL%3E%3CLINGO-LABEL%3EMicrosoft%20Information%20Protection%20Developers%3C%2FLINGO-LABEL%3E%3C%2FLINGO-LABS%3E
Version history
Last update:
‎May 11 2021 01:59 PM
Updated by: