Offline publikování

Offline publikování umožňuje klientovi po počátečním připojení ke službě Rights Management generovat licence pro publikování nově chráněného obsahu bez volání služby. To je užitečné pro aplikace, které buď potřebují fungovat v offline režimu, nebo se chcete vyhnout volání služeb.

Požadavky

Funkce offline publikování má následující požadavky:

  • Podporovaná verze sady MIP SDK.
  • Uživatel licencovaný pro Microsoft Purview Information Protection. Licenční požadavky
  • Připojení k internetu pro aplikaci pro inicializaci a ukládání dat do mezipaměti offline.

Nepodporováno

Následující položky nejsou podporovány jako součást funkce offline publikování:

  • Služba AD RMS (služba Active Directory Rights Management Services) není podporována.
  • Dvojité šifrování klíče (DKE): Funkce DKE musí volat službu pro načtení veřejného klíče během publikování.

Použití offline publikování s Protection SDK

Offline publikování vyžaduje tři kroky, aby aplikace mohla publikovat bez volání služby.

  1. Povolte nastavení offline publikování v nastavení profilu (pro příslušnou sadu SDK).
  2. Nastavte obnovovací frekvenci šablony. Toto rozhraní API nastavuje dobu platnosti pro šablony uložené v mezipaměti.
  3. Voláním rozhraní API pro načtení šablony naplníte mezipaměť (GetTemplatesAsync() nebo GetTemplates()).

Použití offline publikování se sadou File SDK

Sada File SDK ve výchozím nastavení používá offline publikování a nevyžaduje žádné další nastavení ani konfiguraci.

Chování při ukládání do mezipaměti

Aplikace nebude kontaktovat službu, aby získala šablony, dokud nevyprší doba aktualizace nebo dokud nebude vyvolána funkce GetTemplatesAsync() nebo GetTemplates(). Pokud je aplikace offline a platnost mezipaměti vypršela, publikování se nezdaří. Interval aktualizace by měl zajistit rovnováhu mezi offline využitím pro koncové uživatele a zajistit, aby šablony byly čerstvé. Pro většinu aplikací je ideální 24 hodin nebo méně.

Příklady

Následující fragmenty kódu pocházejí z těchto ukázkových aplikací:

Po dokončení následujících kroků dojde k vytvoření licence pro publikování bez volání služby, pokud nevypršela platnost mezipaměti šablon.

Příklad jazyka C++

Konfigurace nastavení profilu ochrany (C++)

// Initialize ProtectionProfileSettings using MipContext
ProtectionProfile::Settings profileSettings(mMipContext,
    mip::CacheStorageType::OnDiskEncrypted,
    ::make_shared<sample::consent::ConsentDelegateImpl>(),
    std::make_shared<ProtectionProfileObserverImpl>()
);

// Enable Offline Publishing
profileSettings.SetOfflinePublishing(true);

Nastavení období aktualizace šablony (C++)

// Set the template refresh interval
engineSettings.SetTemplateRefreshArgs(std::chrono::hours(24));

Načtení šablon pro inicializaci mezipaměti (C++)

auto loadPromise = std::make_shared<std::promise<vector<shared_ptr<mip::TemplateDescriptor>>>>();
std::future<vector<shared_ptr<mip::TemplateDescriptor>>> loadFuture = loadPromise->get_future();
mEngine->GetTemplatesAsync(engineObserver, loadPromise);
auto templates = loadFuture.get();

Příklad .NET

Konfigurace ProtectionProfileSettings (.NET)

// Initialize ProtectionProfileSettings
var profileSettings = new ProtectionProfileSettings(mipContext, 
                CacheStorageType.OnDisk, 
                new ConsentDelegateImplementation());

// Enable Offline Publishing
profileSettings.OfflinePublishing = true;

Nastavení období aktualizace šablony (.NET)

// Initialize ProtectionEngineSettings
var engineSettings = new ProtectionEngineSettings(identity.Email, authDelegate, "", "")
{
    Identity = identity
};

// Set the template refresh interval
engineSettings.TemplateRefreshRate = new TimeSpan(24, 0, 0);

var engine = profile.AddEngine(engineSettings);

Načtení šablon pro inicializaci mezipaměti (.NET)

List<TemplateDescriptor> templates = engine.GetTemplates();

Příklad Javy

Konfigurace ProtectionProfileSettings (Java)

ProtectionProfileSettings profileSettings = new ProtectionProfileSettings();
profileSettings.setMipContext(mipContext);
profileSettings.setCacheStorageType(CacheStorageType.ON_DISK);
profileSettings.setConsentDelegate(new ConsentDelegateImplementation());

// Enable Offline Publishing
profileSettings.setOfflinePublishing(true);

Nastavení období aktualizace šablony (Java)

ProtectionEngineSettings engineSettings = new ProtectionEngineSettings(identity.getEmail(), authDelegate, "", "");
engineSettings.setIdentity(identity);

// Set the template refresh interval in hours
engineSettings.setTemplateRefreshRate(Duration.ofHours(24));

Načtení šablon pro inicializaci mezipaměti (Java)

List<TemplateDescriptor> templates = engine.getTemplates();
  • Last updated on