Oxalis es la implementación de software de código abierto líder de las especificaciones de punto de acceso de servicio de servicio de eDeliveria (AS4) de OpenPeppol. Este repositorio fue desarrollado originalmente por Steinar Overbeck Cook (Sendregning) y luego fue atendido por la Agencia Noruega para la Gestión Pública y el Egobierno (DIFI) hasta marzo de 2020.
A partir de noviembre de 2020, Oxalis está siendo mantenida por la comunidad de Norstella Oxalis.
Oxalis Community es una organización sin fines de lucro organizada bajo la Fundación Norstella con sede en Noruega, dedicada al continuo apoyo y desarrollo de Oxalis, para asegurar el cumplimiento y el valor de Peppol para sus usuarios.
La comunidad de Oxalis es facilitada por la Fundación Norstella. Está organizado de acuerdo con los principios democráticos sin fines de lucro y establecido como una parte independiente y autónoma de la Asociación Norstella con presupuestos independientes.
Los objetivos de la comunidad Oxalis:
Oxalis se puede utilizar como una solución completa de peppol independiente o como un componente API de su propio código. El componente independiente ( oxalis-standalone
) viene con una herramienta de línea de comandos básica para enviar mensajes. Persiste mensajes entrantes al sistema de archivos fuera de la caja. La persistencia ha sido modularizada para que pueda proporcionar su propia implementación si necesita enviar mensajes entrantes a una cola de mensajes, un motor de flujo de trabajo, un archivo de documentos u otros.
Las distribuciones binarias están disponibles tanto en Maven Central como en GitHub.
Java 11 es la versión Java mínima compatible desde Oxalis 6.0.0. Para una documentación detallada, consulte: Main.Adoc
Las últimas noticias técnicas están disponibles en: https://www.oxalis.network/technical-information
Estamos buscando activamente colaboradores que puedan contribuir a los repositorios de oxalis y GIT asociados. Puede comenzar a solucionar problemas seleccionando cualquier problema existente o puede agregar una nueva función. Consulte la lista de verificación de solicitud de extracción mientras se genera una nueva solicitud de extracción. El equipo revisará su código, si cumplirá con el objetivo deseado y estará de acuerdo con los estándares y las pautas, entonces se fusionará para dominar.
Componente | Tipo | Descripción |
---|---|---|
oxalis-incobundido | guerra | Implementación del punto de acceso entrante que se ejecuta en Tomcat (1) |
oxalis por encima | frasco | Componente saliente para enviar documentos comerciales de Peppol (2) |
oxalis-standalone | principal | Solicitud de línea de comando para enviar documentos comerciales de Peppol (3) |
(1) Recibe mensajes utilizando el protocolo AS2 y los almacena en el sistema de archivos como predeterminado.
(2) se puede incorporar a cualquier sistema que deba enviar documentos de Peppol.
(3) sirve como código de ejemplo sobre cómo enviar documentos comerciales utilizando el componente Oxalis Outbound.
OXALIS_HOME
y edite el archivo oxalis.conf
OXALIS_HOME
para hacer referencia a ese directoriooxalis-distribution
.oxalis.war
a su directorio de Tomcat webapps
example.sh
a su gusto y ejecutarlo. Sending failed ... Received fatal alert: handshake_failure
ocurre cuando Oxalis no puede establecer la conexión HTTPS con el servidor remoto. Por lo general, porque Destination AccessPoint ha "parcheado de caniche" su servidor HTTPS. Oxalis v3.1.0 contiene soluciones para esto, por lo que debe actualizar. Vea el #197 para más información.
Provider net.sf.saxon.TransformerFactoryImpl not found
podría ser una conflos de implementación XSLT entre Oxalis y el validador VEFA. VEFA necesita XSLT 2.0 y establece explícitamente Saxon 9 como motor de transformador al JVM. Dado que Saxon 9 no se usa y se incluye con Oxalis, terminará con ese error en el lado de Oxalis. Para deshacerse del error, asegúrese de ejecutar Oxalis y VEFA en procesos Tomcats/JVM separados.
ValidatorException: PKIX path building failed
probablemente se deba a que el certificado SSL de receptores no contiene la cadena de certificado correcta. La implementación AS2 debe validar la cadena de certificados SSL y cualquier certificado intermedio debe estar presente. Vea el #173 para obtener más información.
Internal error occured: null
cuando la recepción puede deberse a un error en algunas versiones de Apache Tomcat. El mensaje de error completo registrado es ERROR [network.oxalis.as2.inbound.As2Servlet] [] Internal error occured: null
seguido de una traza de pila con java.lang.NullPointerException: null
. Para resolver esta actualización Tomcat a una versión más nueva, eche un vistazo al #179 para obtener más detalles.
Tenga en cuenta que la revisión de la "cabeza" oxalis en la rama maestra a menudo está en "flujo" y debe considerarse una "construcción nocturna". Las versiones oficiales se etiquetan y se pueden descargar haciendo clic en etiquetas.
oxalis
Root Directory Run: mvn clean install -Pdist
oxalis-dist/oxalis-distribution/target/oxalis-distribution-<version.number>-distro/
Por defecto, Oxalis publica las direcciones web que se enumeran en la tabla a continuación.
La tabla describe su uso y da algunas pistas sobre cómo asegurar esas direcciones.
Un escenario bastante estándar es usar algún tipo de equilibrador de carga y descargador SSL frente al AppServer que ejecuta Oxalis.
Esto podría ser un software gratuito/abierto como Nginx y Apache o software comercial como Netscaler y Bigip.
Todo este software front -end debería poder hacer cumplir la seguridad como el sugerido a continuación.
Url | Función | Transporte | Seguridad |
---|---|---|---|
oxalis/as2 | Punto final del protocolo AS2 | HTTPS con certificados adecuados | Habilitar el acceso entrante desde Internet |
oxalis/estado | Información de estado, para uso interno y depuración | Http/https | El acceso a Internet se puede bloquear |
oxalis/estadísticas | Estadísticas en bruto para DIFI | HTTPS con certificados adecuados | Utilizado por DIFI para recopilar estadísticas |