Oxalis adalah implementasi perangkat lunak open-source terkemuka dari spesifikasi akses OpenPeppol Edelivery Access (AS4). Repositori ini pada awalnya dikembangkan oleh Steinar Overbeck Cook (Sendperning) dan kemudian dijaga oleh Badan Norwegia untuk Manajemen Publik dan Egovernment (DIFI) hingga Maret 2020.
Mulai November 2020, Oxalis sedang dipertahankan oleh komunitas Norstella Oxalis.
Oxalis Community adalah organisasi nirlaba yang diselenggarakan di bawah Norstella Foundation yang berbasis di Norwegia, yang didedikasikan untuk dukungan dan pengembangan Oxalis yang berkelanjutan, untuk mengamankan kepatuhan dan nilai peppol bagi penggunanya.
Komunitas Oxalis difasilitasi oleh yayasan Norstella. Ini diselenggarakan sesuai dengan prinsip-prinsip nirlaba yang demokratis dan ditetapkan sebagai bagian independen dan otonom dari Asosiasi Norstella dengan anggaran independen.
Tujuan Komunitas Oxalis:
Oxalis dapat digunakan sebagai solusi peppol mandiri lengkap atau sebagai komponen API dari kode Anda sendiri. Komponen mandiri ( oxalis-standalone
) dilengkapi dengan alat baris perintah dasar untuk mengirim pesan. Itu tetap ada pesan masuk ke sistem file di luar kotak. Kegigihan telah dimodulasi sehingga Anda dapat memberikan implementasi Anda sendiri jika Anda perlu mengirim pesan masuk ke antrian pesan, mesin alur kerja, arsip dokumen atau orang lain.
Distribusi biner tersedia di Maven Central dan GitHub.
Java 11 adalah versi Java yang didukung minimum sejak Oxalis 6.0.0. Untuk dokumentasi terperinci, rujuk: main.adoc
Berita teknis terbaru tersedia di: https://www.oxalis.network/technical-information
Kami secara aktif mencari kontributor yang dapat berkontribusi pada oxalis dan repositori git terkait. Anda dapat mulai memperbaiki masalah dengan memilih masalah yang ada atau Anda dapat menambahkan fitur baru. Silakan merujuk daftar periksa permintaan tarik saat menghasilkan permintaan tarik baru. Tim akan meninjau kode Anda, jika akan memenuhi tujuan yang diinginkan, dan akan sesuai dengan standar dan pedoman maka itu akan digabung untuk dikuasai.
Komponen | Jenis | Keterangan |
---|---|---|
oxalis-in-bound | perang | Implementasi titik akses masuk yang berjalan di Tomcat (1) |
Oxalis Outlound | stoples | Komponen Outbound untuk Mengirim Dokumen Bisnis Peppol (2) |
oxalis-standalone | utama | Aplikasi baris perintah untuk mengirim dokumen bisnis peppol (3) |
(1) Menerima pesan menggunakan protokol AS2 dan menyimpannya di sistem file sebagai default.
(2) dapat dimasukkan ke dalam sistem apa pun yang perlu mengirim dokumen Peppol.
(3) berfungsi sebagai contoh kode tentang cara mengirim dokumen bisnis menggunakan komponen Outbound Oxalis.
OXALIS_HOME
dan edit file oxalis.conf
OXALIS_HOME
ke referensi direktori ituoxalis-distribution
.oxalis.war
ke direktori Tomcat webapps
Andaexample.sh
sesuai keinginan Anda dan jalankan. Sending failed ... Received fatal alert: handshake_failure
terjadi ketika oxalis tidak dapat membuat koneksi https dengan server jarak jauh. Biasanya karena Destination AccessPoint memiliki "pudel yang ditambal" server https mereka. Oxalis v3.1.0 berisi perbaikan untuk ini, jadi Anda perlu meningkatkan. Lihat #197 untuk info lebih lanjut.
Provider net.sf.saxon.TransformerFactoryImpl not found
mungkin merupakan pertemuan implementasi XSLT antara Oxalis dan validator VEFA. VEFA membutuhkan XSLT 2.0 dan secara eksplisit mengatur Saxon 9 sebagai mesin transformator ke JVM. Karena Saxon 9 tidak digunakan dan disertakan dengan oxalis Anda akan berakhir dengan kesalahan itu di sisi oxalis. Untuk menyingkirkan kesalahan, pastikan Anda menjalankan Oxalis dan VEFA dalam proses Tomcats/JVM yang terpisah.
ValidatorException: PKIX path building failed
mungkin karena penerima sertifikat SSL tidak mengandung rantai sertifikat yang benar. Implementasi AS2 perlu memvalidasi rantai sertifikat SSL dan setiap sertifikat menengah harus ada. Lihat #173 untuk info lebih lanjut.
Internal error occured: null
saat menerima mungkin karena bug di beberapa versi Apache Tomcat. Pesan kesalahan penuh dicatat adalah ERROR [network.oxalis.as2.inbound.As2Servlet] [] Internal error occured: null
diikuti oleh jejak tumpukan dengan java.lang.NullPointerException: null
. Untuk menyelesaikan Upgrade Tomcat ini ke versi yang lebih baru, lihat #179 untuk detail lebih lanjut.
Perhatikan bahwa revisi "kepala" oxalis pada cabang master sering dalam "fluks" dan harus dianggap sebagai "bangunan malam". Rilis resmi ditandai dan dapat diunduh dengan mengklik tag.
oxalis
Root Directory Run: mvn clean install -Pdist
oxalis-dist/oxalis-distribution/target/oxalis-distribution-<version.number>-distro/
Secara default oxalis mempublikasikan alamat web yang tercantum dalam tabel di bawah ini.
Tabel menggambarkan penggunaannya dan memberikan beberapa petunjuk tentang cara mengamankan alamat -alamat itu.
Skenario standar yang cukup adalah menggunakan semacam penyeimbang beban dan Offloader SSL di depan AppServer yang menjalankan Oxalis.
Ini bisa berupa perangkat lunak gratis/terbuka seperti NginX dan Apache atau perangkat lunak komersial seperti Netscaler dan BigIP.
Semua perangkat lunak ujung depan tersebut harus dapat menegakkan keamanan seperti yang disarankan di bawah ini.
Url | Fungsi | Mengangkut | Keamanan |
---|---|---|---|
Oxalis/AS2 | Titik akhir protokol AS2 | Https dengan sertifikat yang tepat | Aktifkan akses masuk dari internet |
Oxalis/Status | Informasi status, untuk penggunaan dan debugging internal | Http/https | Akses internet dapat diblokir |
Oxalis/Statistik | Statistik mentah untuk DIFI | Https dengan sertifikat yang tepat | Digunakan oleh DIFI untuk mengumpulkan statistik |