Het configureren van SendGrid e-mail op WHM

Bijgewerkt op
3 min leestijd

SendGrid is een cloudgebaseerde SMTP-service waarmee e-mailbezorging mogelijk is zonder dat je e-mailservers hoeft te beheren.

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

Om de Mailgun-e-mail op WHM te configureren, gebruik 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. Aanmelden voor SendGrid:


Zodra je alle contactgegevens hebt ingevuld, klik je op "Doorgaan".

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 gestuurd, voer deze in onder het veld "Code" en klik op "Verifiëren":


Stap 3. Verifieer je telefoonnummer door de verificatiecode die daarheen is gestuurd in te voeren onder het veld "Enter certification code" en klik op "Verifiëren":


Stap 4. Vervolgens krijg je de herstelcode die handig is in het geval je je telefoon kwijtraakt of geen toegang hebt tot je verificatieapparaat. Kopieer de code, sla deze op en klik op "Doorgaan". Er is ook een optie om de code als bestand te downloaden:


Stap 5. Vul je contactgegevens in op de volgende pagina en klik op "Volgende":


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


Stap 7. Ga daar naar "Instellingen" >> het menu "API Keys" om daar een nieuwe API Key aan te maken:


Stap 8. Voer in het geopende menu de API Key-naam in, stel de API Key-rechten in op de optie "Volledige toegang" en sla de configuratie op:


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

Methode 1: Single Sender Verification

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

NB: Single Sender Verification wordt alleen aanbevolen voor testdoeleinden.

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 naar "Instellingen" vanuit je SendGrid-dashboard >> het menu "Sender Authentication" >> klik op de knop "Verify a Single Sender":

  • Op de volgende pagina maak je een afzender aan door de contactgegevens in te vullen en klik je op "Aanmaken" om alles op te slaan:

  • Daarna ontvang je een verificatie-e-mail van SendGrid. Om het e-mailadres toe te voegen, klik je op de knop "Verify Single Sender" in de e-mail:

Methode 2: Domeinauthenticatie (aanbevolen)

  • Klik op "Instellingen" >> navigeer naar het menu "Sender Authentication" >> onder het veld "Domain Authentication", klik op "Authenticate Your Domain":

  • Op de volgende pagina verifieer je je domeinnaam door de vragen van de eerste en tweede stap te beantwoorden en klik je op "Volgende":


    NB: In de schermafbeelding hebben we het antwoord "Nee" gekozen op de tweede vraag. Dit antwoord is echter optioneel.

  • Voer daarna de benodigde domeinnaam in, stel indien nodig extra instellingen in en klik op "Volgende":

  • Nu moet je de domeinnaam 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 "Ik heb deze records toegevoegd" aan te vinken en klik je hieronder op "Verifiëren":


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

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

Om dit te doen, ga naar WHM >> "Service Configuration" >> "Exim Configuration Manager" >> open het tabblad "Advanced Editor". Zoek naar "Section: AUTH" en voeg daar de volgende code toe:

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

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

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. Stuur een e-mail om te controleren of het systeem werkt. De e-mailheader zal het onderdeel "SendGrid" bevatten.

Een geldig e-mailadres is vereist