Share via

Útmutató: A dokumentumkövetés és -visszavonás engedélyezése

  • Cikk

Fontos

A Microsoft Rights Management Service SDK 2020 márciusa előtt kiadott verziói elavultak; a korábbi verziókat használó alkalmazásokat frissíteni kell a 2020. márciusi kiadás használatához. A részletekért tekintse meg az elavulással kapcsolatos közleményt.

A Microsoft Rights Management Service SDK-hoz nem terveznek további fejlesztéseket. Határozottan javasoljuk a Microsoft-információvédelem SDK bevezetését besorolási, címkézési és védelmi szolgáltatásokhoz.

Ez a témakör alapvető útmutatást nyújt a tartalmak dokumentumkövetésének megvalósításához, továbbá kódpéldákat biztosít a metaadatok frissítéséhez és a Használat követése gomb létrehozásához saját alkalmazása számára.

A dokumentumkövetés megvalósításának lépései

Az 1. és 2. lépésben lehetővé teszi a dokumentum követését. A 3. lépésben lehetővé teszi, hogy az alkalmazás felhasználói hozzáférhessenek a dokumentumkövetési webhelyhez a védett dokumentumok nyomon követése és visszavonása céljából.

  1. Dokumentumkövetési metaadatok hozzáadása
  2. A dokumentum regisztrálása az RMS szolgáltatásban
  3. A „Használat követése” gomb elhelyezése az alkalmazásban

A lépések megvalósításának részletei az alábbiakban olvashatók.

1. Dokumentumkövetési metaadatok hozzáadása

A dokumentumkövetés a Rights Management rendszer szolgáltatása. Ha adott metaadatokat ad hozzá a dokumentum védelmi folyamata során, a dokumentumok regisztrálhatók a nyomkövetési szolgáltatás portálján, amely több lehetőséget nyújt a nyomkövetésre.

Ezekkel az API-kkal adhat hozzá/frissíthet tartalomlicencet dokumentumkövető metaadatokkal.

Működés közben csak a tartalom neve és az értesítés típusa tulajdonság szükséges a dokumentumok nyomon követéséhez.

  • IpcCreateLicenseMetadataHandle

  • IpcSetLicenseMetadataProperty

    Elvárjuk, hogy beállítsa az összes metaadat-tulajdonságot. Az alábbiakban láthatja a típus szerinti listát.

    További információ: Licenc metaadat-tulajdonságainak típusai.

    • IPC_MD_CONTENT_PATH

      Ezzel azonosíthatja a követett dokumentumot. Ahol nincs lehetőség teljes elérési útra, csak adja meg a fájlnevet.

    • IPC_MD_CONTENT_NAME

      Ezzel azonosíthatja a követett dokumentum nevét.

    • IPC_MD_NOTIFICATION_TYPE

      Ezzel adhatja meg, hogy a rendszer mikor küldjön értesítést. További információt az „Értesítés típusa” című szakaszban találhat.

    • IPC_MD_NOTIFICATION_PREFERENCE

      Ezzel adhatja meg az értesítés típusát. További információt az „Értesítés beállítása” című szakaszban találhat.

    • IPC_MD_DATE_MODIFIED

      Érdemes ezt a dátumot minden alkalommal beállítani, amikor a felhasználó a Mentés gombra kattint.

    • IPC_MD_DATE_CREATED

      A fájl létrehozási dátumának beállítására szolgál

  • IpcSerializeLicenseWithMetadata

Ezen API-k közül a megfelelővel adja hozzá a metaadatokat a fájlhoz vagy adatfolyamhoz.

Végül ezzel az API-val regisztrálja a követett dokumentumot a követőrendszerrel.

2. A dokumentum regisztrálása az RMS szolgáltatásban

Itt láthat egy kódrészletet, amely a dokumentumkövető metaadatok beállításának és a követőrendszer regisztrálási hívásának példáját mutatja be.

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

A Használat követése gomb elhelyezése az alkalmazásban

A Használat követése kezelőfelületi elem könnyen elhelyezhető az alkalmazásban – csak használja a következő URL-formátumok egyikét:

  • Tartalomazonosító használata

    • Ha a licenc szerializált, az IpcGetLicenseProperty vagy az IpcGetSerializedLicenseProperty függvénnyel kérje le a tartalomazonosítót, majd használja az IPC_LI_CONTENT_ID licenctulajdonságot. További információ: Licenctulajdonság-típusok.

    • A ContentId és a Kiállító metaadatainál használja a következő formátumot: https://track.azurerms.com/#/{ContentId}/{Issuer}

      Például: https://track.azurerms.com/#/summary/05405df5-8ad6-4905-9f15-fc2ecbd8d0f7/janedoe@microsoft.com

  • Ha nem fér hozzá ezekhez a metaadatokhoz (azaz a dokumentum nem védett verzióját vizsgálja), a Content_Name a következő formátumban használhatja: https://track.azurerms.com/#/?q={ContentName}

    Példa – https://track.azurerms.com/#/?q=Secret!.txt

Az ügyfélnek egyszerűen meg kell nyitnia egy böngészőt a megfelelő URL-lel. A hitelesítést és az esetlegesen szükséges átirányítást az RMS dokumentumkövető portál kezeli.