oxalis

---

Oxalis

Oxalis ist die führende Open-Source-Software-Implementierung von OpenPeppol Edelivery Access Point (AS4) -Technik. Dieses Repository wurde ursprünglich von Steinar Overbeck Cook (SendRegning) entwickelt und später bis März 2020 von der norwegischen Agentur für öffentliches Management und EgoVernment (DIFI) betreut.

Ab November 2020 wird Oxalis von der Norstella Oxalis -Gemeinschaft aufrechterhalten.

Oxalis -Gemeinschaft

Die Oxalis-Community ist eine gemeinnützige Organisation, die unter Norstella Foundation mit Sitz in Norwegen organisiert ist und sich der fortgesetzten Unterstützung und Entwicklung von Oxalis widmet, um Peppol Compliance und Wert für ihre Benutzer zu sichern.

Die Oxalis -Gemeinschaft wird durch die Stiftung Norstella erleichtert. Es ist nach demokratischen, nicht gewinnorientierten Prinzipien organisiert und als unabhängiger und autonomer Bestandteil der Norstella-Verbindung mit unabhängigen Haushaltsbudgets etabliert.

Die Ziele der Oxalis -Gemeinschaft:

• Sichere Nachhaltigkeit und verwaltete Entwicklung der Oxalis -Software
• Förderung der fortgesetzten Implementierung der E -Procurement mithilfe von Peppolspezifikationen.
• Unterstützen Sie innovative Pfeffol-basierte Dienste, die das Ziel von harmonisierten und interoperablen Prozessen fördern.

Oxalis kann entweder als vollständige eigenständige Peppollösung oder als API -Komponente aus Ihrem eigenen Code verwendet werden. Die Standalone-Komponente ( oxalis-standalone ) verfügt über ein grundlegendes Befehlszeilen-Tool zum Senden von Nachrichten. Es bleibt eingehende Nachrichten an das Dateisystem weiterhin außerhalb der Box. Die Persistenz wurde modularisiert, sodass Sie Ihre eigene Implementierung bereitstellen können, wenn Sie eingebundene Nachrichten an eine Nachrichtenwarteschlange, eine Workflow -Engine, ein Dokumentarchiv oder andere senden müssen.

Binärverteilungen sind sowohl bei Maven Central als auch bei GitHub erhältlich.

Die neueste Version ist Oxalis 6.xx

Java 11 ist seit Oxalis 6.0.0 minimal unterstützte Java -Version. Für detaillierte Dokumentation siehe: main.adoc

Technische Informationen

Die neuesten technischen Nachrichten finden Sie unter: https://www.oxalis.network/technical-information

---

Machen Sie Mitwirkende?

Wir suchen aktiv nach Mitwirkenden, die zu Oxalis und zugehörigen Git -Repositorys beitragen können. Sie können mit der Auswahl eines vorhandenen Problems beginnen, oder haben Sie eine neue Funktion hinzufügen. Bitte beziehen Sie sich die Checkliste für Pull -Anfrage, während Sie eine neue Pull -Anfrage generieren. Das Team wird Ihren Code überprüfen, falls er das gewünschte Ziel erreicht und nach Standards und Richtlinien entspricht, wird er zu Master zusammengeführt.

---

Oxalis -Komponenten

Komponente	Typ	Beschreibung
Oxalis-inbound	Krieg	Implementierung der Inbound Access Point, die auf Tomcat ausgeführt wird (1)
Oxalis-Outbound	Krug	Ausgehende Komponente zum Senden von Peppol -Geschäftsdokumenten (2)
Oxalis-Standalone	hauptsächlich	Befehlszeilenantrag zum Senden von Peppol -Geschäftsdokumenten (3)

(1) Empfängt Nachrichten mit dem AS2 -Protokoll und speichert sie standardmäßig im Dateisystem.

(2) kann in jedes System integriert werden, das Peppol -Dokumente senden muss.

(3) dient als Beispielcode zum Senden von Geschäftsdokumenten mithilfe der Oxalis-Outbound-Komponente.

Installation

• Stellen Sie sicher, dass die neueste Version von Tomcat installiert ist. Weitere Informationen finden Sie unter Installationshandbuch.
• Stellen Sie sicher, dass Tomcat in Betrieb ist und dieser Manager mit User Manager/Manager verfügbar ist
• Stellen Sie sicher, dass Tomcat auch in Localhost: 443 auf SSL läuft (es sei denn, Sie beenden SSL vor Tomcat)
• Stellen Sie sicher, dass Ihr Keystore in einem bekannten Verzeichnis installiert ist (separate Anweisungen zum Bau des Keystore)
• Erstellen Sie ein OXALIS_HOME -Verzeichnis und bearbeiten Sie die Datei oxalis.conf
• Fügen Sie die Umgebungsvariable OXALIS_HOME hinzu, um auf das Verzeichnis zu referenzieren
• Bauen Sie Oxalis selbst (siehe unten) oder laden Sie die von Norstella bereitgestellten binären Artefakte von der Maven Central-Suche nach "Oxalis" herunter und laden Sie die neueste Version von oxalis-distribution herunter.
• Stellen Sie oxalis.war in Ihrem Tomcat webapps -Verzeichnis ein
• Senden Sie eine Beispielrechnung; Ändern Sie example.sh nach Ihrem Geschmack und führen Sie es aus.
• Weitere weitere Details finden Sie im Installationshandbuch.
• Um das Peppol -Zertifikat zu installieren oder zu ersetzen, finden Sie im Keystore -Dokument.
• Oxalis soll eher erweitert werden, als den Oxalis -Quellcode zu ändern.

Fehlerbehebung

• Sending failed ... Received fatal alert: handshake_failure tritt auf, wenn Oxalis die HTTPS -Verbindung mit dem Remote -Server nicht herstellen kann. Normalerweise, weil Destination AccessPoint den HTTPS -Server "Pudel gepatcht" hat. Oxalis v3.1.0 enthält hierfür Korrekturen, sodass Sie ein Upgrade durchführen müssen. Weitere Informationen finden Sie in der Nummer 197.

• Provider net.sf.saxon.TransformerFactoryImpl not found . VEFA benötigt XSLT 2.0 und setzt Saxon 9 explizit als Transformatormotor für die JVM. Da Saxon 9 nicht verwendet und in Oxalis enthalten ist, werden Sie diesen Fehler auf der Oxalis -Seite enden. Um den Fehler loszuwerden, stellen Sie sicher, dass Sie Oxalis und VEFA in separaten Tomcats/JVM -Prozessen ausführen.

• ValidatorException: PKIX path building failed ist wahrscheinlich darauf, dass das Empfänger -SSL -Zertifikat nicht die korrekte Zertifikatskette enthält. Die AS2 -Implementierung muss die SSL -Zertifikatskette validieren und alle Zwischenzertifikate müssen vorhanden sein. Weitere Informationen finden Sie in den #173.

• Internal error occured: null beim Empfangen kann auf einen Fehler in einigen Apache -Tomcat -Versionen zurückzuführen sein. Die vollständige Fehlermeldung protokolliert ist ERROR [network.oxalis.as2.inbound.As2Servlet] [] Internal error occured: null gefolgt von einer Stapelspur mit java.lang.NullPointerException: null . Um diesen Upgrade -Tomcat in eine neuere Version zu beheben, finden Sie einen Blick auf Nr. 179, um weitere Informationen zu erhalten.

Aus der Quelle bauen

Beachten Sie, dass die Oxalis "Kopf" -Verrevision am Master -Zweig häufig in "Flux" ist und als "nächtliche Build" angesehen werden sollte. Die offiziellen Veröffentlichungen werden markiert und können durch Klicken auf Tags heruntergeladen werden.

• Stellen Sie sicher, dass Maven 3+ installiert ist
• Stellen Sie sicher, dass JDK 11 installiert ist (die Version, mit der wir getestet haben)
• Ziehen Sie die Version von Interesse von Github.
• Aus oxalis Root Directory Lauf: mvn clean install -Pdist
• LOCATE AUSBALL ARSTIFAKTE IN oxalis-dist/oxalis-distribution/target/oxalis-distribution-<version.number>-distro/

Sicherung von Oxalis

Standardmäßig veröffentlichen Oxalis die in der folgenden Tabelle aufgeführten Webadressen.
Die Tabelle beschreibt ihre Verwendung und gibt einige Hinweise darauf, wie diese Adressen sichern können.
Ein ziemlich Standardszenario ist die Verwendung einer Art Lastausgleich und SSL -Offloader vor dem AppServer, der Oxalis ausführt.
Dies kann kostenlose/offene Software wie NGINX und Apache oder kommerzielle Software wie NetScaler und Bigip sein.
Alle diese Front -End -Software sollte in der Lage sein, die Sicherheit wie die unten vorgeschlagene Sicherheit durchzusetzen.

URL	Funktion	Transport	Sicherheit
Oxalis/As2	AS2 -Protokollendpunkt	HTTPs mit geeigneten Zertifikaten	Aktivieren Sie den Inbound -Zugriff aus dem Internet
Oxalis/Status	Statusinformationen für die interne Verwendung und Debuggierung	Http/https	Internetzugang kann blockiert werden
Oxalis/Statistik	Rohstatistiken für DIFI	HTTPs mit geeigneten Zertifikaten	Verwendet von DIFI, um Statistiken zu sammeln