oxalis

---

Oxalis

Oxalis เป็นซอฟต์แวร์โอเพ่นซอร์สชั้นนำของ OpenPeppol Edelivery Point Point (AS4) ที่เก็บนี้ได้รับการพัฒนาโดย Steinar Overbeck Cook (Sendregning) และต่อมาได้รับการดูแลโดยหน่วยงานนอร์เวย์เพื่อการจัดการสาธารณะและ Egovernment (DIFI) จนถึงเดือนมีนาคม 2563

เริ่มตั้งแต่เดือนพฤศจิกายน 2563 Oxalis จะได้รับการดูแลโดยชุมชน Norstella Oxalis

ชุมชน Oxalis

ชุมชน Oxalis เป็นองค์กรที่ไม่แสวงหาผลกำไรซึ่งจัดขึ้นภายใต้มูลนิธิ Norstella ซึ่งตั้งอยู่ในนอร์เวย์ซึ่งอุทิศตนเพื่อการสนับสนุนอย่างต่อเนื่องและการพัฒนาของ Oxalis เพื่อรักษาความปลอดภัยของ Peppol และคุณค่าสำหรับผู้ใช้

ชุมชน Oxalis ได้รับการอำนวยความสะดวกโดยมูลนิธิ Norstella มันถูกจัดระเบียบตามหลักการที่ไม่แสวงหาผลกำไรประชาธิปไตยและจัดตั้งขึ้นเป็นส่วนหนึ่งและเป็นอิสระของสมาคม Norstella ที่มีงบประมาณอิสระ

เป้าหมายของชุมชน Oxalis:

• ปลอดภัยการพัฒนาอย่างยั่งยืนและการพัฒนาซอฟต์แวร์ Oxalis
• ส่งเสริมการดำเนินการอย่างต่อเนื่องของ eProcurement โดยใช้ข้อกำหนด PEPPOL
• สนับสนุนบริการที่ใช้นวัตกรรมที่ใช้ Peppol ที่ส่งเสริมเป้าหมายของกระบวนการที่กลมกลืนและทำงานร่วมกัน

Oxalis สามารถใช้เป็นโซลูชัน peppol แบบสแตนด์อโลนที่สมบูรณ์หรือเป็นส่วนประกอบ API จากรหัสของคุณเอง ส่วนประกอบแบบสแตนด์อโลน ( oxalis-standalone ) มาพร้อมกับเครื่องมือบรรทัดคำสั่งพื้นฐานสำหรับการส่งข้อความ มันยังคงมีข้อความขาเข้าไปยังระบบไฟล์ออกจากกล่อง การคงอยู่ได้รับการแยกเป็นโมดูลเพื่อให้คุณสามารถให้การใช้งานของคุณเองหากคุณต้องการส่งข้อความขาเข้าไปยังคิวข้อความเอ็นจิ้นเวิร์กโฟลว์การเก็บเอกสารหรืออื่น ๆ

การแจกแจงแบบไบนารีมีให้ทั้งที่ Maven Central และ GitHub

เวอร์ชันล่าสุดคือ Oxalis 6.xx

Java 11 เป็นรุ่น Java ขั้นต่ำที่รองรับตั้งแต่ Oxalis 6.0.0 สำหรับเอกสารโดยละเอียดอ้างอิง: main.adoc

ข้อมูลทางเทคนิค

ข่าวเทคนิคล่าสุดมีอยู่ที่: https://www.oxalis.network/technical-information

---

คุณเป็นผู้สนับสนุน?

เรากำลังมองหาผู้มีส่วนร่วมที่สามารถมีส่วนร่วมกับ Oxalis และที่เก็บ GIT ที่เกี่ยวข้อง คุณสามารถเริ่มแก้ไขปัญหาได้โดยเลือกปัญหาที่มีอยู่หรือคุณสามารถเพิ่มคุณสมบัติใหม่ได้ โปรดดูรายการตรวจสอบคำขอดึงในขณะที่สร้างคำขอดึงใหม่ ทีมจะตรวจสอบรหัสของคุณหากจะบรรลุเป้าหมายที่ต้องการและจะเป็นไปตามมาตรฐานและแนวทางปฏิบัติจะถูกรวมเข้ากับมาสเตอร์

---

ส่วนประกอบออกซาลิส

ส่วนประกอบ	พิมพ์	คำอธิบาย
Oxalis-inbound	สงคราม	การใช้งานจุดเชื่อมต่อขาเข้าซึ่งทำงานบน Tomcat (1)
Oxalis-outbound	ไห	องค์ประกอบขาออกสำหรับการส่งเอกสารธุรกิจ Peppol (2)
อ็อกมาลิส	หลัก	แอปพลิเคชันบรรทัดคำสั่งสำหรับการส่งเอกสารธุรกิจ Peppol (3)

(1) รับข้อความโดยใช้โปรโตคอล AS2 และจัดเก็บไว้ในระบบไฟล์เป็นค่าเริ่มต้น

(2) สามารถรวมเข้ากับระบบใด ๆ ที่จำเป็นต้องส่งเอกสาร Peppol

(3) ทำหน้าที่เป็นรหัสตัวอย่างเกี่ยวกับวิธีการส่งเอกสารทางธุรกิจโดยใช้ส่วนประกอบ Oxalis-outbound

การติดตั้ง

• ตรวจสอบให้แน่ใจว่าติดตั้ง Tomcat เวอร์ชันล่าสุด ดูคู่มือการติดตั้งสำหรับรายละเอียดเพิ่มเติม
• ตรวจสอบให้แน่ใจว่า Tomcat เปิดใช้งานและผู้จัดการคนนั้นสามารถใช้งานกับ Manager/Manager ได้
• ตรวจสอบให้แน่ใจว่า Tomcat ยังทำงานบน SSL ที่ LocalHost: 443 (เว้นแต่คุณจะยุติ SSL ที่ด้านหน้าของ Tomcat)
• ตรวจสอบให้แน่ใจว่ามีการติดตั้งคีย์สโตร์ของคุณในไดเรกทอรีที่รู้จัก (คำแนะนำแยกต่างหากสำหรับการสร้างคีย์สโตร์)
• สร้างไดเรกทอรี OXALIS_HOME และแก้ไขไฟล์ oxalis.conf
• เพิ่มตัวแปรสภาพแวดล้อม OXALIS_HOME เพื่ออ้างอิงไดเร็กทอรีนั้น
• สร้าง Oxalis ด้วยตัวเอง (ดูด้านล่าง) หรือดาวน์โหลดสิ่งประดิษฐ์ไบนารีที่จัดทำโดย Norstella จาก Maven Central Search สำหรับ "Oxalis" และดาวน์โหลด oxalis-distribution เวอร์ชันล่าสุด
• ปรับใช้ oxalis.war ไปยังไดเรกทอรี Tomcat webapps ของคุณ
• ส่งใบแจ้งหนี้ตัวอย่าง แก้ไข example.sh ที่คุณชอบและดำเนินการ
• ดูคู่มือการติดตั้งสำหรับรายละเอียดเพิ่มเติม
• ในการติดตั้งหรือแทนที่ใบรับรอง Peppol ให้ดูเอกสารที่เก็บคีย์
• Oxalis หมายถึงการขยายมากกว่าการเปลี่ยนซอร์สโค้ด Oxalis

การแก้ไขปัญหา

• Sending failed ... Received fatal alert: handshake_failure เกิดขึ้นเมื่อ Oxalis ไม่สามารถสร้างการเชื่อมต่อ HTTPS กับเซิร์ฟเวอร์ระยะไกลได้ โดยปกติแล้วเนื่องจากจุดเชื่อมต่อปลายทางมี "พุดเดิ้ลแพทช์" เซิร์ฟเวอร์ HTTPS ของพวกเขา Oxalis v3.1.0 มีการแก้ไขสำหรับสิ่งนี้ดังนั้นคุณต้องอัพเกรด ดู #197 สำหรับข้อมูลเพิ่มเติม

• Provider net.sf.saxon.TransformerFactoryImpl not found อาจเป็น Conflice การใช้งาน XSLT ระหว่าง Oxalis และ Vefa Validator Vefa ต้องการ XSLT 2.0 และตั้งค่า Saxon 9 อย่างชัดเจนเป็นเอ็นจิ้นหม้อแปลงไปยัง JVM เนื่องจาก Saxon 9 ไม่ได้ใช้และรวมกับ Oxalis คุณจะต้องจบลงด้วยข้อผิดพลาดนั้นในด้าน Oxalis ในการกำจัดข้อผิดพลาดให้แน่ใจว่าคุณเรียกใช้ Oxalis และ Vefa ในกระบวนการ Tomcats/JVM แยกต่างหาก

• ValidatorException: PKIX path building failed อาจเป็นเพราะใบรับรองตัวรับสัญญาณ SSL ไม่มีห่วงโซ่ใบรับรองที่ถูกต้อง การใช้งาน AS2 จำเป็นต้องตรวจสอบความถูกต้องของห่วงโซ่ใบรับรอง SSL และใบรับรองระดับกลางใด ๆ จะต้องมีอยู่ ดู #173 สำหรับข้อมูลเพิ่มเติม

• Internal error occured: null เมื่อได้รับอาจเกิดจากข้อผิดพลาดในบางรุ่น Apache Tomcat ข้อความแสดงข้อผิดพลาดเต็มรูปแบบคือ ERROR [network.oxalis.as2.inbound.As2Servlet] [] Internal error occured: null ตามด้วยการติดตามสแต็กกับ java.lang.NullPointerException: null ในการแก้ไขการอัพเกรด Tomcat นี้เป็นเวอร์ชันใหม่ให้ดูที่ #179 สำหรับรายละเอียดเพิ่มเติม

สร้างจากแหล่งที่มา

โปรดทราบว่าการแก้ไข "หัว" ของ Oxalis ในสาขา หลัก มักจะอยู่ใน "ฟลักซ์" และควรได้รับการพิจารณาว่าเป็น "การสร้างยามค่ำคืน" การเผยแพร่อย่างเป็นทางการจะถูกแท็กและอาจดาวน์โหลดได้โดยคลิกที่แท็ก

• ตรวจสอบให้แน่ใจว่าติดตั้ง Maven 3+
• ตรวจสอบให้แน่ใจว่าติดตั้ง JDK 11 (เวอร์ชันที่เราทดสอบด้วย)
• ดึงเวอร์ชันที่น่าสนใจจาก GitHub
• จาก oxalis Root Directory Run: mvn clean install -Pdist
• ค้นหาสิ่งประดิษฐ์ที่ประกอบขึ้นใน oxalis-dist/oxalis-distribution/target/oxalis-distribution-<version.number>-distro/

การรักษาความปลอดภัยออกซาลิส

โดยค่าเริ่มต้น Oxalis เผยแพร่ที่อยู่เว็บที่แสดงในตารางด้านล่าง
ตารางอธิบายการใช้งานของพวกเขาและให้คำแนะนำเกี่ยวกับวิธีการรักษาความปลอดภัยที่อยู่เหล่านั้น
สถานการณ์มาตรฐานที่สวยงามคือการใช้โหลดบาลานซ์และ SSL Offloader บางชนิดต่อหน้า AppServer ที่ใช้ Oxalis
นี่อาจเป็นซอฟต์แวร์ฟรี/เปิดเช่น Nginx และ Apache หรือซอฟต์แวร์เชิงพาณิชย์เช่น NetScaler และ BigIP
ซอฟต์แวร์ส่วนหน้าทั้งหมดดังกล่าวควรจะสามารถบังคับใช้ความปลอดภัยได้เช่นเดียวกับที่แนะนำด้านล่าง

url	การทำงาน	ขนส่ง	ความปลอดภัย
oxalis/as2	จุดสิ้นสุดโปรโตคอล AS2	https พร้อมใบรับรองที่เหมาะสม	เปิดใช้งานการเข้าถึงขาเข้าจากอินเทอร์เน็ต
Oxalis/สถานะ	ข้อมูลสถานะสำหรับการใช้งานภายในและการดีบัก	http/https	การเข้าถึงอินเทอร์เน็ตสามารถบล็อกได้
Oxalis/สถิติ	สถิติดิบสำหรับ DIFI	https พร้อมใบรับรองที่เหมาะสม	ใช้โดย DIFI เพื่อรวบรวมสถิติ