Microsoft Information Protection (MIP) SDK の FAQ と問題
この記事には、よく寄せられる質問 (FAQ) に対する回答と、既知の問題と一般的なエラーに関するトラブルシューティング ガイダンスが記載されています。
よく寄せられる質問
メタデータ ストレージの変更
私たちは、Office 365、SharePoint Online などのサービスの新機能をサポートするために、Office ファイル (Word、Excel、PowerPoint) のラベル メタデータ ストレージを変更することを発表しました。
メタデータに関するよくあるご質問
質問: PDF などの他の形式への影響はありますか?
- いいえ。Office ファイル、具体的には Word、Excel、PowerPoint ファイルのみです。
質問: 必要とされる MIP SDK の特定のバージョンはありますか?
- MIP SDK 1.7 以降は完全に互換性があります。
質問：このストレージ場所を使用するために必要なOfficeクライアントの特定のバージョンはありますか？
- 2021年9月以降にリリースされたすべてのMicrosoft 365 Appsクライアントは、この新しいメタデータの場所をサポートしています。 新しいストレージの場所は、テナント管理者が保護された共同作成機能を有効するまで使用されません。
質問: custom.xml にカスタム プロパティとして保存されている既存のメタデータは、最新の状態に維持されますか?
- いいえ。 新しい保存場所を使用するように設定した後、文書が初めて保存されると、ラベルメタデータが新しい場所に移動されます。
LabelingOptions.ExtendedPropertiesを介して作成されたメタデータは、custom.xmlに残ります。
質問: MIP SDK を使わずにラベル メタデータを読み取ることは可能ですか?
- はい。ただし、ファイルを解析して情報を抽出するには、独自のコードを実装する必要があります。
質問: 現在、キーと値のペア文字列をファイルから抽出して、ラベルを簡単に "読み取る" ことができます。 メタデータは引き続きこの方法で読み取ることができますか?
- はい。メタデータは、Office ファイル XML で引き続き読み取ることができます。 アプリケーションは、ポリシー ファイルから共同編集設定を読み取って、新しい機能セットが有効になっていることを確認する必要があります。 この設定により、ラベル データの読み取り/書き込み先 (custom.xmlとlabelinfo.xml) が定義されます。 実装の詳細については、「MS-OFFCRYPTO: LabelInfo とカスタム ドキュメント プロパティ | Microsoft Docs」を参照してください。
質問: ラベル ポリシーで共同編集が有効になっているかどうかを判断するにはどうすればよいですか? 共同作成設定の状態はポリシー エンジンから返されます。 アプリケーションでは、ポリシー エンジンから生バイトを読み取って共同編集の状態を判断できます。
質問: ラベルはどのように新しい場所に移行されますか?
- どのセクションが読み取られてラベル データの読み取りまたは書き込みに使用されるかを決定するには、次のロジックを使用します。
| アクション | 機能が有効でない | 機能が有効 |
|---|---|---|
| 既読 | custom.xml (保護なし) または Doc SummaryInfo (保護あり) 内のラベル。 | labelinfo.xml 内にラベルが存在する場合は、それが有効なラベルです。 labelinfo.xmlにラベルがない場合、custom.xmlまたはDoc SummaryInfoのラベルが有効なラベルとなります。 |
| 書き込み | 新しいラベルはすべて、custom.xml (保護なし) または Doc SummaryInfo (保護あり) に書き込まれます。 | 新しいラベルはすべて、labelinfo.xml に書き込まれます。 |
ファイルの解析
質問: ファイル SDK を使って現在読み取り中の同じファイルに書き込みできますか?
MIP SDK では、同じファイルの読み取りと書き込みを同時に行うことはサポートされていません。 ラベル付きファイルは、ラベルアクションが適用された入力ファイルのコピーになります。 アプリケーションで、元のファイルをラベル付きファイルに置き換える必要があります。
SDK の文字列処理
質問: この SDK で文字列はどのように処理され、自分のコードではどの文字列型を使用する必要がありますか?
SDK はクロスプラットフォームで使用することを目的としており、文字列処理に対して、UTF-8 (Unicode Transformation Format - 8-bit) を使用します。 具体的なガイダンスは、使用しているプラットフォームによって異なります。
| プラットフォーム | ガイダンス |
|---|---|
| Windows ネイティブ | C++ SDK クライアントの場合、C++ 標準ライブラリ型 std::string は API 関数に対する文字列の受け渡しに使用されます。 MIP SDK は、UTF-8 との間で行われる変換を内部で管理します。 API から std::string が返される場合は、UTF-8 Encoding を想定し、文字列の変換時はそれに応じて管理する必要があります。 場合によっては、文字列は、uint8_t ベクトル (公開ライセンス (PL) など) の一部として返されますが、不透明 BLOB として扱う必要があります。詳細と例については、次をご覧ください。
|
| .NET | .NET SDK クライアントの場合、すべての文字列はデフォルトの UTF-16 Encoding を使用するので、特別な変換は必要ありません。 MIP SDK は、UTF-16 との間で行われる変換を内部で管理します。 |
| その他のプラットフォーム | MIP SDK でサポートされている他のすべての他のプラットフォームには、UTF-8 のネイティブ サポートがあります。 |
コンテンツ マーキング
質問: MIP SDK でコンテンツ マーキングはサポートされていますか?
MIP SDK では、ヘッダー、フッター、透かしなどのコンテンツ マーキングをファイルに直接適用する機能はサポートされていません。 ラベル メタデータがファイルに書き込まれると、ファイル SDK は contentBits メタデータ プロパティを書き込み、保護が適用されたことを示します (構成されている場合)。 ヘッダー、フッター、または透かしが適用されたことを示すプロパティは書き込まれません。 アプリケーションでファイルを開くときは、コンテンツ マーキング構成をアプリケーションで評価し、保存時にファイルに書き込む必要があります。
Android での保護とポリシー SDK
質問：MIP SDKをAndroidアプリケーションに統合するには、どの共有ライブラリを使用する必要がありますか？
MIP SDK Androidバイナリには、libmip_core.so、libmip_protection_sdk.so、libmip_upe_sdk.so、lipmip_unified.soが含まれます。 libmip_unified.so コア、保護、およびポリシー共有ライブラリを含む推奨ライブラリです。
コンプライアンス
質問: Microsoft Information Protection SDK は Federal Information Processing Standard (FIPS) 140-2 に準拠していますか?
「FIPS 140-2 検証」を参照してください。
問題とエラーの参照先
エラー:「ファイル形式はサポートされていません」
質問: 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 がスローされた場合は、FileEngineSettings プロパティの ProtectionOnlyEngine を true に設定して、要求を再試行します。 その IFileEngine インスタンスにはラベル付け操作は使用できませんが、保護操作は使用できます。
エラー: "System.ComponentModel.Win32Exception: LoadLibrary failed" (LoadLibrary が失敗しました)
質問: MIP SDK .NET Wrapper 使用時に次のエラーが発生します。どうしてでしょうか?
System.ComponentModel.Win32Exception: LoadLibrary failed for: [sdk_wrapper_dotnet.dll] when calling MIP.Initialize().
アプリケーションに必要なランタイムがないか、リリースとしてビルドされていません。 詳細については、「アプリに必要なランタイムがあることを確認する」を参照してください。
エラー: "ProxyAuthError exception" (ProxyAuthError 例外)
質問: MIP SDK 使用時に次のエラーが発生します。どうしてでしょうか?
"ProxyAuthenticatonError: Proxy authentication is unsupported" (プロキシ認証はサポートされていません)
MIP SDK では、認証されたプロキシの使用はサポートされていません。 このメッセージを守勢するには、プロキシ管理者がプロキシをバイパスするように、Microsoft Purview Information Protection サービス エンドポイントを設定する必要があります。 それらのエンドポイントの一覧は、「Office 365 URL および IP アドレス範囲」のページにあります。 MIP SDK では、*.protection.outlook.com (行 9) と Azure Information Protection サービス エンドポイント (行 73) がプロキシ認証をバイパスする必要があります。
エラー: ストリーム出力を使用してイメージ ファイルにラベルを付ける際の「不明なエラー」
質問: 出力ストリームを使用して、イメージ ファイルの種類にラベルまたは保護を追加・削除しようとすると、「不明なエラー」が表示されるのはなぜですか?
出力にストリームを使用する場合、イメージ ファイルのラベルまたは保護を変更するには、ストリームに読み取りと書き込みの両方のアクセス許可が必要です。
質問: MIP SDK を使用する場合、サービスベースのスロットル制限はありますか?
保護 SDK または File SDK の保護操作によって使用される保護サービスには、組織全体で 10 秒あたり 7,500 件の要求という制限があります。 つまり、アプリケーション A が 10 秒あたり 4,000 件の要求を生成し、同じ組織で Applicaiton B が 10 秒あたり 4,000 要求を生成している場合、両方のアプリケーションが HTTP 429 Too Many Requests 応答を受信し始める可能性があります。 開発者は、これらの例外を受信したときにバックオフ期間を実装する必要があります。