Freigeben über

Anfordern von Berechtigungen für API-Verwendung in Add-Ins

  • Artikel

In diesem Artikel werden die verschiedenen Berechtigungsstufen beschreiben, die Sie im Manifest Ihres Inhalts- oder Aufgabenbereich-Add-ins deklarieren können, um die Stufe von JavaScript-API-Zugriff festzulegen, die für den Zugriff auf die Add-in-Funktionen erforderlich ist.

Hinweis

Informationen zu Berechtigungsstufen für E-Mail-Add-Ins (Outlook) finden Sie unter Outlook-Berechtigungsmodell.

Berechtigungsmodell

Der Datenschutz und die Sicherheit für Benutzer Ihrer Inhalts- und Aufgabenbereich-Add-ins basieren auf einem 5-stufigen JavaScript-API-Zugriffsberechtigungsmodell. In Abbildung 1 werden die 5 Stufen von API-Berechtigungen gezeigt, die Sie im Manifest Ihres Add-ins deklarieren können.

Abbildung 1: Das fünfstufige Berechtigungsmodell für Inhalts- und Aufgabenbereich-Add-Ins

Berechtigungsebenen für Aufgabenbereich-Apps.

Diese Berechtigungen geben die Teilmenge der API an, die die Add-In-Runtime ihrem Inhalts- oder Aufgabenbereich-Add-In erlaubt, wenn ein Benutzer einfügt, und dann Ihr Add-In aktiviert (als vertrauenswürdig). Zum Deklarieren der erforderlichen Berechtigungsstufe für Ihr Inhalts- oder Aufgabenbereich-Add-in legen Sie im Element Permissions des Manifests Ihres Add-ins einen der Berechtigungstextwerte fest. Im folgenden Beispiel ist die WriteDocument-Berechtigung erforderlich, die nur solche Methoden zulässt, die in das Dokument schreiben (aber es nicht lesen) können.

<Permissions>WriteDocument</Permissions>

Als bewährte Methode sollten Sie Berechtigungen nach dem Prinzip der geringsten Rechte anfordern. Das heißt, die angeforderten Berechtigungen sollten Zugriff auf lediglich die minimale Teilmenge der API gewähren, die Ihr Add-in für eine ordnungsgemäße Funktion benötigt. Wenn Ihr Add-in zum Funktionieren beispielsweise nur Daten im Dokument eines Benutzers lesen muss, sollten Sie keine Berechtigung anfordern, die über ReadDocument hinausgeht.

In der folgenden Tabelle ist die von den einzelnen Berechtigungsstufen aktivierte Teilmenge der JavaScript-API beschrieben.

Berechtigung Aktivierte Teilmenge der API
Restricted Die Methoden des Settings-Objekts und die Document.getActiveViewAsync-Methode. Dies ist die minimale Berechtigung, die von einem Aufgabenbereich-Add-in angefordert werden kann.
ReadDocument Zusätzlich zur von der Restricted-Berechtigung zugelassenen API fügt es Zugriff auf die zum Lesen des Dokuments und zum Verwalten von Bindungen notwendigen API-Mitglieder hinzu. Dies umfasst die Verwendung von Folgendem:
ReadAllDocument Zusätzlich zu der API, die durch die Berechtigungen Restricted und ReadDocument zulässig ist, ermöglicht den folgenden zusätzlichen Zugriff auf Dokumentdaten.

  • Die Document.getSelectedDataAsync- und Document.getFileAsync-Methoden können auf den zugrunde liegenden OOXML-Code des Dokumentes zugreifen (der zusätzlich zum Text Formatierungen, Verknüpfungen, eingebettete Grafik, Kommentare, Überarbeitungen usw. aufweisen kann).
WriteDocument Zusätzlich zur API, die durch die Berechtigung Eingeschränkt zulässig ist, wird zugriff auf die folgenden API-Member hinzugefügt.
ReadWriteDocument Umfasst, zusätzlich zur durch die Berechtigungen Restricted-, ReadDocument, ReadAllDocument und WriteDocument zulässigen API, Zugriff auf alle verbleibenden, durch Inhalts- und Aufgabenbereich-Add-ins unterstützten APIs, einschließlich Methoden für das Abonnieren von Ereignissen. Für den Zugriff auf diese zusätzlichen API-Mitglieder müssen Sie die ReadWriteDocument-Berechtigung deklarieren:

Siehe auch