Дарвозаҳои тасдиқ — AiHummer Ҳуҷҷатнигорӣ

Баъзе даъватҳои абзор набояд бидуни ризоияти инсон рух диҳанд — фиристодани нома, паём ба канал, тағйирот бо оқибатҳои воқеӣ. Дарвозаҳои тасдиқ-и AiHummer пеш аз иҷрои чунин абзорҳо як шахсро дар ҳалқа мегузоранд ва бо таъсироти иловагии идемпотентӣ ҷуфт мешаванд, то тасдиқи як даври барқароршуда ҳаргиз ҳамон амалро ду бор сар надиҳад.

Чӣ тавр дарвоза кор мекунад

Шумо бо танзими AIHUMMER_APPROVAL_TOOLS эълом мекунед, ки кадом абзорҳо тасдиқ талаб мекунанд — рӯйхати номҳои абзор. Вақте агент тасмим мегирад, ки яке аз ин абзорҳоро даъват кунад, иҷро таваққуф мекунад ва дархости тасдиқ барои баррасии инсон ба миён меояд.

# /home/.aihummer/etc/gateway.env
# Comma-separated list of tools that require approval before execution
AIHUMMER_APPROVAL_TOOLS=mail,http_request

Дархости интизорӣ дар UI-и админ ва API-и админ (/v1/admin/approvals) пайдо мешавад, ки дар он баррасикунанда абзор, далелҳои он ва контекстро мебинад ва сипас онро тасдиқ ё рад мекунад.

Тасдиқ маънои иҷро дорад, рад маънои иҷро накардан дорад

Дарвоза якмаъно аст:

Тасдиқ — абзор маҳз бо ҳамон далелҳое, ки баррасӣ шуданд, иҷро мешавад.
Рад — абзор иҷро намешавад. Иҷрои қисман ё ба таъхиргузошта вуҷуд надорад; даъвати раддшуда танҳо рух намедиҳад ва даври кор бидуни он таъсири иловагӣ идома меёбад.

[!NOTE] Рад барои он даъвати мушаххас таваққуфи қатъист. Агент пушти сари баррасикунанда хомӯшона амали раддшударо аз нав санҷиш намекунад.

Чаро ин зери барқароршавӣ бехатар аст

Дарвозаҳои тасдиқ бо таъсироти иловагии идемпотентӣ-и AiHummer ҷуфт мешаванд. Як даври кор метавонад қатъ шавад (бозоғозӣ, ноком шудан) ва сипас барқарор гардад. Бидуни ҳифз, як даври барқароршуда метавонад амалеро, ки аллакай рух дода буд, аз нав содир кунад — ҳамон номаро ду бор фиристад, ҳамон паёмро дубора гузорад.

AiHummer инро бо калиди дафтари устувор ба идомадиҳӣ ва монеаи таъсири иловагӣ пешгирӣ мекунад: ҳар таъсири иловагӣ зери як калиди устувор сабт мешавад ва монеа аз иҷрои дубораи таъсире, ки дафтар онро аллакай иҷрошуда нишон медиҳад, рад мекунад.

[!TIP] Натиҷаи амалӣ: тасдиқи як даври барқароршуда нома ё паёми каналро дубора сар намедиҳад. Монеа кафолат медиҳад, ки таъсир маҳз як бор рух диҳад, новобаста аз он ки даври кор барқарор шуда буд ё не.

Барои механикаи пурраи дафтар ва монеаи таъсири иловагӣ ба Бисёрмустаъҷирӣ ва идемпотентӣ нигаред.

Интихоби он ки кадом абзорҳоро дарвозабандӣ кардан

Абзорҳоеро дарвозабандӣ кунед, ки таъсирашон аз берун намоён ё бекор кардани онҳо душвор аст. Номзадҳои хуб:

mail — номаи берунӣ.
Паём ба канал / расонидани берунӣ ба муштариён ё кормандон.
http_request ва дигар абзорҳое, ки метавонанд системаҳои берунаро тағйир диҳанд.
code_exec дар мизбонҳои муштарак (он ҷо низ ба таври пешфарз хомӯш аст).

Абзорҳои танҳохонданӣ (ҷустуҷӯ, ҷустуҷӯи дониш, вақт) одатан ба дарвоза ниёз надоранд. Дарвозаҳои тасдиқро бо реҷаи аз шабака ҷудошуда ва назорати хуруҷ барои абзорҳое, ки ба интернети ҷамъиятӣ мерасанд, якҷоя кунед.

Минбаъд ба куҷо

Бисёрмустаъҷирӣ ва идемпотентӣ — дафтар ва монеаи таъсири иловагӣ дар паси таъсироти маҳз-як-бора.
Монеаҳои муҳофизатӣ ва дифоъ аз сӯзандани дастур — модел аз он нигоҳ доред, ки ба таври бадхоҳона ба даъвати абзори дарвозабандишуда роҳбарӣ нашавад.
Шабака, аудит ва аз шабака ҷудошуда — маҳдуд кардани он ки абзорҳо ба чӣ мерасанд.