Content for TS 33.128 Word version: 18.7.0

0… 4… 5… 5.7… 6… 6.2.2.2A… 6.2.3… 6.2.3.2.7… 6.2.3.3… 6.2.4… 6.3… 6.3.2.2A… 6.3.3… 6.3.3.2… 6.3.3.2.4… 6.3.3.2A… 7… 7.3… 7.3.3… 7.3.3.2.21… 7.3.3.2.42… 7.3.3.2.63… 7.3.4… 7.4… 7.4.3.8… 7.5… 7.6… 7.7… 7.7.4… 7.8… 7.8.4… 7.9… 7.10… 7.10.4… 7.11… 7.12… 7.13… 7.13.3… 7.13.3.4… 7.14… 7.15… 8… A… D… E… M…

M.1 Encapsulated Information M.1.1 General M.1.2 Encapsulated information reporting parameters M.1.2.1 Simple Types for encapsulate information reporting M.1.2.2 Type: SBIType M.1.2.3 Type: XMLType M.1.2.4 Type: MIMEEntity M.1.2.5 Type: MSRPMessage M.1.2.6 Type: MIMEPartIdentifier M.1.2.7 Type: ExternalASNType M.1.2.8 Type: ExternalASNValue M.2 Encapsulated information modification M.2.1 General M.2.2 Predefined modifications M.2.3 Use of described modifications M.2.4 Encapsulated information modification parameters M.2.4.1 Simple Types for encapsulated information modification M.2.4.2 Type: PayloadModifications M.2.4.3 Type: PayloadModification M.2.4.4 Enumeration: PredefinedPayloadModification M.2.4.5 Type: PayloadModificationDescription M.2.4.6 Type: ModificationLocation M.2.4.7 Type: ModificationType M.2.4.8 Type: PayloadInformationReplacedWithCharacters M.2.4.9 Type: PayloadInformationRemoved M.2.4.10 Type: MIMEBody M.2.4.11 Type: IndexRange

M (Normative) Reuse of externally defined structures p. 404

M.1 Encapsulated Information p. 404

M.1.1 General p. 404

The subclauses below define LI structures to allow for the reuse of externally defined structures and schemas.

The current version of this specification the following specific encapsulated information types are defined:

SBIType for carrying messages or parameters defined by 3GPP for use over the Service Based Interfaces (SBIs).
XMLTypes for carrying messages or parameters in XML.
MIMEEntity for carrying MIME Entities.
MSRPMessage for sending information formated in an MSRP Message.
ExternalASNType for sending information encoded using an externally defined ASN.1 schema.

The encapsulated information type of the outermost layer of the encapsulated payload shall be used to report the payload.

M.1.2 Encapsulated information reporting parameters p. 404

M.1.2.1 Simple Types for encapsulate information reporting p. 404

Table M.1.2.1-1: Simple Types for LI reporting of encapsulated information

Type name	Type definition	Description
EncapsulatedMSRP	UTF8String	Shall contain the entire MSRP Message in the original encoding.
SBIReference	UTF8String	JSON pointer that indicates the schema definition for the reported SBIValue. Shall be sent in the form of a JSON string value (see Section 5 of RFC 6901). When using the SBIType as a parameter within a record, the value of the SBI Reference shall be clearly indicated in the associated description field of the Table describing the record.
SBIValue	UTF8String	Shall contain the entire value of the SBI Message or parameter being reported.
XMLNamespace	UTF8String	XML namespace that indicates the schema definition for the reported XMLValue. When using the XMLType as a parameter within a record, the value of the XML namespace shall be clearly indicated if known in the associated description field of the Table describing the record.
XMLValue	UTF8String	The contents of the XML document being reported. Shall be sent as an XML document that matches the schema indicated by the xMLNamespace.
EncapsulatedMIMEEntity	UTF8String	Shall contain the entire MIME entity (see Section 2.4 of RFC 2045) in the original encoding.
MIMEContentType	UTF8String	Shall contain the MIME Content Type of the entity being described.
ExternalASNReference	UTF8String	The formal reference notation (as described in clause D.5) for the ASN.1 component used to encode the parameter or message reported in the EncodedASNValue.

M.1.2.2 Type: SBIType p. 405

Table M.1.2.2-1: Structure of the SBIType type

Field name	Type	Cardinality	Description	M/C/O
sBIReference	SBIReference	1	JSON pointer that indicates the schema definition for the reported SBIValue. Shall be sent in the form of a JSON string value (see Section 5 of RFC 6901). When using the SBIType as a parameter within a record, the value of the SBI Reference shall be clearly indicated in the associated description field of the Table describing the record.	M
sBIValue	SBIValue	1	The contents of the SBI message or parameter being reported. Shall be sent as a JSON document that matches the schema indicated by the sBIReference.	M

M.1.2.3 Type: XMLType p. 405

Table M.1.2.3-1: Structure of the XMLType type

Field name	Type	Cardinality	Description	M/C/O
xMLNamespace	XMLNamespace	1	XML namespace that indicates the schema definition for the reported XMLValue. When using the XMLType as a parameter within a record, the value of the XML namespace shall be clearly indicated if known in the associated description field of the Table describing the record.	M
xMLValue	XMLValue	1	The contents of the XML document being reported. Shall be sent as an XML document that matches the schema indicated by the xMLNamespace.	M

M.1.2.4 Type: MIMEEntity p. 405

Table M.1.2.4-1: Structure of the MIMEEntity type

Field name	Type	Cardinality	Description	M/C/O
contentType	MIMEContentType	1	Indicates the MIME content type of the Entity.	M
encapsulatedMIMEEntity	EncapsulatedMIMEEntity	1	The contents of the MIME Entity.	M

M.1.2.5 Type: MSRPMessage p. 405

Table M.1.2.5-1: Structure of the MSRPMessage type

Field name	Type	Cardinality	Description	M/C/O
encapsulatedMSRP	EncapsulatedMSRP	1	The contents of the MSRP Message.	M

M.1.2.6 Type: MIMEPartIdentifier p. 406

Table M.1.2.6-1: Structure of the MIMEPartIdentifier type

Field name	Type	Cardinality	Description	M/C/O
index	INTEGER	1	Indicates a MIME Body Part of a multipart MIME Message. When referring to the MIME Body Parts, the index starts at one.	M

M.1.2.7 Type: ExternalASNType p. 406

Table M.1.2.7-1: Structure of the ExternalASNType type

Field name	Type	Cardinality	Description	M/C/O
moduleIdentifier	OBJECT IDENTIFIER	1	Shall be populated with the Object Identifier of the ASN.1 module used to encode the parameter or message reported in the EncodedASNValue.	M
aSNReference	ExternalASNReference	0..1	The formal reference notation (as described in clause D.5) for the ASN.1 component used to encode the parameter or message reported in the EncodedASNValue. Shall be present if the OBJECT IDENTIFIER is insufficient to unambiguously decode the EncodedASNValue.	C
encodedASNValue	ExternalASNValue	1	The contents of the encoded message or parameter being reported.	M

M.1.2.8 Type: ExternalASNValue p. 406

Table M.1.2.8-1: Choices for the ExternalASNValue type

Field name	Type	Description
bER	OCTET STRING	Shall be used if the reported value is a BER, CER or DER encoded ASN.1 value. Shall be populated with the entire encoded payload.
alignedPER	OCTET STRING	Shall be used if the reported value is an aligned PER encoded ASN.1 value. Shall be populated with the entire encoded payload.

M.2 Encapsulated information modification p. 406

M.2.1 General p. 406

When encapsulated information needs to be modified, the following structures may be used to report that payload in IRI messages.

In general, the predefined redactions listed in the PredefinedPayloadModification Table below should be used whenever possible. In cases where none of the predefined modifications describe the required redactions, the PayloadModificationDescription may be used.

When an encapsulated payload is modified to redact unauthorised information each type of modification applied shall be reported in the PayloadModifications parameter. If the same type of modification is performed in multiple locations, this PayloadModification shall only be indicated once. Additionally, the indication of a PayloadModification indicates that all instances that match the conditions for that modification profile were modified.

M.2.2 Predefined modifications p. 407

The current document provides details for the following predefined methods for redacting unauthorised information from encapsulated payloads:

SMS TP-User-Data content redaction as described in clause 7.12.9.3.2.
IMS location and content information redaction as described in clause 7.12.9.
RCS location and content information redaction as described in clause 7.13.5.

M.2.3 Use of described modifications p. 407

Each modification is described using a ModificationLocation (see clause M.2.4.6) and a ModificationType (see clause M.2.4.7).

M.2.4 Encapsulated information modification parameters p. 407

M.2.4.1 Simple Types for encapsulated information modification p. 407

Table M.2.4.1-1: Simple Types for LI reporting of encapsulated information with modifications

Type name	Type definition	Description
ABNFRuleLocation	UTF8String	The ABNF rule name defining the syntax of the portion of the payload that was modified.

M.2.4.2 Type: PayloadModifications p. 407

Table M.2.4.2-1: Structure of the PayloadModifications type

Field name	Type	Cardinality	Description	M/C/O
modificationList	SEQUENCE OF PayloadModification	1..MAX	Contains a list of modifications performed on the payload being reported.	M

M.2.4.3 Type: PayloadModification p. 407

Table M.2.4.3-1: Choices for the PayloadModification type

Field name	Type	Description
predefinedModification	PredefinedPayloadModification	Shall be chosen if one of the predefined payload modification profiles was applied to the reported payload.
describedModification	PayloadModificationDescription	Shall be chosen if the modification used is described using the PayloadModificationDescription below.

M.2.4.4 Enumeration: PredefinedPayloadModification p. 407

The PredefinedPayloadModification shall be set to indicate which predefined payload modification profile was used on the reported modified payload.

Table M.2.4.4-1: Enumeration for PredefinedPayloadModification parameter

Enumeration	Description
pANILocationRemoval(1)	Shall be selected if location information was redacted from an encapsulated P-Access-Network-Info header using the process described in clause 7.12.9.2.2.
cNILocationRemoval(2)	Shall be selected if location information was redacted from an encapsulated Cellular-Network-Info header using the process described in clause 7.12.9.2.3.
sIPGeolocationInfoRemoval(3)	Shall be selected if location information was redacted due to the presence of a Geolocation header using the process described in clause 7.12.9.2.4.
presenceInformationLocationRemoval(4)	Shall be selected if location information was redacted from the geopriv element of an encapsulated presence information document using the process described in clause 7.12.9.2.5.
tS33128SMSTPDURedaction(5)	Shall be selected if content is redacted from an encapsulated SMS TPDU using the process described in clause 7.4.5.2.
tS33128TruncatedSMSTPDU(6)	Shall be selected if content is removed from an encapsulated SMS TPDU using the process described in clause 6.2.5.3.
iMSTextContentRemoval(7)	Shall be selected if content is redacted from an encapsulated SIP message using the process described in clause 7.12.9.3.3.
iMSSubjectContentRemoval(8)	Sall be selected if content is redacted from an encapsulated SIP message using the process described in clause 7.12.9.3.4.
rCSPresenceLocationRemoval(9)	Shall be selected if location is redacted from the geopriv element of an encapsulated presence information document using the process described in clause 7.13.5.2.2.
rCSCPIMLocationRemoval(10)	Shall be selected if location in the form of a P-Access-Network-Info header is redacted from application specific CPIM headers using the process described in clause 7.13.5.2.3.
rCSTextContentRemoval(11)	Shall be selected if text content is removed from the an RCS message.
rCSSubjectContentRemoval(12)	Shall be selected if content is removed from the Subject header of a layer of an RCS Message using the process described in clause 7.13.5.3.3.
rCSGeolocationPUSHContentRemoval(13)	Shall be selected if content is removed from an RCS Geolocation PUSH message using the process described in clause 7.13.5.3.4.
rCSFileTransferURLRemoval(14)	Shall be selected if URL content is redacted from an RCS File Transfer message as described in clause 7.13.5.3.5.

M.2.4.5 Type: PayloadModificationDescription p. 408

The PayloadModificationDescription shall be used to describe redactions performed on a payload.

Table M.2.4.5-1: Structure of the PayloadModificationDescription type

Field name	Type	Cardinality	Description	M/C/O
modificationLocation	ModificationLocation	1	Contains criteria used to identify where the information redacted from the encapsulated payload was located within the payload.	M
modificationType	ModificationType	1	Contains details on the method used to redact the information from the encapsulated payload.	M

M.2.4.6 Type: ModificationLocation p. 409

Table M.2.4.6-1: Choices for ModificationLocation Type

Choice name	Type	Description
jSONPointer	UTF8String	JSON pointer that indicates location of the modified information within a JSON Document. Shall be sent in the form of a JSON string value (see Section 5 of RFC 6901).
xPath	UTF8String	XPath indicating the node or nodes within an XML document that were modified. Shall be sent in the form of a XPath string value (see W3C Recommendation: "XML Path Language (XPath)" [119]).
sIPHeader	UTF8String	Indicates the header field-name (see Section 7.3.1 of RFC 3261) of the SIP Header field that was modified.
sIPBody	NULL	Indicates the body of the SIP message was modified.
mIMEHeader	UTF8String	Indicates the header field-name (see Section 3 of RFC 2045 and Section 3.6 of RFC 5322) of the MIMEHeader that was modified.
mIMEBody	MIMEBody	Indicated that the body of the MIME Message was modified.
uTF8Location	IndexRange	Indicates that the portion of a UTF8String identified by the IndexRange was modified.
octetLocation	IndexRange	Indicates that the portion of the OCTET STRING identified by the IndexRange was modified.
aBNFRule	ABNFRuleLocation	Indicates the ABNF rule name of the rule that was modified.

M.2.4.7 Type: ModificationType p. 409

Table M.2.4.7-1: Choices for ModificationType Type

Choice name	Type	Description
removed	PayloadInformationRemoved	Indicates that modification being described was the removal of information from the modifiedPayload.
replacedWithCharacters	PayloadInformationReplacedWithCharacters	Indicates that the information was replaced with characters.
replacedWithOctets	OCTET STRING	Indicates that the information was replaced with octets. Shall contain the value of the octets used to replace the information. If the length of the information being replaced is longer than the OCTET STRING included in this parameter, the value included in this parameter is repeated until the full length of the information being replaced is filled.
replacedWithBits	BIT STRING	Indicates that the information was replaced with bits. Shall contain the value of the bits used to replace the information. If the length of the information being replaced is longer than the BIT STRING included in this parameter, the value included in this parameter is repeated until the full length of the information being replaced is filled.

M.2.4.8 Type: PayloadInformationReplacedWithCharacters p. 410

Table M.2.4.8-1: Structure of the PayloadInformationReplacedWithCharacters type

Field name	Type	Cardinality	Description	M/C/O
characters	UTF8String	1	Shall contain the characters used to replace the information. If the length of the information being replaced is longer than the string included in this parameter, the value included in this parameter is repeated until the full length of the information being replaced is filled. The replacement shall be done using the encoding.	M

M.2.4.9 Type: PayloadInformationRemoved p. 410

Table M.2.4.9-1: Choices for PayloadInformationRemoved Type

Choice name	Type	Description
charactersRemoved	INTEGER	Indicates the number of characters removed from the modifiedPayload as a part of the described modification.
octetsRemoved	INTEGER	Indicates the number of octets removed from this portion of the modifiedPayload as a part of the described modification.
bitsRemoved	INTEGER	Indicates the number of bits removed from this portion of the modifiedPayload as a part of the described modification. This choice shall only be used if the information removed cannot be measured in octets.

M.2.4.10 Type: MIMEBody p. 410

Table M.2.4.10-1: Choices for MIMEBody Type

Choice name	Type	Description
fullBody	NULL	Indicates that the entire body of the MIME Entity was modified or that the MIME Entity had only one body part.
bodyPart	MIMEPartIdentifier	Indicates which part of a multipart message was modified by the described modification.

M.2.4.11 Type: IndexRange p. 410

Table M.2.4.11-1: Structure of the IndexRange type

Field name	Type	Cardinality	Description	M/C/O
start	INTEGER	1	Indicates the location where the modification starts. The first octet, character, or bit of the portion of the message that is being modified is referred to as 1.	M
end	INTEGER	1	Indicates the location where the modification ends. The first octet, character, or bit of the portion of the message that is being modified is referred to as 1.	M