Rychlý start: Ochrana serveru služba Active Directory Rights Management (AD RMS)

V tomto rychlém startu se dozvíte, jak implementovat podporu pro služba Active Directory Rights Management Server (AD RMS) pomocí sady MIP SDK.

Poznámka:

Kroky popsané v tomto rychlém startu platí jenom pro sadu File SDK pro C# nebo C++ a Protection SDK pro jazyk C++.

Požadavky

Pokud jste to ještě neudělali, nezapomeňte:

Zjišťování služeb

Sada MIP SDK automaticky zjistí místní koncový bod služby pro konkrétní FileEngine nebo ProtectionEngine když explicitně nezadáte adresu URL služby. Používá identitu uživatele poskytnutou prostřednictvím FileEngineSettings hlavního názvu uživatele (UPN) nebo ProtectionEngineSettings přípony e-mailové adresy. Nejprve vyhledá v hierarchii domény záznam _rmsdisco pro MDE. Další informace o tomto procesu naleznete v tématu Určení záznamů DNS SRV pro rozšíření mobilních zařízení služby AD RMS. Pokud se tento záznam DNS SRV nenajde, ve výchozím nastavení se jako umístění služby nastaví služba Microsoft Purview Information Protection.

Konfigurace sady File SDK v jazyce C# pro použití služby AD RMS

Aplikace vyžaduje dvě menší změny, pokud používá Identity a ověřování Microsoftu (MSAL.NET) a sadu File SDK v jazyce C#. FileEngineSettings Aktualizujte objekt a konfiguraci autority MSAL tak, aby fungovaly se službou AD RMS a Služby Active Directory Federation (AD FS).

Poznámka:

Knihovna služba Active Directory Authentication Library (ADAL) je zastaralá. Nové aplikace by měly používat knihovnu MSAL. Pozadí najdete v tématu Aktualizace aplikací tak, aby používaly Identity a ověřování Microsoftu a Microsoft Graph API.

Pokud jste nasadili záznam DNS SRV pro rozšíření mobilního zařízení a plánujete zadat hlavní název uživatele (UPN) nebo e-mailovou adresu, postupujte podle pokynů k použití identity.

Aktualizujte nastavení modulu souborů tak, aby používal službu AD RMS s identitou

Pokud jste publikovali záznam DNS SRV pro MDE a zadali Microsoft.InformationProtection.Identity jako součást nastavení modulu, jediná požadovaná změna v kódu spočívá v nastavení FileEngineSettings.ProtectionOnlyEngine = true. Tuto vlastnost musíte nastavit, protože koncové body ochrany AD RMS nepodporují operace popisování (zásad).

// Configure FileEngineSettings as protection only engine.
var engineSettings = new FileEngineSettings("", authDelegate, "", "en-US")
{
     // Provide the identity for service discovery.
     Identity = identity,
     // Set ProtectionOnlyEngine to true for AD RMS as labeling isn't supported
     ProtectionOnlyEngine = true
};

Aktualizace delegáta ověřování

Pokud v aplikaci .NET používáte MSAL.NET, nakonfigurujte veřejnou klientskou aplikaci tak, aby při cílení na autoritu služby AD FS přeskočí ověření autority. Nastavte WithAuthority(authority, validateAuthority: false) na PublicClientApplicationBuilder:

var app = PublicClientApplicationBuilder
    .Create(clientId)
    .WithAuthority(authority, validateAuthority: false)
    .WithRedirectUri(redirectUri)
    .Build();

Pokud udržujete starší aplikaci, která stále používá zastaralou knihovnu služba Active Directory Authentication Library (ADAL), odpovídající změnou je předat false místo validateAuthority v konstruktoru AuthenticationContext. Naplánujte migraci tohoto kódu do knihovny MSAL.

Konfigurace sady File SDK v jazyce C++ pro použití služby AD RMS

Pokud jste nasadili záznam DNS SRV pro rozšíření mobilního zařízení a plánujete zadat hlavní název uživatele (UPN) nebo e-mailovou adresu, postupujte podle pokynů k použití identity.

Aktualizace FileEngine::Settings tak, aby používala službu AD RMS s identitou

Pokud jste zveřejnili záznam DNS SRV pro MDE a zadali mip::Identity v části FileEngine::Settings, je jediným krokem nastavit modul do režimu pouze ochrany.

FileEngine::Settings engineSettings(mip::Identity(mUsername), authDelegate, "");
engineSettings.SetProtectionOnlyEngine(true);

Konfigurace sady Protection SDK v jazyce C++ pro použití služby AD RMS

Pokud jste nasadili záznam DNS SRV pro rozšíření mobilního zařízení a plánujete zadat hlavní název uživatele (UPN) nebo e-mailovou adresu, postupujte podle pokynů k použití identity.

Nastavení ProtectionEngine::Settings pro použití služby AD RMS s identitou

Pokud jste publikovali záznam DNS SRV pro rozšíření mobilních zařízení a zadali identitu v ProtectionEngine::Settings, nepotřebujete k používání služby AD RMS další změny kódu. Zjišťování služeb najde koncový bod služby AD RMS a použije ho k operacím ochrany.

ProtectionEngine::Settings engineSettings(mip::Identity(mUsername), authDelegate, "");

Odeberte nebo zakomentujte odkazy na štítky

Pokud aplikaci sestavíte z některého z průvodců rychlým startem, zjistíte, že vaše aplikace obsahuje odkazy na popisky ve formě fileEngine.SensitivityLabels nebo engine->ListSensitivityLabels();. Vzhledem k tomu, že aplikaci nastavíte pouze na ochranu, zakomentujte nebo odeberte tyto bloky kódu. Jejich spuštění způsobí výjimku.

Další kroky

Teď, když jste provedli změny podpory služby AD RMS, může vaše aplikace provádět jakékoli operace pouze s ochranou pomocí služby AD RMS jako poskytovatele ochrany.

  • Poslední aktualizace v