方法: ドキュメント追跡の有効化と取り消し
重要
2020 年 3 月より前にリリースされた Microsoft Rights Management Service SDK のバージョンは非推奨です。以前のバージョンを使用するアプリケーションは、2020 年 3 月のリリースを使用するように更新する必要があります。 詳細については、 非推奨の通知を参照してください。
Microsoft Rights Management Service SDK の追加の機能強化は計画されていません。 分類、ラベル付け、保護サービスにMicrosoft Information Protection SDK を導入することを強くお勧めします。
このトピックでは、コンテンツのドキュメント追跡機能を導入する方法について、その基礎を説明し、また、メタデータ更新のサンプル コードとアプリの [使用の追跡] ボタンを作成するためのサンプルコードを紹介します。
ドキュメント追跡を実装する手順
手順 1 と 2 では、追跡するドキュメントを有効にします。 手順 3 では、保護ドキュメントを追跡するか、取り消す目的で、アプリ ユーザーがドキュメント追跡サイトにアクセスできるようにします。
- ドキュメント追跡メタデータを追加する
- RMS サービスでドキュメントを登録する
- [使用の追跡] ボタンをアプリに追加する
導入の詳しい手順は以下のようになります。
1. ドキュメント追跡メタデータを追加する
ドキュメント追跡は、Rights Management システムの機能です。 ドキュメントの保護プロセス中に特定のメタデータを追加することにより、追跡用のいくつかのオプションを提供する追跡サービス ポータルにドキュメントを登録できます。
これらの API を使用して、ドキュメント追跡メタデータと共にコンテンツのライセンスを追加または更新します。
運用上、ドキュメント追跡に必要なプロパティは、コンテンツ名と通知の種類のみです。
-
すべてのメタデータ プロパティを設定することをお勧めします。 種類ごとの一覧を以下に示します。
詳細については、「License metadata property types (ライセンス メタデータ プロパティの種類)」を参照してください。
IPC_MD_CONTENT_PATH
追跡対象のドキュメントの識別に使用します。 完全パスが使用できない場合は、ファイル名のみを指定します。
IPC_MD_CONTENT_NAME
追跡対象のドキュメントの名前の識別に使用します。
IPC_MD_NOTIFICATION_TYPE
通知を送信するタイミングの指定に使用します。 詳細については、「Notification type (通知の種類)」を参照してください。
IPC_MD_NOTIFICATION_PREFERENCE
通知の種類の指定に使用します。 詳細については、「Notification preference (通知の基本設定)」を参照してください。
IPC_MD_DATE_MODIFIED
ユーザーが [保存] をクリックするたびに、この日付を設定することをお勧めします。
IPC_MD_DATE_CREATED
ファイルの作成日の設定に使用します。
これらの API から適切なものを使用して、ファイルまたはストリームにメタデータを追加します。
最後に、この API を使用して、追跡対象のドキュメントを追跡システムに登録します。
2. RMS サービスにドキュメントを登録する
ドキュメント追跡メタデータの設定と追跡システムに登録するための呼び出しの例を表すコード スニペットを次に示します。
C++:
HRESULT hr = S_OK;
LPCWSTR wszOutputFile = NULL;
wstring wszWorkingFile;
IPC_LICENSE_METADATA md = {0};
md.cbSize = sizeof(IPC_LICENSE_METADATA);
md.dwNotificationType = IPCD_CT_NOTIFICATION_TYPE_ENABLED;
md.dwNotificationPreference = IPCD_CT_NOTIFICATION_PREF_DIGEST;
//file origination date, current time for this example
md.ftDateCreated = GetCurrentTime();
md.ftDateModified = GetCurrentTime();
LOGSTATUS_EX(L"Encrypt file with official template...");
hr =IpcfEncryptFileWithMetadata( wszWorkingFile.c_str(),
m_wszTestTemplateID.c_str(),
IPCF_EF_TEMPLATE_ID,
0,
NULL,
NULL,
&md,
&wszOutputFile);
/* This will contain the serialized license */
PIPC_BUFFER pSerializedLicense;
/* the context to use for the call */
PCIPC_PROMPT_CTX pContext;
wstring wstrContentName("MyDocument.txt");
bool sendLicenseRegistrationNotificationEmail = FALSE;
hr = IpcRegisterLicense( pSerializedLicense,
0,
pContext,
wstrContentName.c_str(),
sendLicenseRegistrationNotificationEmail);
[使用の追跡] ボタンをアプリに追加する
[使用の追跡] UI アイテムをアプリに追加する作業は、次のいずれかの URL 形式の使用と同じように簡単です。
コンテンツ ID の使用
ライセンスがシリアル番号になっており、ライセンス プロパティの IPC_LI_CONTENT_ID が使用される場合、IpcGetLicenseProperty または IpcGetSerializedLicenseProperty を使用してコンテンツ ID を入手します。 詳細については、「License property types」 (ライセンスのプロパティの種類) を参照してください。
ContentId と発行者のメタデータでは、次の形式を使用します。
https://track.azurerms.com/#/{ContentId}/{Issuer}例 -
https://track.azurerms.com/#/summary/05405df5-8ad6-4905-9f15-fc2ecbd8d0f7/janedoe@microsoft.com
そのメタデータにアクセスできない場合 (つまり、保護されていないバージョンのドキュメントを調べている場合)、 Content_Name を次の形式で使用できます。
https://track.azurerms.com/#/?q={ContentName}
このクライアントでは、適切な URL でブラウザーを開く必要があります。 RMS ドキュメント追跡ポータルが認証と必要なリダイレクトを処理します。