Рұқсат етілген және тыйым салынған жіберушілер

Жағымсыз поштадан қорғау үшін жіберушілерді тыйым салынғандар тізіміне пошта мекенжайы, домен, IP немесе ішкі желі мекенжайы арқылы қосуға болады. Осылайша сіз белгілі бір көздерден жіберілетін хабарларды, олар тіпті Спамооборона тексеруінен өтсе де блоктай аласыз.

Бастамас бұрын

Рұқсат етілген және тыйым салынған жіберушілердің тізімдерін басқару тек API арқылы қолжетімді және Домендік саясат ережелері арқылы жүзеге асырылады.

1. API интерфейсімен жұмыс істеу үшін сізге Яндекс OAuth сервисінде қолданбаны жасағаннан кейін алуға болатын OAuth токені қажет болады.

   • Егер сізде әлі OAuth қолданбасы болмаса, оны жасау және токен алу үшін API интерфейсін пайдалану рұқсаты бетіндегі нұсқаулықты пайдаланыңыз. Қолданба жасау кезінде ya360_admin:mail_write_routing_rules және ya360_admin:mail_read_routing_rules рұқсаттарын таңдаңыз.
   • Егер сізде Бизнеске арналған Яндекс 360 API интерфейсімен жұмыс істеу үшін OAuth қолданбасы бұрыннан бар болса, онда оған домендік саясаттар мен хаттарды өңдеу ережелерімен жұмыс істеу үшін пайдалану рұқсатын қосып, содан кейін нұсқаулық бойынша жаңа OAuth токенін алыңыз.

2. Ұйым идентификаторын анықтаңыз: admin.yandex.kz бетін ашып, Жалпы реттеулер → Ұйым профилі тармағын таңдаңыз. Идентификатор ұйым атауының астында жазылады.

Ережелер тізімін қарау жолы

1. GET сұрауын жасап, оны жіберіңіз:

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

   Кодқа мына мәндерді қойыңыз:

   • {orgId} — ұйым идентификаторы;
   • {oauth_token} — OAuth токені.

2. Сұрауға жауап рұқсат етілген және тыйым салынған жіберушілердің тізімдері бар ережелер тізбесін қайтарады.

Жіберушіні тізімге қалай қосу керек

Жіберушіні қолданыстағы ережеге қосуға немесе жаңа ереже орнатуға болады.

1. GET сұрауын жасап, оны жіберіңіз:

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

   Кодқа мына мәндерді қойыңыз:

   • {orgId} — ұйым идентификаторы;
   • {oauth_token} — OAuth токені.

2. Бұрыннан бар ережелер тізімі body.json файлына сақталады.

3. Файлды кез келген редакторда ашыңыз. Мазмұн мысалы:

   {
       "rules": [{
               "name":{атауы},
               "description":{сипаттамасы},
               "enabled":{белсенділік},
               "condition":{
                   "email_from_filter":{
                       "list": [
                           "username@domain.ru",
                           "username@my.domain.ru",
                           "username@SOME.DOMAIN",
                           "username@other.domain.ru"
                       ]
                   }
               },
               "action":{
                   "type":{әрекет},
                   "options":{
                       "force":{белгі}
                   }
               }
           }
       ]
   }
   

   Бұл жерде: {атауы} — ереже атауы, мысалы,"Тыйым салынған пошта мекенжайлары"; {сипаттамасы} — түсіндірме беруге болатын ереженің қысқаша сипаттамасы, мысалы, "Жағымсыз хаттарды қабылдамау"; {белсенділік} — ережені қосу қажеттілігі: true — ереже қосулы, false — ереже өшірулі; {әрекет} — орындалатын әрекет: reject — хатты қабылдамау, accept — хатты қабылдау; {белгі} — қабылданған хатқа қосымша белгі қою қажеттілігі: spam — хатты спам ретінде белгілеу, ham — Поштаның Спамооборона жүйесі хатты спам ретінде белгілесе де, хатты спам деп санамау. Параметр тек type=accept болса ғана пайдаланылады.

   Әрбір ереже үшін condition параметрінде тізімдегі шарттардың біреуі ғана көрсетілуі мүмкін:

   • email_from_filter — электрондық пошта мекенжайларының тізімі;
   • ip_filter — IP мекенжайлары мен ішкі желілер тізімі;
   • domain_filter — домендер тізімі (осы тізімдегі мәндерде жоғары деңгейлі домен үшін кез келген ішкі домендерді көрсету үшін * ауыстыру таңбасы болуы мүмкін. Мысал).

4. Жіберушіні қолданыстағы ереженің тиісті тізіміне қосыңыз немесе жаңа ереже орнатыңыз. Тізімдегі ережелердің реті маңызды: ереже тізімде неғұрлым жоғары болса, оның басымдығы соғұрлым жоғары болады.

   Бірнеше ережелері бар дайын файлдың мысалы

   {
       "rules": [{
               "name": "Тыйым салынған пошта мекенжайлары",
               "description": "Жағымсыз хаттарды қабылдамау",
               "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": "Тыйым салынған домендер",
               "description": "Жағымсыз хаттарды қабылдамау",
               "enabled": true,
               "condition":{
                   "domain_filter":{
                       "list": [
                           "SOME.DOMAIN",
                           "other.domain.ru",
                           "*.download"
                       ]
                   }
               },
               "action":{
                   "type": "reject"
               }
           },{
               "name": "Рұқсат етілген IP мекенжайлары",
               "description": "Серіктестердің IP мекенжайлары",
               "enabled": true,
               "condition":{
                   "ip_filter":{
                       "list": [
                           "44.33.22.11",
                           "255.255.0.0/16"
                       ]
                   }
               },
               "action":{
                   "type": "accept"
               }
           },{
               "name": "Спамға күдігі бар",
               "description": "Спам қалтасына орналастыру",
               "enabled": true,
               "condition":{
                   "ip_filter":{
                       "list": [
                           "55.55.33.33"
                       ]
                   }
               },
               "action":{
                   "type": "accept",
                   "options":{
                       "force": "spam"
                   }
               }
           }
       ]
   }
   

5. Файлды сақтаңыз.

6. PUT сұрауын жасап, оны жіберіңіз:

   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 
   

   Кодқа мына мәндерді қойыңыз:

   • {orgId} — ұйым идентификаторы;
   • {oauth_token} — OAuth токені.

7. Сәтті сұраудың нәтижесі — 200 коды бар жауап.

API құжаттамасы

Рұқсат етілген және тыйым салынған жіберушілердің тізімдерін басқарудың барлық әдістерінің толық сипаттамасын құжаттамадан таба аласыз.