Webtop Pecbridge component

[DavidePrincipi]

Webtop Pecbridge is a new integrated Webtop component that fetches and sends PEC (Posta Elettronica Certificata) messages. The component requires a license key to run. When the license is active, Webtop can use the component as mail gateway for both normal and PEC messages.

Proposed solution

• Add Pecbridge sources to Webapp image. Add Pecbridge service to Webtop ns8-webtop#59
• Run Pecbridge inside the Webapp container of Webtop application. Add Pecbridge service to Webtop ns8-webtop#59
• Make webtop.properties customizable. Extend webtop.properties with custom contents ns8-webtop#60
• Define an environment variable as substitute of webtop AdminMail prop of NS7. Add Pecbridge service to Webtop ns8-webtop#59
• Implement migration of AdminMail from NS7 to NS8. Add AdminMail to migration with default value nethserver-ns8-migration#85
• Modify AdminMail from NS8 cluster-admin UI. Add PEC bridge admin mail field to configuration ns8-webtop#73
• Update Webtop manual page with Pec Bridge information and the new UI field description. Add Webtop PEC Bridge section ns8-docs#115

Alternative solutions

• Run Pecbridge as a separate container

Additional context

Pecbridge is distributed in binary form and requires a license key to work.

See also

Discussion (PVT): https://mattermost.nethesis.it/nethesis/pl/d5ith8k84pgujm6p7uf856y4tc

---

Thanks to Sonicle and @lucagasparini

[nethbot]

in 7.9.2009/testing:

• nethserver-ns8-migration-1.0.16-1.2.gce2cc96.ns7.x86_64.rpm x86_64

[DavidePrincipi]

Acceptance checks

• After installation (or update) a new service is running: systemctl --user status pecbridge.service
• The webtop.properties file is expanded with new PEC Bridge properties.
• The webtop.properties file can be overridden as explained in the module README.
• The webtop-pecbridge/AdminMail NS7 prop is migrated to NS8 configuration.
• The PEC Bridge notify address can be modified from Webtop cluster-admin UI. Changes are applied.
• PEC Bridge Notifications are sent. Relax smtpd_sender_restrictions ns8-mail#136
• The PECBridge management interface is present in the WebTop admin interface, under Domains --> Nethserver --> PECBridge
• It is possible to buy a PB license, activate it in Webtop admin UI, and once activated, PB can be configured and it works.

[Amygos]

Testing release: 1.0.22-testing.2

[lucagasparini]

The webapp module fails to start with this error:

2024-09-24T07:11:18Z [1:webtop11:systemd] Starting WebTop webapp...
2024-09-24T07:11:18Z [1:webtop11:expandconfig-webapp] /home/webtop11/.config/scripts/expandconfig-webapp: line 24: AGENT_INSTALL_DIR: parameter null or not set
2024-09-24T07:11:18Z [1:webtop11:systemd] webapp.service: Control process exited, code=exited, status=1/FAILURE
2024-09-24T07:11:18Z [1:webtop11:systemd] webapp.service: Failed with result 'exit-code'.
2024-09-24T07:11:18Z [1:webtop11:systemd] Failed to start WebTop webapp.

[Amygos]

Testing release: 1.0.22-testing.3

[Amygos]

Repeat the above test cases

[lucagasparini]

Almost all acceptance checks have been successfully tested.

PEC Bridge Notifications are sent.

Only this one is still failing

Sep 25 08:58:45 rl2 pecbridge[1575176]: javax.mail.SendFailedException: Invalid Addresses
....
Sep 25 08:58:45 rl2 pecbridge[1575176]: Caused by: com.sun.mail.smtp.SMTPAddressFailedException: 504 5.5.2 <pecbridge-daemon>: Sender address rejected: need fully-qualified address

[DavidePrincipi]

The last test requires Mail 1.4.7
https://github.com/NethServer/ns8-mail/releases/tag/1.4.7

[nethbot]

in 7.9.2009/testing:

• nethserver-ns8-migration-1.0.16-1.5.gcf4bbf9.ns7.x86_64.rpm x86_64

[lucagasparini]

VERIFIED

[Amygos]

Before release wait for Issue #7033 to be verified.