Description

Python library for digital signing and verification of digital signatures in mail, PDF and XML documents.

The ASN.1 implementation depends on asn1crypto. Cryptographic routines depends on cryptography library.

For certificate verification OpenSSL is used but I would not trust it, next version should switch to cryptography.

This library implements S/MIME handler which can encrypt and decrypt S/MIME messages using a public RSA key, in AES-128/192/256 CBC/OFB modes. It can also sign and verify S/MIME messages.

This library implements CAdES-B handler for signing and verifying PDF documents in Adobe.PPKLite/adbe.pkcs7.detached form. It can sign documents during generation using a modified version of pyfpdf which is included in this library. It can also sign documents generated by external programms.

This library implements XADES-BES handler for creating signed xml files.

This library implements CMS handler for signing and verifying plain text files with detached signature files.

License

This software is licensed under the MIT License. See the LICENSE file in the top distribution directory for the full license text.

## Requirements

• Python 3.*
• cryptography
• asn1crypto
• lxml
• pykcs11
• Pillow

Examples

cert-make.py

Create required certificates (password is 1234)

cert-make-hsm.py

Create required certificates for SoftHSM (password is secret1)

pdf-make.py

Create simple two paged PDF document which is used in pdf-sign-cms.py.

pdf-sign-cms.py

Create signature in externally created PDF.

pdf-sign-cms-hsm.py

Create signature in externally created PDF but signed with key stored in SoftHSM.

pdf-sign-fpdf.py

Create signature while creating PDF.

pdf-verify.py

Verify prevously generated files (cms/pdf).

plain-make.py

Create simple UTF-8 text file.

plain-openssl.sh

Sign, encrypt and decrypt text file with help of openssl executable.

plain-sign-attr.py

Sign text file with 'extended' CMS attributes.

plain-sign-noattr.py

Sign text file without 'extended' CMS attributes.

plain-verify.py

Verify all generated signatures for text file.

smime-make.py

Create simple UTF-8 text file for use in following examples.

smime-openssl.sh

Create signed S/MIME file, encrypted S/MIME file and decrypt generated S/MIME file with help of openssl executable.

smime-encrypt.py

Create encrypted S/MIME file.

smime-decrypt.py

Decrypt encrypted S/MIME file.

smime-sign-attr.py

Create signed S/MIME file with 'extended' CMS attributes.

smime-sign-noattr.py

Create signed S/MIME file without 'extended' CMS attributes.

smime-verify.py

Verify all generated S/MIME files.

xml-make.py

Create simple xml file for use in following examples.

xml-xades-bes-sign-b64.py

Create xml file with base64 encoded embedded source file inside own content.

xml-xades-bes-sign-xml.py

Create xml file with not encoded but still embedded source file inside own content.

xml-xades-bes-sign-xml-detached.py

Create xml file with signature in detached mode.

xml-xades-bes-read.py

Decode generated xml signatures and extract their content.

Tools

Online pdf validator pdfvalidator or verapdf. Offline Apache pdfbox java based validator. Free S/MIME certificates (usable for documents signing) can be obtained from actalis.