İzin verilen ve engellenen göndericiler

İstenmeyen e-postalara karşı koruma sağlamak için, gönderenleri e-posta adresi, alan adı, IP adresi veya alt ağa göre engelli listesine ekleyebilirsiniz. Bu şekilde, belirli kaynaklardan gelen mesajları, Spam Savunması kontrolünü geçseler bile engelleyebilirsiniz.

Başlamadan önce

İzin verilen ve engellenen gönderen listelerinin yönetimi şimdilik sadece API aracılığıyla mümkündür ve Alan Adı Politika Kuralları yardımıyla gerçekleştirilir.

1. API ile çalışmak için Yandex OAuth servisinde bir uygulama oluşturduktan sonra elde edilebilecek OAuth-belirteci’ne ihtiyacınız olacaktır.

   • Henüz bir OAuth uygulamanız yoksa, bir tane oluşturmak ve bir belirteç almak için API’ye Erişim sayfasındaki talimatları kullanın. Uygulamayı oluştururken ya360_admin:mail_write_routing_rules ve ya360_admin:mail_read_routing_rules yetkilerini seçin.
   • Yandex 360 API for business ile çalışmak için zaten bir OAuth uygulamanız varsa, alan adı politikaları ve e-posta işleme kuralları ile çalışmak için ona erişim yetkileri ekleyin ve ardından talimatlara göre yeni bir OAuth belirteci edinin.

2. Organizasyonun kimliğini belirleyin: admin.yandex.ru adresini açın ve Genel Ayarlar → Organizasyon Profili öğesini seçin. Kimlik, organizasyonun adının altına yazılacaktır.

Kural listesi nasıl görüntülenir?

1. Aşağıdaki şekilde GET-istek oluşturun ve gönderin:

   curl -X GET -H "Authorization: OAuth {oauth_token}" https://api360.yandex.net/admin/v1/org/{orgId}/mail/routing/policies 
   

   Kodda şu değerleri kullanın:

   • {orgId} – organizasyon kimliği;
   • {oauth_token} – OAuth belirteci.

2. İsteğe verilen yanıt, izin verilen ve reddedilen göndericilerin listesini içeren bir kural listesi getirir.

Listeye bir gönderici nasıl eklenir?

Mevcut bir kurala gönderen ekleyebilir veya yeni bir kural tanımlayabilirsiniz.

1. Aşağıdaki şekilde GET-istek oluşturun ve gönderin:

   curl -X GET -H "Authorization: OAuth {oauth_token}" -o body.json https://api360.yandex.net/admin/v1/org/{orgId}/mail/routing/policies 
   

   Kodda şu değerleri kullanın:

   • {orgId} – organizasyon kimliği;
   • {oauth_token} – OAuth belirteci.

2. Mevcut kuralların bir listesi body.json dosyasına kaydedilecektir.

3. Herhangi bir düzenleyicide dosyayı açın. İçerik Örneği:

   {
       "rules": [{
               "name":{ad},
               "description":{açıklama},
               "enabled":{etkinlik},
               "condition":{
                   "email_from_filter":{
                       "list": [
                           "username@domain.ru",
                           "username@my.domain.ru",
                           "username@SOME.DOMAIN",
                           "username@other.domain.ru"
                       ]
                   }
               },
               "action":{
                   "type":{eylem},
                   "options":{
                       "force":{işaret}
                   }
               }
           }
       ]
   }
   

   Burada: {ad} – kuralın adıdır, örneğin “Engelli e-posta adresleri”; {açıklama} – kuralın “İstenmeyen e-postaları engelle” gibi kısa bir açıklamasıdır; {etkinlik} – kuralı etkinleştirmenin gerekip gerekmediğidir: true – kural etkindir, false – kural etkin değildir; {eylem} – hangi eylemin gerçekleştirileceğidir: reject – “e-postayı engelle”dir, accept – “e-postayı kabul et”dir; {işaret} – kabul edilen e-postanın ayrıca işaretlenmesinin gerekip gerekmediğidir: spam – “e-postayı spam olarak işaretleyin”dir, ham – “Mail Spam Koruması e-postayı spam olarak işaretlemiş olsa bile e-postayı spam olarak değerlendirmeyin”dir. Parametre sadece type=accept ise kullanılır.

   Her kural için, condition parametresinde listeli koşullardan sadece biri belirlenebilir:

   • email_from_filter – elektronik posta adreslerinin listesi;
   • ip_filter – IP adreslerinin ve alt ağların listesi;
   • domain_filter – alan adları listesi (bu listedeki değerler, üst düzey alan adı için herhangi bir alt alan adını belirtmek üzere * yıldız karakterini içerebilir. Örnek).

4. Göndereni mevcut bir kuralın uygun olan listesine ekleyin veya yeni bir kural tanımlayın. Listedeki kuralların sıralanışı önemlidir: Bir kural listenin ne kadar üstündeyse, önceliği o kadar yüksektir.

   Birkaç kural içeren hazır bir dosya örneği

   {
       "rules": [{
               "name": "Engelli e-posta adresleri",
               "description": "İstenmeyen e-postaları engelle",
               "enabled": true,
               "condition":{
                   "email_from_filter":{
                       "list": [
                           "username@domain.ru",
                           "username@my.domain.ru",
                           "username@SOME.DOMAIN",
                           "username@other.domain.ru"
                       ]
                   }
               },
               "action":{
                   "type": "reject"
               }
           },{
               "name": "Engellenen alan adları",
               "description": "İstenmeyen e-postaları engelle",
               "enabled": true,
               "condition":{
                   "domain_filter":{
                       "list": [
                           "SOME.DOMAIN",
                           "other.domain.ru",
                           "*.download"
                       ]
                   }
               },
               "action":{
                   "type": "reject"
               }
           },{
               "name": "Engellenen IP adresleri",
               "description": "Ortakların IP adresleri",
               "enabled": true,
               "condition":{
                   "ip_filter":{
                       "list": [
                           "44.33.22.11",
                           "255.255.0.0/16"
                       ]
                   }
               },
               "action":{
                   "type": "accept"
               }
           },{
               "name": "Spam şüphesi",
               "description": "Spam klasörüne at.",
               "enabled": true,
               "condition":{
                   "ip_filter":{
                       "list": [
                           "55.55.33.33"
                       ]
                   }
               },
               "action":{
                   "type": "accept",
                   "options":{
                       "force": "spam"
                   }
               }
           }
       ]
   }
   

5. Dosyayı kaydedin.

6. Aşağıdaki şekilde PUT-istek oluşturun ve gönderin:

   curl -X PUT -H "Authorization: OAuth {oauth_token}" -H "Content-Type: application/json" -d "@body.json" https://api360.yandex.net/admin/v1/org/{orgId}/mail/routing/policies 
   

   Kodda şu değerleri kullanın:

   • {orgId} – organizasyon kimliği;
   • {oauth_token} – OAuth belirteci.

7. Başarılı bir istek, 200 kodlu bir yanıtla sonuçlanır.

API belgeleri

İzin verilen ve engellenen gönderen listelerinin yönetilmesine ilişkin tüm yöntemlerin tam açıklamasını belgeler’de bulabilirsiniz.