Hoe configureer je SendGrid SMTP op CyberPanel

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 standaard 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 SendGrid-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 CyberPanel-kant te configureren:

1. Meld je aan bij SendGrid:

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

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”:

3. Verifieer je telefoonnummer door de verificatiecode die daarheen is gestuurd in te voeren onder het veld “Voer certificeringscode in” en klik op “Verifiëren”:

4. Vervolgens krijg je de herstelcode die handig is als 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:

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


6. Open op de volgende pagina je SendGrid-dashboard:

7. Ga daar naar “Instellingen” >> het menu “API-sleutels” om daar een nieuwe API-sleutel aan te maken:


8. Voer in het geopende menu de naam van de API-sleutel in, stel de machtigingen van de API-sleutel in op de optie “Volledige toegang” en sla de configuratie op:

9. Stel de SendGrid-verzenderauthenticatie in. Er zijn twee manieren om dit te doen:

Methode 1: Verificatie van enkele verzender

Verificatie van enkele verzender - is een snelle verificatiemethode waarmee je een geautoriseerde ontvanger (één (of meerdere) e-mailadres(sen)) kunt toevoegen bij gebruik van een SendGrid-account. Dit kan bijvoorbeeld worden gebruikt als je e-mails wilt verzenden vanaf 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 Verificatie van enkele verzender op SendGrid.

NB: Verificatie van enkele verzender 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 de verificatie van enkele verzender in te stellen, ga je naar “Instellingen” in je SendGrid-dashboard >> het menu “Verzenderauthenticatie” >> klik op de knop “Verifieer een enkele verzender”:

Maak op de volgende pagina een verzender aan door de contactgegevens in te vullen en klik 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 “Verifieer enkele verzender” in de e-mail:

Methode 2: Domeinauthenticatie (aanbevolen)

Klik op “Instellingen” >> navigeer naar het menu “Verzenderauthenticatie” >> onder het veld “Domeinauthenticatie”, klik op “Authenticeer je domein”:

Op de volgende pagina kun je je domeinnaam authenticeren door de vragen van de eerste en tweede stap te beantwoorden en op “Volgende” te klikken:

NB: In de schermafbeelding hebben we “Nee” gekozen als antwoord 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 gepropageerd.

10. De volgende stap is het configureren van SMTP-instellingen voor de CyberPanel-server.

Helaas biedt CyberPanel gebruikers nog geen speciale interface voor SMTP-configuraties. SendGrid moet via de SSH-terminal worden geconfigureerd. 

  • Log eerst in op je server als root:

ssh root@SERVER_IP_ADDRESS -p PORT


Waar SERVER_IP_ADDRESS het IP-adres van je server is en PORT de SSH-verbindingpoort (standaard is dit 22022)

  • Open /etc/postfix/main.cf bestand met een teksteditor:

nano /etc/postfix/main.cf
of
vi /etc/postfix/main.cf

  • Voeg de volgende regels toe aan het einde van het bestand:

smtp_sasl_auth_enable = yes
smtp_sasl_password_maps = hash:/etc/postfix/sasl_passwd
smtp_sasl_security_options = noanonymous
smtp_sasl_tls_security_options = noanonymous
smtp_tls_security_level = encrypt
header_size_limit = 4096000
relayhost = [smtp.sendgrid.net]:587

  • Nu moet je je inloggegevens opgeven (gebruik apikey als gebruikersnaam en een API-sleutel als wachtwoord) in het aparte bestand /etc/postfix/sasl_passwd (je moet het waarschijnlijk aanmaken):

echo “[smtp.sendgrid.net]:587 apikey:YOUR_SENDGRID_API_KEY” > /etc/postfix/sasl_passwd

Waar YOUR_SENDGRID_API_KEY de sleutel is die je hebt aangemaakt bij stap 8.

  • Controleer vervolgens of het bestand beperkte lees- en schrijfrechten heeft alleen voor root, en gebruik het postmap-commando om de hash-tabellen van Postfix bij te werken om dit nieuwe bestand te gebruiken:

sudo chmod 600 /etc/postfix/sasl_passwd
sudo postmap /etc/postfix/sasl_passwd

  • Herstart ten slotte Postfix:

systemctl restart postfix

  • Installeer de SASL-plugin op je server:

apt-get install libsasl2-modules  # voor Ubuntu
dnf install cyrus-sasl-plain      # voor Almalinux/CloudLinux
yum install cyrus-sasl-plain       # voor CentOS

Sommige instanties vereisen ook een MySQL-driver voor Dovecot om MySQL-backend voor authenticatie te configureren:

apt install dovecot-sqlite dovecot-mysql   # voor Ubuntu
dnf install dovecot-mysql               # voor Almalinux/CloudLinux
yum install dovecot-mysql                # voor CentOS

  • Herstart daarna Dovecot:

systemctl restart dovecot

  • Nu kun je testen of een e-mail via SendGrid wordt doorgestuurd:

sendmail -f YOUR_LOCAL_EMAIL -v DESTINATION_EMAIL

Waar YOUR_LOCAL_EMAIL het e-mailaccount is dat je hebt aangemaakt in je CyberPanel-account, en DESTINATION_EMAIL het e-mailadres is waarnaar een testmail wordt verzonden.

Typ vervolgens je berichttekst en druk op Ctrl+D om te verzenden.

Je kunt ook Webmail in je CyberPanel-account gebruiken om daar een testmail te verzenden.

Een geldig e-mailadres is vereist