| ... | @@ -16,13 +16,13 @@ Throughout this process, you will: |
... | @@ -16,13 +16,13 @@ Throughout this process, you will: |
|
|
## Variables
|
|
## Variables
|
|
|
The instructions in these guidelines use variables that must be replaced with the appropriate values in your context:
|
|
The instructions in these guidelines use variables that must be replaced with the appropriate values in your context:
|
|
|
|
|
|
|
|
**`{DOMIBUS_SERVER_DIRECTORY}`**: This signifies the directory on your server where Domibus will be installed.
|
|
- **`{DOMIBUS_SERVER_DIRECTORY}`**: This signifies the directory on your server where Domibus will be installed.
|
|
|
**`{DOMIBUS_HOSTNAME}`**: Denotes the public IP address of the server where you intend to install Domibus.
|
|
- **`{DOMIBUS_HOSTNAME}`**: Denotes the public IP address of the server where you intend to install Domibus.
|
|
|
**`{DOMIBUS_PORT}`**: Represents the internet-accessible port that you will open for Domibus.
|
|
- **`{DOMIBUS_PORT}`**: Represents the internet-accessible port that you will open for Domibus.
|
|
|
**`{DOMIBUS_ACCESS_POINT}`**: This is the designated name for your Domibus instance. Choose a clear and descriptive name, such as `france_ap`.
|
|
- **`{DOMIBUS_ACCESS_POINT}`**: This is the designated name for your Domibus instance. Choose a clear and descriptive name, such as `france_ap`.
|
|
|
**`{KEYSTORE_PASSWORD}`**: Refers to the password for your Java KeyStore.
|
|
- **`{KEYSTORE_PASSWORD}`**: Refers to the password for your Java KeyStore.
|
|
|
**`{PRIVATE_KEY_PASSWORD}`**: Refers to the password for the private key within your Java KeyStore.
|
|
- **`{PRIVATE_KEY_PASSWORD}`**: Refers to the password for the private key within your Java KeyStore.
|
|
|
**`{TRUSTORE_PASSWORD}`**: Refers to the password for your Java TrustStore.
|
|
- **`{TRUSTORE_PASSWORD}`**: Refers to the password for your Java TrustStore.
|
|
|
|
|
|
|
|
## Requirement:
|
|
## Requirement:
|
|
|
Before proceeding with the above steps, ensure that your environment meets the following prerequisites:
|
|
Before proceeding with the above steps, ensure that your environment meets the following prerequisites:
|
| ... | @@ -185,9 +185,8 @@ domibus.auth.unsecureLoginAllowed=false |
... | @@ -185,9 +185,8 @@ domibus.auth.unsecureLoginAllowed=false |
|
|
> **Note**:
|
|
> **Note**:
|
|
|
While you might consider creating a `PKCS12` KeyStore, please be aware that it currently appears to be non-functional.
|
|
While you might consider creating a `PKCS12` KeyStore, please be aware that it currently appears to be non-functional.
|
|
|
|
|
|
|
|
## 4 - Domibus Console
|
|
## 4 - Users Credentials
|
|
|
Within the directory or any of its subdirectories of the **`{DOMIBUS_SERVER_DIRECTORY}`**
|
|
Within the directory or any of its subdirectories of the **`{DOMIBUS_SERVER_DIRECTORY}`**, restart your Domibus server by doing the command:
|
|
|
Restart your Domibus server by doing the command:
|
|
|
|
|
```shell
|
|
```shell
|
|
|
docker compose restart
|
|
docker compose restart
|
|
|
```
|
|
```
|
| ... | @@ -195,8 +194,7 @@ From your browser, access to your Domibus server with the following URL: |
... | @@ -195,8 +194,7 @@ From your browser, access to your Domibus server with the following URL: |
|
|
```http
|
|
```http
|
|
|
http://{DOMIBUS_HOSTNAME}:{DOMIBUS_PORT}/domibus
|
|
http://{DOMIBUS_HOSTNAME}:{DOMIBUS_PORT}/domibus
|
|
|
```
|
|
```
|
|
|
### A - Users Credentials
|
|
### A - Dashboard Users
|
|
|
#### - Dashboard Users
|
|
|
|
|
Access the Domibus Admin Console using the default credentials:
|
|
Access the Domibus Admin Console using the default credentials:
|
|
|
```
|
|
```
|
|
|
Username: admin
|
|
Username: admin
|
| ... | @@ -208,8 +206,9 @@ You have the option to change this password at the top right of the console. |
... | @@ -208,8 +206,9 @@ You have the option to change this password at the top right of the console. |
|
|
|
|
|
|
|
Alternatively, user management can be performed in the `Users` section of the left navigation bar.
|
|
Alternatively, user management can be performed in the `Users` section of the left navigation bar.
|
|
|
|
|
|
|
|
#### - Plugin Users
|
|
### B - Plugin Users
|
|
|
A plugin user, specifically utilized for eDelivery message exchange through our Connector API, can be added in the `Plugin Users` section. To do so, navigate to this section, click on `+ New`, and provide the desired username, password, and role.
|
|
A plugin user, specifically utilized for eDelivery message exchange through our Connector API, can be added in the `Plugin Users` section. To do so, navigate to this section, click on `+ New`, and provide the desired username, password, and role.
|
|
|
|
|
|
|
Make sure that you save your modification.
|
|
Make sure that you save your modification.
|
|
|
|
|
|
|
|
> **Example**:
|
|
> **Example**:
|
| ... | @@ -217,16 +216,20 @@ For the French-Connector, you might create a user named `frc_user`. |
... | @@ -217,16 +216,20 @@ For the French-Connector, you might create a user named `frc_user`. |
|
|
|
|
|
|
|

|
|

|
|
|
|
|
|
|
|
### B - Processing Modes
|
|
## 5 - Processing Modes
|
|
|
Processing Modes _PModes_ are used to configure Access Points. The PMode parameters are loaded into the Access Point via an XML file.
|
|
Processing Modes _PModes_ are used to configure Access Points. The PMode parameters are loaded into the Access Point via an XML file.
|
|
|
Begin by downloading the PMode template file [pmode.xml](uploads/domibus/pmode-2023-11-24.xml) and replacing the variables with the appropriate placeholder values. Upload the modified file under:
|
|
Begin by downloading the PMode template file [pmode.xml](uploads/domibus/pmode-2023-11-24.xml) and replacing the variables with the appropriate placeholder values. Upload the modified file under:
|
|
|
`PMode` → `Current`
|
|
|
|
|
|
**`PMode` → `Current`**
|
|
|
|
|
|
|
Ensure that you save your modifications.
|
|
Ensure that you save your modifications.
|
|
|
|
|
|
|
|
Similar to sharing our certificate with the EU Access Point previously, we also need to import the EU Access Point certificate to grant them exchange authorization. To achieve this, follow these steps for each Access Point you wish to authorize.
|
|
Similar to sharing our certificate with the EU Access Point previously, we also need to import the EU Access Point certificate to grant them exchange authorization. To achieve this, follow these steps for each Access Point you wish to authorize.
|
|
|
|
|
|
|
|
Navigate to:
|
|
Navigate to:
|
|
|
`PMode` → `Party`
|
|
|
|
|
|
**`PMode` → `Party`**
|
|
|
|
|
|
|
Click on `+ New`
|
|
Click on `+ New`
|
|
|
|
|
|
|
|
Create a name such as `europe_ap` and set the endpoint with the `/domibus/services/msh` path.
|
|
Create a name such as `europe_ap` and set the endpoint with the `/domibus/services/msh` path.
|
| ... | |
... | |
| ... | | ... | |