Hızlı Başlangıç: Liste Şablonları (C#)

Bu Hızlı Başlangıçta, kullanıcının kullanabileceği koruma şablonlarını listelemek için MIP Koruması SDK'sını nasıl kullanacağınız gösterilmektedir.

Önkoşullar

Henüz yapmadıysanız devam etmeden önce aşağıdaki önkoşulları tamamladığınızdan emin olun:

Koruma şablonlarını listelemek için mantık ekleme

Koruma altyapısı nesnesini kullanarak kullanıcının kullanabileceği koruma şablonlarını listelemek için mantık ekleyin.

  1. Önceki "Hızlı Başlangıç - İstemci uygulaması başlatma - Koruma SDK'sı (C#)" makalesinde oluşturduğunuz Visual Studio çözümünü açın.

  2. Çözüm Gezgini'ni kullanarak, projenizde yönteminin uygulanmasını Main() içeren .cs dosyasını açın. Proje oluşturma sırasında belirlediğiniz isim, varsayılan olarak projeyle aynı olup onu içeren yapıdadır.

  3. Gövdenin Main() sonuna doğru, işlevin uygulama kapatma bölümünün Main() (önceki Hızlı Başlangıçta kaldığınız yer) üzerine aşağıdaki kodu ekleyin:

// List protection templates using protectionEngine and display the list

var templates=protectionEngine.GetTemplates();

for(int i = 0; i < templates.Count; i++)
{
    Console.WriteLine("{0}: {1}", i.ToString(), templates[i].Name + " : " + templates[i].Id);
}

Console.WriteLine("Press a key to continue...");

Uygulamayı derleme ve test etme

Son olarak, istemci uygulamanızı derleyin ve test edin.

  1. İstemci uygulamanızı derlemek için CTRL-SHIFT-B (Çözüm Derleme) kullanın. Derleme hatanız yoksa, uygulamanızı çalıştırmak için F5 (Hata ayıklamayı başlat) kullanın.

  2. Projeniz başarıyla derlenip çalıştırılırsa, SDK yönteminizi AcquireToken() her çağırdığında uygulama MSAL aracılığıyla kimlik doğrulaması isteyebilir. Önbelleğe alınmış kimlik bilgileri zaten varsa, oturum açmanız gerekmeyecek ve etiket listesini görmeyeceksiniz.

    Visual Studio belirteç alma oturum açma

    • Uygulamanın oturum açma hesabı altında çalışırken MIP API'lerine erişmesine izin vermek için de onay vermeniz gerekebilir. Microsoft Entra uygulama kaydı önceden onaylanmamışsa ("MIP SDK kurulumu ve yapılandırmasında belirtildiği gibi") veya farklı bir kiracıdan (uygulamanızın kayıtlı olduğu hesap dışında) bir hesapla oturum açtığınızda bu durum ortaya çıkar. Onayınızı kaydetmek için Kabul Et'e tıklamanız yeterlidir.

      Visual Studio onayı

  3. Kimlik doğrulamasından sonra, konsol çıkışınızda aşağıdaki örneğe benzer şekilde kimliği doğrulanmış kullanıcının koruma şablonları gösterilmelidir:

0: Confidential \ All Employees : a74f5027-f3e3-4c55-abcd-74c2ee41b607
1: Highly Confidential \ All Employees : bb7ed207-046a-4caf-9826-647cff56b990
2: Confidential : 174bc02a-6e22-4cf2-9309-cb3d47142b05
3: Contoso Employees Only : 667466bf-a01b-4b0a-8bbf-a79a3d96f720
Press a key to continue.

Uyarı

Bir veya daha fazla koruma şablonunun kimliğini (örneğin, bb7ed207-046a-4caf-9826-647cff56b990) kopyalayın ve sonraki Hızlı Başlangıçta kullanacağınız şekilde kaydedin.

Sorun giderme

C# uygulamasını yürütme sırasında karşılaşılan sorunlar

Özet Hata iletisi Çözüm
Hatalı erişim belirteci Bir özel durum oluştu... Erişim belirteci yanlış mı/süresi dolmuş mu?

Başarısız API çağrısı: profile_add_engine_async [class mip::PolicySyncException] ilke edinimi başarısız oldu, İstek 401 http durum koduyla başarısız oldu, x-ms-diagnostics: [2000001; gerekçe="İstekle gönderilen OAuth belirteci ayrıştırılamıyor."; hata_kategorisi="invalid_token"], correlationId:[35bc0023-3727-4eff-8062-000006d5d672]

C:\VSProjects\MipDev\Quickstarts\AppInitialization\x64\Debug\AppInitialization.exe (işlem 29924) 0 koduyla çıktı.

Bu pencereyi kapatmak için herhangi bir tuşa basın. . .		 Projeniz başarıyla derlenmişse ancak soldaki örneğe benzer bir çıktı görüyorsanız, AcquireOAuth2Token() metodunuzda büyük olasılıkla geçersiz veya süresi dolmuş bir belirteç bulunmaktadır. Uygulamayı derleyip test etmeye geri dönün, erişim belirtecini yeniden oluşturun, bir kez daha güncelleyin ve yeniden derleyin/yine test edin. Ayrıca tek sayfalı jwt.ms web uygulamasını kullanarak belirteci ve taleplerini inceleyip doğrulayabilirsiniz.

Sonraki Adımlar

Kimliği doğrulanmış kullanıcının kullanabileceği koruma şablonlarını listelemeyi öğrendiğinize göre, sonraki hızlı başlangıcı deneyin:

Hızlı Başlangıç - Metni şifreleme ve şifresini çözme

  • Last updated on