Microsoft Information Protection (MIP)
Diese Dokumentfunktion ermöglicht es, beim Generierten von Word-, PowerPoint- und Excel-Dokumenten Vertraulichkeitsbezeichnungen (Sensitivity Labels) von Microsoft Information Protection (Microsoft Purview) anzuwenden. Der Benutzer wählt das Label beim Generieren im Eingabeformular aus; primedocs wendet die zugehörigen visuellen Markierungen (Kopf-/Fusszeilen, Wasserzeichen) und – falls aktiviert – den Rechteschutz an.
- Eine Azure-AD-App-Registrierung, deren Client-ID in
ApplicationIdhinterlegt wird (für die MIP-SDK-Operationen). - Für den Rechteschutz (
EnableProtection) muss zusätzlich der Connected Service_System.MIP.Protectionkonfiguriert sein. - Die Auswahl eines Labels durch den Benutzer kann eine vorgängige Anmeldung am Connected Service erfordern.
Grundaufbau
Die Konfiguration erfolgt im Vorlageneditor unter Dokumentfunktionen. Die Einstellungen können entweder direkt (lokal) oder über eine Globale Konfiguration referenziert werden – eine Mischung beider Varianten ist nicht zulässig.
<MipConfiguration>
<ApplicationId>00000000-0000-0000-0000-000000000000</ApplicationId>
<EnableProtection>true</EnableProtection>
</MipConfiguration>
Konfigurationselemente
| Element | Pflicht | Beschreibung |
|---|---|---|
ApplicationId | optional | Client-ID der Azure-AD-App-Registrierung, die für die MIP-SDK-Operationen verwendet wird. |
EnableProtection | optional | true, wenn Labels mit Rechteschutz (Rights Management) unterstützt werden sollen. Erfordert den Connected Service _System.MIP.Protection. |
OverrideServiceUrl | optional | Überschreibt den MIP-Service-Endpunkt (z.B. für lokale Entwicklung). |
GlobalMipSettings | optional | Referenz auf eine globale MIP-Konfiguration über das Attribut Key. Bei Verwendung werden alle Einstellungen aus dem referenzierten globalen Eintrag geladen; darf nicht mit lokalen Einstellungen kombiniert werden. |
Globale MIP-Einstellungen wiederverwenden
Wird dieselbe MIP-Konfiguration in mehreren Vorlagen benötigt, lässt sie sich als globale Konfiguration vom Typ MipGlobalSettings zentral pflegen und über GlobalMipSettings referenzieren:
<MipConfiguration>
<GlobalMipSettings Key="StandardMip" />
</MipConfiguration>
Die Auswahl der Vertraulichkeitsbezeichnung erscheint dem Benutzer als Feld im Generierungsformular. Welche Labels verfügbar sind, ergibt sich aus der MIP-/Purview-Konfiguration des Mandanten.