الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل

Oxalis Master Build

حامض

Oxalis هو تنفيذ البرمجيات المفتوحة المصدر الرائدة لمواصفات OpenPeppol Edelivery Access Point (AS4). تم تطوير هذا المستودع في الأصل بواسطة Steinar Overbeck Cook (sendregning) وبعد ذلك اعتنى به الوكالة النرويجية للإدارة العامة والعقار (DIFI) حتى مارس 2020.

ابتداءً من نوفمبر 2020 ، يتم الحفاظ على Oxalis بواسطة مجتمع Norstella Oxalis.

مجتمع أوكساليس

مجتمع Oxalis هي منظمة غير هادفة للربح تنظمها مؤسسة Norstella ومقرها في النرويج ، مكرسة لاستمرار الدعم والتطوير من Oxalis ، لتأمين امتثال Peppol وقيمتها لمستخدميها.

يتم تسهيل مجتمع Oxalis من قبل مؤسسة Norstella. يتم تنظيمه وفقًا للمبادئ الديمقراطية غير الهادفة للربح وأنشئت كجزء مستقل ومستقل من ارتباط نورستيلا بالميزانيات المستقلة.

أهداف مجتمع أوكساليس:

  • تأمين الاستدامة والتطوير المدارة لبرنامج Oxalis
  • تشجيع استمرار تنفيذ eProcurement باستخدام مواصفات Peppol.
  • دعم الخدمات المبتكرة المستندة إلى Peppol والتي تعزز هدف العمليات المنسقة والقابلة للتشغيل المتبادل.

يمكن استخدام Oxalis إما كحل مستقل كامل أو كمكون API من الكود الخاص بك. يأتي المكون المستقل ( oxalis-standalone ) مع أداة سطر الأوامر الأساسية لإرسال الرسائل. يستمر الرسائل الواردة إلى نظام الملفات خارج المربع. لقد تم تحديد الثبات حتى تتمكن من توفير تطبيقك الخاص إذا كنت بحاجة إلى إرسال رسائل inbound إلى قائمة انتظار الرسائل أو محرك سير العمل أو أرشيف المستندات أو غيرها.

التوزيعات الثنائية متوفرة في كل من Maven Central و Github.

أحدث إصدار هو Oxalis 6.xx

Java 11 هو الحد الأدنى لنسخة Java المدعومة منذ Oxalis 6.0.0. للحصول على وثائق مفصلة ، راجع: main.adoc

المعلومات الفنية

آخر الأخبار الفنية متوفرة على: https://www.oxalis.network/technical-

هل أنت مساهم؟

نحن نبحث بنشاط عن المساهمين الذين يمكنهم المساهمة في Oxalis ومستودعات GIT المرتبطة بها. يمكنك البدء في إصلاح المشكلات عن طريق تحديد أي مشكلة موجودة أو يمكنك إضافة ميزة جديدة. يرجى الرجوع إلى قائمة مراجعة طلب السحب أثناء إنشاء طلب سحب جديد. سيقوم الفريق بمراجعة الكود الخاص بك ، إذا كان سيحقق الهدف المطلوب ، وسيكون وفقًا للمعايير والإرشادات ، ثم سيتم دمجها لإتقانها.

مكونات Oxalis

عنصر يكتب وصف
Oxalis-Inbound حرب تطبيق نقطة الوصول الداخلي الذي يعمل على Tomcat (1)
Oxalis-Outbound جرة المكون الخارجي لإرسال مستندات Beppol Business (2)
أوكساليس تراندالون رئيسي تطبيق سطر الأوامر لإرسال مستندات Beapl Business (3)

(1) يتلقى الرسائل التي تستخدم بروتوكول AS2 وتخزينها في نظام الملفات الافتراضي.

(2) يمكن دمجها في أي نظام يحتاج إلى إرسال مستندات Peppol.

(3) بمثابة رمز مثال على كيفية إرسال مستندات عمل باستخدام مكون Oxalis-Obnound.

تثبيت

  • تأكد من تثبيت أحدث إصدار من Tomcat. انظر دليل التثبيت للحصول على تفاصيل إضافية.
  • تأكد من أن Tomcat قيد التشغيل وأن هذا المدير متاح مع مدير المستخدم/المدير
  • تأكد من أن 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 أو استبدالها ، راجع وثيقة KeyStore.
  • من المفترض أن يتم تمديد Oxalis بدلاً من تغيير رمز مصدر Oxalis.

استكشاف الأخطاء وإصلاحها

  • Sending failed ... Received fatal alert: handshake_failure يحدث عندما لا يمكن لـ Oxalis إنشاء اتصال HTTPS مع الخادم البعيد. عادةً لأن AccessPoint يحتوي على "Poodle المصححة" خادم HTTPS الخاص بهم. يحتوي Oxalis v3.1.0 على إصلاحات لهذا ، لذلك تحتاج إلى الترقية. انظر #197 لمزيد من المعلومات.

  • Provider net.sf.saxon.TransformerFactoryImpl not found قد يكون قد يكون كريق تنفيذ XSLT بين Oxalis و Vefa Deadator. يحتاج 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 على الفرع الرئيسي غالبًا ما تكون في "Flux" ويجب اعتبارها "بناء ليلي". يتم وضع علامة على الإصدارات الرسمية ويمكن تنزيلها بالنقر فوق العلامات.

  • تأكد من تثبيت Maven 3+
  • تأكد من تثبيت JDK 11 (الإصدار الذي اختبرناه)
  • اسحب نسخة الاهتمام من جيثب.
  • من دليل جذر oxalis : mvn clean install -Pdist
  • حدد موقع القطع الأثرية المجمعة في oxalis-dist/oxalis-distribution/target/oxalis-distribution-<version.number>-distro/

تأمين oxalis

بشكل افتراضي ، تنشر Oxalis عناوين الويب المدرجة في الجدول أدناه.
يصف الجدول استخدامه ويعطي بعض التلميحات حول كيفية تأمين تلك العناوين.
سيناريو قياسي إلى حد ما هو استخدام نوع من موازن التحميل و SSL Offloader أمام AppServer الذي يعمل على تشغيل Oxalis.
قد يكون هذا برنامجًا مجانيًا/مفتوحًا مثل Nginx و Apache أو برامج تجارية مثل NetScaler و Bigip.
يجب أن تكون كل هذه البرامج الأمامية قادرة على تطبيق الأمان مثل تلك المقترحة أدناه.

عنوان URL وظيفة ينقل حماية
Oxalis/AS2 نقطة نهاية بروتوكول AS2 HTTPS مع شهادات مناسبة تمكين الوصول الداخلي من الإنترنت
أوكساليس/الحالة معلومات الحالة ، للاستخدام الداخلي وتصحيح الأخطاء HTTP/HTTPS يمكن حظر الوصول إلى الإنترنت
Oxalis/الإحصاءات الإحصائيات الأولية لـ Difi HTTPS مع شهادات مناسبة تستخدمها DIFI لجمع الإحصاءات
يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل