Oxalisは、OpenPeppol Edelivery Access Point(AS4)仕様の主要なオープンソースソフトウェア実装です。このリポジトリはもともとSteinar Overbeck Cook(SendRegning)によって開発され、後に2020年3月までノルウェーの公共管理省庁(DIFI)が世話をしました。
2020年11月から、OxalisはNorstella Oxalisコミュニティによって維持されています。
Oxalis Communityは、ユーザーのペッポールコンプライアンスと価値を確保するために、オキサリの継続的なサポートと開発に専念するノルウェーに拠点を置くノルウェー財団の下で組織された非営利組織です。
シュカリスのコミュニティは、ノルステラ財団によって促進されています。それは、民主的な非営利の原則に従って組織されており、独立した予算とのノルステラ協会の独立した自律的な部分として設立されています。
オキサリのコミュニティの目標:
oxalisは、完全なスタンドアロンペッポールソリューションとして、または独自のコードのAPIコンポーネントとして使用できます。スタンドアロンコンポーネント( oxalis-standalone
)には、メッセージを送信するための基本的なコマンドラインツールが付属しています。箱から出してファイルシステムへのインバウンドメッセージを持続します。永続性はモジュール化されているため、メッセージキュー、ワークフローエンジン、ドキュメントアーカイブなどにインバウンドメッセージを送信する必要がある場合は、独自の実装を提供できます。
バイナリ分布は、Maven CentralとGithubの両方で利用できます。
Java 11は、Socalis 6.0.0以降で最小限のサポートされているJavaバージョンです。詳細なドキュメントについては、main.adocを参照してください
最新のテクニカルニュースは、https://www.oxalis.network/technical-informationで入手できます
私たちは、シュウラスや関連するGITリポジトリに貢献できる貢献者を積極的に探しています。既存の問題を選択して問題の修正を開始するか、新しい機能を追加することができます。新しいプルリクエストの生成中に、プルリクエストチェックリストを参照してください。チームは、希望する目標を達成し、標準とガイドラインに従って、マスターに合併する場合、コードをレビューします。
成分 | タイプ | 説明 |
---|---|---|
シュカリスインバウンド | 戦争 | Tomcatで実行されるインバウンドアクセスポイント実装(1) |
シュオリスアウトバウンド | 瓶 | Peppolビジネスドキュメントを送信するためのアウトバウンドコンポーネント(2) |
シュカリス・スタンダロン | 主要 | Peppolビジネスドキュメントを送信するためのコマンドラインアプリケーション(3) |
(1)AS2プロトコルを使用してメッセージを受信し、デフォルトとしてファイルシステムに保存します。
(2)Peppolドキュメントを送信する必要があるシステムに組み込むことができます。
(3)Oxalis-Outboundコンポーネントを使用してビジネスドキュメントを送信する方法に関する例コードとして提供します。
OXALIS_HOME
ディレクトリを作成し、ファイルoxalis.conf
編集しますOXALIS_HOME
環境変数を追加して、そのディレクトリを参照してくださいoxalis-distribution
をダウンロードします。oxalis.war
Tomcat webapps
ディレクトリに展開しますexample.sh
好みに変更して実行します。Sending failed ... Received fatal alert: handshake_failure
oxalisがリモートサーバーとのHTTPS接続を確立できない場合に発生します。通常、宛先アクセスポイントにHTTPSサーバーが「パッチをかけた」ためです。 Oxalis v3.1.0にはこれの修正が含まれているため、アップグレードする必要があります。詳細については、#197を参照してください。
Provider net.sf.saxon.TransformerFactoryImpl not found
xslt実装である可能性がありますsocalisとvefa valibatorの間の概要。 VEFAはXSLT 2.0を必要とし、JVMのトランスエンジンとしてSaxon 9を明示的に設定します。 Saxon 9は使用されておらず、Oxalisに含まれていないため、Oxalis側のそのエラーになります。エラーを取り除くには、別々のTomcats/JVMプロセスでOxalisとVEFAを実行してください。
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
ルートディレクトリの実行: mvn clean install -Pdist
oxalis-dist/oxalis-distribution/target/oxalis-distribution-<version.number>-distro/
で組み立てられたアーティファクトを見つけますデフォルトでは、Oxalisは以下の表にリストされているWebアドレスを公開します。
この表は、それらの使用について説明し、それらのアドレスを保護する方法に関するいくつかのヒントを示します。
かなり標準的なシナリオは、Oxalisを実行しているAppServerの前で、ある種のロードバランサーとSSLオフローダーを使用することです。
これは、NginxやApacheなどの無料/オープンソフトウェア、またはNetscalerやBigIPなどの商用ソフトウェアです。
このようなフロントエンドソフトウェアはすべて、以下に提案するようなセキュリティを実施できるはずです。
URL | 関数 | 輸送 | 安全 |
---|---|---|---|
oxalis/as2 | AS2プロトコルエンドポイント | 適切な証明書を持つHTTPS | インターネットからのインバウンドアクセスを有効にします |
シュカリス/ステータス | ステータス情報、内部使用およびデバッグのための | http/https | インターネットアクセスをブロックできます |
シュカリス/統計 | Difiの生の統計 | 適切な証明書を持つHTTPS | DIFIが統計を収集するために使用します |