O Oxalis é a principal implementação de software de código aberto das especificações do OpenPeppol Edelivery Access Point (AS4). Este repositório foi originalmente desenvolvido por Steinar Overbeck Cook (Sendregning) e mais tarde tratado pela Agência Norueguesa de Gestão Pública e EGOVERNAMENTO (DIFI) até março de 2020.
A partir de novembro de 2020, o Oxalis está sendo mantido pela comunidade Norstella Oxalis.
A Oxalis Community é uma organização sem fins lucrativos organizada pela Fundação Norstella, com sede na Noruega, dedicada ao apoio e desenvolvimento contínuos da Oxalis, para garantir a conformidade e o valor da Peppol para seus usuários.
A comunidade Oxalis é facilitada pela fundação Norstella. É organizado de acordo com os princípios democratas sem fins lucrativos e estabelecido como uma parte independente e autônoma da Associação Norstella com orçamentos independentes.
Os objetivos da comunidade Oxalis:
O oxalis pode ser usado como uma solução completa de peppol independente ou como um componente API do seu próprio código. O componente independente ( oxalis-standalone
) vem com uma ferramenta básica de linha de comando para enviar mensagens. Ele persiste as mensagens de entrada no sistema de arquivos pronta para uso. A persistência foi modularizada para que você possa fornecer sua própria implementação se precisar enviar mensagens de entrada para uma fila de mensagens, um mecanismo de fluxo de trabalho, um arquivo de documentos ou outros.
As distribuições binárias estão disponíveis no Maven Central e no Github.
O Java 11 é a versão Java mínima suportada desde o Oxalis 6.0.0. Para documentação detalhada, consulte: main.adoc
As últimas notícias técnicas estão disponíveis em: https://www.oxalis.network/technical-information
Estamos procurando ativamente contribuidores que possam contribuir com o Oxalis e os repositórios Git associados. Você pode começar a corrigir problemas selecionando qualquer problema existente ou pode adicionar um novo recurso. Consulte a lista de verificação de solicitação de puxar ao gerar uma nova solicitação de puxar. A equipe analisará seu código, se atingir a meta desejada e estará de acordo com os padrões e diretrizes, será fundido para dominar.
Componente | Tipo | Descrição |
---|---|---|
Oxalis-Inbound | guerra | Implementação de pontos de acesso de entrada que é executada no tomcat (1) |
Oxalis Outbound | jarra | Componente de saída para enviar documentos comerciais da Peppol (2) |
Oxalis-Standalona | principal | Aplicação da linha de comando para enviar documentos comerciais da Peppol (3) |
(1) recebe mensagens usando o protocolo AS2 e as armazena no sistema de arquivos como padrão.
(2) pode ser incorporado a qualquer sistema que precise enviar documentos PEPPOL.
(3) Serve como código de exemplo sobre como enviar documentos comerciais usando o componente Oxalis Outbound.
OXALIS_HOME
e edite o arquivo oxalis.conf
OXALIS_HOME
para fazer referência a esse diretóriooxalis-distribution
.oxalis.war
no seu diretório webapps
Tomcatexample.sh
ao seu gosto e execute -o. Sending failed ... Received fatal alert: handshake_failure
acontece quando o Oxalis não pode estabelecer a conexão HTTPS com o servidor remoto. Geralmente porque o Destination AccessPoint tem "Poodle Patched" seu servidor HTTPS. Oxalis v3.1.0 contém correções para isso, então você precisa atualizar. Veja o #197 para mais informações.
Provider net.sf.saxon.TransformerFactoryImpl not found
pode ser um conflito de implementação do XSLT entre oxalis e o Validador Vefa. O VEFA precisa do XSLT 2.0 e definir explicitamente Saxon 9 como o mecanismo de transformador na JVM. Como o Saxon 9 não é usado e incluído no oxalis, você acabará com esse erro no lado oxalis. Para se livrar do erro, certifique -se de executar o Oxalis e o VEFA em processos separados de Tomcats/JVM.
ValidatorException: PKIX path building failed
é provavelmente porque o certificado SSL dos receptores não contém a cadeia de certificação correta. A implementação do AS2 precisa validar a cadeia de certificados SSL e qualquer certificado intermediário precisa estar presente. Veja o #173 para mais informações.
Internal error occured: null
Quando o recebimento pode ser devido a um bug em algumas versões do Apache Tomcat. A mensagem de erro completa registrada é ERROR [network.oxalis.as2.inbound.As2Servlet] [] Internal error occured: null
seguido de um rastreamento de pilha com java.lang.NullPointerException: null
. Para resolver este Tomcat de atualização para uma versão mais recente, dê uma olhada no #179 para obter mais detalhes.
Observe que a revisão do Oxalis "Head" no Master Branch é frequentemente em "Flux" e deve ser considerada uma "construção noturna". Os lançamentos oficiais são marcados e podem ser baixados clicando em tags.
oxalis
Run: mvn clean install -Pdist
oxalis-dist/oxalis-distribution/target/oxalis-distribution-<version.number>-distro/
Por padrão, o oxalis publica os endereços da Web listados na tabela abaixo.
A tabela descreve seu uso e dá algumas dicas sobre como proteger esses endereços.
Um cenário bastante padrão é usar algum tipo de balanceador de carga e descarregador SSL em frente ao AppServer em execução Oxalis.
Isso pode ser um software gratuito/aberto, como NGINX e Apache ou software comercial, como NetScaler e Bigip.
Todo esse software de front -end deve ser capaz de aplicar a segurança como a sugerida abaixo.
Url | Função | Transporte | Segurança |
---|---|---|---|
Oxalis/AS2 | Endpoint de protocolo AS2 | HTTPS com certificados adequados | Ativar acesso de entrada da Internet |
oxalis/status | Informações de status, para uso interno e depuração | Http/https | O acesso à Internet pode ser bloqueado |
oxalis/estatística | Estatísticas brutas para difi | HTTPS com certificados adequados | Usado pela DIFI para coletar estatísticas |