How to: Use built-in rights

  • Article

This topic outlines the built-in rights that the Rights Management SDK 4.2 provides and usage restrictions that an app should enforce in honoring those restrictions.

Note

For the Linux SDK, see the rights.h source file for details.

Common Rights

Right
 Values
 Description
All
  • Android: [CommonRights.All](commonrights-class-java.md)
  • iOS and OS X: [[MSCommonRights owner]](mscommonrights-interface-objc.md)
  • Windows Store and Windows Phone: [CommonRights.All](commonrights-owner.md)
  • Linux: [CommonRights::All](http://azuread.github.io/rms-sdk-for-cpp/classrmscore_1_1modernapi_1_1CommonRights.mdl)
 A collection of all common rights.
Owner
  • Android: [CommonRights.Owner](commonrights-class-java.md)
  • iOS and OS X: [[MSCommonRights owner]](mscommonrights-interface-objc.md)
  • Windows Store and Windows Phone: [CommonRights.Owner](commonrights-owner.md)
  • Linux: [CommonRights::Owner](http://azuread.github.io/rms-sdk-for-cpp/classrmscore_1_1modernapi_1_1CommonRights.mdl)
 The Owner right grants full control over the protected content.
View
  • Android: [CommonRights.View](commonrights-class-java.md)
  • iOS and OS X: [[MSCommonRights view]](mscommonrights-interface-objc.md)
  • Windows Store and Windows Phone: [CommonRights.View](commonrights-view.md)
  • Linux: [CommonRights::View](http://azuread.github.io/rms-sdk-for-cpp/classrmscore_1_1modernapi_1_1CommonRights.mdl)
 The right to view protected content. Typically, when this right is granted, the application enables the user to open and view protected content; however, additional rights are required to modify, extract, forward, or save the content.

Editable Document Rights

Right
 Values
 Restrictions
All
  • Android: [EditableDocumentRights.All](editabledocumentrights-class-java.md)
  • iOS and OS X: [[MSEditableDocumentRights all]](mseditabledocumentrights-interface-objc.md)
  • Windows Store and Windows Phone: [EditableDocumentRights.All](editabledocumentrights-all.md)
  • Linux: [EditableDocumentRights::All](http://azuread.github.io/rms-sdk-for-cpp/classrmscore_1_1modernapi_1_1EditableDocumentRights.mdl)
 A collection that contains all of the editable document rights.
Comment
  • Android: [EditableDocumentRights.Comment](editabledocumentrights-class-java.md)
  • iOS and OS X: [[MSEditableDocumentRights comment]](mseditabledocumentrights-interface-objc.md)
  • Windows Store and Windows Phone: [EditableDocumentRights.Comment](editabledocumentrights--comment.md)
  • Linux: [EditableDocumentRights::Comment](http://azuread.github.io/rms-sdk-for-cpp/classrmscore_1_1modernapi_1_1EditableDocumentRights.mdl)
 The right to make comments on the document.
Edit
  • Android: [EditableDocumentRights.Edit](editabledocumentrights-class-java.md)
  • iOS and OS X: [[MSEditableDocumentRights edit]](mseditabledocumentrights-interface-objc.md)
  • Windows Store and Windows Phone: [EditableDocumentRights.Edit](editabledocumentrights-edit.md)
  • Linux: [EditableDocumentRights::Edit](http://azuread.github.io/rms-sdk-for-cpp/classrmscore_1_1modernapi_1_1EditableDocumentRights.mdl)
 The right to edit protected content and save it in the same protected format. Typically, when this right is granted, the app enables the user to change protected content and then save it to the same file.
Export
  • Android: [EditableDocumentRights.Export](editabledocumentrights-class-java.md)
  • iOS and OS X: [[MSEditableDocumentRights exportable]](mseditabledocumentrights-interface-objc.md)
  • Windows Store and Windows Phone: [EditableDocumentRights.Export](editabledocumentrights-export.md)
  • Linux: [EditableDocumentRights::Export](http://azuread.github.io/rms-sdk-for-cpp/classrmscore_1_1modernapi_1_1EditableDocumentRights.mdl)
 The right to extract content from a protected format and place it in a different AD RMS-protected format. Typically, when this right is granted, the app enables the user to save protected content to other AD RMS-protected formats; for example, if the application implements a Save As functionality.
Extract
  • Android: [EditableDocumentRights.Extract](editabledocumentrights-class-java.md)
  • iOS and OS X: [[MSEditableDocumentRights extract]](mseditabledocumentrights-interface-objc.md)
  • Windows Store and Windows Phone: [EditableDocumentRights.Extract](editabledocumentrights-print.md)
  • Linux: [EditableDocumentRights::Extract](http://azuread.github.io/rms-sdk-for-cpp/classrmscore_1_1modernapi_1_1EditableDocumentRights.mdl)
 The right to extract content from a protected format and place it in an unprotected format. Typically, when this right is granted, the app enables the user to copy and paste information from protected content. If the app implements a Save As functionality, the application might also enable the user to save protected content to unprotected formats and other protected formats. This right has the same value as the Extract right for email.
Print
  • Android: [EditableDocumentRights.Print](editabledocumentrights-class-java.md)
  • iOS and OS X: [[MSEditableDocumentRights print]](mseditabledocumentrights-interface-objc.md)
  • Windows Store and Windows Phone: [EditableDocumentRights.Print](editabledocumentrights-print.md)
  • Linux: [EditableDocumentRights::Print](http://azuread.github.io/rms-sdk-for-cpp/classrmscore_1_1modernapi_1_1EditableDocumentRights.mdl)
 The right to print protected content. Typically, when this right is granted, the app enables the user to print protected content. This right has the same value as the Print right for email.

Email Rights

Right
 Values
 Restrictions
All
  • Android: [EmailRights.All](emailrights-class-java.md)
  • iOS and OS X: [[MSEmailRights all]](msemailrights-interface-objc.md)
  • Windows Store and Windows Phone: [EmailRights.All](emailrights-all.md)
  • Linux: [EmailRights::All](http://azuread.github.io/rms-sdk-for-cpp/classrmscore_1_1modernapi_1_1EmailRights.mdl)
 A collection that contains all of the email rights.
Extract
  • Android: [EmailRights.Extract](emailrights-class-java.md)
  • iOS and OS X: [[MSEmailRights extract]](msemailrights-interface-objc.md)
  • Windows Store and Windows Phone: [EmailRights.Extract](emailrights-extract.md)
  • Linux: [EmailRights::Extract](http://azuread.github.io/rms-sdk-for-cpp/classrmscore_1_1modernapi_1_1EmailRights.mdl)
 The right to extract content from a protected format and place it in an unprotected format. Typically, when this right is granted, the app enables an email recipient to copy and paste information from a protected message. If the app implements a Save As functionality, the application might also enable the recipient to save protected content to unprotected formats and other protected formats. This right has the same value as the Extract right for editable documents.
Forward
  • Android: [EmailRights.Forward](emailrights-class-java.md)
  • iOS and OS X: [[MSEmailRights forward]](msemailrights-interface-objc.md)
  • Windows Store and Windows Phone: [EmailRights.Forward](emailrights-forward.md)
  • Linux: [EmailRights::Forward](http://azuread.github.io/rms-sdk-for-cpp/classrmscore_1_1modernapi_1_1EmailRights.mdl)
 The right to forward a protected message. Typically, when this right is granted, the app enables an email recipient to forward a protected message.
Print
  • Android: [EmailRights.Print](emailrights-class-java.md)
  • iOS and OS X: [[MSEmailRights print]](msemailrights-interface-objc.md)
  • Windows Store and Windows Phone: [EmailRights.Print](emailrights-print.md)
  • Linux: [EmailRights::Print](http://azuread.github.io/rms-sdk-for-cpp/classrmscore_1_1modernapi_1_1EmailRights.mdl)
 The right to print protected content. Typically, when this right is granted, the app enables an email recipient to print a protected message. This right has the same value as the Print right for editable documents.
Reply
  • Android: [EmailRights.Reply](emailrights-class-java.md)
  • iOS and OS X: [[MSEmailRights reply]](msemailrights-interface-objc.md)
  • Windows Store and Windows Phone: [EmailRights.Reply](emailrights-reply.md)
  • Linux: [EmailRights::Reply](http://azuread.github.io/rms-sdk-for-cpp/classrmscore_1_1modernapi_1_1EmailRights.mdl)
 Typically, when this right is granted, the app enables an email recipient to reply to a protected message and include a copy of the original message.
ReplyAll
  • Android: [EmailRights.ReplyAll](emailrights-class-java.md)
  • iOS and OS X: [[MSEmailRights replyAll]](msemailrights-interface-objc.md)
  • Windows Store and Windows Phone: [EmailRights.ReplyAll](emailrights-replyall.md)
  • Linux: [EmailRights::ReplyAll](http://azuread.github.io/rms-sdk-for-cpp/classrmscore_1_1modernapi_1_1EmailRights.mdl)
 Typically, when this right is granted, the app enables an email recipient to reply to all recipients of a protected message and include a copy of the original message.