On the first pages you can set the default settings for all newly created BPMN diagrams. Still, you are able to change these setting for each diagram via the diagram configuration afterwards without affecting other macros.

For more information about diagram Settings, see in this manual in Configuration.

Under the Space Permissions Tab, you have the option to restrict the use of BPMN Modeler Enterprise to certain spaces. This way, the creation and editing of BPMN diagrams is only permitted in the whitelisted Confluence spaces.

The Process Net macro uses a central database to manage all diagram links. In case of any incorrect behavior, or if you simply want to refresh and reimport all you diagram links, this can be done in the admin app configuration of the BPMN Modeler Enterprise.

Reset

The reflection of all links in the database will be deleted. This leaves a clean and empty database to be filled again.

This does not affect the links in the diagrams! All models will remain untouched.

Synchronize

All currently present diagram links in all models in your entire Confluence instance will be saved to the database.

Depending on the number of diagrams, this can take some time.

This does not affect the links in the diagrams! All models will remain untouched.

To enable users of the BPMN Modeler Enterprise to import diagrams from GitLab and push diagrams to GitLab, you need to establish a connection between the Add-On and GitLab. This involves setting up an OAuth2 connection between the two systems. To do so, follow these steps:

1. Create an OAuth2 App in GitLab:

   • Log in to GitLab as an administrator.

   • Go to Settings > Access > Applications

   • Select “Add new Application”, give it a name, and use the redirect URI provided in the BPMN Modeler Enterprise Add-Ons's App Configuration. Add the scope api to leverage the GitLab connection fully.

   • Store the OAuth app's secret securely

   For more detailed guidance, refer to the GitLab OAuth App Documentation.

2. Configure the Connection in Confluence:

   • If you are using a Confluence SERVER | DATA CENTER instance, you must provide the following environment variables containing Base64-encoded 32-byte encryption keys to store your configuration securely:

     • GITLAB_OAUTH_CID_KEY

     • GITLAB_OAUTH_CSC_KEY

     • GITLAB_OAUTH_AT_KEY

   • You can find instructions on generating your encryption keys here.

   • Enter your GitLab Base URL, application ID, and secret into the corresponding fields in Confluence and save them.

     • If GitLab is not self-hosted, the base URL will be https://gitlab.com

   • Click on Test Connection. This will open GitLab in a new browser tab, prompting you to sign in. Then, the OAuth app will ask you to authorize access to repositories.

   • After granting authorization, you should see a success message. If there is an issue, you will receive feedback on what went wrong.

To enable users of the BPMN Modeler Enterprise to import diagrams from GitHub and push diagrams to GitHub, you need to establish a connection between the Add-On and GitHub. This involves setting up an OAuth2 connection between the two systems. To do so, follow these steps:

1. Create an OAuth2 App in GitHub:

   • Log in to GitHub as an administrator.

   • Go to your Organization > Settings > Developer Settings > OAuth Apps

   • Select “New Org Oauth Application”, give it a name, and use the redirect URI provided in the BPMN Modeler Enterprise Add-Ons's App Configuration.

     • The Homepage URL is of no relevance.

   • Generate a new client secret and store it securely.

   For more detailed guidance, refer to the GitHub OAuth App Documentation

2. Configure the Connection in Confluence:

   • If you are using a Confluence SERVER | DATA CENTER instance, you must provide the following environment variables containing Base64-encoded 32-byte encryption keys to store your configuration securely:

     • GITHUB_OAUTH_CID_KEY

     • GITHUB_OAUTH_CSC_KEY

     • GITHUB_OAUTH_AT_KEY

   • You can find instructions on generating your encryption keys here.

   • Enter your application ID and secret into the corresponding fields in Confluence and save them.

   • Click on Test Connection. This will open GitHub in a new browser tab, prompting you to sign in. Then, the OAuth app will ask you to authorize access to repositories.

   • After granting authorization, you should see a success message. If there is an issue, you will receive feedback on what went wrong.

To generate encryption keys, there are several methods available, with OpenSSL being one of the simplest options. If you have OpenSSL installed, you can do this directly from your command line. Simply enter the following command, which will generate a random 32-byte key encoded in Base64.

• openssl rand -base64 32

Alternatively, you can also write your own script in programming languages such as Node.js, Java, or Python to achieve similar results. The generated keys can then be used to store your credentials securely in your database.