signxml 0.3.5

Python XML Signature library

SignXML is an implementation of the W3C XML Signature standard in Python (both “Second Edition” and Version 1.1). This standard (also known as XMLDSig and RFC 3275) is used to provide payload security in SAML 2.0, among other uses. SignXML implements all of the required components of the standard, and most recommended ones. Its features are:

• Use of defusedxml.lxml to defend against common XML-based attacks when verifying signatures

• Extensions to allow signing with and verifying X.509 certificate chains, including hostname/CN validation

• Support for exclusive XML canonicalization with inclusive prefixes (InclusiveNamespaces PrefixList, required to verify signatures generated by some SAML implementations)

• Modern Python compatibility (2.7-3.4+ and PyPy)

• Well-supported, portable, reliable dependencies: lxml, defusedxml, cryptography, eight, pyOpenSSL

• Comprehensive testing (including the XMLDSig interoperability suite) and continuous integration

• Simple interface with useful defaults

• Compactness, readability, and extensibility

Installation

pip install signxml

Synopsis

SignXML uses the ElementTree API (also supported by lxml) to work with XML data.

from signxml import xmldsig

cert = open("example.pem").read()
key = open("example.key").read()
root = ElementTree.fromstring(signature_data)
xmldsig(root).sign(key=key, cert=cert)
xmldsig(root).verify()

Verifying SAML assertions

Assuming metadata.xml contains SAML metadata for the assertion source:

from lxml import etree
from base64 import b64decode
from signxml import xmldsig

with open("metadata.xml", "rb") as fh:
    cert = etree.parse(fh).find("//ds:X509Certificate").text

root = etree.parse(b64decode(assertion)).getroot()
xmldsig(root).verify(x509_cert=cert)

Signing SAML assertions

The SAML assertion schema specifies a location for the enveloped XML signature (between <Issuer> and <Subject>). To sign a SAML assertion in a schema-compliant way, insert a signature placeholder tag at that location before calling xmldsig: <ds:Signature Id="placeholder"></ds:Signature>.

See the API documentation for more.

Authors

• Andrey Kislyuk

Links

• Project home page (GitHub)

• Documentation (Read the Docs)

• Package distribution (PyPI)

• List of W3C XML Signature standards and drafts

• W3C Recommendation: XML Signature Syntax and Processing (Second Edition)

• W3C Recommendation: XML Signature Syntax and Processing Version 1.1

• W3C Working Group Note: XML Signature Syntax and Processing Version 2.0

• W3C Working Group Note: XML Signature Best Practices

• XML-Signature Interoperability

• W3C Working Group Note: Test Cases for C14N 1.1 and XMLDSig Interoperability

• XMLSec: Related links

Bugs

Please report bugs, issues, feature requests, etc. on GitHub.

License

Licensed under the terms of the Apache License, Version 2.0.