Ruxsat etilgan va taqiqlangan yuboruvchilar

Nomaqbul pochtadan himoyalanish uchun siz yuboruvchilarni taqiqlanganlar ro‘yxatiga qo‘shishingiz mumkin — pochta manzili, domeni, IP-manzili yoki quyi tarmog‘i bo‘yicha. Shunday qilib, siz xabarlarni muayyan manbalardan bloklashingiz mumkin, hatto ular Spamdan himoyalash tekshiruvidan o‘tsa ham.

Boshlashdan oldin

Ruxsat etilgan va taqiqlangan yuboruvchilar ro‘yxatini boshqarish hozircha faqat API orqali mavjud va Domen siyosati qoidalari yordamida amalga oshiriladi.

1. API bilan ishlash uchun sizga Yandex OAuth xizmatida ilovani yaratgandan keyin olishingiz mumkin bo‘lgan OAuth-token kerak bo‘ladi.

   • Hali sizda OAuth-ilova mavjud bo‘lmasa, uni yaratish va token olish uchun API ruxsat sahifasidagi ko‘rsatmalardan foydalaning. Ilovani yaratishda ya360_admin:mail_write_routing_rules va ya360_admin:mail_read_routing_rules huquqlarini tanlang.
   • Agar sizda allaqachon Yandex 360 Biznes API bilan ishlash uchun OAuth ilovasi bo‘lsa, unga domen siyosatlari va xatlarni qayta ishlash qoidalari bilan ishlash uchun kirish huquqlarini qo‘shing va keyin yo‘riqnoma bo‘yicha yangi OAuth tokenini oling.

2. Tashkilot identifikatorini aniqlang: admin.yandex.ru sahifasini oching va Umumiy sozlamalar → Tashkilot profili bandini tanlang. Identifikator tashkilot nomi ostida yoziladi.

Qoidalar ro‘yxatini qanday ko‘rish mumkin

1. GET-so‘rov yarating va yuboring:

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

   Kodga vazifa qo‘yasiz:

   • {orgId} — tashkilotingiz identifikatori;
   • {oauth_token} — OAuth-token.

2. So‘rovga javob ruxsat etilgan va taqiqlangan jo‘natuvchilarning ro‘yxatlarini o‘z ichiga olgan qoidalar ro‘yxatini qaytaradi.

Yuboruvchi ro‘yxatga qanday kiritiladi

Yuboruvchini mavjud qoidaga qo‘shishingiz yoki yangi qoida o‘rnatishingiz mumkin.

1. GET-so‘rov yarating va yuboring:

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

   Kodga vazifa qo‘yasiz:

   • {orgId} — tashkilotingiz identifikatori;
   • {oauth_token} — OAuth-token.

2. Mavjud qoidalar ro‘yxati body.json fayliga saqlanadi.

3. Faylni istalgan muharrirda oching. Kontent namunasi:

   {
       "rules": [{
               "name":{nomi},
               "description":{tavsif},
               "enabled":{faolligi},
               "condition":{
                   "email_from_filter":{
                       "list": [
                           "username@domain.ru",
                           "username@my.domain.ru",
                           "username@SOME.DOMAIN",
                           "username@other.domain.ru"
                       ]
                   }
               },
               "action":{
                   "type":{amallar},
                   "options":{
                       "force":{belgi}
                   }
               }
           }
       ]
   }
   

   Bu yerda: {nom} — qoida nomi, masalan, “Taqiqlangan pochta manzillari”; {tavsif} — izoh berishi mumkin bo‘lgan qoidalarning qisqa tavsifi, masalan, “Istalmagan xatlarni rad etish”; {faollik} — qoidani yoqish kerakmi: true — qoida yoqildi, false — qoida yoqildi; {amallar} — qanday amallarni bajarish kerak: reject — xatni rad etish, accept — xatni qabul qilish; {belgi} — qabul qilingan xatga qo‘shimcha belgi qo‘yish kerakmi: spam — xatni spam deb belgilab, ham — xatni spam deb hisoblamang, hatto Pochta Spamdan himoya xizmati uni spam deb belgilagan bo‘lsa ham. Bu parametr faqat type=accept bo‘lsa ishlatiladi.

   Har bir qoida uchun condition parametrida ro‘yxatli shartlardan faqat bittasi ko‘rsatilishi mumkin:

   • email_from_filter — elektron pochta manzillari ro‘yxati;
   • ip_filter — IP manzillar va quyi tarmoqlar ro‘yxati;
   • domain_filter — domenlar ro‘yxati (bu ro‘yxatdagi qiymatlar yuqori darajadagi domen uchun har qanday kichik domenlarni belgilash uchun * almashtirish belgisini o‘z ichiga olishi mumkin. Namuna).

4. Yuboruvchini mavjud qoidalarning mos ro‘yxatiga kiriting yoki yangi qoida kiriting. Ro‘yxatdagi qoidalar tartibi ahamiyatga ega: qoida ro‘yxat boshida qanchalik yuqori bo‘lsa, uning ustuvorligi shunchalik yuqori bo‘ladi.

   Bir nechta qoidaga ega tayyor faylga misol

   {
       "rules": [{
               "name": "Taqiqlangan pochta manzillari",
               "description": "Istalmagan xatlarni rad etish",
               "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": "Taqiqlangan domenlar",
               "description": "Yoqimsiz xatlarni rad etish",
               "enabled": true,
               "condition":{
                   "domain_filter":{
                       "list": [
                           "SOME.DOMAIN",
                           "other.domain.ru",
                           "*.download"
                       ]
                   }
               },
               "action":{
                   "type": "reject"
               }
           },{
               "name": "Ruxsat berilgan IP manzillar",
               "description": "Hamkorlarning IP manzillari",
               "enabled": true,
               "condition":{
                   "ip_filter":{
                       "list": [
                           "44.33.22.11",
                           "255.255.0.0/16"
                       ]
                   }
               },
               "action":{
                   "type": "accept"
               }
           },{
               "name": "Spamga shubha qilish",
               "description": "Spam jildiga joylash",
               "enabled": true,
               "condition":{
                   "ip_filter":{
                       "list": [
                           "55.55.33.33"
                       ]
                   }
               },
               "action":{
                   "type": "accept",
                   "options":{
                       "force": "spam"
                   }
               }
           }
       ]
   }
   

5. Faylni saqlang.

6. PUT-so‘rov yarating va yuboring:

   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 
   

   Kodga vazifa qo‘yasiz:

   • {orgId} — tashkilotingiz identifikatori;
   • {oauth_token} — OAuth-token.

7. Muvaffaqiyatli so‘rov natijasi 200 kodli javobdir.

API hujjatlari

Ruxsat etilgan va taqiqlangan yuboruvchilar ro‘yxatlarini boshqarish uchun barcha usullarning to‘liq tavsifini hujjatlarda topasiz.