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

Führen Sie die folgenden Voraussetzungen aus, bevor Sie fortfahren:

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 in Projektmappen-Explorer die datei .cs 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 Main() Texts oberhalb des Abschnitts zum Herunterfahren der Anwendung der Main() Funktion (wo Sie in der vorherigen Schnellstartanleitung 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 Ihre Clientanwendung.

  1. Drücken Sie STRG+UMSCHALT+B (Projektmappe erstellen), um Ihre Clientanwendung zu erstellen. Wenn der Build keine Fehler aufweist, verwenden Sie F5 (Debuggen starten), um Ihre Anwendung auszuführen.

  2. Wenn Ihr Projekt erfolgreich erstellt wird und ausgeführt werden kann, fordert die Anwendung möglicherweise jedes Mal zur Authentifizierung mit MSAL auf, wenn das SDK Ihre AcquireToken()-Methode aufruft. Wenn bereits zwischengespeicherte Anmeldeinformationen vorhanden sind, werden Sie nicht aufgefordert, sich anzumelden und die Liste der Bezeichnungen anzuzeigen.

    Visual Studio-Anmeldung zum Erhalten des Tokens.

    • 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. Wählen Sie "Annehmen" aus, um Ihre Zustimmung aufzuzeichnen.

      Visual Studio Zustimmung.

  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.

Hinweis

Kopieren und speichern Sie die IDs einer oder mehrerer Schutzvorlagen (z. B. bb7ed207-046a-4caf-9826-647cff56b990), um sie im nächsten Schnellstart zu verwenden.

Problembehandlung

Probleme bei der Ausführung der C#-Anwendung

Zusammenfassung Fehlermeldung Lösung
Ungültiges Zugriffstoken Ausnahme ist aufgetreten... ist das Zugriffstoken falsch/abgelaufen?

Fehler bei API-Aufruf: profile_add_engine_async Fehler: [class mip::PolicySyncException] Fehler beim Abruf von Richtlinie, Fehler bei Anforderung mit HTTP-Statuscode: 401, x-ms-diagnostics: [2000001;reason="Das mit der Anforderung übermittelte OAuth-Token kann nicht analysiert werden.";error_category="invalid_token"], correlationId:[35bc0023-3727-4eff-8062-000006d5d672]'

C:\VSProjects\MipDev\Quickstarts\AppInitialization\x64\Debug\AppInitialization.exe (Prozess 29924) wurde mit Code 0 beendet.

Drücken Sie eine beliebige Taste, um dieses Fenster zu schließen. . .		 Wenn Ihr Projekt erfolgreich erstellt wird und dennoch eine Ausgabe ähnlich der linken angezeigt wird, enthält Ihre AcquireOAuth2Token()-Methode wahrscheinlich ein ungültiges oder abgelaufenes Token. Wechseln Sie zurück zu Build, und testen Sie die Anwendung , und generieren Sie das Zugriffstoken erneut, aktualisieren AcquireOAuth2Token() Sie es erneut, und erstellen/wiederholen Sie den Test. Sie können auch das Token und seine Anforderungen mithilfe der Single-Page-Webanwendung jwt.ms prüfen und verifizieren.

Nächste Schritte

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

Schnellstart : Verschlüsseln und Entschlüsseln von Text

  • Last updated on