xml encryption: processing rules for xml elements and content ed simon xmlsec inc. “xml security...
TRANSCRIPT
XML Encryption: Processing Rules for XML
Elements and Content
Ed SimonXMLsec Inc.
“XML Security Training and Consulting”
http://xmlsec.com
Overview
The current XML Encryption Processing Rules (section 4) state that – when encrypting an XML document’s child elements or
element content, one must replace the plaintext content with <EncryptedData> elements
– when decrypting, decrypted <EncryptedData> elements (of type Element or Content) must be replaced by the revealed XML
If the requirement for replacement is not intentional, we should fix the text. If the requirement is intentional, I propose that it may be too limiting.
Overview…
Note: I am not suggesting that XML Encryption specify an API design, absolutely NOT! However, I don’t want XML Encryption to unnecessarily restrict API designs either.
Note 2: Slides with detailed code are included for completeness; they are not essential for understanding this topic.
How the current Processing Rules workOriginal/Decrypted
<?xml version="1.0" encoding="UTF-8"?>
<Customers> <Customer> <Name>Jose Aznar</Name> <CreditCard> <Number>
1000 1234 5678 0001 </Number>
<ExpiryDate> 2003 June 30 </ExpiryDate>
</CreditCard> </Customer>. . .</Customers>
Encrypted
<?xml version="1.0" encoding="UTF-8"?>
<Customers> <Customer> <Name><EncryptedData…></Name> <CreditCard><Number><EncryptedData…></Number> <ExpiryDate>
2003 June 30 </ExpiryDate>
</Customer>. . .</Customers>
What the code looks likeEncrypting
// Encrypt the content of the <CreditCard>/<Number> elementsNodeIterator ni2 = XPathAPI.selectNodeIterator(doc,"//CreditCard/Number");
// Encrypt the nodes (only element content is encrypted)while ((node = ni2.nextNode())!= null) { System.out.print(".");
xmlencEncryptor.encryptAndReplace((Element)node, true, getEncryptedDataTemplate(desKey, true), desKey);
Decrypting// Get the nodes to be decryptedNodeList nl2 = DOMUtil.getElementsByTagNameNS( doc, XEncryption.XMLENC_NS, "EncryptedData");// Decryptfor (int i = 0; i < nl2.getLength(); i++) { System.out.print("."); Element el = (Element)nl2.item(i); xmlencDecryptor.decryptAndReplace(el);}
Other processing scenarios
Scenario A: The XML source has no encrypted parts and is protected through authorization instead. However, there is an authorized app which selects certain credit card info for processing. It wants to query <CreditCard> elements and/or content, encrypt, and import the resulting <EncryptedData> element into a SOAP message.
Scenario B: The XML source has encrypted elements and content accessible by a number of applications. When one of these applications queries an encrypted element, that app needs to decrypt the element but MUST NOT modify the source.
Scenario A: SOAP msg w/ encrypted data
.
SOAP msgcustomer.xml(no encryption)
Authorizationcontrol
1. Select node
2. Encrypt node (no replace)and return to application
3. Form SOAP msg
Credit card info app
Scenario A: SOAP message
<?xml version="1.0" encoding="UTF-8"?><Envelope xmlns="http://www.w3.org/2001/06/soap-envelope"> <Body> <VerifyCreditCardRequest xmlns="http://…/actions"> <EncryptedData Type="NodeList“ xmlns="http://…/xmlenc"> <EncryptionMethod Algorithm="urn:nist-gov:tripledes…"> <IV>adCwS3wowQ8=</IV> </EncryptionMethod> …<CipherData>Ynj…M1f</CipherData>… </EncryptedData> </VerifyCreditCardRequest> </Body></Envelope>
Scenario A codeEncrypting
// Encrypt the content of the 2nd <CreditCard>/<Number> elementnodeToBeEncrypted = XPathAPI.selectSingleNode(doc, "//Customer[2]/CreditCard/Number");
// Encrypt the nodes (whole elements are encrypted)Element elemEncryptedData = xmlencEncryptor.encrypt((Element)nodeToBeEncrypted, false, getEncryptedDataTemplate(desKey, false), desKey);
Document docSoap = new DocumentImpl();Element elemEnvelope = docSoap.createElement("Envelope");Element elemBody = docSoap.createElement("Body");Element elemBodyChild = docSoap.createElement("VerifyCreditCardRequest");Node nodeImported = docSoap.importNode(elemEncryptedData, true);elemBodyChild.appendChild(nodeImported);elemBody.appendChild(elemBodyChild);elemEnvelope.appendChild(elemBody);docSoap.appendChild(elemEnvelope);
Scenario A code…
Note: The preceding code works (uses IBM’s XSS4J) but, according to the spec, its illegal because the XML source is not being replaced.
Scenario B: Encrypted customer DB
1. Select <EncryptedData> node
.
Interface to authorized usercustomer.xml
(encrypted)
Credit card info app
Customer name: H. LuCredit card#: 4011 23
3. Display info to authorized user2. Decrypt node (no replace)
and return to application
Scenario B codeDecrypting
// Get the nodes to be decryptedElement elemEncryptedDataToDecrypt = (Element) DOMUtil.getElementsByTagNameNS(doc, XEncryption.XMLENC_NS,
"EncryptedData").item(5);Element elemIV = (Element) elemEncryptedDataToDecrypt.getElementsByTagName("IV").item(0);String strIV = elemIV.getFirstChild().getNodeValue();
Element elemCipherData = (Element) elemEncryptedDataToDecrypt.getElementsByTagName("CipherText").item(0);String strCipherData = elemCipherData.getFirstChild().getNodeValue();
javax.crypto.spec.IvParameterSpec ivparmspec = new javax.crypto.spec.IvParameterSpec(com.ibm.xml.dsig.Base64.decode(strIV));
Cipher desCipher = Cipher.getInstance("DESede/CBC/PKCS5Padding");desCipher.init(Cipher.DECRYPT_MODE, desKey, ivparmspec);byte[] bytesPlainData =
desCipher.doFinal(com.ibm.xml.dsig.Base64.decode(strCipherData));String strCreditCardNumber = new String(bytesPlainData);
Scenario B code…
Don’t want to use decryptAndReplace() because I don’t want to modify the XML source.
But XML Encryption doesn’t allow Toolkits to give me an alternative so I have to use low-level security APIs instead!
Rather, XML Encryption should allow Toolkits to return the decrypted XML element or content without requiring replacement in the source.
QAQ(Quietly Anticipated Questions)
Question: Why not create a dummy document before and/or after encrypting?
Answer: Yes, one could create a dummy document and copy in the relevant elements before encrypting or decrypting and still conform to the XML Encryption spec as it currently stands.However, this would be inefficient and often inelegant.
Question: The example code you showed doesn’t deal with more complex context situations such as inherited namespaces, default attributes, etc.. How will those artifacts affect the no-replacement processing of <EncryptedData> elements?
Answer: I think this question will only be answered through more coding and application experience. There could be some issues that arise.