(Ms-Asrm) : Exchange Activesync: Rights Management Protocol
(Ms-Asrm) : Exchange Activesync: Rights Management Protocol
Tools. The Open Specifications documentation does not require the use of Microsoft programming
tools or programming environments in order for you to develop an implementation. If you have access
to Microsoft programming tools and environments, you are free to take advantage of them. Certain
Open Specifications documents are intended for use in conjunction with publicly available standards
specifications and network programming art and, as such, assume that the reader either is familiar
with the aforementioned material or has immediate access to it.
1 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
Revision Summary
Revision Revision
Date History Class Comments
2 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
Table of Contents
1 Introduction ............................................................................................................ 5
1.1 Glossary ........................................................................................................... 5
1.2 References ........................................................................................................ 6
1.2.1 Normative References ................................................................................... 6
1.2.2 Informative References ................................................................................. 6
1.3 Overview .......................................................................................................... 6
1.4 Relationship to Other Protocols ............................................................................ 7
1.5 Prerequisites/Preconditions ................................................................................. 7
1.6 Applicability Statement ....................................................................................... 8
1.7 Versioning and Capability Negotiation ................................................................... 8
1.8 Vendor-Extensible Fields ..................................................................................... 8
1.9 Standards Assignments....................................................................................... 8
2 Messages ................................................................................................................. 9
2.1 Transport .......................................................................................................... 9
2.2 Message Syntax ................................................................................................. 9
2.2.1 Namespaces ................................................................................................ 9
2.2.2 Elements ..................................................................................................... 9
2.2.2.1 ContentExpiryDate .................................................................................. 9
2.2.2.2 ContentOwner ...................................................................................... 10
2.2.2.3 EditAllowed .......................................................................................... 11
2.2.2.4 ExportAllowed ...................................................................................... 11
2.2.2.5 ExtractAllowed ...................................................................................... 12
2.2.2.6 ForwardAllowed .................................................................................... 13
2.2.2.7 ModifyRecipientsAllowed ........................................................................ 14
2.2.2.8 Owner ................................................................................................. 14
2.2.2.9 PrintAllowed ......................................................................................... 15
2.2.2.10 ProgrammaticAccessAllowed ................................................................... 15
2.2.2.11 RemoveRightsManagementProtection ...................................................... 16
2.2.2.12 ReplyAllAllowed .................................................................................... 17
2.2.2.13 ReplyAllowed ........................................................................................ 17
2.2.2.14 RightsManagementLicense ..................................................................... 18
2.2.2.15 RightsManagementSupport .................................................................... 19
2.2.2.16 RightsManagementTemplate................................................................... 20
2.2.2.17 RightsManagementTemplates ................................................................. 20
2.2.2.18 TemplateDescription .............................................................................. 21
2.2.2.18.1 TemplateDescription (RightsManagementLicense)................................ 21
2.2.2.18.2 TemplateDescription (RightsManagementTemplate) ............................. 22
2.2.2.19 TemplateID .......................................................................................... 22
2.2.2.19.1 TemplateID (RightsManagementLicense) ............................................ 23
2.2.2.19.2 TemplateID (RightsManagementTemplate) ......................................... 23
2.2.2.19.3 TemplateID (SendMail, SmartForward, SmartReply) ............................ 24
2.2.2.20 TemplateName ..................................................................................... 25
2.2.2.20.1 TemplateName (RightsManagementLicense) ....................................... 25
2.2.2.20.2 TemplateName (RightsManagementTemplate) .................................... 25
3 Protocol Details ..................................................................................................... 27
3.1 Client Details ................................................................................................... 27
3.1.1 Abstract Data Model .................................................................................... 27
3.1.2 Timers ...................................................................................................... 27
3.1.3 Initialization ............................................................................................... 27
3.1.4 Higher-Layer Triggered Events ..................................................................... 27
3.1.4.1 Requesting Server-Side Decompression and Decryption of Rights-Managed E-
mail Messages ...................................................................................... 27
3.1.4.2 Getting Rights Policy Templates .............................................................. 27
3 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
3.1.4.3 Sending Protected E-mail ....................................................................... 28
3.1.5 Message Processing Events and Sequencing Rules .......................................... 28
3.1.6 Timer Events .............................................................................................. 28
3.1.7 Other Local Events ...................................................................................... 28
3.2 Server Details .................................................................................................. 28
3.2.1 Abstract Data Model .................................................................................... 28
3.2.2 Timers ...................................................................................................... 28
3.2.3 Initialization ............................................................................................... 28
3.2.4 Higher-Layer Triggered Events ..................................................................... 28
3.2.4.1 Enforcing Rights Policy Template Settings ................................................ 28
3.2.4.2 Sending Rights Policy Templates ............................................................. 29
3.2.4.3 Sending Rights-Managed E-Mail Messages to the Client ............................. 29
3.2.5 Message Processing Events and Sequencing Rules .......................................... 29
3.2.5.1 Handling SmartForward and SmartReply Requests .................................... 29
3.2.6 Timer Events .............................................................................................. 31
3.2.7 Other Local Events ...................................................................................... 32
4 Protocol Examples ................................................................................................. 33
4.1 Retrieve Rights Policy Templates by Using the Settings Command .......................... 33
4.2 Request That the Server Decompress and Decrypt Rights-Managed E-mail Messages 34
4.3 Request That the Server Not Decompress and Decrypt Rights-Managed E-mail
Messages ........................................................................................................ 35
4.4 Reply to a Rights-Managed E-Mail Message by Using the SmartReply Command ...... 36
4.5 Search for a Rights-Managed E-Mail Message by Using the Search Command .......... 37
4.6 Fetch a Rights-Managed E-Mail Message by Using the ItemOperations Command ..... 38
4.7 Remove IRM Protection by Using the ItemOperations Command ............................ 40
5 Security ................................................................................................................. 43
5.1 Security Considerations for Implementers ........................................................... 43
5.2 Index of Security Parameters ............................................................................ 43
6 Appendix A: Full XML Schema ................................................................................ 44
7 Appendix B: Product Behavior ............................................................................... 45
8 Change Tracking .................................................................................................... 46
9 Index ..................................................................................................................... 47
4 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
1 Introduction
The Exchange ActiveSync: Rights Management Protocol is used by a client, typically a mobile device,
to create and consume rights-managed e-mail messages. A rights-managed e-mail message is
used to protect e-mail content from inappropriate access, use, and distribution.
Sections 1.5, 1.8, 1.9, 2, and 3 of this specification are normative. All other sections and examples in
this specification are informative.
1.1 Glossary
rights policy template: An XrML 1.2 document that contains a predefined usage policy that is
used to create the PL when content is protected. Conceptually, a rights policy template (or
"template") is a blueprint for a PL, identifying authorized users and the actions they are
authorized to take with the content (along with any conditions on that usage). Unlike a PL, a
template does not contain a content key or information about the content owner. The content
key and information about the content owner are required to be added when the PL for a given
piece is created from the template. End users can use a template when protecting a document
instead of defining the specifics of the usage policy themselves. When a document is published
using a template, the template is used to generate the PL.
rights-managed email message: An email message that specifies permissions that are designed
to protect its content from inappropriate access, use, and distribution.
Secure Sockets Layer (SSL): A security protocol that supports confidentiality and integrity of
messages in client and server applications that communicate over open networks. SSL supports
server and, optionally, client authentication using X.509 certificates [X509] and [RFC5280]. SSL
is superseded by Transport Layer Security (TLS). TLS version 1.0 is based on SSL version 3.0
[SSL3].
Wireless Application Protocol (WAP) Binary XML (WBXML): A compact binary representation
of XML that is designed to reduce the transmission size of XML documents over narrowband
communication channels.
XML namespace: A collection of names that is used to identify elements, types, and attributes in
XML documents identified in a URI reference [RFC3986]. A combination of XML namespace and
local name allows XML documents to use elements, types, and attributes that have the same
names but come from different sources. For more information, see [XMLNS-2ED].
XML schema: A description of a type of XML document that is typically expressed in terms of
constraints on the structure and content of documents of that type, in addition to the basic
syntax constraints that are imposed by XML itself. An XML schema provides a view of a
document type at a relatively high level of abstraction.
5 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
MAY, SHOULD, MUST, SHOULD NOT, MUST NOT: These terms (in all caps) are used as defined
in [RFC2119]. All statements of optional behavior use either MAY, SHOULD, or SHOULD NOT.
1.2 References
Links to a document in the Microsoft Open Specifications library point to the correct section in the
most recently published version of the referenced document. However, because individual documents
in the library are not updated at the same time, the section numbers in the documents may not
match. You can confirm the correct section numbering by checking the Errata.
We conduct frequent surveys of the normative references to assure their continued availability. If you
have any issue with finding a normative reference, please contact [email protected]. We will
assist you in finding the relevant information.
[MS-ASWBXML] Microsoft Corporation, "Exchange ActiveSync: WAP Binary XML (WBXML) Algorithm".
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC
2119, March 1997, http://www.rfc-editor.org/rfc/rfc2119.txt
[XMLNS] Bray, T., Hollander, D., Layman, A., et al., Eds., "Namespaces in XML 1.0 (Third Edition)",
W3C Recommendation, December 2009, http://www.w3.org/TR/2009/REC-xml-names-20091208/
[XMLSCHEMA1] Thompson, H., Beech, D., Maloney, M., and Mendelsohn, N., Eds., "XML Schema Part
1: Structures", W3C Recommendation, May 2001, http://www.w3.org/TR/2001/REC-xmlschema-1-
20010502/
1.3 Overview
This protocol defines a set of XML elements used by a client to create and consume rights-managed
e-mail messages. A rights-managed e-mail message is used to protect e-mail content from
inappropriate access, use and distribution. Each rights-managed e-mail message has an associated
rights policy template, which controls the usage policy applied to each rights-managed e-mail
message.
6 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
A rights policy template specifies whether a user can edit, forward, reply, reply all, print, extract
(copy), export (remove protection), or programmatically access the content in the rights-managed e-
mail message. When a user creates a rights-managed e-mail message, the user chooses and applies
the rights policy template that has the protection settings they require. For example, a manager can
send an employee confidential information using a template that prohibits forwarding or printing the
e-mail, but does allow the user to respond to the e-mail. Or, a public relations manager can send
confidential company information to users inside their organization, and select a template that only
allows the protected content to be viewed, replied to, and forwarded within the organization, but not
viewed outside the organization.
The creation of rights policy templates is external to this protocol. For more information about
deployment and distribution of rights policy templates, see [MSFT-ARPTC].
The XML elements specified in this protocol enable the client to:
Retrieve the rights policy templates available to the client for composing rights-managed e-mail
message.
Request that the server decompress and decrypt rights-managed e-mail messages before sending
them to the client. For details about decompress and decrypt rights-managed email messages,
refer to [MS-OXORMMS] section 3.1.4.2.1.
Perform actions on a rights-managed e-mail message in accordance with the rights policy
template applied to the e-mail message.
It is the responsibility of the client to enforce the rights specified by the rights policy template to the
rights-managed e-mail message.
This protocol consists of a series of XML elements that are embedded inside an XML-formatted
command request or a command response. Command requests and responses are described in [MS-
ASCMD]. Command requests and responses are transmitted using Wireless Application Protocol
(WAP) Binary XML (WBXML), as described in [MS-ASWBXML].
The protected content contained in rights-managed e-mail messages are synchronized between
the client and the server by using the E-mail class elements defined in [MS-ASEMAIL].
This protocol defines elements according to the data type definitions that are described in [MS-
ASDTYPE].
For conceptual background information and overviews of the relationships and interactions between
this and other protocols, see [MS-OXPROTO].
1.5 Prerequisites/Preconditions
This protocol requires a secure connection between the client and server, as described in section 5.1.
This protocol assumes that the client has been approved to consume and compose IRM content by
the server. For more information about client-side and server-side IRM requirements, see [MSFT-
IRMEAS].
7 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
1.6 Applicability Statement
This protocol is designed for the creation and consumption of rights-managed e-mail messages on
a client, which is typically a mobile device.
None.
None.
None.
8 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
2 Messages
2.1 Transport
This protocol consists of a series of XML elements that are embedded inside a command request or a
command response. The XML markup that constitutes the request body or the response body is
transmitted between client and server by using Wireless Application Protocol (WAP) Binary XML
(WBXML), as specified in [MS-ASWBXML].
For more information about how the RightsManagement namespace elements are used in command
requests and responses, see sections 3.1.4 and 3.2.4.
2.2.1 Namespaces
This specification defines and references various XML namespaces using the mechanisms specified in
[XMLNS]. Although this specification associates a specific XML namespace prefix for each XML
namespace that is used, the choice of any particular XML namespace prefix is implementation-specific
and not significant for interoperability.
None RightsManagement
xs http://www.w3.org/2001/XMLSchema [XMLSCHEMA1]
2.2.2 Elements
2.2.2.1 ContentExpiryDate
9 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
ASCMD] section 2.2.1.10) to fetch the content again from the server. If the rights management
license allows it, the content can be provided once more with a new ContentExpiryDate.
Protocol Versions
The following table specifies the protocol versions that support this element. The client indicates the
protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-
ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section
2.2.1.1.1.1, in the request.
2.5
12.0
12.1
14.0
14.1 Yes
16.0 Yes
16.1 Yes
2.2.2.2 ContentOwner
The value of this element is a string ([MS-ASDTYPE] section 2.7). The value MUST have a minimum
of one character.
Protocol Versions
The following table specifies the protocol versions that support this element. The client indicates the
protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-
ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section
2.2.1.1.1.1, in the request.
2.5
12.0
12.1
14.0
10 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
Protocol version Element support
14.1 Yes
16.0 Yes
16.1 Yes
2.2.2.3 EditAllowed
The value of this element is a boolean ([MS-ASDTYPE] section 2.1). If the value is TRUE (1), the e-
mail can be modified by the user; if the value is FALSE (0), the email cannot be modified by the user.
The value of this element MUST be set to TRUE (1) if the ExportAllowed element is set to TRUE (1).
A value of FALSE requires that the client MUST exclude the original rights-managed email
message from the SmartForward ([MS-ASCMD] section 2.2.1.19) or SmartReply ([MS-ASCMD]
section 2.2.1.20) request. Consequently, inline replies are not allowed if the EditAllowed element is
set to FALSE. When EditAllowed is set to FALSE and composemail:ReplaceMime ([MS-ASCMD]
section 2.2.3.148) is not present in a SmartForward or SmartReply request, the server will add the
original rights-managed email message as an attachment to the new message. Conversely, if
composemail:ReplaceMime is present, the server will not attach the original rights-managed email
message as an attachment.
Protocol Versions
The following table specifies the protocol versions that support this element. The client indicates the
protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-
ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section
2.2.1.1.1.1, in the request.
2.5
12.0
12.1
14.0
14.1 Yes
16.0 Yes
16.1 Yes
11 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
2.2.2.4 ExportAllowed
The value of this element is a boolean ([MS-ASDTYPE] section 2.1). If the value is TRUE (1), the
user can remove the IRM protection of the original message’s content in the outgoing message when
the user forwards, replies, or replies all to the original e-mail message; if the value is FALSE (0), the
user cannot remove the IRM protection of the original message’s content in the outgoing message
when the user forwards, replies, or replies all to the original e-mail message.
The original rights policy template has the ExportAllowed element set to TRUE
The TemplateID (section 2.2.2.19.3) on the new message is set to the "No Restriction" template
(TemplateID value "00000000-0000-0000-0000-000000000000")
If both of the conditions are true, the IRM protection is removed from the outgoing message. The
original message retains its IRM protection.
Protocol Versions
The following table specifies the protocol versions that support this element. The client indicates the
protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-
ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section
2.2.1.1.1.1, in the request.
2.5
12.0
12.1
14.0
14.1 Yes
16.0 Yes
16.1 Yes
2.2.2.5 ExtractAllowed
The value of this element is a boolean ([MS-ASDTYPE] section 2.1). If the value is TRUE (1), the
content of the e-mail message can be cut, copied, or a screen capture can be taken of the content; if
the value is FALSE (0), the content of the e-mail message cannot be cut, copied, or a screen capture
cannot be taken of the content.
12 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
The ExtractAllowed element has no child elements.
Protocol Versions
The following table specifies the protocol versions that support this element. The client indicates the
protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-
ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section
2.2.1.1.1.1, in the request.
2.5
12.0
12.1
14.0
14.1 Yes
16.0 Yes
16.1 Yes
2.2.2.6 ForwardAllowed
The value of this element is a boolean ([MS-ASDTYPE] section 2.1). If the value is TRUE (1), the
user can forward the e-mail message; if the value is FALSE (0), the user cannot forward the e-mail
message.
Protocol Versions
The following table specifies the protocol versions that support this element. The client indicates the
protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-
ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section
2.2.1.1.1.1, in the request.
2.5
12.0
12.1
14.0
14.1 Yes
16.0 Yes
16.1 Yes
13 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
2.2.2.7 ModifyRecipientsAllowed
This element is a boolean data type, as specified in [MS-ASDTYPE] section 2.1. If the value is TRUE
(1), the user can modify the recipient list; if the value is FALSE (0), the user cannot modify the
recipient list. The value of this element MUST be the same as that of the ForwardAllowed element in
the response.
Protocol Versions
The following table specifies the protocol versions that support this element. The client indicates the
protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-
ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section
2.2.1.1.1.1, in the request.
2.5
12.0
12.1
14.0
14.1 Yes
16.0 Yes
16.1 Yes
2.2.2.8 Owner
The Owner element is a required child element of the RightsManagementLicense element (section
2.2.2.14). It specifies whether the user is the owner of the e-mail message.
The value of this element is a boolean ([MS-ASDTYPE] section 2.1). If the value is TRUE (1), the
user is the owner of the e-mail message; if the value is FALSE (0), the user is not the owner of the e-
mail message. A value of TRUE indicates that the authenticated user has owner rights on this
message. This element is used for information presentation purposes only. The Allowed elements
(EditAllowed, ReplyAllowed, etc.) are used to evaluate whether a particular action is permitted or
restricted.
Protocol Versions
The following table specifies the protocol versions that support this element. The client indicates the
protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-
ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section
2.2.1.1.1.1, in the request.
14 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
Protocol version Element support
2.5
12.0
12.1
14.0
14.1 Yes
16.0 Yes
16.1 Yes
2.2.2.9 PrintAllowed
The value of this element is a boolean ([MS-ASDTYPE] section 2.1). If the value is TRUE (1), the e-
mail can be printed by the user; if the value is FALSE (0), the e-mail cannot be printed by the user.
Protocol Versions
The following table specifies the protocol versions that support this element. The client indicates the
protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-
ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section
2.2.1.1.1.1, in the request.
2.5
12.0
12.1
14.0
14.1 Yes
16.0 Yes
16.1 Yes
2.2.2.10 ProgrammaticAccessAllowed
15 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
The value of this element is a boolean ([MS-ASDTYPE] section 2.1). If the value is TRUE (1), third
party applications can access the protected content of the e-mail message programmatically; if the
value is FALSE (0), third party applications cannot access the protected content of the e-mail
message programmatically. Protected content consists of the message body and attachments.
Protocol Versions
The following table specifies the protocol versions that support this element. The client indicates the
protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-
ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section
2.2.1.1.1.1, in the request.
2.5
12.0
12.1
14.0
14.1 Yes
16.0 Yes
16.1 Yes
2.2.2.11 RemoveRightsManagementProtection
IRM protection can only be removed from e-mail messages when the ExportAllowed element is set
to TRUE.
Protocol Versions
The following table specifies the protocol versions that support this element. The client indicates the
protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-
ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section
2.2.1.1.1.1, in the request.
2.5
12.0
12.1
16 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
Protocol version Element support
14.0
14.1 Yes
16.0 Yes
16.1 Yes
2.2.2.12 ReplyAllAllowed
The value of this element is a boolean ([MS-ASDTYPE] section 2.1). If the value is TRUE (1), the
user can reply to all of the recipients of the e-mail message; if the value is FALSE (0), the user cannot
reply to all of the recipients of the e-mail message.
Protocol Versions
The following table specifies the protocol versions that support this element. The client indicates the
protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-
ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section
2.2.1.1.1.1, in the request.
2.5
12.0
12.1
14.0
14.1 Yes
16.0 Yes
16.1 Yes
2.2.2.13 ReplyAllowed
The value of this element is a boolean ([MS-ASDTYPE] section 2.1). If the value is TRUE (1), the
user can reply to the e-mail message; if the value is FALSE (0), the user cannot reply to the e-mail
message.
17 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
Protocol Versions
The following table specifies the protocol versions that support this element. The client indicates the
protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-
ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section
2.2.1.1.1.1, in the request.
2.5
12.0
12.1
14.0
14.1 Yes
16.0 Yes
16.1 Yes
2.2.2.14 RightsManagementLicense
The RightsManagementLicense element can only have the following child elements:
18 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
TemplateName (section 2.2.2.20.1). This element is required.
Protocol Versions
The following table specifies the protocol versions that support this element. The client indicates the
protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-
ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section
2.2.1.1.1.1, in the request.
2.5
12.0
12.1
14.0
14.1 Yes
16.0 Yes
16.1 Yes
2.2.2.15 RightsManagementSupport
The value of this element is a boolean ([MS-ASDTYPE] section 2.1). If the value of this element is
TRUE (1), the server will decompress and decrypt rights-managed email messages before sending
them to the client, as specified in section 3.2.4.3. If the value is FALSE (0), the server will not
decompress or decrypt rights-managed email messages before sending them to the client. If the
RightsManagementSupport element is not included in a request message, a default value of FALSE
is assumed.
Protocol Versions
The following table specifies the protocol versions that support this element. The client indicates the
protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-
ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section
2.2.1.1.1.1, in the request.
2.5
12.0
12.1
14.0
19 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
Protocol version Element support
14.1 Yes
16.0 Yes
16.1 Yes
2.2.2.16 RightsManagementTemplate
The RightsManagementTemplate element can have only one of each of the following child
elements:
Protocol Versions
The following table specifies the protocol versions that support this element. The client indicates the
protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-
ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section
2.2.1.1.1.1, in the request.
2.5
12.0
12.1
14.0
14.1 Yes
16.0 Yes
16.1 Yes
2.2.2.17 RightsManagementTemplates
The RightsManagementTemplates element is an optional child element of the Get element ([MS-
ASCMD] section 2.2.3.83) that contains the rights policy templates available to the client.
The RightsManagementTemplates element can only have the following child element
20 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
RightsManagementTemplate (section 2.2.2.16). This element is optional. A maximum of 20
RightsManagementTemplate elements can be returned to the client.
Protocol Versions
The following table specifies the protocol versions that support this element. The client indicates the
protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-
ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section
2.2.1.1.1.1, in the request.
2.5
12.0
12.1
14.0
14.1 Yes
16.0 Yes
16.1 Yes
2.2.2.18 TemplateDescription
The value of this element is a string ([MS-ASDTYPE] section 2.7). The value MUST have a minimum
of one character.
Protocol Versions
The following table specifies the protocol versions that support this element. The client indicates the
protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-
ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section
2.2.1.1.1.1, in the request.
2.5
12.0
21 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
Protocol version Element support
12.1
14.0
14.1 Yes
16.0 Yes
16.1 Yes
Protocol Versions
The following table specifies the protocol versions that support this element. The client indicates the
protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-
ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section
2.2.1.1.1.1, in the request.
2.5
12.0
12.1
14.0
14.1 Yes
16.0 Yes
16.1 Yes
2.2.2.19 TemplateID
22 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
RightsManagementTemplate (section 2.2.2.16)
The value of this element is a string ([MS-ASDTYPE] section 2.7). The value MUST have a minimum
of one character.
Protocol Versions
The following table specifies the protocol versions that support this element. The client indicates the
protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-
ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section
2.2.1.1.1.1, in the request.
2.5
12.0
12.1
14.0
14.1 Yes
16.0 Yes
16.1 Yes
Protocol Versions
The following table specifies the protocol versions that support this element. The client indicates the
protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-
ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section
2.2.1.1.1.1, in the request.
2.5
12.0
12.1
23 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
Protocol version Element support
14.0
14.1 Yes
16.0 Yes
16.1 Yes
The TemplateID element is an optional child element of the SendMail element ([MS-ASCMD] section
2.2.3.162), the SmartForward element ([MS-ASCMD] section 2.2.3.169), and the SmartReply
element ([MS-ASCMD] section 2.2.3.170). It contains a string that identifies a particular rights policy
template to be applied to the outgoing message.
The original rights policy template has the ExportAllowed element set to TRUE.
The TemplateID on the new message is set to the "No Restriction" template (TemplateID value
"00000000-0000-0000-0000-000000000000").
Protocol Versions
The following table specifies the protocol versions that support this element. The client indicates the
protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-
ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section
2.2.1.1.1.1, in the request.
2.5
12.0
12.1
14.0
14.1 Yes
16.0 Yes
16.1 Yes
24 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
2.2.2.20 TemplateName
The value of this element is a string ([MS-ASDTYPE] section 2.7). The value MUST have a minimum
of one character.
Protocol Versions
The following table specifies the protocol versions that support this element. The client indicates the
protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-
ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section
2.2.1.1.1.1, in the request.
2.5
12.0
12.1
14.0
14.1 Yes
16.0 Yes
16.1 Yes
Protocol Versions
The following table specifies the protocol versions that support this element. The client indicates the
protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-
ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section
2.2.1.1.1.1, in the request.
25 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
Protocol version Element support
2.5
12.0
12.1
14.0
14.1 Yes
16.0 Yes
16.1 Yes
26 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
3 Protocol Details
None.
3.1.2 Timers
None.
3.1.3 Initialization
None.
The user triggers the client to create request messages when they synchronize, search, fetch, reply,
or forward rights-managed e-mail messages from their mobile device.
When the client sends a Sync ([MS-ASCMD] section 2.2.1.21), ItemOperations ([MS-ASCMD]
section 2.2.1.10), or Search ([MS-ASCMD] section 2.2.1.16) command request, the client can request
that the server decompress and decrypt rights-managed email messages by including the
RightsManagementSupport element set to TRUE (1). Clients MUST enforce the restrictions on the
message as indicated by the RightsManagementLicense element (section 2.2.2.14) included in the
response. If a client cannot enforce the restrictions on the message, it SHOULD NOT include the
RightsManagementSupport element set to TRUE (1) in requests.
The client obtains the details about the available rights policy templates by sending a Settings
command request that includes the settings:RightsManagementInformation element ([MS-
ASCMD] section 2.2.3.156) with a settings:Get child element. The server returns the rights policy
template settings in the response, as defined in section 3.2.4.2. Once the server returns the
templates, the client stores the templates locally for future use within the SendMail, SmartReply or
SmartForward commands. Because the templates can change, it is recommended that the client
caches the templates for no longer than 24 hours.
27 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
3.1.4.3 Sending Protected E-mail
The client protects an e-mail message by including the TemplateID element in the SendMail ([MS-
ASCMD] section 2.2.1.17), SmartReply ([MS-ASCMD] section 2.2.1.20), or SmartForward ([MS-
ASCMD] section 2.2.1.19) command requests. If the command request does not include the
TemplateID element, the e-mail message is sent without rights management.
None.
None.
None.
3.2.2 Timers
None.
3.2.3 Initialization
None.
The client triggers the server to create response messages when it receives request messages that
contain IRM-protected data or settings.
The server returns Status ([MS-ASCMD] section 2.2.3.177) value 168 if IRM is disabled on the
server. For an example, see section 4.1.
The server returns Status value 169 if a transient failure was encountered. The client SHOULD retry
the request in a few minutes if Status value 169 is returned.
The server returns Status value 170 if a permanent failure or multiple transient failures were
encountered.
The server returns Status value 171 in a SmartReply or SmartForward command response if the
request included an invalid TemplateID value.
The server returns Status value 172 if the client tries to perform an action on a rights-managed e-
mail message that is prohibited by the rights policy template.
28 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
3.2.4.2 Sending Rights Policy Templates
The string values in the TemplateDescription and TemplateName elements SHOULD be returned
to the client in the language specified in the request (either by the Locale field in the Base64
Encoded Query Value as specified in [MS-ASHTTP] section 2.2.1.1.1.1, or by the Accept-Language
header if the request line is not encoded) if available on the server. If the requested language is not
available, the server SHOULD return the strings in the closest possible match to the requested
language. The method of determining a closest possible match is implementation-specific. If no
language is specified in the request, the string values SHOULD be returned in English.
To respond to a Sync, ItemOperations, or Search command request message that includes the
RightsManagementSupport element, the server includes the RightsManagementLicense element
and its child elements in the Sync, ItemOperations, or Search command response message.
The string values in the TemplateDescription and TemplateName elements SHOULD be returned
to the client in the language specified in the request (either by the Locale field in the Base64
Encoded Query Value as specified in [MS-ASHTTP] section 2.2.1.1.1.1, or by the Accept-Language
header if the request line is not encoded) if available on the server. If the requested language is not
available, the server SHOULD return the strings in the closest possible match to the requested
language. The method of determining a closest possible match is implementation-specific. If no
language is specified in the request, the string values SHOULD be returned in English.
The server processes request messages as specified in [MS-ASCMD]. If the protocol version that is
specified by the command request does not support the XML elements that are defined for this
protocol, the server SHOULD consider the XML body of the command request to be invalid. For details
about the XML elements for this protocol and the protocol versions that support them, see section
2.2.2.
When the client sends the server a SmartForward or SmartReply command request for a message
with a rights policy template, the server MUST do the following to enforce the rights policy template:
1. If no TemplateID element is included in the command request, the server proceeds as follows:
If the original message had rights management restrictions, the server replaces the body
of the message with boilerplate text. In a SmartForward command, the rights-
29 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
managed e-mail message is added as an .rpmsg attachment as specified in [MS-
OXORMMS].
2. If any of the following are true, the server fails the request and returns composemail:Status
value 168:
The server does not support IRM features. See section 1.5 for more details.
3. If the TemplateID element is included in the command request, the server does the following:
If the original message is not protected, the server proceeds to step 5. If the template
does not exist on the server, the server fails the request and returns a
composemail:Status value of 171.
If the original message is protected and the specified TemplateID value is the same as
the TemplateID value on the original message, the server proceeds to step 4.
If the original message is protected and the specified TemplateID value is different than
the TemplateID value on the original message, the server verifies that the new
TemplateID value exists on the server. If the TemplateID value does not correspond to
a template on the server, the server fails the request and returns a composemail:Status
value of 171; otherwise, the server proceeds to step 4.
4. The server compares the recipients on the original message to the recipients sent by the client
within the new message. The server verifies that the recipient list on the new message aligns with
the granted permissions, as specified in the following table. If permissions allow it, the server
creates the reply or forwarded message; otherwise, a composemail:Status value of 172 is
returned by the server.
5. If the message has a TemplateID element, the server protects the new outgoing message with
the specified rights policy template.
The following table describes the reply, reply all, and forward enforcement that is performed by the
server.
ModifyRecipientsAllowed = TRUE* For reply and reply all, refer to the last four rows in
FALSE this table.
For forwarding, attach the original message and send
it.*
TRUE TRUE FALSE Reply to exactly one recipient or all original recipients.
Whether the sender chooses to include themselves in
the reply message is optional. All other SmartReply
command requests are restricted and error out with a
composemail:Status value of 172.
SmartForward requests are restricted and return a
composemail:Status value of 172.
TRUE FALSE FALSE Reply to exactly one recipient, the sender of the
original message. All other SmartReply command
requests are restricted and error out with a
composemail:Status value of 172.
30 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
ReplyAllowed ReplyAllAllowed ForwardAllowed Server-side enforcement
FALSE TRUE FALSE Reply to exactly all original recipients. Whether the
sender chooses to include themselves in the reply
message is optional All other SmartReply command
requests are restricted and error out with a
composemail:Status value of 172.
SmartForward command requests are restricted and
return a composemail:Status value of 172.
*The server does not enforce the lack of reply and reply all rights.
The following table describes the edit and export enforcement that is performed by the server.
*In these cases, the client MUST NOT include the original message inline in the new message due to
the possible breach of IRM protection.
None.
31 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
3.2.7 Other Local Events
None.
32 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
4 Protocol Examples
To retrieve the rights policy templates available to the user, the client sends the Settings
command to the server. The request message includes the
settings:RightsManagementInformation and settings:Get elements, which instruct the server to
include the rights policy template in the response. In this scenario, the successful response includes
two rights policy templates, each specified in its own RightsManagementTemplate element. The
unsuccessful response includes settings:Status value 168, which indicates that IRM protection is
disabled on the server. Other error values are possible and are specified in section 3.2.4.1.
Request
Successful Response
Unsuccessful Response
33 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
4.2 Request That the Server Decompress and Decrypt Rights-Managed E-mail
Messages
To retrieve a new email message from the server and request that the server decompress and decrypt
rights-managed email messages, the client sends the Sync command and sets the
RightsManagementSupport element to TRUE. The response includes a new rights-managed email
message, which has the rights policy template included in the RightsManagementLicense element.
Request
Response
34 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
<email2:ConversationIndex>…</email2:ConversationIndex>
<email:Categories />
<airsyncbase:BodyPart>
<airsyncbase:Status>1</airsyncbase:Status>
<airsyncbase:Type>2</airsyncbase:Type>
<airsyncbase:EstimatedDataSize>90</airsyncbase:EstimatedDataSize>
<airsyncbase:Data><div>
<div>This is a test message that we want to use.</div>
</div>
</airsyncbase:Data>
</airsyncbase:BodyPart>
<rm:RightsManagementLicense>
<rm:Owner>0</rm:Owner>
<rm:ContentOwner>[email protected]</rm:ContentOwner>
<rm:ReplyAllAllowed>1</rm:ReplyAllAllowed>
<rm:EditAllowed>1</rm:EditAllowed>
<rm:ReplyAllowed>1</rm:ReplyAllowed>
<rm:ForwardAllowed>0</rm:ForwardAllowed>
<rm:ExportAllowed>0</rm:ExportAllowed>
<rm:ModifyRecipientsAllowed>0</rm:ModifyRecipientsAllowed>
<rm:TemplateID>cf5cf348-a8d7-40d5-91ef-a600b88a395d</rm:TemplateID>
<rm:ExtractAllowed>0</rm:ExtractAllowed>
<rm:TemplateDescription>Recipients can read this message, but they can't
forward, print, or copy content. The conversation owner has full permission to their message
and all replies.</rm:TemplateDescription>
<rm:ContentExpiryDate>9999-12-30T23:59:59.999Z</rm:ContentExpiryDate>
<rm:TemplateName>Do Not Forward</rm:TemplateName>
<rm:PrintAllowed>0</rm:PrintAllowed>
<rm:ProgrammaticAccessAllowed>0</rm:ProgrammaticAccessAllowed>
</rm:RightsManagementLicense>
<email2:IsDraft>0</email2:IsDraft>
</ApplicationData>
</Add>
</Commands>
</Collection>
</Collections>
</Sync>
4.3 Request That the Server Not Decompress and Decrypt Rights-Managed E-mail
Messages
When the client does not request that the server decompress and decrypt rights-managed email
messages, the server sends the content as a message.rpmsg attachment, as described in [MS-
OXORMMS] section 2.2.4.5. In this scenario, the RightsManagementSupport element is not
included in the Sync command request, and a default value of FALSE is assumed on the server.
The response message includes the file message.rpmsg as an attachment to the e-mail message. The
message.rpmsg file includes the protected content, which cannot be opened on a client that does not
support IRM natively.
Request
35 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
</Collection>
</Collections>
</Sync>
Response
To reply to a rights-managed email message, the client sends a SmartReply command message
and includes the TemplateID element. In this scenario, the client retrieves the TemplateID from the
local store, because it is responding to a message that it sent originally.
Request
36 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
<?xml version="1.0" encoding="utf-8"?>
<SmartReply xmlns:rm="RightsManagement:" xmlns="ComposeMail:">
<ClientId>634135220584105742</ClientId>
<Source>
<FolderId>5</FolderId>
<ItemId>5:1</ItemId>
</Source>
<Mime>From: [email protected]
To: [email protected]
Subject: Message
MIME-Version: 1.0
Content-Type: text/plain; Charset= us-ascii
Content-Transfer-Encoding: 7bit
X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2800.1441
Response
HTTP/1.1 200 OK
Date: Thu, 01 Jul 2010 02:14:20 GMT
Content-Length: 0
4.5 Search for a Rights-Managed E-Mail Message by Using the Search Command
To search for a rights-managed e-mail message, the client sends the Search command and sets
the RightsManagementSupport element to TRUE.
Request
Response
37 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
<?xml version="1.0" encoding="utf-8"?>
<Search xmlns:airsyncbase="AirSync:" xmlns:email="Email:" xmlns:airsyncbase="AirSyncBase:"
xmlns:email2="Email2:" xmlns:rm="RightsManagement:" xmlns="Search:">
<Status>1</Status>
<Response>
<Store>
<Status>1</Status>
<Result>
<airsyncbase:Class>Email</airsyncbase:Class>
<LongId>RgAAAAC56adCCdvKRYRrNA1IgBolBwB%2bSy6NhndsQ7ldDXB%2fCAqQAAAAbHbTAAB%2bSy6NhndsQ7ldDXB
%2fCAqQAAAAbJ5XAAAJ</LongId>
<airsyncbase:CollectionId>5</airsyncbase:CollectionId>
<Properties>
<email:To>"T0SyncUser3" <[email protected]></email:To>
<email:From>"T0SyncUser1" <[email protected]></email:From>
<email:Subject>DoNotForward</email:Subject>
<email:DateReceived>2010-06-30T23:52:51.908Z</email:DateReceived>
<email:DisplayTo>T0SyncUser3</email:DisplayTo>
<email:ThreadTopic>DoNotForward</email:ThreadTopic>
<email:Importance>1</email:Importance>
<email:Read>0</email:Read>
<airsyncbase:Body>
<airsyncbase:Type>1</airsyncbase:Type>
<airsyncbase:EstimatedDataSize>64</airsyncbase:EstimatedDataSize>
<airsyncbase:Data>This is a test message that we want to use.</airsyncbase:Data>
</airsyncbase:Body>
<email:MessageClass>IPM.Note</email:MessageClass>
<email:InternetCPID>28591</email:InternetCPID>
<email:Flag />
<email:ContentClass>urn:content-classes:message</email:ContentClass>
<airsyncbase:NativeBodyType>1</airsyncbase:NativeBodyType>
<email2:ConversationId>…</email2:ConversationId>
<email2:ConversationIndex>…</email2:ConversationIndex>
<email:Categories />
<rm:RightsManagementLicense>
<rm:Owner>0</rm:Owner>
<rm:ContentOwner>[email protected]</rm:ContentOwner>
<rm:ReplyAllAllowed>1</rm:ReplyAllAllowed>
<rm:EditAllowed>1</rm:EditAllowed>
<rm:ReplyAllowed>1</rm:ReplyAllowed>
<rm:ForwardAllowed>0</rm:ForwardAllowed>
<rm:ExportAllowed>0</rm:ExportAllowed>
<rm:ModifyRecipientsAllowed>0</rm:ModifyRecipientsAllowed>
<rm:TemplateID>cf5cf348-a8d7-40d5-91ef-a600b88a395d</rm:TemplateID>
<rm:ExtractAllowed>0</rm:ExtractAllowed>
<rm:TemplateDescription>Recipients can read this message, but they can't forward,
print, or copy content. The conversation owner has full permission to their message and all
replies.</rm:TemplateDescription>
<rm:ContentExpiryDate>9999-12-30T23:59:59.999Z</rm:ContentExpiryDate>
<rm:TemplateName>Do Not Forward</rm:TemplateName>
<rm:PrintAllowed>0</rm:PrintAllowed>
<rm:ProgrammaticAccessAllowed>0</rm:ProgrammaticAccessAllowed>
</rm:RightsManagementLicense>
<email2:IsDraft>0</email2:IsDraft>
</Properties>
</Result>
<Range>0-0</Range>
<Total>1</Total>
</Store>
</Response>
</Search>
To fetch a rights-managed e-mail message, the client sends the ItemOperations command and
sets the RightsManagementSupport element to TRUE.
38 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
The response includes the rights-managed e-mail message.
Request
Response
39 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
<rm:TemplateDescription>Recipients can read this message, but they can't forward,
print, or copy content. The conversation owner has full permission to their message and all
replies.</rm:TemplateDescription>
<rm:ContentExpiryDate>9999-12-30T23:59:59.999Z</rm:ContentExpiryDate>
<rm:TemplateName>Do Not Forward</rm:TemplateName>
<rm:PrintAllowed>0</rm:PrintAllowed>
<rm:ProgrammaticAccessAllowed>0</rm:ProgrammaticAccessAllowed>
</rm:RightsManagementLicense>
<email2:IsDraft>0</email2:IsDraft>
</Properties>
</Fetch>
</Response>
</ItemOperations>
To remove IRM protection from a rights-managed e-mail message, the user first uses the Sync
command to sync the e-mail message to the client. The client then uses the ItemOperations
command to remove rights management protection. This section includes both successful and
unsuccessful ItemOperations responses.
ItemOperations Request
In this scenario, the ItemOperations command was successful because the ExportAllowed value
was set to TRUE for the rights policy template applied to the e-mail message. The e-mail message
included in the response has no IRM protection and includes the previously protected content in the
body of the message.
40 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
<email:To>"T0SyncUser3" <[email protected]></email:To>
<email:From>"T0SyncUser1" <[email protected]></email:From>
<email:Subject>Confidential</email:Subject>
<email:DateReceived>2010-06-30T23:47:06.961Z</email:DateReceived>
<email:DisplayTo>T0SyncUser3</email:DisplayTo>
<email:ThreadTopic>Confidential</email:ThreadTopic>
<email:Importance>1</email:Importance>
<email:Read>0</email:Read>
<airsyncbase:Body>
<airsyncbase:Type>1</airsyncbase:Type>
<airsyncbase:EstimatedDataSize>64</airsyncbase:EstimatedDataSize>
<airsyncbase:Data>This is a test message that we want to use.</airsyncbase:Data>
</airsyncbase:Body>
<email:MessageClass>IPM.Note</email:MessageClass>
<email:InternetCPID>28591</email:InternetCPID>
<email:Flag />
<email:ContentClass>urn:content-classes:message</email:ContentClass>
<airsyncbase:NativeBodyType>2</airsyncbase:NativeBodyType>
<email2:ConversationId>…</email2:ConversationId>
<email2:ConversationIndex>…</email2:ConversationIndex>
<email2:IsDraft>0</email2:IsDraft>
</Properties>
</Fetch>
</Response>
</ItemOperations>
In this scenario, the ItemOperations command to remove rights management protection was not
successful because the ExportAllowed value was set to FALSE for the rights policy template applied
to the e-mail message. The ItemOperations command response includes the protected content in
the body of the message, but the message is still a rights-managed e-mail message and is using the
ViewOnly template to restrict editing, forwarding, replying, replying all, exporting, or extracting the
content.
41 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
<rm:RightsManagementLicense>
<rm:Owner>0</rm:Owner>
<rm:ContentOwner>[email protected]</rm:ContentOwner>
<rm:ReplyAllAllowed>0</rm:ReplyAllAllowed>
<rm:EditAllowed>0</rm:EditAllowed>
<rm:ReplyAllowed>0</rm:ReplyAllowed>
<rm:ForwardAllowed>0</rm:ForwardAllowed>
<rm:ExportAllowed>0</rm:ExportAllowed>
<rm:ModifyRecipientsAllowed>0</rm:ModifyRecipientsAllowed>
<rm:TemplateID>e9225d21-a80e-4642-81eb-d5e9afe3f33a</rm:TemplateID>
<rm:ExtractAllowed>0</rm:ExtractAllowed>
<rm:TemplateDescription>Description for template
'ViewOnly'</rm:TemplateDescription>
<rm:ContentExpiryDate>9999-12-30T23:59:59.999Z</rm:ContentExpiryDate>
<rm:TemplateName>ViewOnly</rm:TemplateName>
<rm:PrintAllowed>0</rm:PrintAllowed>
<rm:ProgrammaticAccessAllowed>0</rm:ProgrammaticAccessAllowed>
</rm:RightsManagementLicense>
<email2:IsDraft>0</email2:IsDraft>
</Properties>
</Fetch>
</Response>
</ItemOperations>
42 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
5 Security
This protocol requires that communication between the client and server occurs over an HTTP
connection that uses Secure Sockets Layer (SSL), as described in [MS-ASHTTP] section 1.5,
2.2.1.1.2.2, and 5.1.
None.
43 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
6 Appendix A: Full XML Schema
For ease of implementation, this section contains the contents of the RightsManagement.xsd file,
which represents the full XML schema for this protocol. The additional file that this schema file
requires to operate correctly is listed in the following table.
44 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
7 Appendix B: Product Behavior
The information in this specification is applicable to the following Microsoft products or supplemental
software. References to product versions include updates to those products.
Exceptions, if any, are noted in this section. If an update version, service pack or Knowledge Base
(KB) number appears with a product name, the behavior changed in that update. The new behavior
also applies to subsequent updates unless otherwise specified. If a product edition appears with the
product version, behavior is different in that product edition.
Unless otherwise specified, any statement of optional behavior in this specification that is prescribed
using the terms "SHOULD" or "SHOULD NOT" implies product behavior in accordance with the
SHOULD or SHOULD NOT prescription. Unless otherwise specified, the term "MAY" implies that the
product does not follow the prescription.
45 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
8 Change Tracking
This section identifies changes that were made to this document since the last release. Changes are
classified as Major, Minor, or None.
The revision class Major means that the technical content in the document was significantly revised.
Major changes affect protocol interoperability or implementation. Examples of major changes are:
The revision class Minor means that the meaning of the technical content was clarified. Minor changes
do not affect protocol interoperability or implementation. Examples of minor changes are updates to
clarify ambiguity at the sentence, paragraph, or table level.
The revision class None means that no new technical changes were introduced. Minor editorial and
formatting changes may have been made, but the relevant technical content is identical to the last
released version.
The changes made to this document are listed in the following table. For more information, please
contact [email protected].
46 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
9 Index
A F
C Glossary 5
Capability negotiation 8 H
Change tracking 46
Client Higher-layer triggered events
abstract data model 27 client 27
higher-layer triggered events 27 server 28
initialization 27
message processing 28 I
other local events 28
sequencing rules 28 Implementer - security considerations 43
timer events 28 Index of security parameters 43
timers 27 Informative references 6
Initialization
D client 27
server 28
Data model - abstract Introduction 5
client 27
server 28 M
E Message processing
client 28
Elements server 29
ContentExpiryDate 9 Messages
ContentOwner 10 Namespaces 9
EditAllowed 11 transport 9
ExportAllowed 11
ExtractAllowed 12 N
ForwardAllowed 13
ModifyRecipientsAllowed 14 Namespaces message 9
Owner 14 Normative references 6
PrintAllowed 15
ProgrammaticAccessAllowed 15 O
RemoveRightsManagementProtection 16
ReplyAllAllowed 17 Other local events
ReplyAllowed 17 client 28
RightsManagementLicense 18 server 32
RightsManagementSupport 19 Overview (synopsis) 6
RightsManagementTemplate 20
RightsManagementTemplates 20
P
TemplateDescription 21
TemplateID 22
Parameters - security index 43
TemplateName 25
Preconditions 7
Examples
Prerequisites 7
fetching a rights-managed e-mail 38
Product behavior 45
removing IRM protection 40
replying to a rights-managed e-mail 36
requesting that the server decompress and decrypt R
rights-managed e-mail 34
requesting that the server not decompress and References 6
decrypt rights-managed e-mail 35 informative 6
retrieving rights policy templates 33 normative 6
searching for a rights-managed e-mail 37 Relationship to other protocols 7
47 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018
S
Security
implementer considerations 43
parameter index 43
Sequencing rules
client 28
server 29
Server
abstract data model 28
higher-layer triggered events 28
initialization 28
message processing 29
other local events 32
sequencing rules 29
timer events 31
timers 28
Standards assignments 8
Timer events
client 28
server 31
Timers
client 27
server 28
Tracking changes 46
Transport 9
Triggered events - higher-layer
client 27
server 28
Vendor-extensible fields 8
Versioning 8
XML schema 44
48 / 48
[MS-ASRM] - v20181001
Exchange ActiveSync: Rights Management Protocol
Copyright © 2018 Microsoft Corporation
Release: October 1, 2018