Microsoft Information Protection (MIP) SDK kurulumu ve yapılandırması

Hızlı başlangıç ve öğretici makaleleri, MIP SDK kitaplıklarını ve API'lerini kullanan uygulamalar oluşturmaya odaklanır. Bu makalede, SDK'yı kullanmadan önce Microsoft 365 aboneliğinizi ve istemci iş istasyonunuzu nasıl ayarlayıp yapılandırabileceğiniz gösterilir.

Önkoşullar

Başlamadan önce aşağıdaki konuları gözden geçirin:

Önemli

Kullanıcı gizliliğine saygı göstermek için otomatik günlüğe kaydetmeyi etkinleştirmeden önce kullanıcıdan onay istemeniz gerekir. Aşağıdaki örnek, Microsoft'un günlük bildirimi için kullandığı standart bir iletidir:

Hata ve performans günlüğünü açarak hata ve performans verilerini Microsoft göndermeyi kabul etmiş olursunuz. Microsoft, İnternet üzerinden hata ve performans verilerini ("Veri") toplar. Microsoft, Microsoft ürün ve hizmetlerinin kalitesini, güvenliğini ve bütünlüğünü sağlamak ve geliştirmek için bu Verileri kullanır. Örneğin, Microsoft hangi özellikleri kullandığınız, özelliklerin ne kadar hızlı yanıt verdiği, cihaz performansı, kullanıcı arabirimi etkileşimleri ve ürünle yaşadığınız sorunlar gibi performans ve güvenilirliği analiz eder. Veriler, şu anda çalıştırdığınız yazılım ve IP adresi gibi yazılım yapılandırmanızla ilgili bilgileri de içerir.

Office 365 aboneliğine kaydolma

SDK örneklerinin çoğu office 365 aboneliğine erişim gerektirir. Aşağıdaki abonelik türlerinden birine kaydolun:

İsim Kaydolma
Office 365 Kurumsal E3 Deneme Sürümü (30 günlük ücretsiz deneme) https://go.microsoft.com/fwlink/p/?LinkID=403802
Office 365 Kurumsal E3 veya E5 https://www.microsoft.com/microsoft-365/enterprise/office-365-e3
Enterprise Mobility and Security E3 veya E5 https://www.microsoft.com/security
Azure Information Protection Premium P1 veya P2 Güvenlik ve uyumluluk için Microsoft 365 lisanslama kılavuzu
Microsoft 365 E3, E5 veya F1 https://www.microsoft.com/microsoft-365/enterprise/microsoft365-plans-and-pricing

Not

Azure Information Protection Premium P1 veya P2 artık tek başına teklifler olarak dahil değildir. Bunları Microsoft 365 E3 veya E5 ya da Enterprise Mobility and Security E3 veya E5 kapsamında satın alabilirsiniz.

Duyarlılık etiketlerini yapılandırma

Şu anda eski etiket yapılandırmalarını kullanıyorsanız etiketlerinizi Microsoft Purview'a geçirmeniz gerekir. İşlem hakkında daha fazla bilgi için bkz. Duyarlılık etiketleri ve ilkeleri oluşturma ve yapılandırma.

İstemci iş istasyonunuzu yapılandırma

Ardından, istemci bilgisayarınızı doğru şekilde ayarlamak ve yapılandırmak için aşağıdaki adımları tamamlayın.

  1. Windows 10 iş istasyonu kullanıyorsanız:

    Makinenizi Fall Creators Update (sürüm 1709) veya sonraki Windows 10 güncelleştirmek için Windows Update kullanın. Geçerli sürümünüzü doğrulamak için:

    • Sol alttaki Windows simgesini seçin.
    • Bilgisayarınız hakkında yazın ve Enter tuşuna basın.
    • Ekranı aşağı kaydırarak Windows belirtimlerine gidin ve Sürüm'e bakın.

  2. Windows 11 veya Windows 10 iş istasyonu kullanıyorsanız:

    İş istasyonunuzda Geliştirici Modu'nu açın:

    • Sol alttaki Windows simgesini seçin.
    • Geliştirici özelliklerini kullan yazın ve Geliştirici özelliklerini kullan öğesi görüntülendiğinde Enter tuşuna basın.
    • Ayarlar iletişim kutusundaki Geliştiriciler için sekmesindeki Geliştirici özelliklerini kullan'ın altında Geliştirici modu seçeneğini belirleyin.
    • Ayarlar iletişim kutusunu kapatın.

  3. Visual Studio 2022'yi aşağıdaki iş yükleri ve isteğe bağlı bileşenlerle yükleyin:

    • Evrensel Windows Platformu geliştirme Windows iş yüküne ek olarak aşağıdaki isteğe bağlı bileşenler:

      • C++ Evrensel Windows Platformu araçları
      • Varsayılan olarak dahil değilse Windows 10 SDK 10.0.16299.0 SDK veya üzeri

    • C++ Windows iş yüküyle masaüstü geliştirme ve aşağıdaki isteğe bağlı bileşenler:

      • Varsayılan olarak dahil değilse Windows 10 SDK 10.0.16299.0 SDK veya üzeri

      Visual Studio kurulumu.

  4. MSAL.PS PowerShell Modülünü yükleyin:

    • Yükleme yönetici hakları gerektirdiğinden şu seçeneklerden birini kullanın:

      • Bilgisayarınızda yönetici haklarına sahip bir hesapla oturum açın.
      • Yükseltilmiş haklarla Windows PowerShell oturumunu çalıştırın (Yönetici Olarak Çalıştır).

    • Install-Module -Name MSAL.PS cmdlet'i çalıştırın.

      PS C:\WINDOWS\system32> Install-Module -Name MSAL.PS

Untrusted repository
You are installing the modules from an untrusted repository. If you trust this repository, change its
InstallationPolicy value by running the Set-PSRepository cmdlet. Are you sure you want to install the modules from
'PSGallery'?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A

PS C:\WINDOWS\system32>

  5. Dosyaları indirme:

    MIP SDK'sı, desteklenen her platform ve dil için ayrı indirmelerle aşağıdaki platformlarda desteklenir:

    İşletim sistemi Sürümler İndirmeler Notlar
    Ubuntu 22.04 C++ tar.gz
    Java (Önizleme) tar.gz
    .NET Core
    Ubuntu 24 Nisan C++ tar.gz
    Java (Önizleme) tar.gz
    .NET Core
    Red Hat Enterprise Linux 8 ve 9 C++ tar.gz
    Debian 10 ve 11 C++ tar.gz
    macOS Desteklenen tüm sürümler C++ .zip Xcode geliştirme için 13 veya daha büyük bir değer gerekir.
    Windows Desteklenen tüm sürümler, 32/64 bit C++
    C++/.NET NuGet
    Java (Önizleme) .zip
    Android 9.0 ve üzeri C++ .zip Yalnızca Koruma ve İlke SDK'ları.
    Ios Desteklenen tüm sürümler C++ .zip Yalnızca Koruma ve İlke SDK'ları.

    Tar.gz/.zip indirmeleri

    Tar.gz ve .zip indirmeleri, her API için bir tane olan sıkıştırılmış dosyalar içerir. Sıkıştırılmış dosyalar, şu adlandırma kuralını kullanır; burada <API> = file, protection veya upe ve <OS> = platform: mip_sdk_<API>_<OS>_1.0.0.0.zip (or .tar.gz). Örneğin, Debian'da Protection SDK ikili dosyaları ve başlık dosyaları için dosya mip_sdk_protection_debian9_1.0.0.0.tar.gz'dır. İçeren her .tar.gz/.zip dosyası üç dizine ayrılır:

    • Bölmeler: Uygun olduğunda her platform mimarisi için derlenmiş ikili dosyalar.
    • Ekle: Üst bilgi dosyaları (C++).
    • Örnekler: Örnek uygulamalar için kaynak kodu.

    NuGet paketleri

    Visual Studio geliştirme yapıyorsanız, NuGet Paket Yöneticisi Konsolu'nu kullanarak SDK'yı da yükleyebilirsiniz:

    Install-Package Microsoft.InformationProtection.File
Install-Package Microsoft.InformationProtection.Policy
Install-Package Microsoft.InformationProtection.Protection

  6. NuGet paketini kullanmıyorsanız, SDK ikili dosyalarının yollarını PATH ortam değişkenine ekleyin. PATH değişkeni, istemci uygulamalarının çalışma zamanında bağımlı ikili dosyaları (DLL' ler) bulmasını sağlar. Bu adım isteğe bağlıdır.

    Windows 11 veya Windows 10 iş istasyonu kullanıyorsanız:

    • Sol alttaki Windows simgesini seçin.

    • Yol yazın ve Sistem ortamı değişkenlerini düzenle öğesi görüntülendiğinde Enter tuşuna basın.

    • Sistem Özellikleri iletişim kutusunda Ortam Değişkenleri'ni seçin.

    • Ortam Değişkenleri iletişim kutusunda, <kullanıcısı için Kullanıcı değişkenleri> altındaki Path değişkeni satırını seçin, ardından Düzenle'yi seçin.

    • Ortam değişkenini düzenle iletişim kutusunda, Düzenlenebilir bir satır oluşturan Yeni'yi seçin. protection\bins\debug\amd64, upe\bins\debug\amd64 ve file\bins\debug\amd64 alt dizinlerinin her bir tam yolu için yeni bir satır ekleyin. SDK dizinleri bir <API>\bins\<target>\<platform> biçimde depolanır ve burada:

      • <API> = file, protection, upe
      • <hedef> = debug, release
      • <platform> = amd64 (x64), x86 ve benzeri.

    • Yol değişkenini güncelleştirmeyi bitirdiğinizde Tamam'ı seçin. Ardından Ortam Değişkenleri iletişim kutusuna döndüğünüzde Tamam'ı seçin.

  7. GitHub'dan SDK örneklerini indirin. Bu adım isteğe bağlıdır.

Microsoft Entra Id ile bir istemci uygulaması kaydetme

Microsoft 365 abonelik sağlama işleminin bir parçası olarak Microsoft ilişkili bir Microsoft Entra kiracısı oluşturur. Microsoft Entra kiracısı, Microsoft 365 kullanıcı hesapları ve uygulama hesapları için kimlik ve erişim yönetimi sağlar. Güvenli API'lere (MIP API'leri gibi) erişim gerektiren uygulamalar bir uygulama hesabı gerektirir.

Çalışma zamanında kimlik doğrulaması ve yetkilendirme için güvenlik sorumlusu bir hesabı temsil eder ve hesabın kimlik bilgilerinden türetilir. Bir uygulama hesabını temsil eden güvenlik sorumlularına hizmet sorumlusu adı verilir.

Hızlı başlangıçlar ve MIP SDK örnekleriyle kullanmak üzere bir uygulama hesabını Microsoft Entra ID kaydetmek için:

Önemli

Hesap oluşturmak üzere Microsoft Entra kiracı yönetimine erişmek için abonelikteki Sahip rolünün üyesi olan bir kullanıcı hesabıyla Azure portalında oturum açın. Kiracınızın yapılandırmasına bağlı olarak, bir uygulamayı kaydetmek için Genel Yönetici dizin rolünün de üyesi olmanız gerekebilir. Kısıtlı bir hesapla test edin. Hesaba yalnızca gerekli SCC uç noktalarına erişmek için gereken hakları verin. Günlükleme sistemleri, komut satırı üzerinden iletilen düz metin parolaları toplayabilir.

  1. Yeni uygulama kaydetme bölümündeki adımları izleyin. Test amacıyla, kılavuz adımlarını ilerleterek verilen özellikler için aşağıdaki değerleri kullanın:

    • Desteklenen hesap türleri - Yalnızca bu kuruluş dizinindeki Hesaplar'ı seçin.
    • Yeniden yönlendirme URI'si - Yeniden yönlendirme URI'si türünü Genel istemci (mobil ve masaüstü) olarak ayarlayın. Uygulamanız Microsoft Authentication Library (MSAL) kullanıyorsa kullanınhttp://localhost. Aksi takdirde biçiminde <app-name>://authorizebir şey kullanın.

  2. İşiniz bittiğinde, yeni uygulama kaydınız için Kayıtlı uygulama sayfasına dönersiniz. Hızlı başlangıçlar için ihtiyacınız olduğu gibi GUID'yi kopyalayıp Uygulama (istemci) Kimliği alanına kaydedin.

  3. İstemcinin erişmesi gereken API'leri ve izinleri eklemek için API izinleri'ni seçin. İzin ekle'yi seçerek API izinleri iste bölmesini açın.

  4. Uygulamanın çalışma zamanında gerektirdiği MIP API'lerini ve izinlerini ekleyin:

    • API seçin sayfasında Rights Management Services Azure'ı seçin.
    • Azure Rights Management Services API sayfasında Temsilci izinleri'ni seçin.
    • İzinleri seçin bölümünde user_impersonation iznini seçin. Bu hak, uygulamanın kullanıcı adına korumalı içerik oluşturmasını ve bunlara erişmesini sağlar.
    • Kaydetmek için İzin ekle'yi seçin.

  5. 4. adımı yineleyin, ancak bu kez API seçin sayfasına gittiğiniz zaman API'yi arayın.

    • API seçin sayfasında kuruluşumun kullandığı API'leri seçin. Ardından arama kutusuna Microsoft Information Protection Sync Service yazın ve seçin.
    • Microsoft Information Protection Eşitleme Hizmeti API'sinde Temsilci izinleri'ni seçin.
    • UnifiedPolicy düğümünü genişletin ve UnifiedPolicy.User.Read öğesini seçin.
    • Kaydetmek için İzin ekle'yi seçin.

  6. API izinleri sayfasına geri döndüğünüzde, (Kiracı Adı) için yönetici onayı ver seçeneğini, ardından Evet'i seçin. Bu adım, belirtilen izinler altındaki API'lere erişmek için bu kaydı kullanan uygulamaya ön onay verir. Genel yönetici olarak oturum açtıysanız, uygulamayı çalıştıran kiracıdaki tüm kullanıcılar için onay kaydedilir. Aksi takdirde, yalnızca kullanıcı hesabınız için geçerlidir.

tamamlandığında, uygulama kaydı ve API izinleri aşağıdaki örneklere benzer görünmelidir:

Microsoft Entra uygulama kaydı. Microsoft Entra uygulama API izinleri.

bir istemci uygulaması için gereken API'leri ve izinleri ekleme hakkında daha fazla bilgi için bkz. Web API'lerine erişmek için bir istemci uygulaması yapılandırma.

Bilgi Koruma Tümleştirme Sözleşmesi (IPIA) isteme

MIP ile geliştirilen bir uygulamayı genel kullanıma sunmadan önce, Microsoft ile resmi bir sözleşmeye başvurmanız ve bunu tamamlamanız gerekir.

Not

Bu sözleşmeye yalnızca şirket içi kullanıma yönelik uygulamalar için ihtiyacınız yoktur.

  1. Aşağıdaki bilgileri içeren bir e-postayı IPIA@microsoft.com adresine göndererek IPIA'nızı almak için:

    Konu: Şirket Adı için IPIA İsteme

    E-postanın gövdesine şunları ekleyin:

    • Uygulama ve ürün adı
    • İstekte bulunanın adı ve soyadı
    • İstekte bulunanın e-posta adresi

  2. Microsoft IPIA isteğinizi aldıktan sonra Microsoft size Word belge olarak bir form gönderir. IPIA'nın hüküm ve koşullarını gözden geçirin ve formu IPIA@microsoft.com aşağıdaki bilgilerle geri gönderin:

    • Şirketin yasal adı
    • Eyalet/il (ABD/Kanada) veya kuruluş ülkesi/bölgesi
    • Şirket URL'si
    • İlgili kişinin e-posta adresi
    • Şirketin diğer adresleri (isteğe bağlı)
    • Şirket uygulamasının adı
    • Uygulamanın kısa açıklaması
    • Azure Kiracı Kimliği
    • Uygulamanın Uygulama Kimliği
    • Kritik durum yazışmaları için şirket kişileri, e-posta ve telefon

  3. Microsoft formunuzu aldıktan sonra Microsoft size dijital olarak imzalamanız için son IPIA bağlantısını gönderir. İmzaladıktan sonra, uygun Microsoft temsilcisi sözleşmeyi imzalar.

Zaten imzalı bir IPIA'nız mı var?

Zaten imzalı bir IPIA'nız varsa ve yayınladığınız bir uygulama için yeni bir Uygulama Kimliği eklemek istiyorsanız adresine bir e-posta IPIA@microsoft.com gönderin ve aşağıdaki bilgileri sağlayın:

  • Şirket uygulamasının adı
  • Uygulamanın kısa açıklaması
  • Azure Kiracı Kimliği (öncekiyle aynı olsa bile)
  • Uygulamanın Uygulama Kimliği
  • Kritik durum yazışmaları için şirket kişileri, e-posta ve telefon

E-postayı gönderdikten sonra alındı bildirimi için 72 saate kadar bekleyin.

Uygulamanızın gerekli bağımlılıklara sahip olduğundan emin olun

Windows üzerinde MIP SDK'sı ile oluşturulan uygulamalar, henüz yüklü değilse Visual C++ Çalışma Zamanı bileşenini gerektirir:

Bu bağımlılıklar yalnızca uygulamayı Release olarak derlediyseniz çalışır. Uygulamayı Hata Ayıklama olarak derlerseniz, Visual C++ çalışma zamanı hata ayıklama DLL'lerini uygulamaya ekleyin veya makineye yükleyin.

Linux üzerinde MIP SDK'sı ile oluşturulan uygulamalar için şu bağımlılıkların desteklenen sürümleri gerekir:

İkili dosyalar, her işletim sistemi için gerekli bağımlılıkları yüklemeye yönelik komutları içeren bir dosya içeren bir how-to-build-and-run.txt örnek klasörü içerir.

Sonraki Adımlar

  • Son güncelleştirme: