Share via

Instructies: documenttracking en intrekking van documenten inschakelen

  • Artikel

Belangrijk

Versies van de Microsoft Rights Management Service SDK die vóór maart 2020 zijn uitgebracht, worden afgeschaft; toepassingen die eerdere versies gebruiken, moeten worden bijgewerkt voor gebruik van de release van maart 2020. Zie de afschaffingsmelding voor meer informatie.

Er zijn geen verdere verbeteringen gepland voor de Microsoft Rights Management Service SDK. We raden u ten zeerste aan de Microsoft Information Protection SDK te gebruiken voor classificatie-, label- en beveiligingsservices.

Dit onderwerp bevat de algemene richtlijnen voor de implementatie van documenttracking voor inhoud, evenals voorbeeldcode voor updates van metagegevens en voor het maken van een knop Gebruik bijhouden voor uw app.

Stappen voor het implementeren van documenttracking

Met stap 1 en 2 schakelt u het document in dat u wilt bijhouden. Met stap 3 kunnen uw app-gebruikers de site voor documenttracking bereiken zodat ze de beveiligde documenten kunnen bijhouden en intrekken.

  1. Voeg metagegevens voor documenttracking toe
  2. Registreer het document bij de RMS-service
  3. Voeg de knop Gebruik bijhouden toe aan uw app

Hieronder vindt u de implementatiedetails voor deze stappen.

1. Metagegevens voor documenttracking toevoegen

Het bijhouden van documenten is een functie van Rights Management. Door specifieke metagegevens toe te voegen tijdens het beveiligingsproces, kan een document worden geregistreerd bij de serviceportal voor tracering. Vervolgens beschikt u over verschillende opties om het document bij te houden.

Gebruik deze API's om een inhoudslicentie met metagegevens voor het bijhouden van documenten toe te voegen/bij te werken.

Operationeel gezien zijn voor documenttracking alleen de eigenschappen Naam inhoud en Meldingstype vereist.

  • IpcCreateLicenseMetadataHandle

  • IpcSetLicenseMetadataProperty

    We verwachten dat u alle eigenschappen voor metagegevens instelt. Deze eigenschappen staan hieronder vermeld, gerangschikt op type.

    Zie License metadata property types (Typen eigenschappen voor licentiemetagegevens) voor meer informatie.

    • IPC_MD_CONTENT_PATH

      Gebruik dit om het bijgehouden document te identificeren. Als een volledig pad niet mogelijk is, geeft u alleen de bestandsnaam op.

    • IPC_MD_CONTENT_NAME

      Gebruik dit om de naam van het bijgehouden document te identificeren.

    • IPC_MD_NOTIFICATION_TYPE

      Gebruik dit om op te geven wanneer een melding wordt verzonden. Zie Notification type (Meldingstype) voor meer informatie.

    • IPC_MD_NOTIFICATION_PREFERENCE

      Gebruik dit om het type melding op te geven. Zie Notification preference (Meldingsvoorkeuren) voor meer informatie.

    • IPC_MD_DATE_MODIFIED

      Het wordt aangeraden dat u deze datum telkens instelt wanneer de gebruiker op Opslaan klikt.

    • IPC_MD_DATE_CREATED

      Gebruik dit voor het instellen van de oorspronkelijke datum van het bestand

  • IpcSerializeLicenseWithMetadata

Gebruik een van deze API's om de metagegevens toe te voegen aan uw bestand of stroom.

Gebruik ten slotte deze API om uw bijgehouden document te registreren bij het traceersysteem.

2. Registreer het document bij de RMS-service

Hier volgt een codefragment met een voorbeeld van het instellen van de metagegevens voor het bijhouden van documenten en de aanroep voor registratie bij het traceersysteem.

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);

Voeg een knop Gebruik bijhouden toe aan uw app

Het toevoegen van een UI-item Gebruik bijhouden is net zo eenvoudig als het gebruik van een van de volgende URL-indelingen:

  • Inhoud-id gebruiken

    • Haal de inhoud-id op met IpcGetLicenseProperty of IpcGetSerializedLicenseProperty als de licentie is geserialiseerd en gebruik de licentie-eigenschap IPC_LI_CONTENT_ID. Zie License property types (Typen licentie-eigenschappen) voor meer informatie.

    • Gebruik met de metagegevens van ContentId en Issuer de volgende indeling: https://track.azurerms.com/#/{ContentId}/{Issuer}

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

  • Als u geen toegang hebt tot die metagegevens (u bekijkt de niet-beveiligde versie van het document), kunt u de Content_Name in de volgende indeling gebruiken: https://track.azurerms.com/#/?q={ContentName}

    Voorbeeld - https://track.azurerms.com/#/?q=Secret!.txt

De client moet een browser openen met de juiste URL. Verificatie en eventuele omleiding worden uitgevoerd in de RMS-portal voor documenttracking.