face_signer's Introduction

FACe signer

It provides a Zeep plugin desired to patch SOAP envelopes providing a pseudo-X509 WS-Security integration (expected by FACe servers) signing just the soap header.

Usage

Just create a Zeep client with FACE_signer plugin with the following arguments:

certificate must be an string with the relative path to the PEM file
debug is an optional boolean flag that triggers the stdout printing

FACe_signer initialization:

FACE_plugin = FACe_signer(
    certificate=PEM_CERTIFICATE,
    [debug=False]
)

from FACe_signer import FACe_signer

import zeep

FACE_ENVS = {
    'staging': "https://se-face-webservice.redsara.es/facturasspp2?wsdl",
    'prod': "https://webservice.face.gob.es/facturasspp2?wsdl"
}
OUR_CERT = "certs/our_cert.pem"

client = zeep.Client(
    FACE_ENVS['prod'],
    plugins=[FACe_signer(OUR_CERT)]
)

# Use the expected service as usual with zeep
client.service.XXX()

How to install

Just install it using pip:

$ pip install FACe_signer

Remember to process the OS requirements (libsecxml development), see requirements_os.txt

How to debug

debug=True argument can be passed at FACe_signer initialization to reach a dump of the request and the response of each FACe's interaction.

Also, "normal" debug using python logging can be performed, i.e:

import logging.config

# Activate DEBUG for zeep transports
logging.config.dictConfig({
    'version': 1,
    'formatters': {
        'verbose': {
            'format': '%(name)s: %(message)s'
        }
    },
    'handlers': {
        'console': {
            'level': 'DEBUG',
            'class': 'logging.StreamHandler',
            'formatter': 'verbose',
        },
    },
    'loggers': {
        'zeep.transports': {
            'level': 'DEBUG',
            'propagate': True,
            'handlers': ['console'],
        },
    }
})

Recommend Projects