SendGrid आने वाला ईमेल

Status200 का Incoming Email Monitor आपको हर मॉनिटर के लिए अलग, अनोखे ईमेल पतों पर भेजे गए ईमेल के आधार पर अलर्ट बनाने और सुलझाने देता है। यह पुराने सिस्टम, अलर्टिंग टूल या ईमेल भेज सकने वाली किसी भी सेवा को जोड़ने के लिए उपयोगी है।

यही सेटअप वर्कफ़्लो को भी ईमेल पाने देता है: Incoming Email ट्रिगर वाले वर्कफ़्लो को उसी डोमेन पर अपना पता मिलता है, और उस पर आने वाला हर ईमेल वर्कफ़्लो शुरू करता है। देखें ट्रिगर।

यह गाइड बताती है कि आने वाले ईमेल को आपके सेल्फ-होस्टेड Status200 इंस्टेंस तक भेजने के लिए SendGrid Inbound Parse कैसे सेट करें। Status200 Cloud को इसमें से कुछ नहीं चाहिए: वहाँ पते शुरू से ही काम करते हैं।

यह कैसे काम करता है#

1. आप Status200 में एक Incoming Email Monitor बनाते हैं
2. Status200 उस मॉनिटर के लिए एक अनोखा ईमेल पता बनाता है (जैसे, monitor-abc123@inbound.yourdomain.com)
3. जब उस पते पर कोई ईमेल भेजा जाता है, तो SendGrid उसे प्राप्त करता है और वेबहुक के ज़रिए Status200 को भेज देता है
4. Status200 आपके कॉन्फ़िगर किए गए मानदंडों के आधार पर ईमेल का मूल्यांकन करके अलर्ट बनाता या सुलझाता है

पूर्व-आवश्यकताएँ#

• Inbound Parse की पहुँच वाला एक SendGrid खाता
• आपके नियंत्रण वाला एक डोमेन, जिसकी DNS सेटिंग्स तक आपकी पहुँच हो
• एक सार्वजनिक HTTPS एंडपॉइंट जो SendGrid के वेबहुक आपके Status200 इंस्टेंस तक भेजे

नेटवर्क पहुँच#

Inbound Parse में SendGrid ही Status200 से कनेक्शन शुरू करता है। Status200 को केवल बाहर जाने वाली इंटरनेट पहुँच देना काफ़ी नहीं है।

वेबहुक होस्टनाम के लिए DNS प्रकाशित करें और ऐसा प्रमाणपत्र दें जिस पर सार्वजनिक क्लाइंट भरोसा करते हों। निजी Status200 डिप्लॉयमेंट केवल वेबहुक पाथ को किसी ऐसे सार्वजनिक रिवर्स प्रॉक्सी या गेटवे के ज़रिए खोल सकता है जो अंदर से Status200 तक पहुँच सके। पाथ, सीक्रेट, कंटेंट टाइप और multipart अनुरोध बॉडी को वैसा ही रखें, और POST को बिना इंटरैक्टिव लॉगिन या ब्राउज़र चैलेंज के गुज़रने दें। Status200 सर्वर को आने वाले SMTP लिसनर की ज़रूरत नहीं है। देखें SendGrid का Inbound Parse सेटअप।

INBOUND_EMAIL_WEBHOOK_SECRET को एक मज़बूत यादृच्छिक मान पर सेट करें और URL में YOUR_SECRET को उसी मान से बदलें। रूट के लिए आख़िरी पाथ सेगमेंट ज़रूरी है, और Status200 कोई ईमेल तभी लेता है जब वह सेगमेंट सीक्रेट हो। जब तक सीक्रेट सेट नहीं होता, हर ईमेल 503 के साथ अस्वीकार किया जाता है, जिसे SendGrid तीन दिन तक फिर से भेजने की कोशिश करता है। पूरा URL और मॉनिटरों के ईमेल पते गोपनीय रखें, प्रॉक्सी लॉग में भी। Status200 अभी SendGrid के हस्ताक्षरित Inbound Parse हेडर या OAuth टोकन की जाँच नहीं करता। अगर आपको ये तंत्र चाहिए, तो SendGrid के वेबहुक सुरक्षा दस्तावेज़ के अनुसार एक ऐसा गेटवे कॉन्फ़िगर करें जो पूरे URL पर भेजने से पहले उनकी जाँच करे।

SendGrid, Inbound Parse के लिए स्थिर स्रोत IP की कोई भरोसेमंद सूची नहीं देता। SendGrid के ईमेल भेजने वाले IP और mx.sendgrid.net के लिए रिज़ॉल्व होने वाले पते वेबहुक की अनुमति-सूची नहीं हैं। किसी मौजूदा DNS नतीजे को स्थायी करने के बजाय SendGrid का फ़ायरवॉल मार्गदर्शन अपनाएँ।

Inbound Parse बाहर जाने वाले ईमेल भेजने से अलग है। मॉनिटर ईमेल पाने के लिए Status200 को SendGrid API कॉल करने की ज़रूरत नहीं है। अगर आप सूचनाएँ भेजने के लिए भी SendGrid चुनते हैं, तो DNS रिज़ॉल्यूशन और api.sendgrid.com तक बाहर जाने वाला HTTPS अनुमत करें; Mail Send को भेजने के लिए किसी आने वाले कॉलबैक की ज़रूरत नहीं होती। अगर आप इसके बजाय SMTP उपयोग करते हैं, तो Status200 में कॉन्फ़िगर किया गया SMTP सर्वर और पोर्ट अनुमत करें।

सेटअप निर्देश#

1. अपना इनबाउंड ईमेल डोमेन चुनें#

   Status200 के लिए ईमेल पाने के लिए समर्पित एक सबडोमेन चुनें, जैसे inbound.yourdomain.com, email.yourdomain.com या monitor.yourdomain.com। इसका उपयोग केवल Status200 मॉनिटरों और वर्कफ़्लो के ईमेल के लिए होता है, इसलिए इस पर आपका कोई मेलबॉक्स नहीं रहता।

2. इसके MX रिकॉर्ड को SendGrid की ओर इंगित करें#

   एक MX रिकॉर्ड जोड़ें जो सबडोमेन के ईमेल को SendGrid तक भेजे:

   प्रकार	होस्ट/नाम	प्राथमिकता	मान
   MX	inbound	10	mx.sendgrid.net

   अगर आपका डोमेन example.com है और आप inbound.example.com उपयोग कर रहे हैं, तो रिकॉर्ड ऐसा होगा:

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

   DNS बदलावों को फैलने में 48 घंटे तक लग सकते हैं, लेकिन आम तौर पर वे कुछ ही घंटों में पूरे हो जाते हैं।

3. SendGrid में डोमेन प्रमाणित करें#

   प्राप्त करने वाला डोमेन आपके SendGrid में प्रमाणित डोमेन में से किसी एक का होना चाहिए। SendGrid डैशबोर्ड में Settings > Sender Authentication पर जाएँ, Authenticate Your Domain पर क्लिक करें, और माँगे गए DNS रिकॉर्ड जोड़ें (DKIM के लिए CNAME रिकॉर्ड)।

4. Inbound Parse वेबहुक जोड़ें#

   SendGrid डैशबोर्ड में Settings > Inbound Parse पर जाएँ और Add Host & URL पर क्लिक करें। इसे नीचे दिए अनुसार भरें, फिर Add पर क्लिक करें:

   फ़ील्ड	मान
   Receiving Domain	आपका इनबाउंड सबडोमेन (जैसे, inbound.yourdomain.com)
   Destination URL	https://your-oneuptime-domain.com/incoming-email/sendgrid/YOUR_SECRET
   Check incoming emails for spam	वैकल्पिक - चाहें तो सक्षम करें
   Send raw, full MIME message	बिना चुने छोड़ दें (आवश्यक नहीं)
   POST the raw, full MIME message	बिना चुने छोड़ दें (आवश्यक नहीं)

5. Status200 कॉन्फ़िगर करें#

   इनबाउंड ईमेल वेरिएबल सेट करें, उसी सीक्रेट के साथ जो Destination URL में है:

   Docker ComposeKubernetes

   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 ज़रूरी है: जब तक यह खाली है या अब भी इस पेज का कोई प्लेसहोल्डर है, Status200 हर ईमेल अस्वीकार करता है। openssl rand -hex 32 एक लंबा यादृच्छिक मान बनाता है।

   फिर इन्हें लागू करें: Docker Compose पर npm run start चलाएँ, जो नए मानों के साथ कंटेनर फिर से बनाता है, या Kubernetes पर Helm रिलीज़ अपग्रेड करें।

6. एक Incoming Email मॉनिटर बनाएँ#

   एक Incoming Email मॉनिटर बनाएँ। इसका अवलोकन पृष्ठ इसका पता दिखाता है, जैसे monitor-abc123def456@inbound.yourdomain.com, और इसके मानदंड तय करते हैं कि कौन-से ईमेल अलर्ट बनाते हैं और कौन-से उसे सुलझाते हैं।

   वर्कफ़्लो भी इसी डोमेन का उपयोग करते हैं। किसी वर्कफ़्लो में Incoming Email ट्रिगर जोड़ें और उस पर क्लिक करें: उसका पता (workflow-…@inbound.yourdomain.com) उसकी सेटिंग्स में सबसे ऊपर होता है। जब तक ऊपर के इनबाउंड ईमेल वेरिएबल सेट नहीं होते, ट्रिगर बताता है कि सर्वर ईमेल पाने के लिए सेट नहीं है।

7. एक टेस्ट ईमेल भेजें#

   मॉनिटर के पते पर ऐसे विषय वाला ईमेल भेजें जो उसके मानदंडों से मेल खाता हो। मॉनिटर का सारांश ईमेल दिखाता है, और मानदंड मेल खाने पर एक अलर्ट बनता है।

एनवायरनमेंट वेरिएबल संदर्भ#

कोई Incoming Email मॉनिटर किन चीज़ों पर मिलान कर सकता है - विषय, भेजने वाला, मुख्य भाग, प्राप्तकर्ता, और यह कि ईमेल समय पर पहुँचा या नहीं - यह उपलब्ध फ़िल्टर प्रकार में है।

समस्या निवारण#

सुरक्षा के सर्वोत्तम तरीके#

1. HTTPS उपयोग करें: अपने वेबहुक एंडपॉइंट के लिए हमेशा HTTPS उपयोग करें
2. वेबहुक सीक्रेट: INBOUND_EMAIL_WEBHOOK_SECRET के लिए अपना एक लंबा यादृच्छिक मान रखें, अपने वेबहुक URL के अंत में (जैसे, /incoming-email/sendgrid/your-secret): इसी से SendGrid के ईमेल बाकी सबके ईमेल से अलग पहचाने जाते हैं
3. डोमेन सत्यापन: बेहतर ईमेल सुरक्षा के लिए SendGrid में अपना डोमेन सत्यापित करें
4. पहुँच सीमित करें: केवल भरोसेमंद ईमेल स्रोतों के लिए मॉनिटर बनाएँ
5. लॉग की निगरानी करें: संदिग्ध गतिविधि के लिए आने वाले ईमेल के लॉग नियमित रूप से देखें

अगले कदम#