Voir la source de Triple Wrapping Technical Documentation

> [[Documentation]] > [[Trustedbird]] > [[Triple_Wrapping|Triple Wrapping]] > [[Triple_Wrapping_Technical_Documentation|Technical Documentation]]


== Specifications ==

The reference for the implementation of this functionality is the [http://www.ietf.org/rfc/rfc2634.txt RFC 2634]

Additional resources:
* http://fr.wikipedia.org/wiki/Multipurpose_Internet_Mail_Extensions
* http://tools.ietf.org/html/rfc1847

== Architecture ==

=== Synthetic presentation of the architecture of the extension ===

This functionality is in the list of features to be implemented by the Mozilla foundation: http://www.mozilla.org/projects/security/pki/nss/smime/. So, it is integrated to the source code of Thunderbird, without relaying on an extension. Furthermore, this make more simple the addition of this functionality, because we need to update the heart of the product.

This functionality is going to be integrated with the official source code by Mozilla: https://bugzilla.mozilla.org/show_bug.cgi?id=380624

=== GUI files ===

At the GUI level, signing and encrypting are implemented by two flags ''signMessage'' and ''requireEncryptMessage'', encapsulated in a [http://www.xulplanet.com/references/xpcomref/ifaces/nsIMsgSMIMECompFields.html nsIMsgSMIMECompFields] object. The whole code handling those flags are contained in the JS built-in library ''msgCompSMIMEOverlay.js''.

Then, the object [http://www.xulplanet.com/references/xpcomref/ifaces/nsIMsgSMIMECompFields.html nsIMsgSMIMECompFields] is forwarded to the XPCOM layer, that handles the signing and encrypting. So, this class has been updated to add a flag for the triple wrapping mode. Furthermore, the GUI has been updated so that the user can choose this security level.

[[Image:TripleWrapping_Options1_en.gif]]

[[Image:TripleWrapping_Options2_en.gif]]

[[Image:TripleWrapping_Options3_en.gif]]

[[Image:TripleWrapping_Icon_en.gif]]

=== XPCOM files ===

==== Message sending ====

The implementation is mainly located in the file ''nsMsgComposeSecure.cpp'' in the [http://www.xulplanet.com/references/xpcomref/ifaces/nsIMsgComposeSecure.html nsMsgComposeSecure] class.
This implementation handles the triple wrapping case and called the right existing routines to sign, then encrypt, then sign a message.

==== Message receiving ====

When receiving a message, the standard implementation is able to handle triple wrapped messages: the MIME library use a recursive algorithm and so is able to read a multi wrapped message.