Schnellstart: Listenvorlagen (C#)

In dieser Schnellstartanleitung erfahren Sie, wie Sie das MIP Protection SDK verwenden, um die für den Benutzer verfügbaren Schutzvorlagen auflisten zu können.

Voraussetzungen

Falls Sie dies noch nicht getan haben, stellen Sie vor dem Fortfahren sicher, dass die folgenden Voraussetzungen erfüllt sind.

• Schließen Sie zuerst den Schnellstart: Initialisieren von Clientanwendungen – Protection SDK (C#) ab, in dem eine Starterprojektmappe für Visual Studio erstellt wird. Dieser Schnellstart zum „Auflisten der Schutzvorlagen“ baut auf der vorherigen Erstellung der Starterprojektmappe auf.
• Optional: Überprüfen Sie die RMS-Vorlagenkonzepte .

Hinzufügen von Logik zum Auflisten der Schutzvorlagen

Fügen Sie mithilfe des Protection-Modulobjekts Logik zu Listenschutzvorlagen hinzu, die einem Benutzer zur Verfügung stehen.

1. Öffnen Sie die Visual Studio-Lösung, die Sie im vorherigen Artikel "Schnellstart – Clientanwendungsinitialisierung – Protection SDK (C#)" erstellt haben.

2. Öffnen Sie im Projektmappen-Explorer die CS-Datei in Ihrem Projekt, die die Implementierung der Main()-Methode enthält. Standardmäßig weist sie denselben Namen wie das Projekt auf, in dem sie enthalten ist. Diesen Namen haben Sie bei der Projekterstellung angegeben.

3. Fügen Sie am Ende des Methodenkörpers von Main() oberhalb des Abschnitts zum Herunterfahren der Anwendung in der Main()-Funktion (wo Sie im vorherigen Schnellstart aufgehört haben) den folgenden Code ein:

// 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...");

Erstellen und Testen der Anwendung

Erstellen und testen Sie schließlich Ihre Clientanwendung.

1. Verwenden Sie Strg-SHIFT-B (Lösung erstellen), um Ihre Client-App zu erstellen. Wenn keine Buildfehler auftreten, verwenden Sie F5 (Debuggen starten), um Ihre Anwendung auszuführen.

2. Wenn Ihr Projekt erfolgreich erstellt und ausgeführt wird, fordert die Anwendung die Authentifizierung über ADAL jedes Mal auf, wenn das SDK Ihre AcquireToken() Methode aufruft. Wenn bereits zwischengespeicherte Anmeldeinformationen vorhanden sind, werden Sie nicht aufgefordert, sich anzumelden und die Liste der Labels anzuzeigen.

   

   • Möglicherweise müssen Sie auch die Zustimmung erteilen, damit die Anwendung auf die MIP-APIs zugreifen kann, während sie unter dem Anmeldekonto ausgeführt wird. Dies geschieht, wenn die Registrierung der Microsoft Entra-Anwendung nicht vorab zugestimmt wird (wie in "MIP SDK-Setup und -Konfiguration" beschrieben), oder Sie melden sich mit einem Konto von einem anderen Mandanten (außer dem konto, in dem Ihre Anwendung registriert ist) an. Klicken Sie einfach auf "Annehmen" , um Ihre Zustimmung aufzuzeichnen.

     

3. Nach der Authentifizierung sollte die Konsolenausgabe die Schutzvorlagen für den authentifizierten Benutzer anzeigen, ähnlich dem folgenden Beispiel:

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.

Problembehandlung

Probleme bei der Ausführung der C#-Anwendung

Nächste Schritte

Nachdem Sie nun erfahren haben, wie Sie die für authentifizierten Benutzer verfügbaren Schutzvorlagen auflisten, probieren Sie die nächste Schnellstartanleitung aus: