Habilitación de la revocación y el seguimiento de documentos
Importante
Las versiones del SDK del servicio Microsoft Rights Management publicadas antes de marzo de 2020 están en desuso; Las aplicaciones que usan versiones anteriores deben actualizarse para usar la versión de marzo de 2020. Para obtener información completa, consulte el aviso de desuso.
No se planean mejoras adicionales para el SDK del servicio Microsoft Rights Management. Se recomienda encarecidamente la adopción del SDK de Microsoft Information Protection para los servicios de clasificación, etiquetado y protección.
En este tema se abordan las instrucciones básicas para implementar el seguimiento de documentos, así como código de ejemplo para las actualizaciones de metadatos y para la creación de un botón Hacer seguimiento de uso para la aplicación.
Pasos para implementar el seguimiento de documentos
Los pasos 1 y 2 permiten que se realice un seguimiento del documento. El paso 3 permite que los usuarios de la aplicación lleguen al sitio de seguimiento de documentos para realizar un seguimiento de los documentos protegidos y revocarlos.
- Incorporación de metadatos de seguimiento de documentos
- Registro del documento con el servicio de RMS
- Incorporación del botón Hacer seguimiento de uso a la aplicación
A continuación se indican los detalles de implementación de estos pasos.
1. Agregar metadatos de seguimiento de documentos
El seguimiento de documentos es una característica del sistema Rights Management. Al agregar metadatos específicos durante el proceso de protección de documentos, se puede registrar un documento con el seguimiento de portal de servicio de seguimiento que ofrece varias opciones de seguimiento.
Use estas API para agregar o actualizar una licencia de contenido con metadatos de seguimiento de documentos.
Funcionalmente, solo las propiedades content name y notification type son necesarias para el seguimiento de documentos.
-
Se espera que establezca todas las propiedades de metadatos. Aquí están, mostradas por tipo.
Para obtener más información, consulte License metadata property types (Tipos de propiedades de metadatos de licencias).
IPC_MD_CONTENT_PATH
Se usa para identificar el documento cuyo seguimiento se realiza. En aquellos casos en los que no sea posible especificar una ruta de acceso completa, basta con que proporcione el nombre de archivo.
IPC_MD_CONTENT_NAME
Se usa para identificar el nombre del documento cuyo seguimiento se realiza.
IPC_MD_NOTIFICATION_TYPE
Se usa para especificar cuándo se enviará la notificación. Para obtener más información, consulte Tipo de notificación.
IPC_MD_NOTIFICATION_PREFERENCE
Se usa para especificar el tipo de notificación. Para obtener más información, consulte Preferencia de notificación.
IPC_MD_DATE_MODIFIED
Se recomienda establecer esta fecha cada vez que el usuario hace clic en Guardar.
IPC_MD_DATE_CREATED
Se usa para establecer la fecha de creación del archivo.
De estas API, use la adecuada para agregar los metadatos al archivo o la secuencia.
Por último, use esta API para registrar el documento cuyo seguimiento se realiza en el sistema de seguimiento.
2. Registrar el documento con el servicio RMS
El siguiente es un fragmento de código que muestra un ejemplo de cómo establecer metadatos de seguimiento de documentos y la llamada al registro en el sistema de seguimiento.
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);
Incorporación del botón Hacer seguimiento de uso a la aplicación
Agregar a la aplicación un elemento de interfaz de usuario Hacer seguimiento de uso es tan sencillo como usar uno de los siguientes formatos de dirección URL:
Mediante el identificador de contenido
Obtenga el identificador de contenido mediante IpcGetLicenseProperty o IpcGetSerializedLicenseProperty si la licencia está serializada y use la propiedad de la licencia IPC_LI_CONTENT_ID. Para obtener más información, vea License property types (Tipos de propiedades de licencias).
Con los metadatos ContentId y Issuer , use el siguiente formato:
https://track.azurerms.com/#/{ContentId}/{Issuer}
Ejemplo:
https://track.azurerms.com/#/summary/05405df5-8ad6-4905-9f15-fc2ecbd8d0f7/janedoe@microsoft.com
Si no tiene acceso a esos metadatos (es decir, está examinando la versión desprotegida del documento), puede usar el Content_Name en el formato siguiente:
https://track.azurerms.com/#/?q={ContentName}
El cliente solo tiene que abrir un explorador con la dirección URL apropiada. El portal de seguimiento de documentos de RMS controlará la autenticación y los redireccionamientos necesarios.