Dela via

Anvisningar: Aktiverar Azure RMS-dokumentspårning och -återkallelse

  • Artikel

Viktigt

Versioner av Microsoft Rights Management Service SDK som släpptes före mars 2020 är inaktuella. program som använder tidigare versioner måste uppdateras för att använda versionen från mars 2020. Fullständig information finns i utfasningsmeddelandet.

Inga ytterligare förbättringar planeras för Microsoft Rights Management Service SDK. Vi rekommenderar starkt att du använder Microsoft Information Protection SDK för klassificerings-, märknings- och skyddstjänster.

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.

Steg för att implementera dokumentspårning

Steg 1 och 2 aktiverar spårning för dokumentet. Steg 3 låter användare av ditt program att nå dokumentspårningsplatsen för att spåra och återkalla skyddade dokument.

  1. Lägg till metadata för dokumentspårning
  2. Registrera dokumentet med RMS-tjänsten
  3. Lägga till en knapp för användningsspårning i ditt program

Implementeringsdetaljerna för de här stegen följer.

1. Lägg till metadata för dokumentspårning

Dokumentspårning är en funktion i Rights Management-systemet. Om du lägger till specifika metadata under dokumentskyddsprocessen kan ett dokument registreras på spårningstjänstportalen som tillhandahåller flera spårningsalternativ.

Använd dessa API:er för att lägga till/uppdatera en innehållslicens med metadata för dokumentspårning.

Funktionsmässigt krävs endast egenskaperna för innehållsnamn och meddelandetyp för dokumentspårning.

  • IpcCreateLicenseMetadataHandle

  • IpcSetLicenseMetadataProperty

    Vi förutsätter att du anger alla metadataegenskaper. Här är de, sorterade efter typ.

    Mer information finns i Typer av licensmetadataegenskaper.

    • IPC_MD_CONTENT_PATH

      Används för att identifiera det spårade dokumentet. Om det inte går att ange en fullständig sökväg anger du bara filnamnet.

    • IPC_MD_CONTENT_NAME

      Används för att identifiera det spårade dokumentnamnet.

    • IPC_MD_NOTIFICATION_TYPE

      Används för att ange när ett meddelande ska skickas. Mer information finns i Meddelandetyp.

    • IPC_MD_NOTIFICATION_PREFERENCE

      Används för att ange typen av meddelande. Mer information finns i Meddelandepreferenser.

    • IPC_MD_DATE_MODIFIED

      Vi rekommenderar att du ställer in det här datumet varje gång användaren klickar på Spara.

    • IPC_MD_DATE_CREATED

      Använd för att ange filens ursprungsdatum

  • IpcSerializeLicenseWithMetadata

Använd dessa API:n om du vill lägga till metadata till en fil eller dataström.

Använd detta API om du vill registrera det spårade dokumentet med spårningssystemet.

2. Registrera dokumentet med RMS-tjänsten

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.

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 program

Lägga till ett UI-objektet för Användningsspårning till ditt program är enkelt med någon av följande URL-format:

  • Använda innehålls-ID

    • Hämta innehålls-ID genom att använda IpcGetLicenseProperty eller IpcGetSerializedLicenseProperty om licensen serialiseras och använder licensegenskapen IPC_LI_CONTENT_ID. Mer information finns i licensegenskapstyper.

    • Använd följande format med Metadata för ContentId och Issuer : https://track.azurerms.com/#/{ContentId}/{Issuer}

      Exempel – 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}

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

Klienten behöver bara öppna en webbläsare med rätt URL. RMS-portalen för dokumentspårning kommer att hantera autentisering och omdirigering om så nödvändigt.