Het configureren van SendGrid e-mail op WHM

Bijgewerkt op
3 min leestijd

SendGrid is een cloudgebaseerde SMTP-service waarmee e-mail kan worden bezorgd zonder dat e-mailservers beheerd hoeven te worden.

NB: Poort 25 is standaard gesloten voor verbinding op onze VM's standaard. Als je poort 25 wilt openen, koop dan Mail Bridge en configureer deze in VPS Manager.

Om de Mailgun-e-mail op WHM te configureren, gebruik je deze handleiding.

Volg de onderstaande stappen om de SendGrid-service en het e-mailsysteem voor je domeinnaam aan de WHM-zijde te configureren:

Stap 1. Meld je aan voor SendGrid:


Zodra je alle contactgegevens hebt ingevuld, klik je op “Continue”.

Stap 2. Je wordt doorgestuurd naar een nieuw tabblad in de browser om je e-mailaccount te verifiëren. Kopieer de verificatiecode die naar je e-mailaccount is verzonden, voer deze in onder het veld “Code” en klik op “Verify”:


Stap 3. Verifieer je telefoonnummer door de verificatiecode die ernaartoe is verzonden in te voeren in het veld “Enter certification code” en klik op “Verify”:


Stap 4. Vervolgens krijg je de herstelcode te zien, die handig is als je je telefoon verliest of geen toegang hebt tot je verificatieapparaat. Kopieer de code, sla deze op en klik op “Continue”. Er is ook een optie om de code als bestand te downloaden:


Stap 5. Vul op de volgende pagina je contactgegevens in en klik op “Next”:


Stap 6. Open vanaf de volgende pagina je SendGrid-dashboard:


Stap 7. Zodra je daar bent, ga je naar “Settings” >> het menu “API Keys” om daar een nieuwe API Key aan te maken:


Stap 8. Voer in het geopende menu de API Key name in, stel de API Key permissions in op de optie “Full Access” en sla de configuratie op:


Stap 9. Stel de SendGrid Sender Authentication in. Er zijn twee manieren om dat te doen:

Methode 1: Single Sender Verification

Single Sender Verification - is een snelle verificatiemethode waarmee een geautoriseerde ontvanger (één of meerdere e-mailadressen) kan worden toegevoegd bij het gebruik van een SendGrid-account. Dit kan bijvoorbeeld worden gebruikt als je e-mails wilt verzenden van john.doe@example.com, dat is toegevoegd op de cPanel-server, naar jane.doe@gmail.com. Hiervoor moet het e-mailadres jane.doe@gmail.com worden toegevoegd aan Single Sender Verification in SendGrid.

NB: Single Sender Verification wordt alleen voor testen aanbevolen.

NB: Je kunt alleen verzenden vanaf het adres dat je verifieert, en niet vanaf elk adres op een geauthenticeerd domein.

  • Om Single Sender Verification in te stellen, ga je vanuit je SendGrid-dashboard naar “Settings” >> het menu “Sender Authentication” >> klik je op de knop “Verify a Single Sender”:

  • Maak op de volgende pagina een afzender aan door de contactgegevens in te vullen en klik op “Create” om alles op te slaan:

  • Daarna ontvang je een verificatie-e-mail van SendGrid. Om het toevoegen van het e-mailadres te bevestigen, klik je in de e-mail op de knop “Verify Single Sender”:

Methode 2: Domain Authentication (aanbevolen)

  • Klik op  “Settings” >> ga naar het menu “Sender Authentication” >> klik onder het veld “Domain Authentication” op “Authenticate Your Domain”:

  • Authenticeer op de volgende pagina je domeinnaam door de vragen uit de eerste en tweede stap te beantwoorden en klik op “Next”:


    NB: In de schermafbeelding hebben we als antwoord op de tweede vraag “No” gekozen. Dit antwoord is echter optioneel.

  • Voer daarna de benodigde domeinnaam in, stel indien nodig extra instellingen in en klik op “Next”:

  • Nu is het nodig om de domeinnaam te verifiëren door de bijbehorende CNAME- en TXT-DNS-records te configureren.

    Zodra de DNS-records voor het domein zijn aangemaakt, bevestig je hun toevoeging in stap 2 door het vakje “I’ve added these records” aan te vinken en hieronder op “Verify” te klikken:


NB: Het kan 24-48 uur duren voordat de DNS-records zijn doorgevoerd.

Stap 10. De volgende stap is het configureren van SMTP-instellingen voor het e-mailaccount aan de WHM-zijde.

Ga hiervoor naar WHM >> “Service Configuration” >> “Exim Configuration Manager” >> open het tabblad “Advanced Editor”. Zoek naar “Section: AUTH” en voeg de volgende code daarin toe:

sendgrid_login:
driver = plaintext
public_name = LOGIN
client_send = : apikey : <API_KEY_VALUE>

Zorg ervoor dat je <API_KEY_VALUE> vervangt door de API Key die in stap 8 is gegenereerd.

Stap 11. Zoek daarna naar “Section: POSTMAILCOUNT” en voeg daar de volgende code toe:

send_via_sendgrid:
driver = manualroute
domains = ! +local_domains
.ifdef SRSENABLED
# if outbound, and forwarding has been done, use an alternate transport
transport = ${if eq {$local_part@$domain} \
{$original_local_part@$original_domain} \
{sendgrid_smtp} {sendgrid_forwarded_smtp}}
.else
transport = sendgrid_smtp
.endif
route_list = "* smtp.sendgrid.net::587 byname"
host_find_failed = defer
no_more

Stap 12. Zoek naar “Section: TRANSPORTSTART” en voeg nog een code toe:

sendgrid_smtp:
driver = smtp
hosts = smtp.sendgrid.net
hosts_require_auth = smtp.sendgrid.net
hosts_require_tls = smtp.sendgrid.net

Stap 13. Sla de SMTP-configuratie op. 

Stap 14. Verstuur een e-mail om te zien of het systeem werkt. De e-mailheader bevat het onderdeel “SendGrid”.

Een geldig e-mailadres is vereist