SendGrid Relay Setup (own frontend)

Konfiguracja SendGrid Relay z własnym frontendem pozwala wysyłać pocztę przez tę usługę z poziomu własnej aplikacji.

Rola SendGrid Relay w aplikacji z własnym frontendem

SendGrid Relay Setup (own frontend) oznacza skonfigurowanie wysyłki wiadomości przez usługę SendGrid oraz przygotowanie własnego interfejsu aplikacji do obsługi tego procesu. Frontend może zawierać formularz tworzenia wiadomości, pola adresata, temat, treść, załączniki i przycisk wysyłki, ale samo połączenie z serwerem SMTP SendGrid powinno być realizowane po stronie backendu. Przeglądarka użytkownika nie powinna otrzymywać klucza API ani hasła używanego do uwierzytelniania SMTP.

SendGrid może działać jako zewnętrzny przekaźnik poczty wychodzącej. Aplikacja przekazuje do niego przygotowaną wiadomość, a usługa odpowiada za przyjęcie żądania i próbę dostarczenia poczty do serwera odbiorcy. Własny frontend jest warstwą prezentacji i obsługi danych, natomiast backend pełni funkcję pośrednika między interfejsem a SendGrid. Taki podział pozwala kontrolować uprawnienia, walidować dane formularza i rejestrować wynik wysyłki bez ujawniania danych uwierzytelniających w kodzie JavaScript.

Parametry połączenia SMTP z SendGrid

Połączenie SMTP z SendGrid korzysta z hosta smtp.sendgrid.net. W typowej konfiguracji stosowany jest port 587 z szyfrowaniem uruchamianym przez STARTTLS. SendGrid obsługuje także port 2525, często używany w środowiskach, w których port 25 jest ograniczany przez dostawcę internetu lub operatora hostingu. Port 25 może być używany do transmisji SMTP, lecz w praktyce jego dostępność i sposób filtrowania zależą od sieci, z której działa aplikacja.

Przy uwierzytelnianiu SMTP SendGrid używa nazwy użytkownika apikey, a jako hasło przyjmuje wartość utworzonego klucza API. Klucz powinien mieć co najmniej uprawnienie umożliwiające wysyłkę poczty, określane w SendGrid jako Mail Send. Backend powinien przechowywać ten klucz poza kodem źródłowym, na przykład w zmiennej środowiskowej lub bezpiecznej konfiguracji serwera. Nie należy umieszczać go w kodzie frontendowym, publicznym repozytorium, adresie URL ani w danych zwracanych do przeglądarki.

Przepływ danych od formularza do wiadomości

Własny frontend może wysłać do backendu żądanie HTTP zawierające dane wiadomości. Backend powinien sprawdzić poprawność adresu odbiorcy, obecność tematu i treści oraz dopuszczalny rozmiar załączników, jeżeli aplikacja je obsługuje. Następnie tworzy wiadomość SMTP z adresem nadawcy, odbiorcą, tematem, treścią tekstową lub HTML i ewentualnymi załącznikami. Po nawiązaniu szyfrowanego połączenia z smtp.sendgrid.net backend wykonuje uwierzytelnienie i przekazuje wiadomość do SendGrid.

Odpowiedź backendu dla frontendu powinna rozróżniać co najmniej przyjęcie żądania od faktycznego wyniku dostarczenia. Pomyślne przekazanie wiadomości do SendGrid nie oznacza jeszcze, że została ona odebrana przez adresata. Własny interfejs może wyświetlić komunikat o przyjęciu wysyłki, a szczegółowy status należy ustalać na podstawie odpowiedzi biblioteki SMTP, logów aplikacji oraz danych dostępnych w SendGrid. Błędy uwierzytelnienia, odrzucenie nadawcy, niedostępny serwer SMTP i błędny adres odbiorcy powinny być rejestrowane po stronie backendu, bez ujawniania klucza API.

Uwierzytelnianie nadawcy i kontrola konfiguracji

Konfiguracja wysyłki powinna obejmować nie tylko dane SMTP, lecz także prawidłowy adres nadawcy. SendGrid wymaga weryfikacji tożsamości nadawcy zgodnie z ustawieniami konta. W przypadku użycia własnej domeny konfiguracja Domain Authentication służy do powiązania domeny z usługą i obejmuje rekordy DNS wykorzystywane przez mechanizmy uwierzytelniania poczty, w tym SPF oraz DKIM. Rekordy należy dodać u operatora DNS zgodnie z wartościami pokazanymi w panelu SendGrid, ponieważ są one zależne od konkretnej konfiguracji.

Podczas wdrażania warto sprawdzić, czy frontend nie wysyła danych bezpośrednio do usługi SMTP, czy backend wymaga uwierzytelnionej sesji aplikacyjnej i czy komunikaty błędów nie zawierają poufnych parametrów. Należy również przetestować wysyłkę zwykłego tekstu, HTML, niepoprawnego adresu oraz sytuacji, w której SendGrid odrzuca próbę nadania. Diagnostyka komputera używanego do pracy z taką aplikacją może obejmować sprawdzenie przeglądarki, połączenia sieciowego, certyfikatów TLS i lokalnych blokad portów. Warszawskie Pogotowie Komputerowe wykonuje profesjonalną naprawę laptopów, komputerów PC i ich podzespołów, gdy problem z urządzeniem utrudnia korzystanie z aplikacji.