Administrar la etiqueta de confidencialidad del mensaje o cita en modo de redacción

La colaboración en el lugar de trabajo no solo se produce dentro de la organización, sino que también se extiende a asociados externos. Con la información que se comparte más allá de la red de una organización, es importante establecer medidas para evitar la pérdida de datos y aplicar las directivas de cumplimiento. Microsoft Purview Information Protection le ayuda a implementar soluciones para clasificar y proteger la información confidencial. El uso de etiquetas de confidencialidad en Outlook es una funcionalidad que puede configurar para proteger los datos.

Puede usar la API de JavaScript de Office para implementar soluciones de etiquetas de confidencialidad en los proyectos de complementos de Outlook y admitir los siguientes escenarios.

• Aplique automáticamente etiquetas de confidencialidad a determinados mensajes y citas mientras se componen, de modo que los usuarios puedan centrarse en su trabajo.
• Restrinja acciones adicionales si se aplica una etiqueta de confidencialidad determinada a un mensaje o una cita, como impedir que los usuarios agreguen destinatarios externos a un mensaje.
• Agregue un encabezado o pie de página a un mensaje o cita en función de su etiqueta de confidencialidad para cumplir con las directivas empresariales y legales.

Requisitos previos

Para implementar la característica de etiqueta de confidencialidad en el complemento, debe tener una suscripción de Microsoft 365 E5. Puede calificar para una suscripción de desarrollador de Microsoft 365 E5 a través del Programa para desarrolladores de Microsoft 365; para obtener más información, consulte las preguntas más frecuentes. Como alternativa, puede registrarse para obtener una evaluación gratuita de 1 mes o comprar un plan de Microsoft 365.

Plataformas y clientes admitidos

En la tabla siguiente se enumeran las combinaciones cliente-servidor que admiten el uso de la característica de etiqueta de confidencialidad en complementos de Outlook. No se admiten combinaciones excluidas.

Configuración del manifiesto

Para usar la característica de confidencialidad en el proyecto de complemento de Outlook, debe configurar el permiso de elemento de lectura y escritura en el manifiesto del complemento.

• Manifiesto unificado para Microsoft 365: en la matriz "authorization.permissions.resourceSpecific", establezca la propiedad "name" de un objeto en "MailboxItem.ReadWrite.User".
• Manifiesto de solo complemento: establezca el <elemento Permissions> en ReadWriteItem.

Si el complemento detectará y controlará el OnSensitivityLabelChanged evento, se requieren configuraciones de manifiesto adicionales para habilitar la característica de activación basada en eventos. Para obtener más información, vea Detectar cambios en la etiqueta de confidencialidad con el evento OnSensitivityLabelChanged.

Comprobación del estado del catálogo de etiquetas de confidencialidad

El administrador de una organización configura las etiquetas y directivas de confidencialidad a través de la portal de cumplimiento Microsoft Purview. Para obtener instrucciones sobre cómo configurar etiquetas de confidencialidad en el inquilino, consulte Creación y configuración de etiquetas de confidencialidad y sus directivas.

Antes de obtener o establecer la etiqueta de confidencialidad en un mensaje o cita, primero debe asegurarse de que el catálogo de etiquetas de confidencialidad está habilitado en el buzón donde está instalado el complemento. Para comprobar el estado del catálogo de etiquetas de confidencialidad, llame a context.sensitivityLabelsCatalog.getIsEnabledAsync en el modo de redacción.

// 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);
    }
});

Identificación de etiquetas de confidencialidad disponibles

Si quieres determinar las etiquetas de confidencialidad disponibles para su uso en un mensaje o cita en modo de redacción, usa context.sensitivityLabelsCatalog.getAsync. Las etiquetas disponibles se devuelven en forma de objetos SensitivityLabelDetails , que proporcionan los siguientes detalles.

• Nombre de la etiqueta.
• Identificador único (GUID) de la etiqueta.
• Descripción de la etiqueta.
• Color asignado a la etiqueta.
• Las subetiquetas configuradas, si las hay.

En el ejemplo siguiente se muestra cómo identificar las etiquetas de confidencialidad disponibles en el catálogo.

// 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);
    }
});

Obtener la etiqueta de confidencialidad de un mensaje o cita

Para obtener la etiqueta de confidencialidad aplicada actualmente a un mensaje o cita en modo de redacción, llame a item.sensitivityLabel.getAsync como se muestra en el ejemplo siguiente. Esto devuelve el GUID de la etiqueta de confidencialidad.

// 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);
    }
});

Establecer la etiqueta de confidencialidad en un mensaje o cita

Solo puede establecer una etiqueta de confidencialidad en un mensaje o cita en modo de redacción. Antes de establecer la etiqueta, llame a context.sensitivityLabelsCatalog.getAsync. Esto garantiza que la etiqueta que desea aplicar esté disponible para su uso. También le ayuda a identificar el GUID de una etiqueta, que tendrá que aplicar la etiqueta al elemento de correo. Después de confirmar la disponibilidad de la etiqueta, pase su GUID como parámetro a item.sensitivityLabel.setAsync, como se muestra en el ejemplo siguiente.

// 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);
    }
});

En lugar de usar el GUID para establecer la etiqueta de confidencialidad, puede pasar el objeto SensitivityLabelDetails recuperado de la llamada de catálogo, como se muestra en el ejemplo siguiente.

// 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);
    }
});

Detección de cambios en la etiqueta de confidencialidad con el evento OnSensitivityLabelChanged

Tome medidas adicionales para proteger los datos mediante el OnSensitivityLabelChanged evento . Este evento permite que el complemento complete tareas en respuesta a los cambios de etiqueta de confidencialidad en un mensaje o cita. Por ejemplo, puede evitar que los usuarios reduzcan la etiqueta de confidencialidad de un elemento de correo si contiene determinados datos adjuntos.

El OnSensitivityLabelChanged evento está disponible a través de la característica de activación basada en eventos. Para obtener información sobre cómo configurar, depurar e implementar un complemento basado en eventos que usa este evento, consulte Configuración del complemento de Outlook para la activación basada en eventos.

Recursos adicionales

• Información sobre las etiquetas de confidencialidad
• Introducción a las etiquetas de confidencialidad
• Crear y configurar etiquetas de confidencialidad y sus directivas
• Configuración del complemento de Outlook para la activación basada en eventos
• Ejemplo de código de complementos de Office: comprobar la etiqueta de confidencialidad de un mensaje