Aracılığıyla paylaş


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.

Ön koş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 kullanarak, yönteminin uygulanmasını Main() içeren projenizde .cs dosyasını açın. Varsayılan olarak, proje oluşturma sırasında belirttiğiniz, onu içeren projeyle aynı ada sahiptir.

  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 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

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 Microsoft Authentication Library (MSAL) kullanarak kimlik doğrulaması isteyebilir. Önbelleğe alınmış kimlik bilgileri zaten varsa oturum açmanız ve etiket listesini görmeniz istenmez.

    Visual Studio acquire token sign-in

    • 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 consent

  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.

Dekont

Bir veya daha fazla duyarlılık etiketinin kimliğini (örneğin, f42a3342-8706-4288-bd31-ebb85995028z) 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 Başarısız: [class mip::P olicySyncException] başarısız ilke alma, İstek http durum koduyla başarısız oldu: 401, x-ms-diagnostics: [2000001; reason="İstekle gönderilen OAuth belirteci ayrıştırılamıyor."; error_category="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 sola benzer bir çıkış görüyorsanız, yönteminizde büyük olasılıkla geçersiz veya süresi dolmuş bir belirteciniz AcquireOAuth2Token() vardır. Uygulamayı derleyip test edin ve erişim belirtecini yeniden oluşturun, yeniden güncelleştirin AcquireOAuth2Token() ve yeniden derleyin/yeniden test edin. Ayrıca tek sayfalı jwt.ms web uygulamasını kullanarak belirteci ve taleplerini inceleyip doğrulayabilirsiniz.
Duyarlılık etiketleri yapılandırılmadı yok Projeniz başarıyla derleniyorsa ancak konsol penceresinde çıkışınız yoksa 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 listelemeyi öğrendiğinize göre sonraki hızlı başlangıcı deneyin: