Het veilig verzenden van e-mails vanuit integratiestromen kan een sleutelvereiste zijn in veel bedrijfs toepassingen of het nu gaat om meldingen, alerts of gegevens overdracht. In deze blog leer je hoe je e-mails kunt versturen vanuit WSO2 Micro Integrator 4.4.0 door e-mailfunctionaliteit te integreren met twee benaderingen: de Email Connector en de Transport Mail-functionaliteit.
- De Email Connector: een kant-en-klare functionaliteit van WSO2 die werkt met populaire e-mailproviders zoals Gmail, Outlook en SMTP-servers.
- De Transport Mail Feature: een ingebouwde mogelijkheid om e-mailverkeer te ondersteunen via Axis2-configuraties.
We laten je zien hoe je e-mail integreert in je workflows met de juiste SMTP-configuratie, zodat je een veilige e-mailomgeving opzet die voldoet aan moderne standaarden. Of je nu veilig e-mails wilt versturen vanuit je integratielaag of volledig geautomatiseerde processen wilt bouwen waarin e-mailintegratie is opgenomen, deze gids helpt je op weg.
Aan het einde van deze tutorial begrijp je de configuratiestappen, deploymethodes en best practices die nodig zijn om veilig e-mails te versturen met zowel de flexibele als de ingebouwde opties van WSO2 Micro Integrator.
Vereisten:
- VS Code met de WSO2 MI extensie
- JDK
- WSO2 Micro Integrator (MI) Runtime
Als deze niet op je lokale machine zijn geïnstalleerd, zal de Micro Integrator-extensie voor VS Code je tijdens het aanmaken van het project automatisch vragen om ze te downloaden en te configureren, afhankelijk van de runtimeversie van het project.
Klik op de link voor meer informatie over het gebruik van de WSO2 MI extensie in Visual Studio Code.
1. E-mails versturen middels de Email Connector
De Email Connector is een kant-en-klare connector die beschikbaar is in de Connector Store van WSO2. Deze connector neemt de complexiteit van transport en configuratie uit handen, waardoor je eenvoudig e-mailfunctionaliteit kunt integreren in je integratiestromen.
Configuratie:
- Eerst moet je een lokale entry aanmaken om de Email Connector te initialiseren met de benodigde parameters voor de verbinding met Outlook / Gmail via SMTP. Afhankelijk van je behoefte pas je de hostwaarde in de onderstaande configuratie aan.
De key “EMAIL_CONNECTION” maakt het mogelijk om dit item te benaderen binnen verschillende integratiecomponenten.
connectionType: Specificeert SMTPS (Secure SMTP) voor versleutelde e-mailoverdracht.
host: Omschrijft de SMTP server, in dit geval, Office 365 (smtp.office365.com).
port: Gebruikt port 587, welke de standaard is voor SMTP met TLS.
username: Geef de gebruikersnaam van het SMTP account op.
password: Geef het wachtwoord van het SMTP account op.
requireTLS: Indien juist, dan moet een geschikte trust store worden geconfigureerd zodat de client het certificaat van de server vertrouwt en zodat de verbinding TLS-encryptie gebruikt voor veilige communicatie.
enableOAuth2: Onjuist betekent dat OAuth2-authenticatie niet is ingeschakeld (dit resulteert in alleen inloggen middels gebruikersnaam en wachtwoord).
Let op:
– Als je wachtwoord speciale tekens bevat (bijvoorbeeld <, >, &), kunnen er fouten optreden bij het starten van de server. Om dit te
voorkomen, pas de wachtwoordparameter aan zodat speciale tekens correct worden verwerkt.
– Zorg ervoor dat “Minder veilige app-toegang” in je Gmail-account is ingeschakeld, of gebruik een App-wachtwoord als 2-
stapsverificatie. Deze instelling is noodzakelijk om SMTP met Gmail te laten werken.
– Het wordt aanbevolen om inloggegevens veilig op te slaan met behulp van omgevingsvariabelen of een veilige kluis, in plaats van ze
hard te coderen.
2. Vervolgens maken we een API die de geïnitialiseerde Email Connector gebruikt om een e-mail te versturen. Deze API luistert op het endpoint /sendEmail/send en verwacht een POST-request met een JSON-payload. In deze payload staan gegevens zoals het e-mailadres van de ontvanger, het onderwerp en de inhoud of body van de e-mail uit het verzoek.
Bovenstaand plaatje laat de overall project structuur in VS code zien
Bouwen en Implementeren
Gebruik een van de volgende twee opties om het project te bouwen en uit te voeren:
Optie 1 :
Klik bovenaan in VS Code op de Command Palette.
Typ > om de beschikbare commando’s te tonen.
Selecteer MI: Build and Run.
Optie 2 :
Klik op het pictogram Build and Run rechtsboven in VS Code.
Testen en validatie
Je kunt de service testen met Postman of met de Runtime-services die beschikbaar zijn in VS Code. Test dit door een HTTP-verzoek naar het API-endpoint te sturen. De e-mail wordt vervolgens afgeleverd bij de opgegeven ontvanger.
2. E-mails verzenden met de Transport Mail-functie
Transport Mail in WSO2 MI maakt het mogelijk om direct e-mails te versturen zonder dat er extra connectors nodig zijn. Deze methode maakt gebruik van de onderliggende Apache Axis2-transportlaag.
Configuratie
- Email instellingen in de deployment.toml configureren.
In plaats van e-mailgegevens hard te coderen in de integratiereeks, slaan we ze op in deployment.toml voor betere beveiliging en beheerbaarheid. Ga naar de map MI_HOME/conf/ en bewerk het bestand deployment.toml om de volgende e-mailconfiguraties toe te voegen:
Let op: Als je wachtwoord speciale tekens bevat (bijvoorbeeld <, > of &), kunnen er fouten optreden bij het starten van de server. Om dit te voorkomen, werk de parameter password als volgt bij:
parameter.password = “<![CDATA[${password}]]>”
2. Maak een API om e-mails te versturen:
In deze code haal ik het e-mailadres van de ontvanger en het onderwerp uit de JSON-request body om de mailto-URL dynamisch op te bouwen. De inhoud van de e-mail is op dit moment ingesteld op een statisch bericht: “Hallo, dit is een testmail verstuurd via SMTP transport!”. Als er een dynamisch bericht nodig is, moet dit gedeelte worden aangepast zodat de inhoud uit de JSON-request wordt gehaald. Daarnaast zorgt de OUT_ONLY-property ervoor dat de request in een fire-and-forget manier wordt uitgevoerd—er wordt geen response van de SMTP-server verwacht.
Bouwen en implementeren
Bouw en implementeer het project met een van de eerder genoemde methoden.
Testen en Validatie
Je kunt de service testen met Postman of met runtime-services die VS Code biedt. Test dit door een HTTP-verzoek naar het API-endpoint te sturen. De e-mail wordt vervolgens afgeleverd bij de opgegeven ontvanger.
Conclusie
Nu je beide manieren hebt onderzocht om e-mailfunctionaliteit in je WSO2 Micro Integrator-project te integreren, via de Email Connector en de Transport Mail-functie kun je bepalen welke methode het beste past bij jouw use case.
De Email Connector biedt een flexibele en eenvoudige manier om veilig e-mails te versturen, vooral als je de voorkeur geeft aan een connector-gebaseerde, configuratievriendelijke oplossing. De Transport Mail-functie daarentegen geeft je meer controle door middel van maatwerkconfiguratie, ideaal voor scenario’s waarin specifieke verwerking of integratie in bestaande flows nodig is.
Welke methode je ook kiest, zorg ervoor dat je SMTP-configuratie correct is en dat je inloggegevens veilig worden verwerkt voor een betrouwbare e-mailopzet.
Als volgende stap kun je deze voorbeelden aanpassen aan je eigen omgeving en de e-mailfunctionaliteit testen in een echte integratieflow. Met beide opties heb je nu de middelen om vol vertrouwen e-mailintegratie aan je projecten toe te voegen.
Neem contact op met onze experts als je meer vragen hebt n.a.v. dit blog.
