Verwalten der Vertraulichkeitsbezeichnung Ihrer Nachricht oder Ihres Termins im Verfassenmodus

Die Zusammenarbeit am Arbeitsplatz findet nicht nur innerhalb der organization statt, sondern erstreckt sich auch auf externe Partner. Da Informationen außerhalb des Netzwerks eines organization freigegeben werden, ist es wichtig, Maßnahmen festzulegen, um Datenverluste zu verhindern und Konformitätsrichtlinien durchzusetzen. Microsoft Purview Information Protection unterstützt Sie bei der Implementierung von Lösungen zum Klassifizieren und Schützen vertraulicher Informationen. Die Verwendung von Vertraulichkeitsbezeichnungen in Outlook ist eine Funktion, die Sie zum Schutz Ihrer Daten konfigurieren können.

Sie können die Office JavaScript-API verwenden, um Lösungen für Vertraulichkeitsbezeichnungen in Ihren Outlook-Add-In-Projekten zu implementieren und die folgenden Szenarien zu unterstützen.

• Wenden Sie vertraulichkeitsbezeichnungen automatisch auf bestimmte Nachrichten und Termine an, während sie zusammengestellt werden, damit sich Die Benutzer auf ihre Arbeit konzentrieren können.
• Schränken Sie zusätzliche Aktionen ein, wenn eine bestimmte Vertraulichkeitsbezeichnung auf eine Nachricht oder einen Termin angewendet wird, z. B. um zu verhindern, dass Benutzer externe Empfänger zu einer Nachricht hinzufügen.
• Fügen Sie einer Nachricht oder einem Termin eine Kopf- oder Fußzeile basierend auf der Vertraulichkeitsbezeichnung hinzu, um die Geschäftlichen und rechtlichen Richtlinien einzuhalten.

Voraussetzungen

Um die Vertraulichkeitsbezeichnungsfunktion in Ihrem Add-In zu implementieren, benötigen Sie ein Microsoft 365 E5-Abonnement. Sie können sich über das Microsoft 365-Entwicklerprogramm für ein Microsoft 365 E5-Entwicklerabonnement qualifizieren. Weitere Informationen finden Sie in den häufig gestellten Fragen. Alternativ können Sie sich für eine kostenlose 1-monatige Testversion registrieren oder einen Microsoft 365-Plan erwerben.

Unterstützte Clients und Plattformen

In der folgenden Tabelle sind Client-Server-Kombinationen aufgeführt, die die Verwendung der Vertraulichkeitsbezeichnungsfunktion in Outlook-Add-Ins unterstützen. Ausgeschlossene Kombinationen werden nicht unterstützt.

Konfigurieren des Manifests

Um die Vertraulichkeitsfunktion in Ihrem Outlook-Add-In-Projekt verwenden zu können, müssen Sie die Berechtigung zum Lesen/Schreiben von Elementen im Manifest Ihres Add-Ins konfigurieren.

• Einheitliches Manifest für Microsoft 365: Legen Sie im Array "authorization.permissions.resourceSpecific" die Eigenschaft "name" eines Objekts auf "MailboxItem.ReadWrite.User" fest.
• Nur Add-In-Manifest: Legen Sie das <Permissions-Element> auf ReadWriteItem fest.

Wenn Ihr Add-In das OnSensitivityLabelChanged Ereignis erkennt und behandelt, sind zusätzliche Manifestkonfigurationen erforderlich, um die ereignisbasierte Aktivierungsfunktion zu aktivieren. Weitere Informationen finden Sie unter Erkennen von Änderungen an Vertraulichkeitsbezeichnungen mit dem OnSensitivityLabelChanged-Ereignis.

Überprüfen der status des Katalogs der Vertraulichkeitsbezeichnungen

Vertraulichkeitsbezeichnungen und Richtlinien werden vom Administrator eines organization über die Microsoft Purview-Complianceportal konfiguriert. Eine Anleitung zum Konfigurieren von Vertraulichkeitsbezeichnungen in Ihrem Mandanten finden Sie unter Erstellen und Konfigurieren von Vertraulichkeitsbezeichnungen und deren Richtlinien.

Bevor Sie die Vertraulichkeitsbezeichnung für eine Nachricht oder einen Termin abrufen oder festlegen können, müssen Sie zunächst sicherstellen, dass der Katalog der Vertraulichkeitsbezeichnungen für das Postfach aktiviert ist, in dem das Add-In installiert ist. Um die status des Katalogs der Vertraulichkeitsbezeichnungen zu überprüfen, rufen Sie context.sensitivityLabelsCatalog.getIsEnabledAsync im Verfassenmodus auf.

// Check whether the catalog of sensitivity labels is enabled.
Office.context.sensitivityLabelsCatalog.getIsEnabledAsync((asyncResult) => {
    if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
        console.log(asyncResult.value);
    } else {
        console.log("Action failed with error: " + asyncResult.error.message);
    }
});

Identifizieren verfügbarer Vertraulichkeitsbezeichnungen

Wenn Sie die Vertraulichkeitsbezeichnungen ermitteln möchten, die für eine Nachricht oder einen Termin im Verfassenmodus verfügbar sind, verwenden Sie context.sensitivityLabelsCatalog.getAsync. Die verfügbaren Bezeichnungen werden in Form von SensitivityLabelDetails-Objekten zurückgegeben, die die folgenden Details bereitstellen.

• Der Name der Bezeichnung.
• Der eindeutige Bezeichner (GUID) der Bezeichnung.
• Eine Beschreibung der Bezeichnung.
• Die Farbe, die der Bezeichnung zugewiesen ist.
• Die konfigurierten Unterbezeichnungen, falls vorhanden.

Das folgende Beispiel zeigt, wie Die im Katalog verfügbaren Vertraulichkeitsbezeichnungen identifiziert werden.

// It's recommended to check the status of the catalog of sensitivity labels before
// calling other sensitivity label methods.
Office.context.sensitivityLabelsCatalog.getIsEnabledAsync((asyncResult) => {
    if (asyncResult.status === Office.AsyncResultStatus.Succeeded && asyncResult.value == true) {
        // Identify available sensitivity labels in the catalog.
        Office.context.sensitivityLabelsCatalog.getAsync((asyncResult) => {
            if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
                const catalog = asyncResult.value;
                console.log("Sensitivity Labels Catalog:");
                catalog.forEach((sensitivityLabel) => {
                    console.log(`Name: ${sensitivityLabel.name}`);
                    console.log(`ID: ${sensitivityLabel.id}`);
                    console.log(`Tooltip: ${sensitivityLabel.tooltip}`);
                    console.log(`Color: ${sensitivityLabel.color}`);
                    console.log(`Sublabels: ${JSON.stringify(sensitivityLabel.children)}`);
                });
            } else {
                console.log("Action failed with error: " + asyncResult.error.message);
            }
        });
    } else {
        console.log("Action failed with error: " + asyncResult.error.message);
    }
});

Abrufen der Vertraulichkeitsbezeichnung einer Nachricht oder eines Termins

Um die Vertraulichkeitsbezeichnung abzurufen, die derzeit auf eine Nachricht oder einen Termin im Verfassenmodus angewendet wird, rufen Sie item.sensitivityLabel.getAsync auf, wie im folgenden Beispiel gezeigt. Dadurch wird die GUID der Vertraulichkeitsbezeichnung zurückgegeben.

// It's recommended to check the status of the catalog of sensitivity labels before
// calling other sensitivity label methods.
Office.context.sensitivityLabelsCatalog.getIsEnabledAsync((asyncResult) => {
    if (asyncResult.status === Office.AsyncResultStatus.Succeeded && asyncResult.value == true) {
        // Get the current sensitivity label of a message or appointment.
        Office.context.mailbox.item.sensitivityLabel.getAsync((asyncResult) => {
            if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
                console.log(asyncResult.value);
            } else {
                console.log("Action failed with error: " + asyncResult.error.message);
            }
        });
    } else {
        console.log("Action failed with error: " + asyncResult.error.message);
    }
});

Festlegen der Vertraulichkeitsbezeichnung für eine Nachricht oder einen Termin

Sie können nur eine Vertraulichkeitsbezeichnung für eine Nachricht oder einen Termin im Verfassenmodus festlegen. Rufen Sie vor dem Festlegen der Bezeichnung context.sensitivityLabelsCatalog.getAsync auf. Dadurch wird sichergestellt, dass die Bezeichnung, die Sie anwenden möchten, zur Verwendung verfügbar ist. Es hilft Ihnen auch, die GUID einer Bezeichnung zu identifizieren, die Sie benötigen, um die Bezeichnung auf das E-Mail-Element anzuwenden. Nachdem Sie die Verfügbarkeit der Bezeichnung bestätigt haben, übergeben Sie die GUID als Parameter an item.sensitivityLabel.setAsync, wie im folgenden Beispiel gezeigt.

// It's recommended to check the status of the catalog of sensitivity labels before
// calling other sensitivity label methods.
Office.context.sensitivityLabelsCatalog.getIsEnabledAsync((asyncResult) => {
    if (asyncResult.status === Office.AsyncResultStatus.Succeeded && asyncResult.value == true) {
        // Identify available sensitivity labels in the catalog.
        Office.context.sensitivityLabelsCatalog.getAsync((asyncResult) => {
            if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
                const catalog = asyncResult.value;
                if (catalog.length > 0) {
                    // Get the GUID of the sensitivity label.
                    var id = catalog[0].id;
                    // Set the mail item's sensitivity label using the label's GUID.
                    Office.context.mailbox.item.sensitivityLabel.setAsync(id, (asyncResult) => {
                        if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
                            console.log(asyncResult.status);
                        } else {
                            console.log("Action failed with error: " + asyncResult.error.message);
                        }
                    });
                } else {
                    console.log("Catalog list is empty");
                }
            } else {
                console.log("Action failed with error: " + asyncResult.error.message);
            }
        });
    } else {
        console.log("Action failed with error: " + asyncResult.error.message);
    }
});

Anstatt die GUID zum Festlegen der Vertraulichkeitsbezeichnung zu verwenden, können Sie das vom Katalogaufruf abgerufene SensitivityLabelDetails-Objekt übergeben, wie im folgenden Beispiel gezeigt.

// It's recommended to check the status of the catalog of sensitivity labels before
// calling other sensitivity label methods.
Office.context.sensitivityLabelsCatalog.getIsEnabledAsync((asyncResult) => {
    if (asyncResult.status === Office.AsyncResultStatus.Succeeded && asyncResult.value == true) {
        // Identify available sensitivity labels in the catalog.
        Office.context.sensitivityLabelsCatalog.getAsync((asyncResult) => {
            if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
                const catalog = asyncResult.value;
                if (catalog.length > 0) {
                    // Set the mail item's sensitivity label using the SensitivityLabelDetails object.
                    Office.context.mailbox.item.sensitivityLabel.setAsync(catalog[0], (asyncResult) => {
                        if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
                            console.log(asyncResult.status);
                        } else {
                            console.log("Action failed with error: " + asyncResult.error.message);
                        }
                    });
                } else {
                    console.log("Catalog list is empty");
                }
            } else {
                console.log("Action failed with error: " + asyncResult.error.message);
            }
        });
    } else {
        console.log("Action failed with error: " + asyncResult.error.message);
    }
});

Erkennen von Änderungen an Vertraulichkeitsbezeichnungen mit dem OnSensitivityLabelChanged-Ereignis

Ergreifen Sie zusätzliche Maßnahmen, um Ihre Daten mithilfe des -Ereignisses OnSensitivityLabelChanged zu schützen. Dieses Ereignis ermöglicht es Ihrem Add-In, Aufgaben als Reaktion auf Änderungen der Vertraulichkeitsbezeichnung an einer Nachricht oder einem Termin auszuführen. Sie können beispielsweise verhindern, dass Benutzer die Vertraulichkeitsbezeichnung eines E-Mail-Elements herabstufen, wenn es bestimmte Anlagen enthält.

Das OnSensitivityLabelChanged Ereignis ist über die ereignisbasierte Aktivierungsfunktion verfügbar. Informationen zum Konfigurieren, Debuggen und Bereitstellen eines ereignisbasierten Add-Ins, das dieses Ereignis verwendet, finden Sie unter Konfigurieren Ihres Outlook-Add-Ins für die ereignisbasierte Aktivierung.

Siehe auch

• Weitere Informationen zu Vertraulichkeitsbezeichnungen
• Erste Schritte mit Vertraulichkeitsbezeichnungen
• Erstellen und Konfigurieren von Vertraulichkeitsbezeichnungen und deren Richtlinien
• Konfigurieren Ihres Outlook-Add-Ins für die ereignisbasierte Aktivierung
• Codebeispiel für Office-Add-Ins: Überprüfen der Vertraulichkeitsbezeichnung einer Nachricht