Upcoming Changes to Microsoft Information Protection Metadata Storage

Published Nov 19 2020 12:44 PM 8,216 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
%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--1186476795%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-1301036038%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:
We support Ukraine and condemn war. Push Russian government to act against war. Be brave, vocal and show your support to Ukraine. Follow the latest news HERE