Cliente para conectar instituciones con BCCR FVA.
Project description
pyfva
Cliente para conectar instituciones con BCCR FVA.
Abstrae la comunicación entre los servicios SOAP del BCCR y python creando clientes de fácil uso, por ejemplo si se desea autenticar a una persona se realizaría como
from pyfva.clientes.autenticador import ClienteAutenticador
authclient = ClienteAutenticador(1,1) # negocio, entidad
if authclient.validar_servicio():
data = authclient.solicitar_autenticacion('08-0888-0888')
else:
# warnings.warn("Auth BCCR No disponible", RuntimeWarning)
data = authclient.DEFAULT_ERROR
Instalación
Instale mediante pypi
pip install pyfva
o usando el repositorio
pip install git+https://github.com/solvo/pyfva.git
Documentación
Por supuesto la documentoación está aquí
Parámetros de ambiente
Los siguientes parámetros pueden ser modificados usando variables de entorno o variables en django settings.
Los valores por defecto son:
FVA_HOST = “http://bccr.fva.cr/”
RECEPTOR_HOST = ‘http://bccr.fva.cr/’
Ambos son direcciones del esquema, deben ser iguales al esquema del servicio WSDL.
STUB_SCHEME = ‘http’
STUB_HOST = “localhost:8001”
Dirección y protocolo donde se ubica el servicio FVA.
DEFAULT_BUSSINESS = 1
DEFAULT_ENTITY = 1
Números de identificación en el servicio FVA. (en el simulador no son usados).
RECEPTOR_CLIENT = ‘pyfva.receptor.client’
Cliente para recibir las respuestas del FVA.
Configurando entorno del BCCR externo
Las siguientes configuraciones son requeridas, los archivos deben estar en formato PEM
REQUESTS_CA_BUNDLE=/<ruta de archivo>/ca_nacional_de_CR.pem
REQUESTS_CA_PATH=/<ruta de archivo>/ca_nacional_de_CR.pem
REQUESTS_CERT_PATH=/<ruta de archivo>/bccr_agent.pem
REQUESTS_KEY_PATH=/<ruta de archivo>/bccr_agent_key.pem
STUB_SCHEME = ‘https’
STUB_HOST = “firmadorexterno.bccr.fi.cr”
Para realizar pruebas de conexión es importante configurar una comunicación por ssl, los siguientes comándos pueden ser de ayuda
Unifica la cadena de certificados de confianza
cat CA RAIZ NACIONAL - COSTA RICA v2.pem CA POLITICA PERSONA JURIDICA - COSTA RICA v2.pem CA SINPE - PERSONA JURIDICA v2.pem >/ca_nacional_de_CR.pem
Verifique que su certificado está validado por la CA que acaba de crear
openssl verify -verbose -CAfile ca_nacional_de_CR.pem bccr_agent.pem
Verifica que puede realizar una conexión con el BCCR autenticándose con el certificado
curl --http1.1 --cert bccr_agent.pem --key bccr_agent_key.pem --cacert ca_nacional_de_CR.pem https://firmadorexterno.bccr.fi.cr:443/WebServices/Bccr.Fva.Entidades.AmbDePruebas.Sello.Ws.SI/SelladorElectronicoConControlDeLlave.asmx?wsdl
Generar documentoación
Instale Sphinx mediante pypi
pip install -U Sphinx sphinx_rtd_theme
Cambiese de directorio y ejecute la creación de códigos
cd docs
bash build_doc.sh
Para regenerar la documentación, si no se tienen cambios en los códigos de error
make html
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file pyfva-0.0.41.tar.gz
.
File metadata
- Download URL: pyfva-0.0.41.tar.gz
- Upload date:
- Size: 42.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.0 CPython/3.9.12
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | d48c827feddeab9717af489651efaa3502b05c9e3ec690b211a06de6c5f1149f |
|
MD5 | cddd31435279d7f75a6addbe022cdcd7 |
|
BLAKE2b-256 | be1c701ae798bac554b49c13d9e14dae8dc26ff5aa5795744a27c4292a7f57dc |