Schnellstart: Auflisten von Vertraulichkeitsbezeichnungen (C#)

Artikel
01/30/2024

In diesem Schnellstart erfahren Sie, wie Sie das MIP File SDK verwenden, um die für Ihre Organisation konfigurierten Vertraulichkeitsbezeichnungen aufzulisten.

Voraussetzungen

Stellen Sie vor dem Fortfahren sicher, dass die folgenden Voraussetzungen erfüllt sind:

Schließen Sie zuerst den Schnellstart: Initialisieren von Clientanwendungen (C#) ab, in dem eine Starterprojektmappe für Visual Studio erstellt wird. Dieser Schnellstart „Auflisten der Vertraulichkeitsbezeichnungen“ baut auf der vorherigen Erstellung der Starterprojektmappe auf.
Lesen Sie optional die Konzepte zu Klassifizierungsbezeichnungen.

Hinzufügen von Logik zum Auflisten von Vertraulichkeitsbezeichnungen

Im Folgenden fügen Sie mithilfe des File-Engine-Objekts Logik zum Auflisten der Vertraulichkeitsbezeichnungen Ihrer Organisation hinzu.

Öffnen Sie die Visual Studio-Projektmappe, die Sie im vorherigen Artikel „Schnellstart: Initialisieren von Clientanwendungen (C#)“ erstellt haben.
Ö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.
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 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));
        }
    }
}

Erstellen und Testen der Anwendung

Erstellen und testen Sie abschließend die Clientanwendung.

Drücken Sie STRG+UMSCHALT+B (Projektmappe erstellen), um Ihre Clientanwendung zu erstellen. Wenn keine Buildfehler auftreten, verwenden Sie F5 (Debuggen starten), um die Anwendung auszuführen.
Wenn das Projekt erfolgreich erstellt und ausgeführt wird, kann die Anwendung Sie jedes Mal zur Authentifizierung über die Microsoft Authentication Library (MSAL) auffordern, wenn das SDK Ihre AcquireToken()-Methode aufruft. Wenn bereits zwischengespeicherte Anmeldeinformationen vorhanden sind, werden Sie nicht zur Anmeldung aufgefordert, und die Liste der Bezeichnungen wird sofort angezeigt.
- Möglicherweise müssen Sie Ihre Einwilligung erteilen, um der Anwendung den Zugriff auf die MIP-APIs zu gewähren, während die Ausführung unter dem Anmeldekonto erfolgt. Dies geschieht, wenn der Azure AD-Anwendungsregistrierung nicht (wie in „MIP SDK: Setup und Konfiguration“ beschrieben) vorab zugestimmt wurde, oder wenn Sie sich mit einem Konto eines anderen Mandanten anmelden (der sich von dem unterscheidet, bei dem Ihre Anwendung registriert ist). Klicken Sie einfach auf Akzeptieren, damit Ihre Einwilligung erfasst wird.
Nach der Authentifizierung sollten die Vertraulichkeitsbezeichnungen in der Konsolenausgabe dem folgenden Beispiel ähneln:

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.

Notiz

Kopieren und speichern Sie die ID von mindestens einer Vertraulichkeitsbezeichnung (z. B. f42a3342-8706-4288-bd31-ebb85995028z), da Sie diese im nächsten Schnellstart benötigen.

Problembehandlung

Probleme bei der Ausführung der C#-Anwendung

Zusammenfassung	Fehlermeldung	Lösung
Ungültiges Zugriffstoken	Eine 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]' Die Ausführung von „C:\VSProjects\MipDev\Quickstarts\AppInitialization\x64\Debug\AppInitialization.exe“ (Prozess 29924) wurde mit dem 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. Navigieren Sie zurück zu Erstellen und Testen der Anwendung, generieren Sie das Zugriffstoken erneut, aktualisieren Sie wieder `AcquireOAuth2Token()`, und wiederholen Sie die Tests und die Erstellung. Sie können das Token und dessen Ansprüche auch untersuchen und überprüfen, indem Sie die Single-Page-Webanwendung jwt.ms verwenden.
Vertraulichkeitsbezeichnungen sind nicht konfiguriert	–	Wenn Ihr Projekt erfolgreich erstellt wird, Sie aber keine Ausgabe im Konsolenfenster erhalten, stellen Sie sicher, dass die Vertraulichkeitsbezeichnungen Ihrer Organisation ordnungsgemäß konfiguriert sind. Ausführliche Informationen finden Sie unter „Definieren des Bezeichnungsschemas und der Schutzeinstellungen“ im Artikel MIP SDK: Setup und Konfiguration.

Nächste Schritte

Nachdem Sie nun erfahren haben, wie Sie die Vertraulichkeitsbezeichnungen für Ihre Organisation auflisten, können Sie mit dem nächsten Schnellstart fortfahren:

Festlegen und Abrufen einer Vertraulichkeitsbezeichnung

Freigeben über