Anvisningar: Aktiverar Azure RMS-dokumentspårning och -återkallelseHow-to: enable document tracking and revocation

I det här avsnittet beskrivs de grundläggande riktlinjerna för att implementera dokumentspårning av innehåll samt kodexempel för uppdatering av metadata och för att skapa en knapp för Användningsspårning för ditt program.This topic covers the basic guidance for implementing document tracking of content as well as example code for metadata updates and for creating a Track Usage button for your app.

Steg för att implementera dokumentspårningSteps to implement document tracking

Steg 1 och 2 aktiverar spårning för dokumentet.Steps 1 and 2 enable the document to be tracked. Steg 3 låter användare av ditt program att nå dokumentspårningsplatsen för att spåra och återkalla skyddade dokument.Step 3 enables your app users to reach the document tracking site in order to track and revoke your protected documents.

  1. Lägg till metadata för dokumentspårningAdd document tracking metadata
  2. Registrera dokumentet med RMS-tjänstenRegister the document with the RMS service
  3. Lägga till en knapp för användningsspårning i ditt programAdd Track Usage button to your app

Implementeringsdetaljerna för de här stegen följer.The implementation details for these steps follow.

1. Lägg till metadata för dokument spårning1. Add document tracking metadata

Dokumentspårning är en funktion i Rights Management-systemet.Document tracking is a feature of the Rights Management system. Om du lägger till specifika metadata under dokumentskyddsprocessen kan ett dokument registreras på spårningstjänstportalen som tillhandahåller flera spårningsalternativ.By adding specific metadata during the document protection process, a document can be registered with the tracking service portal which then provides several options for tracking.

Använd dessa API:er för att lägga till/uppdatera en innehållslicens med metadata för dokumentspårning.Use these APIs to add/update a content license with document tracking metadata.

Funktionsmässigt krävs endast egenskaperna för innehållsnamn och meddelandetyp för dokumentspårning.Operationally, only the content name and the notification type properties are required for document tracking.

  • IpcCreateLicenseMetadataHandleIpcCreateLicenseMetadataHandle

  • IpcSetLicenseMetadataPropertyIpcSetLicenseMetadataProperty

    Vi förutsätter att du anger alla metadataegenskaper.We expect that you will set all of the metadata properties. Här är de, sorterade efter typ.Here they are, listed by type.

    Mer information finns i Typer av licensmetadataegenskaper.For more information, see License metadata property types.

    • IPC_MD_CONTENT_PATHIPC_MD_CONTENT_PATH

      Används för att identifiera det spårade dokumentet.Use to identify the tracked document. Om det inte går att ange en fullständig sökväg anger du bara filnamnet.In cases where a full path is not possible, just provide the file name.

    • IPC_MD_CONTENT_NAMEIPC_MD_CONTENT_NAME

      Används för att identifiera det spårade dokumentnamnet.Use to identify the tracked document name.

    • IPC_MD_NOTIFICATION_TYPEIPC_MD_NOTIFICATION_TYPE

      Används för att ange när ett meddelande ska skickas.Use to specify when notification will be sent. Mer information finns i Meddelandetyp.For more information, see Notification type.

    • IPC_MD_NOTIFICATION_PREFERENCEIPC_MD_NOTIFICATION_PREFERENCE

      Används för att ange typen av meddelande.Use to specify the type of notification. Mer information finns i Meddelandepreferenser.For more information, see Notification preference.

    • IPC_MD_DATE_MODIFIEDIPC_MD_DATE_MODIFIED

      Vi rekommenderar att du ställer in det här datumet varje gång användaren klickar på Spara.We suggest that you set this date each time the user clicks Save.

    • IPC_MD_DATE_CREATEDIPC_MD_DATE_CREATED

      Använd för att ange filens ursprungsdatumUse to set the origination date of the file

  • IpcSerializeLicenseWithMetadataIpcSerializeLicenseWithMetadata

Använd dessa API:n om du vill lägga till metadata till en fil eller dataström.Use the appropriate one of these APIs to add the metadata to your file or stream.

Använd detta API om du vill registrera det spårade dokumentet med spårningssystemet.Lastly, use this API to register your tracked document with the tracking system.

2. registrera dokumentet med RMS-tjänsten2. Register the document with the RMS service

Här är ett kodfragment som visar ett exempel på hur du anger metadata för dokumentspårning samt anropet för registrering i spårningssystemet.Here's a code snippet showing an example of setting document tracking metadata and the call to register with the tracking system.

C++: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);

Lägga till en knapp för Användningsspårning i ditt programAdd a Track Usage button to your app

Lägga till ett UI-objektet för Användningsspårning till ditt program är enkelt med någon av följande URL-format:Adding a Track Usage UI item to your app is as simple as using one of the following URL formats:

  • Använda innehålls-IDUsing Content ID

    • Hämta innehålls-ID genom att använda IpcGetLicenseProperty eller IpcGetSerializedLicenseProperty om licensen serialiseras och använder licensegenskapen IPC_LI_CONTENT_ID.Get the content ID by using IpcGetLicenseProperty or IpcGetSerializedLicenseProperty if the license is serialized and use the license property IPC_LI_CONTENT_ID. Mer information finns i licensegenskapstyper.For more information, see License property types.

    • Använd följande format med ContentId och Issuer -metadata: https://track.azurerms.com/#/{ContentId}/{Issuer}With the ContentId and Issuer metadata, use the following format: https://track.azurerms.com/#/{ContentId}/{Issuer}

      Exempel – https://track.azurerms.com/#/summary/05405df5-8ad6-4905-9f15-fc2ecbd8d0f7/janedoe@microsoft.comExample - https://track.azurerms.com/#/summary/05405df5-8ad6-4905-9f15-fc2ecbd8d0f7/janedoe@microsoft.com

  • Om du inte har åtkomst till dessa metadata (d.v.s. du undersöker den oskyddade versionen av dokumentet) kan du använda Content_Name i följande format: https://track.azurerms.com/#/?q={ContentName}If you don’t have access to that metadata (i.e. you are examining the unprotected version of the document), you can use the Content_Name in the following format: https://track.azurerms.com/#/?q={ContentName}

    Exempel – https://track.azurerms.com/#/?q=Secret !. formatExample - https://track.azurerms.com/#/?q=Secret!.txt

Klienten behöver bara öppna en webbläsare med rätt URL.The client simply needs to open a browser with the appropriate URL. RMS-portalen för dokumentspårning kommer att hantera autentisering och omdirigering om så nödvändigt.The RMS Document Tracking portal will handle authentication and any required redirection.