Hızlı Başlangıç: Koruma SDK'ları için istemci uygulaması başlatma (C#)
Bu hızlı başlangıçta, çalışma zamanında MIP SDK .NET sarmalayıcısı tarafından kullanılan istemci başlatma deseninin nasıl uygulanacağı gösterilir.
Dekont
Bu hızlı başlangıçta özetlenen adımlar, MIP .NET sarmalayıcının Koruma SDK'sını kullanan tüm istemci uygulamaları için gereklidir. Bu Hızlı Başlangıçlar, Uygulama Başlatma ve Kimlik Doğrulaması temsilcisi ve Onay temsilcisi sınıflarının uygulanmasından sonra seri olarak yapılmalıdır.
Ön koşullar
Henüz yapmadıysanız şunları yaptığınızdan emin olun:
- Microsoft Information Protection (MIP) SDK kurulumu ve yapılandırmasındaki adımları tamamlayın. Bu "Koruma Profili ve Altyapısı kurulumu" Hızlı Başlangıcı, uygun SDK kurulumuna ve yapılandırmasına dayanır.
- Isteğe bağlı olarak:
- Profil ve altyapı nesnelerini gözden geçirin. Profil ve altyapı nesneleri, MIP Dosya/İlke/Koruma SDK'larını kullanan istemciler için gerekli olan evrensel kavramlardır.
- Kimlik doğrulaması ve onayın SDK ve istemci uygulaması tarafından nasıl uygulandığını öğrenmek için Kimlik doğrulama kavramlarını gözden geçirin.
Visual Studio çözümü ve projesi oluşturma
İlk olarak, diğer Hızlı Başlangıçların oluşturulacağı ilk Visual Studio çözümünü ve projesini oluşturup yapılandıracağız.
Visual Studio 2017'yi açın, Dosya menüsünü (Yeni, Proje) seçin. Yeni Proje iletişim kutusunda:
MIP Dosya SDK'sı için Nuget paketini projenize ekleyin:
- Çözüm Gezgini proje düğümüne sağ tıklayın (doğrudan üst/çözüm düğümü altında) ve NuGet paketlerini yönet...:'ı seçin:
- NuGet Paket Yöneticisi sekmesi Düzenleyici Grubu sekmeleri alanında açıldığında:
- Göz At'ı seçin.
- Arama kutusuna "Microsoft.InformationProtection" yazın.
- "Microsoft.InformationProtection.File" paketini seçin.
- Önizleme değişiklikleri onay iletişim kutusu görüntülendiğinde "Yükle" seçeneğine ve ardından "Tamam"a tıklayın.
MIP Koruma SDK'sı paketini eklemek için yukarıdaki adımları yineleyin, bunun yerine uygulamaya "Microsoft.IdentityModel.Clients.ActiveDirectory" ekleyin.
Kimlik doğrulama temsilcisi ve onay temsilcisi uygulama
Henüz uygulanmadıysa, kimlik doğrulaması ve onay temsilcisi uygulamak için Dosya SDK'sı uygulaması başlatma bölümünde listelenen adımları izleyin.
MIP SDK Yönetilen Sarmalayıcısını başlatma
Çözüm Gezgini, projenizde yönteminin uygulanmasını
Main()
içeren .cs dosyasını açın. Varsayılan olarak, proje oluşturma sırasında belirttiğiniz, onu içeren projeyle aynı ada sahiptir.oluşturulan uygulamasını
main()
kaldırın.Yönetilen sarmalayıcı başlatma, oluşturma,
Microsoft.InformationProtection.MIP
profil yükleme ve kaynakları serbest bırakma için kullanılan statik birMipContext
sınıf içerir. Dosya SDK'sı işlemleri için sarmalayıcıyı başlatmak için, öğesini çağırarakMIP.Initialize()
MipComponent.Protection
koruma işlemleri için gerekli kitaplıkları yükleyin.Program.cs dosyasında aşağıdakini ekleyin ve application-id> değerini daha önce oluşturulan Microsoft Entra Uygulama Kaydı kimliğiyle değiştirin<.
Main()
using System;
using System.Threading.Tasks;
using Microsoft.InformationProtection;
using Microsoft.InformationProtection.Exceptions;
using Microsoft.InformationProtection.Protection;
namespace mip_sdk_dotnet_quickstart
{
class Program
{
private const string clientId = "<application-id>";
private const string appName = "<friendly-name>";
static void Main(string[] args)
{
//Initialize Wrapper for Protection SDK operations
MIP.Initialize(MipComponent.Protection);
}
}
}
Koruma Profili ve Altyapısı Oluşturma
Belirtildiği gibi, MIP API'lerini kullanan SDK istemcileri için profil ve altyapı nesneleri gereklidir. Yerel DLL'leri yükleyip profil ve altyapı nesnelerinin örneğini oluşturacak kod ekleyerek bu Hızlı Başlangıcın kodlama bölümünü tamamlayın.
using System;
using System.Threading.Tasks;
using Microsoft.InformationProtection;
using Microsoft.InformationProtection.Exceptions;
using Microsoft.InformationProtection.Protection;
namespace mip_sdk_dotnet_quickstart
{
class Program
{
private const string clientId = "<application-id>";
private const string appName = "<friendly-name>";
static void Main(string[] args)
{
// Initialize Wrapper for Protection SDK operations.
MIP.Initialize(MipComponent.Protection);
// Create ApplicationInfo, setting the clientID from Azure AD App Registration as the ApplicationId.
ApplicationInfo appInfo = new ApplicationInfo()
{
ApplicationId = clientId,
ApplicationName = appName,
ApplicationVersion = "1.0.0"
};
// Instantiate the AuthDelegateImpl object, passing in AppInfo.
AuthDelegateImplementation authDelegate = new AuthDelegateImplementation(appInfo);
// Create MipConfiguration Object
MipConfiguration mipConfiguration = new MipConfiguration(appInfo, "mip_data", LogLevel.Trace, false);
// Create MipContext using Configuration
mipContext = MIP.CreateMipContext(mipConfiguration);
// Initialize and instantiate the ProtectionProfile.
// Create the ProtectionProfileSettings object.
// Initialize protection profile settings to create/use local state.
var profileSettings = new ProtectionProfileSettings(mipContext,
CacheStorageType.OnDiskEncrypted,
new ConsentDelegateImplementation());
// Load the Profile async and wait for the result.
var protectionProfile = Task.Run(async () => await MIP.LoadProtectionProfileAsync(profileSettings)).Result;
// Create a ProtectionEngineSettings object, then use that to add an engine to the profile.
var engineSettings = new ProtectionEngineSettings("user1@tenant.com", authDelegate, "", "en-US");
engineSettings.Identity = new Identity("user1@tenant.com");
var protectionEngine = Task.Run(async () => await protectionProfile.AddEngineAsync(engineSettings)).Result;
// Application Shutdown
// handler = null; // This will be used in later quick starts.
protectionEngine = null;
protectionProfile = null;
mipContext = null;
}
}
}
Yapıştırdığınız kaynak kodundaki yer tutucu değerlerini aşağıdaki değerleri kullanarak değiştirin:
Yer tutucu Değer Örnek <uygulama kimliği> "MIP SDK kurulumu ve yapılandırması" (2 örnek) içinde kayıtlı uygulamaya atanan Microsoft Entra Uygulama Kimliği. 0edbblll-8773-44de-b87c-b8c6276d41eb <kolay ad> Uygulamanız için kullanıcı tanımlı kolay ad. AppInitialization Şimdi uygulamanın son derlemesini yapın ve hataları çözün. Kodunuz başarıyla derlenmelidir.
Sonraki Adımlar
Başlatma kodunuz tamamlandıktan sonra, MIP Koruması SDK'larını deneyimlemek için bir sonraki hızlı başlangıç için hazırsınız.