Quickstart: Proteção do Active Directory Rights Management Server (AD RMS)

Este quickstart mostra-lhe como implementar suporte para o Active Directory Rights Management Server (AD RMS) usando o MIP SDK.

Observação

Os passos descritos neste quickstart aplicam-se apenas ao File SDK para C# ou C++ e ao Protection SDK para C++.

Pré-requisitos

Se ainda não o fez, certifique-se de:

Descoberta de serviços

O SDK do MIP deteta automaticamente o ponto final do serviço no local para um FileEngine ou ProtectionEngine quando não fornece explicitamente um URL do serviço. Utiliza a identidade do utilizador fornecida através de FileEngineSettings ou ProtectionEngineSettings, utilizando o UPN ou o sufixo do endereço de e-mail. Primeiro, ele pesquisa na hierarquia de domínios o registo _rmsdisco para MDE (Microsoft Data Exchange). Para mais informações sobre esse processo, consulte Especificar os registos DNS SRV para a extensão de dispositivo móvel AD RMS. Se esse registro SRV DNS não for encontrado, ele assumirá como padrão o serviço Proteção de Informações do Microsoft Purview como o local do serviço.

Configurando o SDK de Arquivo em C# para usar o AD RMS

A sua aplicação requer duas pequenas alterações se utilizar a Biblioteca de Autenticação da Microsoft (MSAL.NET) e o File SDK em C#. Atualize o FileEngineSettings objeto e a configuração da sua autoridade MSAL para funcionarem com AD RMS e Serviços de Federação do Active Directory (AD FS) (AD FS).

Observação

A Biblioteca de Autenticação do Active Directory (ADAL) está obsoleta. As novas aplicações devem usar MSAL. Para contextualizar, consulte Atualizar as suas aplicações para usar a Biblioteca de Autenticação da Microsoft e a Microsoft Graph API.

Se você implantou o registro SRV DNS da extensão de dispositivo móvel e planeja passar um nome principal de usuário ou endereço de email, siga as instruções para usar uma identidade.

Atualize as definições do motor de ficheiros para usar AD RMS com identidade

Se publicou o registo DNS SRV do MDE e forneceu Microsoft.InformationProtection.Identity nas definições do motor, a única alteração de código necessária é definir FileEngineSettings.ProtectionOnlyEngine = true. Tem de definir esta propriedade porque os pontos finais de proteção do AD RMS não suportam operações de rotulagem (política).

// 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
};

Atualizar o delegado de autenticação

Se estiveres a usar MSAL.NET na tua aplicação .NET, configura a aplicação cliente pública para saltar a validação de autoridade ao direcionar uma autoridade AD FS. Defina WithAuthority(authority, validateAuthority: false) no PublicClientApplicationBuilder:

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

Se estiver a manter uma aplicação legada que ainda utiliza a obsoleta Active Directory Authentication Library (ADAL), a alteração equivalente é passar false por validateAuthority no AuthenticationContext construtor. Planeio migrar esse código para MSAL.

Configurando o SDK de Arquivo em C++ para usar o AD RMS

Se você implantou o registro SRV DNS da extensão de dispositivo móvel e planeja passar um nome principal de usuário ou endereço de email, siga as instruções para usar uma identidade.

Atualize o FileEngine::Settings para usar AD RMS com uma identidade

Se publicou o registo DNS SRV do MDE e tiver fornecido mip::Identity em FileEngine::Settings, a única ação necessária é configurar o motor como um motor apenas de proteção.

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

Configurando o SDK de Proteção em C++ para usar o AD RMS

Se você implantou o registro SRV DNS da extensão de dispositivo móvel e planeja passar um nome principal de usuário ou endereço de email, siga as instruções para usar uma identidade.

Defina o ProtectionEngine::Settings para usar AD RMS com uma identidade

Se publicaste o registo DNS SRV para a extensão do dispositivo móvel e forneceste uma identidade no ProtectionEngine::Settings, não precisas de alterações extra no código para usar AD RMS. A deteção de serviços localiza o ponto final do AD RMS e utiliza-o para operações de proteção.

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

Remover ou comentar referências de rótulos

Se construir a aplicação a partir de um dos guias de início rápido, verá que a sua aplicação tem referências a etiquetas na forma de fileEngine.SensitivityLabels ou engine->ListSensitivityLabels();. Como defines a aplicação apenas para proteção, comenta ou remove esses blocos de código. A sua execução gera uma exceção.

Passos seguintes

Agora que você fez as alterações para dar suporte ao AD RMS, seu aplicativo pode executar quaisquer operações somente de proteção usando o serviço AD RMS como provedor de proteção.

  • Última atualização a