Documentation

AegisMX, dağıtık bir e-posta güvenlik ağ geçididir. Panel yönetim içindir (mail yolunda değildir); gerçek mail trafiğini mail node’ları (mx01, mx02) işler. Korunan her domain’in MX’i node’lara yönlendirilir, node gelen postayı tarar ve domain’in gerçek sunucusuna (destination) iletir.

Panelde yaptığın domain / kural / liste / ayar değişiklikleri otomatik olarak node’lara yayınlanır (birkaç saniye içinde).

1. Domains → Add: domain adı (ör. vulut.com) ve destination (gerçek mailin teslim edileceği sunucu, ör. mail.vulut.com) gir.
2. Domain’in DNS’inde MX kaydını mx.aegismx.net’e yönlendir (node’lar MX olur).
3. Test maili gönder; Log Search’te göründüğünü doğrula.

Node, alıcıyı kabul etmeden önce destination’a sorar (recipient verification): olmayan adresi RCPT anında reddeder — geçersiz alıcıya bounce üretilmez.

İki tür kullanıcı vardır:

• Yönetici (admin): tüm paneli yönetir — node’lar, tüm domainler, ayarlar.
• Domain kullanıcısı: yalnızca yetkili olduğu domain(ler)i yönetir. Bir kullanıcıya birden çok domain yetkisi verilebilir; kullanıcı sol-alttaki domain switcher ile aralarında geçiş yapar.

Bir kullanıcıyı silmek domaini silmez. Domain kullanıcısı eklerken mevcut bir hesabı seçebilir veya yeni hesap oluşturabilirsin.

Whitelist (izin) veya blacklist (engel) girişleri; gönderici, alıcı veya IP bazlı. Global (tüm domainler) ya da tek bir domaine özel olabilir.

1. Allow / Block Lists → Add: tür (block/allow), eşleşme (sender/recipient/ip) ve değer gir.
2. Blacklist’teki bir göndericiden gelen mail RCPT/DATA aşamasında reddedilir.

Filter Rules ile konu/başlık regex’i, ülke, ASN veya ek dosya adı desenine göre aksiyon (reddet / karantina / skoru değiştir / kabul) tanımlarsın. Kurallar global veya domaine özel olabilir.

Spam skoru eşik aralığında (varsayılan 5–12) kalan mailler fiziksel olarak tutulur (HOLD) ve Quarantine’de listelenir. Bir maili Release (teslim et), Whitelist & release (gönericiyi beyaz listeye alıp teslim et) veya Delete edebilirsin. Ham mesajı .eml olarak indirebilirsin.

Her node’un canlı Postfix kuyruğu. Bir mesajı Retry (hemen yeniden dene), Delete (sil) ya da tüm deferred kuyruğu Retry all ile flush edebilirsin. Silme anında yansır. Deferred = teslim geçici başarısız, otomatik tekrar denenir.

İşlenen her mesaj; gönderici/alıcı/konu, verdict (accepted / rejected / quarantined / deferred), toplam skor ve SPF/DKIM/DMARC sonuçları. Bir kayda tıkla → Checks sekmesinde her kuralın gerçek skoruyla dökümünü gör (geçen kontroller yeşil, spam sinyali kırmızı; toplam otoritatif skora eşittir).

Domain detayında Antivirus (ClamAV), Greylisting, SPF, DKIM, DMARC ve ek dosya politikasını domain bazında açıp kapatabilirsin (boş = global ayarı devral). Değişiklik ilgili node’lara yayınlanır.

Marka teması (renk/düzen/font) site geneli ve yalnızca admin tarafından, sağ üstteki palet ikonundan (ThemeCustomizer) ayarlanır — tüm kullanıcılara uygulanır. Light/Dark mod ise kişiseldir: her kullanıcı güneş/ay ikonuyla kendi tercihini seçer.

Administration → Audit Log: kim, ne zaman, hangi işlemi yaptı (login, domain/kural/liste/ayar değişiklikleri, karantina/kuyruk aksiyonları, agent güncelleme…) — aktör, aksiyon, sonuç kodu ve IP ile. Aramayla filtrelenir.

Panelin tüm yönetim uçları programatik olarak da kullanılabilir. Kimlik doğrulama API key ile yapılır.

1. Administration → API Keys → New key ile bir anahtar çifti oluştur: bir Key ID (public) ve bir Secret (gizli) üretilir. İstersen izinli IP/CIDR ekle — anahtar yalnızca o IP’lerden çalışır. Secret bir kez gösterilir, güvenli sakla.
2. Her istekte ikisini birlikte gönder — iki başlık: X-API-Key-Id: amxid_… ve X-API-Key-Secret: amxsk_… (ya da birleşik: Authorization: Bearer amxid_…:amxsk_…)

Base URL: https://panel.aegismx.net/api/v1. Tam referans: API Reference (panel içi, gezinilebilir) veya ham OpenAPI 3.0 (openapi.json) — Swagger UI / Postman / Insomnia’ya import edilebilir.

Örnekler

# Domainleri listele
curl -H "X-API-Key-Id: amxid_xxx" -H "X-API-Key-Secret: amxsk_xxx" \
  https://panel.aegismx.net/api/v1/domains

# Bir göndericiyi kara listeye ekle (domain'e özel)
curl -X POST -H "X-API-Key-Id: amxid_xxx" -H "X-API-Key-Secret: amxsk_xxx" \
  -H "Content-Type: application/json" \
  -d '{"kind":"blacklist","match":"sender","value":"spam@x.com","domain_id":"<DOMAIN_ID>"}' \
  https://panel.aegismx.net/api/v1/lists

# Logları ara (birleşik Bearer biçimi)
curl -H "Authorization: Bearer amxid_xxx:amxsk_xxx" \
  "https://panel.aegismx.net/api/v1/logs?search=vulut&limit=50"

Sık kullanılan uçlar: /domains · /lists · /rules · /logs · /quarantine · /queues · /reports · /nodes. Anahtar, oluşturan yöneticinin yetkileriyle çalışır; silindiğinde (delete) anında ve kalıcı olarak devre dışı kalır.

Cluster: mail node’larının durumu (CPU/RAM/disk/uptime, servis sağlığı). Node’lar aktif-aktif çalışır ve kendi kuyruklarını yönetir. Agent güncellemesi panelden tetiklenir; node kendini güncelleyip yeniden başlar.

• Korunan domain’in MX kaydı → mx.aegismx.net.
• Node IP’leri için PTR (reverse DNS) ve gönderim domaini için SPF/DKIM/DMARC kayıtları, giden mailin spam’e düşmemesi için önemlidir.
• Yeni IP’lerde büyük sağlayıcılar (Gmail vb.) düşük itibar nedeniyle geçici rate-limit uygulayabilir; hacim arttıkça düzelir.