Gå til innhold
Dokumentasjon
SendGrid innkommende e-post

SendGrid innkommende e-post

Vis som Markdown

Status200s Incoming Email Monitor lar deg opprette og løse varsler basert på e-poster som sendes til unike, monitorspesifikke e-postadresser. Det er nyttig for å integrere eldre systemer, varslingsverktøy eller enhver tjeneste som kan sende e-post.

Det samme oppsettet lar også arbeidsflyter motta e-post: En arbeidsflyt med utløseren Incoming Email får sin egen adresse på det samme domenet, og hver e-post til den starter arbeidsflyten. Se Utløsere.

Denne veiledningen forklarer hvordan du setter opp SendGrid Inbound Parse til å videresende innkommende e-poster til din selvhostede Status200-instans. Status200 Cloud trenger ingenting av dette: Der virker adressene med en gang.

Før du begynnerEn SendGrid-konto, et domene og en offentlig HTTPS-adresse.OppsettSju trinn, fra MX-posten til en test-e-post.MiljøvariablerDe tre innstillingene og standardverdiene deres.FeilsøkingE-poster som aldri kommer frem, og webhooks som feiler.

Slik fungerer det

sequenceDiagram participant Sender as Avsendende<br/>e-postserver participant SendGrid as SendGrid<br/>Inbound Parse participant Status200 as Status200 Sender->>SendGrid: E-post til<br/>monitorens<br/>adresse<br/>(MX-posten din) SendGrid->>Status200: POST …/sendgrid/YOUR_SECRET Status200->>Status200: Knytte<br/>adressen til en<br/>monitor eller<br/>en arbeidsflyt Status200-->>SendGrid: 200 OK

Slik når en e-post frem til en monitor

  1. Du oppretter en Incoming Email Monitor i Status200
  2. Status200 genererer en unik e-postadresse for den monitoren (f.eks. monitor-abc123@inbound.yourdomain.com)
  3. Når en e-post sendes til den adressen, mottar SendGrid den og videresender den til Status200 via webhook
  4. Status200 vurderer e-posten etter kriteriene du har satt opp, for å opprette eller løse varsler

Forutsetninger

  • En SendGrid-konto med tilgang til Inbound Parse
  • Et domene du kontrollerer, med tilgang til DNS-innstillingene
  • Et offentlig HTTPS-endepunkt som videresender SendGrid-webhooks til Status200-instansen din

Nettverkstilgang

Med Inbound Parse er det SendGrid som oppretter forbindelsen til Status200. Det er ikke nok å bare tillate utgående internettilgang fra Status200.

RetningMålProtokoll / portFormål
SendGrid → Status200https://your-oneuptime-domain.com/incoming-email/sendgrid/YOUR_SECRETHTTPS / TCP 443Levere den tolkede e-posten som en multipart-POST.
Avsendende e-postservere → SendGridmx.sendgrid.net, valgt via den offentlige MX-posten for det innkommende domenet dittSMTP / TCP 25Motta e-post hos SendGrid; denne forbindelsen går ikke til Status200-serveren din.
Status200 → SendGrid, bare når sending av e-post via SendGrid-leverandøren er satt opp separatapi.sendgrid.comHTTPS / TCP 443Sende varslings-e-poster via Mail Send API-et.

Publiser DNS for vertsnavnet til webhooken, og lever et sertifikat som offentlige klienter stoler på. En privat Status200-installasjon kan nøye seg med å eksponere webhook-stien gjennom en offentlig omvendt proxy eller gateway som når Status200 internt. Bevar stien, hemmeligheten, innholdstypen og multipart-forespørselens body, og slipp POST-en gjennom uten interaktiv pålogging eller nettleserutfordring. Status200-serveren trenger ikke en innkommende SMTP-lytter. Se SendGrids oppsett av Inbound Parse.

Sett INBOUND_EMAIL_WEBHOOK_SECRET til en sterk tilfeldig verdi, og erstatt YOUR_SECRET i URL-en med den verdien. Ruten krever det siste stisegmentet, og Status200 tar bare imot en e-post når det segmentet er hemmeligheten. Inntil hemmeligheten er satt, avvises hver e-post med 503, som SendGrid prøver på nytt i opptil tre dager. Hold den fullstendige URL-en og monitorenes e-postadresser hemmelige, også i proxylogger. Status200 validerer foreløpig verken SendGrids signerte Inbound Parse-hoder eller OAuth-tokener. Trenger du de mekanismene, setter du opp en gateway som validerer dem før den videresender til den fullstendige URL-en, etter SendGrids dokumentasjon om webhook-sikkerhet.

SendGrid tilbyr ikke en pålitelig liste over statiske kilde-IP-er for Inbound Parse. SendGrids IP-er for sending av e-post og adressene som slås opp for mx.sendgrid.net, er ikke en tillatelsesliste for webhooks. Følg SendGrids veiledning om brannmurer i stedet for å låse et gjeldende DNS-resultat.

Inbound Parse er atskilt fra sending av utgående e-post. For å motta monitor-e-poster trenger ikke Status200 å kalle SendGrid-API-et. Velger du også SendGrid til å sende varsler, tillater du DNS-oppslag og utgående HTTPS til api.sendgrid.com; Mail Send trenger ingen innkommende tilbakekalling for innsending. Bruker du SMTP i stedet, tillater du SMTP-serveren og porten som er satt opp i Status200.

Oppsettsveiledning

  1. Velg domenet for innkommende e-post

    Velg et underdomene som bare brukes til å motta e-post for Status200, for eksempel inbound.yourdomain.com, email.yourdomain.com eller monitor.yourdomain.com. Det brukes bare til e-post til Status200-monitorer og -arbeidsflyter, så ingen av postkassene dine ligger på det.

  2. La MX-posten peke på SendGrid

    Legg til en MX-post som sender e-post for underdomenet videre til SendGrid:

    TypeVert/NavnPrioritetVerdi
    MXinbound10mx.sendgrid.net

    Hvis domenet ditt er example.com og du bruker inbound.example.com, blir posten:

    inbound.example.com.  IN  MX  10  mx.sendgrid.net.

    DNS-endringer kan ta opptil 48 timer å spre seg, men er som regel ferdige i løpet av noen få timer.

  3. Autentiser domenet i SendGrid

    Det mottakende domenet må høre til et av dine autentiserte domener i SendGrid. Gå i SendGrid-dashbordet til Settings > Sender Authentication, klikk på Authenticate Your Domain, og legg til DNS-postene den ber om (CNAME-poster for DKIM).

  4. Legg til Inbound Parse-webhooken

    Gå i SendGrid-dashbordet til Settings > Inbound Parse, og klikk på Add Host & URL. Fyll ut skjemaet som nedenfor, og klikk deretter på Add:

    FeltVerdi
    Receiving DomainUnderdomenet ditt for innkommende e-post (f.eks. inbound.yourdomain.com)
    Destination URLhttps://your-oneuptime-domain.com/incoming-email/sendgrid/YOUR_SECRET
    Check incoming emails for spamValgfritt – slå på om ønskelig
    Send raw, full MIME messageLa være uavkrysset (ikke nødvendig)
    POST the raw, full MIME messageLa være uavkrysset (ikke nødvendig)

  5. Konfigurer Status200

    Sett variablene for innkommende e-post, med den samme hemmeligheten som i Destination URL:

    Docker Compose

    config.envBash 
    INBOUND_EMAIL_PROVIDER=SendGrid
INBOUND_EMAIL_DOMAIN=inbound.yourdomain.com
INBOUND_EMAIL_WEBHOOK_SECRET=replace-with-a-strong-random-secret

    Kubernetes

    values.yamlYAML 
    inboundEmail:
  provider: "SendGrid"
  domain: "inbound.yourdomain.com"
  webhookSecret: "replace-with-a-strong-random-secret"

    INBOUND_EMAIL_WEBHOOK_SECRET er påkrevd: Status200 avviser hver e-post så lenge den er tom eller fortsatt en plassholder fra denne siden. openssl rand -hex 32 lager en lang tilfeldig verdi.

    Ta dem deretter i bruk: Kjør npm run start på Docker Compose, som gjenoppretter containerne med de nye verdiene, eller oppgrader Helm-releasen på Kubernetes.

  6. Opprett en Incoming Email-monitor

    Opprett en Incoming Email-monitor. Siden Oversikt viser adressen, for eksempel monitor-abc123def456@inbound.yourdomain.com, og kriteriene avgjør hvilke e-poster som oppretter et varsel og hvilke som løser det.

    Arbeidsflyter bruker det samme domenet. Legg til utløseren Incoming Email i en arbeidsflyt og klikk på den: Adressen (workflow-…@inbound.yourdomain.com) står øverst i innstillingene. Til variablene for innkommende e-post ovenfor er satt, sier utløseren at serveren ikke er satt opp til å motta e-post.

  7. Send en test-e-post

    Send en e-post til monitorens adresse, med et emne som samsvarer med kriteriene. Monitorens sammendrag viser e-posten, og et varsel opprettes når kriteriene samsvarer.

Referanse for miljøvariabler

VariabelHelm-verdiBeskrivelsePåkrevdStandard
INBOUND_EMAIL_PROVIDERinboundEmail.providerLeverandøren av innkommende e-post. SendGrid er den eneste.NeiSendGrid
INBOUND_EMAIL_DOMAINinboundEmail.domainUnderdomenet som er satt opp for innkommende e-post. Innkommende e-post er av til det er satt.JaTom
INBOUND_EMAIL_WEBHOOK_SECRETinboundEmail.webhookSecretHemmelighet som det siste segmentet i webhook-URL-en må samsvare med: /incoming-email/sendgrid/YOUR_SECRET. Hver e-post avvises så lenge den er tom eller en plassholder.JaTom

Hva en Incoming Email-monitor kan se etter – emnet, avsenderen, innholdet, mottakeren og om en e-post kom frem i tide – står i Tilgjengelige filtertyper.

Feilsøking

E-poster blir ikke mottatt
  1. Kontroller DNS-spredningen: dig MX inbound.yourdomain.com skal returnere mx.sendgrid.net.
  2. Kontroller Inbound Parse-innstillingene i SendGrid: Sjekk domenet ditt og webhook-URL-en i SendGrid-dashbordet under Settings > Inbound Parse.
  3. Sjekk loggene til Status200: Se etter webhook-forespørsler for innkommende e-post, og eventuelle feil, i loggene til Status200-tjenesten app. SendGrid lagrer ingen detaljerte logger for Inbound Parse, så disse loggene er oversikten over hva som kom frem.
Webhooks feiler
  1. Kontroller den offentlige webhook-ruten: Den fullstendige URL-en, inkludert hemmeligheten, må nå Status200 fra internett. URL-en uten det siste hemmelige segmentet samsvarer ikke med ruten.
  2. Kontroller brannmurreglene: Tillat HTTPS POST-forespørsler til webhook-stien uten påloggingsomdirigeringer eller nettleserutfordringer, og ikke bruk SendGrids IP-er for sending av e-post som tillatelsesliste for webhookens kilde.
  3. Kontroller SSL-sertifikatet: Bruk et gyldig, offentlig klarert sertifikat for vertsnavnet til webhooken, og ta med sertifikatkjeden.
  4. Kontroller webhook-hemmeligheten: Destination URL må slutte med verdien av INBOUND_EMAIL_WEBHOOK_SECRET. Så lenge variabelen er tom eller en plassholder, avvises hver e-post med 503, og loggen til tjenesten app sier det når den starter; en e-post sendt til en URL som slutter med noe annet, avvises med 403.
Monitoren oppretter ikke varsler
  1. Kontroller kriteriene: Sjekk at kriteriene for å opprette varsler samsvarer med innholdet i e-posten, og test først med eksakte strenger før du bruker mønstre.
  2. Sjekk monitoren: Sørg for at den ikke er deaktivert, og at typen er Incoming Email.
  3. Gå gjennom monitorens sammendrag: Sjekk om e-posten ble mottatt og behandlet, og les evalueringsloggene for hvordan kriteriene samsvarte.
Utløseren sier at serveren ikke er satt opp til å motta e-post

INBOUND_EMAIL_DOMAIN er tom på serveren. Sett den, ta endringen i bruk, og åpne arbeidsflytens utløser igjen.

Beste praksis for sikkerhet

  1. Bruk HTTPS: Bruk alltid HTTPS for webhook-endepunktet ditt
  2. Webhook-hemmelighet: Bruk en lang tilfeldig verdi som er din egen, til INBOUND_EMAIL_WEBHOOK_SECRET, på slutten av webhook-URL-en (f.eks. /incoming-email/sendgrid/your-secret): det er den som skiller SendGrids e-poster fra alle andres
  3. Domenebekreftelse: Bekreft domenet ditt i SendGrid for bedre e-postsikkerhet
  4. Begrens tilgangen: Opprett bare monitorer for klarerte e-postkilder
  5. Overvåk logger: Gå jevnlig gjennom loggene for innkommende e-post for mistenkelig aktivitet

Neste steg

Incoming Email MonitorKriterier, adresseformater og eksempler.ArbeidsflytutløsereStart en arbeidsflyt fra en e-post.Tilgang til privat nettverkHva serveren din kan nå i ditt eget nettverk.ArkitekturHvor webhooken lander i en selvhostet installasjon.