Grundlegendes zu Berechtigungen bei Outlook-Add-Ins

  • Artikel

Outlook-Add-Ins geben die erforderliche Berechtigungsstufe in ihrem Manifest an. Es stehen vier Ebenen zur Verfügung.

Kanonischer Name der Berechtigungsstufe
 XML-Manifestname Einheitliches Manifest für Microsoft 365-Name Zusammenfassungsbeschreibung
Beschränkt Restricted MailboxItem.Restricted.User Ermöglicht den Zugriff auf Eigenschaften und Methoden, die sich nicht auf bestimmte Informationen zum Benutzer oder E-Mail-Element beziehen.
Element lesen ReadItem MailboxItem.Read.User Zusätzlich zu dem, was in restricted zulässig ist, ist Folgendes möglich:
  • Reguläre Ausdrücke
  • Lesezugriff auf Outlook-Add-in-API
  • Abrufen der Elementeigenschaften und des Rückruftokens
  • Schreiben benutzerdefinierter Eigenschaften
Element lesen/schreiben ReadWriteItem MailboxItem.ReadWrite.User Zusätzlich zu dem, was in einem Leseelement zulässig ist, ist Folgendes möglich:
  • voller Zugriff auf Outlook-Add-In-API mit Ausnahme von makeEwsRequestAsync
  • Festlegen der Elementeigenschaften
Lese-/Schreibpostfach ReadWriteMailbox Mailbox.ReadWrite.User Zusätzlich zu dem, was im Lese-/Schreibzugriff zulässig ist, ist Folgendes möglich:
  • Erstellen, Lesen und Schreiben von Elementen und Ordnern
  • Senden von Elementen
  • Aufrufen von makeEwsRequestAsync

Berechtigungen werden im Manifest deklariert. Das Markup variiert je nach Art des Manifests.

  • XML-Manifest: Verwenden Sie das <Permissions-Element> .
  • Einheitliches Manifest für Microsoft 365 (Vorschau): Verwenden Sie die Eigenschaft "name" eines Objekts im Array "authorization.permissions.resourceSpecific".

Hinweis

Die vier Berechtigungsstufen sind kumulativ: Die Berechtigung Postfach lesen/schreiben schließt die Berechtigungen Element lesen/schreiben, Element lesen und Eingeschränkt ein, Element lesen/schreiben schließt Element lesen und Eingeschränkt ein, und die Berechtigung Element lesen schließt Eingeschränkt ein.

Sie können die von einem Mail-Add-In angeforderten Berechtigungen sehen, bevor Sie es aus AppSource installieren. Die für installierte Add-Ins erforderlichen Berechtigungen können Sie auch im Exchange Admin Center anzeigen.

Eingeschränkte Berechtigung

Die eingeschränkte Berechtigung ist die grundlegendste Berechtigungsstufe. Outlook weist diese Berechtigung standardmäßig einem Mail-Add-In zu, wenn das Add-In keine bestimmte Berechtigung im Manifest anweist.

Möglich

Wichtig

Entitätsbasierte kontextbezogene Outlook-Add-Ins werden im 2. Quartal 2024 eingestellt. Die Arbeiten zur Einstellung dieses Features beginnen im Mai und werden bis Ende Juni fortgesetzt. Nach Juni können Kontext-Add-Ins keine Entitäten mehr in E-Mail-Elementen erkennen, um Aufgaben für sie auszuführen. Die folgenden APIs werden ebenfalls eingestellt.

Um potenzielle Unterbrechungen zu minimieren, werden die folgenden Elemente weiterhin unterstützt, nachdem entitätsbasierte Kontext-Add-Ins eingestellt wurden.

  • Eine alternative Implementierung der Schaltfläche " An Besprechung teilnehmen ", die von Onlinebesprechungs-Add-Ins aktiviert wird, wird entwickelt. Sobald die Unterstützung für entitätsbasierte Kontext-Add-Ins endet, werden Onlinebesprechungs-Add-Ins automatisch zur alternativen Implementierung übergehen, um die Schaltfläche An Besprechung teilnehmen zu aktivieren.
  • Regeln für reguläre Ausdrücke werden weiterhin unterstützt, nachdem entitätsbasierte Kontext-Add-Ins eingestellt wurden. Es wird empfohlen, Ihr Kontext-Add-In zu aktualisieren, um Regeln für reguläre Ausdrücke als alternative Lösung zu verwenden. Anleitungen zum Implementieren dieser Regeln finden Sie unter Verwenden von Aktivierungsregeln für reguläre Ausdrücke zum Anzeigen eines Outlook-Add-Ins.

Weitere Informationen finden Sie unter Außerbetriebnahme entitätsbasierter kontextbezogener Outlook-Add-Ins.

  • Nur bestimmte Entitäten (Telefonnummer, Adresse, URL) aus dem Betreff oder Textkörper des Elements abrufen.

  • Eine ItemIs-Aktivierungsregel angeben, bei der das aktuelle Element in einem Lese- oder Erstellformular ein bestimmter Elementtyp sein muss oder eine ItemHasKnownEntity-Regel angeben, die mit einem der kleineren Teile der unterstützten bekannten Entitäten (Telefonnummer, Adresse, URL) im ausgewählten Element übereinstimmen.

    Hinweis

    Outlook-Add-In-Features, die von Aktivierungsregeln abhängen, werden nicht unterstützt, wenn das Add-In ein einheitliches Manifest für Microsoft 365 (Vorschau) verwendet.

  • Auf Eigenschaften und Methoden zugreifen, die nicht auf bestimmte Informationen über den Benutzer oder das Element zugreifen (Im nächsten Abschnitt finden Sie eine Liste der Elemente, die dies tun).

Nicht möglich

Berechtigung zum Lesen von Elementen

Die Berechtigung zum Lesen von Elementen ist die nächste Berechtigungsebene im Berechtigungsmodell.

Möglich

Nicht möglich

Lese-/Schreibberechtigung für Elemente

Geben Sie die Berechtigung zum Lesen/Schreiben von Elementen im Manifest an, um diese Berechtigung anzufordern. In Erstellformularen aktivierte Mail-Add-ins, die Schreibmethoden (Message.to.addAsync oder Message.to.setAsync) verwenden, benötigen mindestens diese Berechtigungsstufe.

Möglich

Nicht möglich

  • Verwenden Sie das von mailbox.getCallbackTokenAsync bereitgestellte Token für Folgendes:

    • Zum Aktualisieren oder Löschen des aktuellen Elements mithilfe der Outlook-REST-API oder zum Zugreifen auf andere Elemente im Postfach des Benutzers.
    • Abrufen des aktuellen Kalenderereigniselements mithilfe der Outlook-REST-API.

  • Verwenden der mailbox.makeEWSRequestAsync-Methode.

Lese-/Schreibberechtigung für Postfächer

Die Postfachberechtigung für Lese-/Schreibzugriff ist die höchste Berechtigungsstufe.

Zusätzlich zu dem, was die Lese-/Schreibberechtigung für Elemente unterstützt, bietet das von mailbox.getCallbackTokenAsync bereitgestellte Token Zugriff auf die Verwendung von EWS-Vorgängen (Exchange Web Services) oder Outlook-REST-APIs für folgende Aktionen:

  • Lesen und Schreiben aller Eigenschaften eines beliebigen Elements im Postfach des Benutzers.
  • Erstellen, lesen und schreiben eines beliebigen Ordners oder Elements in dem Postfach.
  • Senden eines Elements aus dem Postfach

Über mailbox.makeEWSRequestAsync können Sie auf die folgenden EWS-Vorgänge zugreifen.

Der Versuch, einen nicht unterstützten Vorgang auszuführen, führt zu einer Fehlermeldung.

Siehe auch