Requesting permissions for API use in content and task pane apps
Last modified: May 01, 2015
Applies to: Access apps for SharePoint | apps for Office | Excel | Office Add-ins | PowerPoint | Project | Word
Learn more about supported hosts and other requirements.
The name "apps for Office" is changing to "Office Add-ins". During the transition, the documentation and the UI of some Office host applications and Visual Studio tools might still use the term "apps for Office".
These permissions specify the subset of the API that the app runtime will allow your content or task pane app to use when a user inserts, and then activates (trusts) your app. To declare the permission level your content or task pane app requires, specify one of the permission text values in the Permissions element of your app's manifest. The following example requests the WriteDocument permission, which will allow only methods that can write to (but not read) the document.
As a best practice, you should request permissions based on the principle of least privilege. That is, you should request permission to access only the minimum subset of the API that your app requires to function correctly. For example, if your app needs only to read data in a user's document for its features, you should request no more than the ReadDocument permission.
Enabled subset of the API
This is the minimum permission level that can be requested by a content or task pane app.
In addition to the API allowed by the Restricted permission, adds access to the API members necessary to read the document and manage bindings.
This includes the use of:
In addition to the API allowed by the Restricted and ReadDocument permissions, allows the following additional access to document data:
In addition to the API allowed by the Restricted permission, adds access to the following API members:
In addition to the API allowed by the Restricted, ReadDocument, ReadAllDocument, and WriteDocument permissions, includes access to all remaining API supported by content and task pane apps, including methods for subscribing to events.
You must declare the ReadWriteDocument permission to access these additional API members: