Amazon SES do Mailtrap:
Przewodnik po Migracji

Przewodnik ten przedstawia kluczowe zasady łatwej migracji z Amazon SES do Mailtrap: od porównań terminologicznych, przez konfiguracje SMTP/API, po specyfikacje techniczne dla gładkiego przejścia.

Różnice między Amazon SES i Mailtrap

  1. Główna różnica między Amazon SES a Mailtrap polega na tym, że do ustawienia i integracji Mailtrap nie potrzebujesz zaawansowanych umiejętności i doświadczenia w programowaniu.
  2. Twoje emaile są przechowywane w Mailtrap Email Logs przez okres do 60 dni, w zależności od Twojego planu cenowego. Treści email i hard data równie przechowuje przez okres od 3 do 15 dni.
  3. Mailtrap oferuje plany z miesięcznym cyklem rozliczeniowym oraz możliwość wnioskowania o plan z rocznym rozliczeniem. Mailtrap nie posiada planu typu pay-as-you-go, ale mamy plan Free Forever z limitem 1000 emaili miesięcznie, aby przetestować i ocenić naszą usługę.
  4. Mailtrap oferuje Email Testing. Jest to odrębny produkt służący do kontroli HTML/CSS, spam scores, itp. oraz debugowania emaili w środowisku stagingowym, deweloperskim i QA przed wysłaniem ich do odbiorców.
  5. Kolejną kluczową różnicą między Amazon SES i Mailtrap jest sposób dostępu do wszystkich wskaźników. Mailtrap oferuje opcję Actionable Analytics, gdzie możesz uzyskać szczegółowe statystyki dla swoich emaili.
  6. Amazon SES nie pozwala na dodawanie opcji rezygnacji z subskrypcji do emaili bez kodowania.

Amazon SES i Mailtrap – podobieństwa

  1. Obsługa wysyłania za pomocą SMTP lub REST API.
  2. Do weryfikacji domeny można użyć rekordów return-path i DKIM.
  3. Gdy wysyłasz z nowo dodanej domeny, throughput jest kolejkowany lub throttled.
  4. Możesz dodać plik .csv, aby zaimportować adresy email z ‘suppression list’ (listy wycofanych subskrypcji).

Porównanie terminologii

  • Identity and Access Management (IAM)
  • Template (CreateTemplate – API operation
  • Account-level suppression list
  • Message Tags (closest comparison, but the logic is different)
  • Event Notifications
  • CONFIGURATIONSET (you have to store all the headers in configuration and create it in advance) or use

    SendRawEmail API method

  • Message Tags

Ogólny przebieg migracji krok-po-kroku

  1. Po zarejestrowaniu się w serwisie Mailtrap przejdź do „Sending Domains”. Dodaj swoją domenę i przejdź do jej weryfikacji.

  2. W przypadku wyboru serwisu SMTP, zmień ustawienia wysyłania zgodnie z danymi poświadczeń podawanymi przez Mailtrap. Patrz informacje pod nagłówkiem SMTP poniżej.

  3. W przypadku integracji API, sprawdź dokumentację API i biblioteki Mailtrap.

  4. Poświęć czas na zapoznanie się z głównymi wskazanych wyżej różnicami między Amazon SES i Mailtrap.

    Potrzebujesz pomocy?

    Skontaktuj się z naszymi specjalistami ds. pomocy i specjalistami ds. technicznych, którzy jej udzielą.

  5. Jeśli planujesz wysyłać ponad 200 tys. emaili miesięcznie – zdecydowanie zalecamy skontaktowanie się z pomocą techniczną Mailtrap. Chętnie Ci pomożemy. Po prostu umów się na rozmowę z członkiem naszego zespołu, a my upewnimy się, że Twoja migracja przebiega prawidłowo.

    Wskazówka dotycząca Mailtrap

    Użyj Ruby gem ActionMailer Balancer, aby proporcjonalnie rozłożyć obciążenie wysyłania emaili pomiędzy dwie różne usługi wysyłkowe (np. 60% AWS SES i 40% Mailtrap), aby zminimalizować ryzyko związane z wysyłaniem.

Jak zacząć

Rozpoczęcie korzystania z Mailtrap nie wymaga zbyt wiele wysiłku. Wystarczy utworzyć konto, a następnie przejść do konfiguracji i weryfikacji domeny albo z poziomu strony głównej w aplikacji lub wybierając opcję „Sending Domains” w “Email Sending”.

Więcej informacji można znaleźć w naszym „Getting Started Guide”, a tutaj przedstawiamy krótką instrukcję.

Weryfikacja domeny

  • Po zarejestrowaniu się, a następnie dodaniu i weryfikacji Twojej domeny, przechodzi ona kontrolę bezpieczeństwa, która zwykle trwa dwa dni robocze. W tym czasie przepustowość jest ograniczona do 100 emaili na godzinę, aby zapobiec przeciążeniu systemu. Przeczytaj nasz artykuł o “Sending Limits“, aby dowiedzieć się więcej.
  • Podczas kontroli bezpieczeństwa krytyczne znaczenie ma to, aby nie usuwać, ani nie dodawać niczego ponownie, ponieważ będzie to uważane za zachowanie rodzące podejrzenia.
  • Zwiększenie limitu można uzyskać zgłaszając się do pomocy technicznej, gdzie trzeba będzie odpowiedzieć na kilka pytań celem potwierdzenia wiarygodności swojej domeny.
  • Upewnij się, że ustawiłeś opcje rezygnacji z subskrypcji w Mailtrap i zaimportowałeś suppression lists z Amazon SES.

SMTP

Przejście z usługi Amazon SES SMTP jest proste.Zapoznaj się z poniższe sekcje, aby lepiej zrozumieć kompatybilność i niezbędne kroki. 

Sending Servers 

Amazon Servers

live.smtp.mailtrap.io email-smtp.us-east-2.amazonaws.com (+16 more) Show all
email-smtp.us-east-1.amazonaws.com
email-smtp-fips.us-east-1.amazonaws.com
email-smtp.us-west-1.amazonaws.com
email-smtp.us-west-2.amazonaws.com
email-smtp-fips.us-west-2.amazonaws.com
email-smtp.ap-south-1.amazonaws.com
email-smtp.ap-northeast-3.amazonaws.com
email-smtp.ap-northeast-2.amazonaws.com
email-smtp.ap-southeast-1.amazonaws.com
email-smtp.ap-southeast-2.amazonaws.com
email-smtp.ap-northeast-1.amazonaws.com
email-smtp.ca-central-1.amazonaws.com
email-smtp.eu-central-1.amazonaws.com
email-smtp.eu-west-1.amazonaws.com
email-smtp.eu-west-2.amazonaws.com
email-smtp.eu-west-3.amazonaws.com
email-smtp.eu-north-1.amazonaws.com
email-smtp.sa-east-1.amazonaws.com

Ports

PortFunction
587Zalecany SMTP relay z TLS
25Duży ruch, zablokowany przez niektórych dostawców skrzynek pocztowych z powodu przeciążenia
2525Alternatywny port, w przypadku problemów z innymi portami
465Na potrzeby połączenia SSL SMTP

Konfiguracja SMTP

Po pomyślnym zweryfikowaniu domeny wybierz “SMTP” w obszarze „Integrations”.

Skopiuj i wklej poświadczenia do swojej aplikacji lub projektu, a następnie wyślij email z potwierdzeniem w celu zweryfikowania konfiguracji. Zapoznaj się z artykułem „Sending Domain Setup”, aby uzyskać więcej informacji na temat tego, jak to zrobić.

Uwaga: Włączenie TLS jest obowiązkowe, jak wspomniano w uwierzytelnieniach.

API

Wyjaśnienie Mailtrap API tokens

Mailtrap automatycznie tworzy token, gdy tworzysz domenę, i domyślnie token ma uprawnienia dostępu Domain Admin. Możesz edytować uprawnienia dla tego tokenu, aby autoryzować go z innymi domenami na Twoim koncie.

Zapoznaj się z treścią naszej instrukcji, aby uzyskać więcej informacji o zarządzaniu tokenami API.

API Mapping

API typeMailtrapSES Naming
The BasicsGeneralWelcome
SendingSend emailSendEmail, SendRawEmail,
SendTemplatedEmail
Email TestingEmail Testing API

Biblioteki API

Obecnie w Mailtrap dostępne są cztery biblioteki.

Język programowaniaMailtrapMailgun
NodeJSNodeJS SDKNot supported
RubyRuby SDKRuby SDK
PHPPHP SDKPHP SDK
PythonPython SDKPython SDK

API Authentication

Mailtrap wykorzystuje uwierzytelnienia Bearer. Dlatego musisz przekazać token API pod nagłówkiem “Authorization” Twojego emaila.

Zarządzanie użytkownikami

Począwszy od planu “Business” w Mailtrap Email API, możesz dodawać użytkowników do swojego konta i zarządzać ich uprawnieniami. Kliknięcie w “User Management” pokazuje wszystkich użytkowników w danym koncie, gdzie możesz łatwo dodawać nowych członków i przydzielać im uprawnienia.

Na podstawie uprawnień, które użytkownicy uzyskają, będą mogli przeglądać, uzyskiwać dostęp i/lub modyfikować określone funkcje aplikacji. Należy pamiętać, że użytkownik potrzebuje uprawnień administratora, aby uzyskać uwierzytelnienie i wysyłać wiadomości email za pośrednictwem interfejsu API.

Przeczytaj więcej o zarządzaniu uprawnieniami użytkowników.

ActionMailer Balancer dla płynnej migracji

W przypadku aplikacji Ruby on Rails Mailtrap oferuje rozszerzenie ActionMailer Balancer, które ułatwia migrację. Rozszerzenie ActionMailer pozwala na proporcjonalne rozłożenie obciążenia wysyłania wiadomości email między dwoma różnymi serwisami wysyłającymi i zmniejszenie zagrożeń związanych z wysyłaniem.

Zainstalowanie Balancera w aplikacji i przeprowadzenie kilku drobnych konfiguracji poszerzy zakres metody wysyłania ActionMailer.

Aby uzyskać bardziej szczegółowe informacje na temat boilerplate i użycia w rozwoju, przeczytaj stronę Mailtrap ActionMailer Balancer na Github.