Holodeck B2B is a standalone system-to-system messaging solution that supports the OASIS ebMS3 Messaging and the AS4 Profile Standards. Being Java based, it will run on most platforms.
It is designed with extensibility in mind providing an interface layer (see the interfaces project) which you can use to add or replace default implemented functionality.
For more information on using Holodeck B2B visit the website at https://holodeck-b2b.org
Lead developer: Sander Fieten
Code hosted at https://github.com/holodeck-b2b/Holodeck-B2B
Issue tracker https://github.com/holodeck-b2b/Holodeck-B2B/issues
The only requirement to run Holodeck B2B is that you have installed a Java run-time environment version 11 and that the JAVA_HOME environment variable is set to the path where the JRE is installed.
If you have multiple Java run-times installed on your system, it is recommended to set the JAVA_HOME variable inside the Holodeck B2B start script (setenv.sh on Linux/MacOS or startServer.bat on Windows).
To help you execute your first message exchange using Holodeck B2B, you will find a step-by-step guide to setting up Holodeck B2B on the project website.
We are using the simplified Github workflow to accept modifications which means you should:
- create an issue related to the problem you want to fix or the function you want to add (good for traceability and cross-reference)
- fork the repository
- create a branch (optionally with the reference to the issue in the name)
- write your code, including comments
- commit incrementally with readable and detailed commit messages
- run tests to check everything works on runtime
- update the changelog with a short description of the changes including a reference to the issues fixed
- submit a pull request against the
nextbranch of this repository
If your contribution is more than a patch, please contact us beforehand to discuss which branch you can best submit the pull request to.
You can report issues directly on the project Issue Tracker. Please document the steps to reproduce your problem in as much detail as you can (if needed and possible include screenshots).
Version numbering follows the Semantic versioning approach.
The Holodeck B2B Core components and default implementations are licensed under the General Public License V3 (GPLv3). This means you are not allowed to include the provided Holodeck B2B components in a closed source application. You can however use the Holodeck B2B application together with your closed source application as long as you only use the provided file based integration method or interfaces (API's) to create your own integration to communicate with the Holodeck B2B core. For this purpose, the interfaces project is licensed under the Lesser General Public License V3 (LGPLv3).`
To implement the cryptographic algorithms Holodeck B2B uses the Bouncy Castle library provided by The Legion of the Bouncy Castle Inc., see the bc_license.txt file.
Commercial Holodeck B2B support is provided by Chasquis. Visit Chasquis-consulting.com for more information.