Hızlı Başlangıç: Duyarlılık etiketlerini listeleme (C#)

Bu hızlı başlangıçta, kuruluşunuz için yapılandırılan duyarlılık etiketlerini listelemek için MIP Dosya 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:

Duyarlılık etiketlerini listelemek için mantık ekleme

Dosya altyapısı nesnesini kullanarak kuruluşunuzun duyarlılık etiketlerini listelemek için mantık ekleyin.

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

  2. Çözüm Gezgini'da, 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. Main() gövdesinin sonlarına doğru, Main() işlevinin uygulamayı kapatma bölümünden önce (önceki hızlı başlangıçta kaldığınız yerde), aşağıdaki kodu ekleyin:

// List sensitivity labels from fileEngine and display name and id
foreach(var label in fileEngine.SensitivityLabels)
{
    Console.WriteLine(string.Format("{0} : {1}", label.Name, label.Id));

    if (label.Children.Count != 0)
    {
        foreach (var child in label.Children)
        {
            Console.WriteLine(string.Format("{0}{1} : {2}", "\t",child.Name, child.Id));
        }
    }
}

Uygulamayı derleme ve test etme

İstemci uygulamanızı derleyin ve test edin.

  1. İstemci uygulamanızı derlemek için CTRL-SHIFT-B (Çözümü Derle) kullanın. Derleme hataları 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 Microsoft Authentication Library (MSAL) kullanarak kimlik doğrulaması isteyebilir. Önbelleğe alınmış kimlik bilgileri zaten varsa oturum açmanız istenmez ve etiket listesini görürsünüz.

    Visual Studio belirteç edinme oturum açma istemi.

    • Ayrıca, 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'i seçin.

      Visual Studio onay istemi.

  3. Kimlik doğrulamasından sonra konsol çıkışınız aşağıdaki örneğe benzer şekilde duyarlılık etiketlerini göstermelidir:

Personal : 73c47c6a-eb00-4a6a-8e19-efaada66dee6
Public : 73254501-3d5b-4426-979a-657881dfcb1e
General : da480625-e536-430a-9a9e-028d16a29c59
Confidential : 569af77e-61ea-4deb-b7e6-79dc73653959
      Recipients Only (C) : d98c4267-727b-430e-a2d9-4181ca5265b0
      All Employees (C) : 2096f6a2-d2f7-48be-b329-b73aaa526e5d
      Anyone (not protected) (C) : 63a945ec-1131-420d-80da-2fedd15d3bc0
Highly Confidential : 905845d6-b548-439c-9ce5-73b2e06be157
      Recipients Only : 05ee72d9-1a75-441f-94e2-dca5cacfe012
      All Employees : 922b06ef-044b-44a3-a8aa-df12509d1bfe
      Anyone (not protected) : c83fc820-961d-40d4-ba12-c63f72a970a3
Press a key to continue.

Note

Bir veya daha fazla duyarlılık etiketinin (örneğin, f42a3342-8706-4288-bd31-ebb85995028z) kimliğini kopyalayın ve kaydedin, çünkü sonraki hızlı başlangıçta bunu kullanırsınız.

Troubleshooting

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

Summary Hata iletisi Solution
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 Şununla başarısız oldu: [class mip::PolicySyncException] İlke alınamadı, istek şu HTTP durum koduyla başarısız oldu: 401, x-ms-diagnostics: [2000001;reason="İstekle birlikte gönderilen OAuth belirteci ayrıştırılamıyor.";error_category="invalid_token"], correlationId:[aaaa0000-bb11-2222-33cc-444444dddddd]'

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 derleniyorsa ancak soldakine benzer bir çıkış görüyorsanız, yönteminizdeki AcquireOAuth2Token() belirtecin geçersiz veya süresi dolmuş olabilir. 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 belirteci ve claim’lerini, jwt.ms tek sayfalı web uygulamasını kullanarak inceleyebilir ve doğrulayabilirsiniz.
Duyarlılık etiketleri yapılandırılmadı n/a Projeniz başarıyla derleniyorsa ancak konsol penceresinde çıkış görünmüyorsa, kuruluşunuzun duyarlılık etiketlerinin doğru yapılandırıldığından emin olun. Ayrıntılar için "Etiket taksonomisi ve koruma ayarlarını tanımlama" altındaki MIP SDK kurulumu ve yapılandırması bölümüne bakın.

Sonraki Adımlar

Kuruluşunuz için duyarlılık etiketlerini nasıl listeleyebileceğinizi öğrendiğinize göre, sonraki hızlı başlangıcı deneyin:

Duyarlılık etiketini ayarla ve al

  • Last updated on