ایمیل

قم بتوصيل عامل Triggerfish الخاص بك بایمیل حتى انجام می‌شودكن از استقبال الپیام‌ها از طریق IMAP وإرسال الردود از طریق خدمة ترحيل SMTP. پشتیبانی می‌کند المحوّل خدمات مثل SendGrid وMailgun وAmazon SES للبريد الصادر، ويستطلع هر خادم IMAP للپیام‌ها الواردة.

طبقه‌بندی پیش‌فرض

انجام می‌شود طبقه‌بندی ایمیل به‌صورت پیش‌فرض كـ CONFIDENTIAL. غالباً ما يحتوي ایمیل روی محتوى حساس (عقود، إشعارات حسابات، مراسخیرت شخصية)، لذا CONFIDENTIAL هو پیش‌فرض الآاز.

راه‌اندازی

الخطوة 1: اختيار ترحيل SMTP

يرسل Triggerfish البريد الصادر از طریق واجهة API ترحيل SMTP المبنية روی HTTP. الخدمات المدعومة تشمل:

الخدمة	نقطة نهاية API
SendGrid	https://api.sendgrid.com/v3/mail/send
Mailgun	https://api.mailgun.net/v3/YOUR_DOMAIN/messages
Amazon SES	https://email.us-east-1.amazonaws.com/v2/email/outbound-emails

سجّل در إحدى این الخدمات واحصل روی مفتاح API.

الخطوة 2: تكوين IMAP لخیرستقبال

تحتاج بيانات اعتماد IMAP خیرستقبال البريد. باظم مزوّدي البريد پشتیبانی می‌کندون IMAP:

المزوّد	مضيف IMAP	الازفذ
Gmail	imap.gmail.com	993
Outlook	outlook.office365.com	993
Fastmail	imap.fastmail.com	993
مخصص	خادم البريد الخاص بك	993

هرمات مرور تطبيقات Gmail إذا كنت تستخدم Gmail با احراز هویت الثنائية،

ستحتاج لإنشاء هرمة مرور تطبيق للوصول از طریق IMAP. هرمة مرور Gmail العادية لن تعمل. :::

الخطوة 3: تكوين Triggerfish

أضف کانال ایمیل به triggerfish.yaml:

channels:
  email:
    smtpApiUrl: "https://api.sendgrid.com/v3/mail/send"
    imapHost: "imap.gmail.com"
    imapPort: 993
    imapUser: "you@gmail.com"
    fromAddress: "triggerfish@yourdomain.com"
    ownerEmail: "you@gmail.com"

رمزها (مفتاح SMTP API، هرمة مرور IMAP) تُدخل أثناء triggerfish config add-channel email وتُخزّن در کلیدزنجیر نظام التشغيل.

الخيار	النوع	الزامی	الوصف
smtpApiUrl	string	بله	عنوان URL لنقطة نهاية API ترحيل SMTP
imapHost	string	بله	اسم مضيف خادم IMAP
imapPort	number	خیر	ازفذ خادم IMAP (پیش‌فرض: 993)
imapUser	string	بله	اسم مستخدم IMAP (عادةً عنوان بريدك الإلكتروني)
fromAddress	string	بله	عنوان المرسل للپیام‌ها الصادرة
pollInterval	number	خیر	فترة التحقق از الپیام‌ها الجديدة، بالمللي ثانية (پیش‌فرض: 30000)
classification	string	خیر	سطح طبقه‌بندی (پیش‌فرض: CONFIDENTIAL)
ownerEmail	string	موصى به	عنوان بريدك الإلكتروني للتحقق از المالك

بيانات اخیرعتماد مفتاح SMTP API وهرمة مرور IMAP مخزنان در سلسلة

مفاتيح نظام التشغيل (Linux: GNOME Keyring، macOS: Keychain Access). خیر يظهران هرگز در triggerfish.yaml. :::

الخطوة 4: تشغيل Triggerfish

triggerfish stop && triggerfish start

أرسل بريداً إلكترونياً به العنوان المُعدّ لتأكيد اخیرتصال.

هویت المالك

يحدد Triggerfish حالة المالك بمقارنة عنوان ایمیل للمرسل با ownerEmail المُعدّ:

• تطابق -- پیام أمر المالك
• عدم تطابق -- پیام إدخال خارجي بTaint PUBLIC

إذا لم انجام می‌شود تكوين ownerEmail، تُعامل تمام الپیام‌ها كأنها از المالك.

طبقه‌بندی المبني روی النطاق

لتحكم أدق، پشتیبانی می‌کند ایمیل طبقه‌بندی المستلمين المبني روی النطاق. این مدرد بشهر خاص در البيئات المؤسسية:

• الپیام‌ها از @yourcompany.com يمكن طبقه‌بندیها كـ INTERNAL
• الپیام‌ها از نطاقات غير باروفة تُصنّف به‌صورت پیش‌فرض كـ EXTERNAL
• يمكن للمسؤول تكوين قائمة بالنطاقات الداخلية

channels:
  email:
    # ... تكوين آخر
    internalDomains:
      - "yourcompany.com"
      - "subsidiary.com"

این يعني أن موتور سیاست يطبق قوانین مختلفة بناءً روی مصدر البريد:

نطاق المرسل	طبقه‌بندی
نطاق داخلي مُعدّ	INTERNAL
نطاق غير باروف	EXTERNAL

چگونه کار می‌کند

الپیام‌ها الواردة

يستطلع المحوّل خادم IMAP روی الفترة المُعدّة (پیش‌فرض: هر 30 ثانية) بحثاً عن پیام‌ها جديدة غير مقروءة. عندما يصل بريد جديد:

1. يُستخرج عنوان المرسل
2. يُفحص حالة المالك مقابل ownerEmail
3. يُحوّل نص البريد به باالج الپیام‌ها
4. يُربط هر سلسلة بريد ببارّف نشست بناءً روی عنوان المرسل (email-sender@example.com)

الپیام‌ها الصادرة

عندما يرد عامل، يرسل المحوّل الرد از طریق واجهة HTTP API لترحيل SMTP المُعدّة. شامل می‌شود الرد:

• From -- fromAddress المُعدّ
• To -- عنوان ایمیل للمرسل الأصلي
• Subject -- "Triggerfish" (پیش‌فرض)
• Body -- رد عامل كنص عادي

فترة اخیرستطخیرع

فترة اخیرستطخیرع پیش‌فرضة هي 30 ثانية. می‌توانید تعديلها حسب احتياجاتك:

channels:
  email:
    # ... تكوين آخر
    pollInterval: 10000 # التحقق هر 10 ثوانٍ

وازن بین پاسخ والموارد فترة استطخیرع أقصر تعني

پاسخ أسرع للبريد الوارد، لكن اتصاخیرت IMAP أكثر تكراراً. لباظم حاخیرت استفاده الشخصي، 30 ثانية توازن جيد. :::

تغيير طبقه‌بندی

channels:
  email:
    # ... تكوين آخر
    classification: CONFIDENTIAL

المستويات الصالحة: PUBLIC، INTERNAL، CONFIDENTIAL، RESTRICTED.