Offlinepublicatie

Met offlinepublicatie kan een client, na het maken van een initiële verbinding met de Rights Management-service, publicerende licenties genereren voor nieuw beveiligde inhoud zonder dat er een serviceaanroep wordt uitgevoerd. Dit is handig voor toepassingen die in een offlinemodus moeten werken of willen voorkomen dat er serviceaanroepen worden uitgevoerd.

Behoeften

De offlinepublicatiefunctie heeft de volgende vereisten:

  • Een ondersteunde versie van MIP SDK.
  • Een gebruiker met een licentie voor Microsoft Purview Information Protection. Licentievereisten
  • Internetverbinding voor de toepassing om gegevens offline te initialiseren en op te cachen.

Niet ondersteund

De volgende items worden niet ondersteund als onderdeel van de offlinepublicatiefunctie:

  • Active Directory Rights Management Services (AD RMS) wordt niet ondersteund.
  • Dubbele sleutelversleuteling (DKE): de DKE-functie moet een service-aanroep maken om de openbare sleutel bij het publiceren op te halen.

Offlinepublicatie gebruiken met de Protection SDK

Offlinepublicatie vereist drie stappen om de toepassing in staat te stellen te publiceren zonder de service aan te roepen:

  1. Schakel de offlinepublicatie-instelling in op de profielinstellingen (voor de toepasselijke SDK).
  2. Stel de vernieuwingsfrequentie van de sjabloon in. Met deze API wordt de geldigheidsperiode voor de sjablonen in de cache ingesteld.
  3. Roep de api's voor het ophalen van sjablonen aan om de cache (GetTemplatesAsync() of GetTemplates()) te vullen.

Offlinepublicatie gebruiken met de File SDK

De File SDK maakt standaard gebruik van offlinepublicatie en vereist geen extra installatie of configuratie.

Caching-gedrag

Een toepassing neemt geen contact op met de service om sjablonen op te halen totdat de vernieuwingsperiode is verlopen of totdat GetTemplatesAsync() of GetTemplates() wordt aangeroepen. Als de toepassing offline is en de cache is verlopen, mislukt het publiceren. Het vernieuwingsinterval moet een balans vinden tussen offlinegebruik voor eindgebruikers en ervoor zorgen dat sjablonen actueel zijn. Voor de meeste toepassingen, 24 uur of minder, is ideaal.

Voorbeelden

De volgende codefragmenten zijn afkomstig uit deze voorbeeldtoepassingen:

Nadat u de volgende stappen hebt voltooid, vindt het maken van een publicatielicentie plaats zonder een serviceaanroep uit te voeren als de sjablonencache niet is verlopen.

C++-voorbeeld

ProtectionProfileSettings configureren (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);

De vernieuwingsperiode van de sjabloon instellen (C++)

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

Sjablonen ophalen om de cache te initialiseren (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();

.NET-voorbeeld

ProtectionProfileSettings (.NET) configureren

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

// Enable Offline Publishing
profileSettings.OfflinePublishing = true;

Vernieuwingsperiode voor sjablonen instellen (.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);

Sjablonen ophalen om de cache te initialiseren (.NET)

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

Java-voorbeeld

ProtectionProfileSettings configureren (Java)

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

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

De vernieuwingsperiode van de sjabloon instellen (Java)

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

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

Sjablonen ophalen om de cache te initialiseren (Java)

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