Skip to main content

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:

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

  1. 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
  1. 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
  1. 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyfva-0.0.41.tar.gz (42.8 kB view details)

Uploaded Source

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

Hashes for pyfva-0.0.41.tar.gz
Algorithm Hash digest
SHA256 d48c827feddeab9717af489651efaa3502b05c9e3ec690b211a06de6c5f1149f
MD5 cddd31435279d7f75a6addbe022cdcd7
BLAKE2b-256 be1c701ae798bac554b49c13d9e14dae8dc26ff5aa5795744a27c4292a7f57dc

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page